Deploy a single instance in Oracle Cloud
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

5.1 KiB

Terraform — Deploy a single instance in Oracle Cloud

Deploy a single instance in Oracle Cloud running under the Always Free tier.

A custom Virtual Cloud Network (VCN) allows for more control over network security. The Terraform script below creates a custom VCN,

The following Ansible playbook covers basic setup for Ubuntu (e.g, swap, fail2ban),

You can get a free hostname for the instance using the Ansible playbook below,

Use a Njalla hostname for the instance using the Ansible playbook below,

Code Mirrors


Step 1: Create a file to store the Terraform input variables. Use india.tfvars.sample as a reference. Keep india.tfvars as the filename or change the name in the following files,

  1. .gitignore
  2. bin/

Step 2: Set ad to the desired Availability Domain. Oracle Cloud Infrastructure randomizes the availability domains by tenancy to help balance capacity in the data centres. To get the specific names of your account, use the ListAvailabilityDomains IAM API. You can also see the names when you use the Console to launch an instance and choose which availability domain to launch the instance in.

Step 3: Set compartment to the desired value. List of compartments in your Oracle Cloud account are at

compartment list screenshot

Step 4: Set vcn_id to the desired VCN ID. Set subnet_id to the desired Subnet ID.

Step 5: Choose a shape from the following two choices,

  • VM.Standard.A1.Flex— Ampere ARM A1
  • VM.Standard.E2.1.Micro — AMD EPYC 7551

Step 6: Choose an appropriate amount of cpu and memory based on the shape,

  • VM.Standard.A1.Flex— Set flex_ocpus between 1 and 4. Set flex_memory_in_gbs between 1 and 24.
  • VM.Standard.E2.1.Micro — Set flex_ocpus and flex_memory_in_gbs to 0. Terraform will use the default value of the shape.

Step 7: Choose an image_id from For VM.Standard.A1.Flex, use aarch64 images.


Oracle provider documentation is at

Oracle Cloud Shell can deploy this script without configuration.


Step 1: Use the following command to create a Terraform plan,

$ ./bin/

To avoid fetching the latest state of resources, use the following command,

$ ./bin/ -refresh=false

Step 2: Review the plan using the following command,

$ ./bin/

Step 3: Apply the plan using the following command,

$ ./bin/

Step 4: Use the following command to display the instance,

$ terraform show

terraform instance part 1 terraform instance part 2 terraform instance part 3


Encrypt sensitive files (Terraform input variables, SSH public key and state) before saving them. .gitignore must contain the unencrypted file paths.

Use the following command to decrypt the files after cloning the repository,

$ ./bin/

Use the following command after running bin/ to encrypt the updated state files,

$ ./bin/ <gpg key id>