OCI Plugin for Formae

Formae plugin for managing Oracle Cloud Infrastructure resources.

Supported Resources

Resource Type	Description
OCI::Identity::Compartment	Compartments
OCI::Core::Vcn	Virtual Cloud Networks
OCI::Core::Subnet	Subnets
OCI::Core::InternetGateway	Internet gateways
OCI::Core::NatGateway	NAT gateways
OCI::Core::ServiceGateway	Service gateways
OCI::Core::RouteTable	Route tables
OCI::Core::SecurityList	Security lists
OCI::Core::NetworkSecurityGroup	Network security groups
OCI::Core::NetworkSecurityGroupSecurityRule	NSG security rules
OCI::ContainerEngine::Cluster	OKE clusters
OCI::ContainerEngine::NodePool	OKE node pools
OCI::ContainerEngine::VirtualNodePool	OKE virtual node pools
OCI::ObjectStorage::Bucket	Object storage buckets

Installation

make install

Configuration

Configure an OCI target in your Forma file:

import "@oci/oci.pkl"

new formae.Target {
    label = "my-oci-target"
    config = new oci.Config {
        region = "us-ashburn-1"
        profile = "DEFAULT"
    }
}

Authentication uses the OCI SDK's default config provider:

• Config file (~/.oci/config)
• Environment variables
• Instance principal (on OCI compute)

Examples

See examples/ for usage patterns:

• lifeline/ - VCN networking infrastructure
• oke/ - OKE Kubernetes cluster

Note: Update vars.pkl with your compartment ID and region before running.

Development

make build          # Build plugin
make test           # Run tests
make install        # Install locally
make install-dev    # Install as v0.0.0 (for debug builds)
make gen-pkl        # Resolve PKL dependencies

Conformance Tests

Run against real OCI resources:

make setup-credentials                           # Verify OCI login
make conformance-test VERSION=0.77.16-internal   # Run full suite

License

FSL-1.1-ALv2