Complete OCI Free Tier Infrastructure Guide - Part 01: Setup & Local Provider Mirror

Phase 4: Offline / Local Provider Mirror Configuration

If your operational environment experiences limitations, such as restricted network access or air-gapped installations, setting up an offline Terraform provider mirror becomes essential. This phase guides you through creating a local copy of the OCI Terraform provider and configuring Terraform to utilize it.

4.1 Download OCI Terraform Provider Archive

Visit the Terraform Registry (https://registry.terraform.io/providers/Oracle/cloud) and navigate to the OCI Cloud Provider page. Download the latest OCI Terraform provider archive file (oci.x.x.x_<provider_version>.zip) to your local machine.

4.2 Extract Provider Files

Extract the downloaded ZIP archive to a dedicated directory on your local machine, e.g., /opt/local-terraform-providers/oci. This will create a subdirectory named oci containing the provider files.

4.3 Configure Terraform to Use Local Provider

Edit your Terraform configuration files or the global configuration block (e.g., terraform.tfvars or a dedicated .tf file) to include the local provider path. Add the following lines within the Terraform block:

provider "oracle" {

# Enable local provider usage

local = "/opt/local-terraform-providers/oci"

}

Replace /opt/local-terraform-providers/oci with the actual path to the oci directory you created earlier.

4.4 Verify Provider Availability

Run terraform init to initialize your Terraform working directory. The command should complete successfully, confirming that Terraform can access the local provider files.

4.5 Utilize Local Provider in Your Configurations

Proceed with defining your OCI infrastructure resources within your .tf files, as you would with any standard Terraform setup. The local provider will now be available for use.