1. IronSecureDoc
  2. Tutorials
  3. Azure Host and Set Up

Deploy a container instance in Azure

Use Terraform on Azure to deploy IronSecureDoc Docker container and make its available with a public IP address and FQDN.

Prerequisites

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

Modify all resource name in variables.tf

  • resource_group_name: Name of the resource group.
  • resource_group_location: Location of the resource group. You can find the region from REGIONS.md use the second column to fill in this variable.
  • container_group_name: Name of the container group.
  • container_name: Name of the container.
  • image_tag: The tag of the image to deploy can be latest or any number.
  • Other variables does not required to change.

Create secret.tfvars to contains all sensitive data and fill below variables

Azure Container Registry

main.tf appends below after dns_name_label = var.dns_name_label:

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

variables.tf adds:

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."
  default     = "latest"
}

secret.tfvars adds:

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

Docker Hub

secret.tfvars adds:

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

Step 4: Create a Terraform execution plan

Run terraform plan to create an execution plan.

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

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

    or display the FQDN.

    terraform output -raw container_fqdn

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

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

    or use FQDN

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

Step 7: Destroy the resource

  • Create a execution plan for destroy resource
terraform plan -destroy -var-files="secret.tfvars" -out main.tfplan
  • Apply a execution destroy plan
terraform apply main.tfplan