Oracle Cloud Infrastructure Documentation

Referencing Images

Reference images using the Oracle Cloud Infrastructure Terraform provider.

When launching compute instances, your Terraform configuration should use the same image every time you run a Terraform apply job.

Note

To avoid referencing a different image in subsequent Terraform apply jobs, specify the region-specific image OCID in the Terraform configuration. Do not locate the image OCID using the oci_core_image data source. This data source calls into the ListImages API, whose return values can change over time because over time images are added and older ones deleted. For a list of Oracle-provided images and their OCIDs, see Oracle-Provided Images. For more information, see Results of oci_core_images will change over time for Oracle-provided images.

To find the latest region-specific OCIDs for an image:

  1. Go to Image Release Notes.

  2. For the image that you want, click Latest Image.

    An image OCID is listed for each region.

  3. Copy the region-specific image OCID that you want.

    For example, copy the image OCID for the us-phoenix-1 region.

We recommend the following pattern for specifying an image for given regions:

variable "image_id" {
  type = "map"
  default = {
    // See https://docs.oracle.com/iaas/images/
    // Oracle-provided image "Oracle-Linux-7.4-2018.02.21-1"
    us-phoenix-1 = "ocid1.image.oc1.phx..<unique_ID>"
    us-ashburn-1 = "ocid1.image.oc1.iad..<unique_ID>"
    eu-frankfurt-1 = "ocid1.image.oc1.eu-frankfurt-1..<unique_ID>"
    uk-london-1 = "ocid1.image.oc1.uk-london-1..<unique_ID>"
  }
}

Compute instance example of this pattern:

resource "oci_core_instance" "TFInstance" {
  image = "${var.image_id[var.region]}"
  ...
}