Deploy a Container Instance in Azure

Prerequisites

• Install and configure Terraform
• Authenticate Terraform to Azure

Step 1: Clone GitHub Repository Template

We have the GitHub Repository template ready for you to clone and get started immediately here:

https://github.com/iron-software/IronSecureDoc-Terraform/

Step 2: Modify All Resource Names

image_registry_credential {
  server   = var.registry_server
  username = var.registry_username
  password = var.registry_password
}

variable "registry_server" {
  type        = string
  sensitive   = false
  description = "The server for the container registry. Required if the image is stored in a private registry."
}

variable "registry_username" {
  type        = string
  sensitive   = true
  description = "Username for the container registry. Required if the image is stored in a private registry."
}

variable "registry_password" {
  type        = string
  sensitive   = true
  description = "Password for the container registry. Required if the image is stored in a private registry."
}

registry_server   = "<registry-name>.azurecr.io"
registry_username = "YOUR-REGISTRY-USERNAME"
registry_password = "YOUR-REGISTRY-PASSWORD"
license_key       = "YOUR-LICENSE-KEY"

license_key = "YOUR-LICENSE-KEY"

Step 3: Initialize Terraform

Run terraform init to initialize the Terraform deployment. This command downloads the Azure provider required to manage your Azure resources.

terraform init -upgrade

terraform init -upgrade

Step 4: Create a Terraform Execution Plan

Run terraform plan to create an execution plan.

terraform plan -var-file="secret.tfvars" -out main.tfplan

terraform plan -var-file="secret.tfvars" -out main.tfplan

Step 5: Apply a Terraform Execution Plan

Run terraform apply to apply the execution plan to your cloud infrastructure.

terraform apply main.tfplan

terraform apply main.tfplan

Step 6: Verify the Results

1. When you apply the execution plan, Terraform outputs the public IP address. To display the IP address again, run terraform output.

   terraform output -raw container_ipv4_address

   terraform output -raw container_ipv4_address

   SHELL

   Or display the FQDN.

   terraform output -raw container_fqdn

   terraform output -raw container_fqdn

   SHELL

2. Use Postman or curl to validate. The expected result should return pong.

   curl http://<container_ipv4_address>:8080/v1/document-services/ping

   curl http://<container_ipv4_address>:8080/v1/document-services/ping

   SHELL

   Or use the FQDN.

   curl http://<container_fqdn>:8080/v1/document-services/ping

   curl http://<container_fqdn>:8080/v1/document-services/ping

   SHELL

Step 7: Destroy the Resource

• Create an execution plan for destroying the resource.

  terraform plan -destroy -var-file="secret.tfvars" -out main.tfplan

  terraform plan -destroy -var-file="secret.tfvars" -out main.tfplan

  SHELL

• Apply an execution destroy plan.

  terraform apply main.tfplan

  terraform apply main.tfplan

  SHELL