Terraform Provider for Oracle Cloud Infrastructure

The OCI Terraform Provider is now available for automatic download through the Terraform Provider Registry.

• Documentation
• Setup guide
• Examples
• OCI forums
• Github issues
• Troubleshooting

Requirements

• Terraform v0.12.31 or greater
• Go 1.21.8 (recommended)

Building the Provider

Clone repository to: $GOPATH/src/terraform-provider-oci

$ mkdir -p $GOPATH/src/github.com/terraform-providers; cd $GOPATH/src/github.com/terraform-providers
$ git clone git@github.com:terraform-providers/terraform-provider-oci

Enter the provider directory and build the provider

$ cd $GOPATH/src/terraform-provider-oci
$ make build

Installation

If you're building the provider, follow the instructions to install it as a plugin. After placing it into your plugins directory, run terraform init to initialize it and begin using Terraform with the Oracle Cloud Infrastructure provider.

Troubleshooting the Provider

See verbose logging for the details.

Developing the Provider

To add features to the provider, install Go and configure your your GOPATH

Compile the provider by running make build. The provider binary will output to your $GOPATH/bin directory, make sure this has been added to your $PATH.

$ make build

To test the provider run make testacc.

$ make testacc

Note: The tests run against live OCI service APIs, you will need to configure environment variables with valid credientials as shown in the documentation.

Contributing

This project welcomes contributions from the community. Before submitting a pull request, please review our contribution guide

Security

Please consult the security guide for our responsible security vulnerability disclosure process

License

Copyright (c) 2017, 2024 Oracle and/or its affiliates.

Released under the Mozilla Public License 2.0