»Azure Container Instances

Builders

Azure Container Instances use Docker images for building, which are generated by these builders:

• Docker
• Cloud Native Buildpacks

azure-container-instance (platform)

Deploy a container to Azure Container Instances.

Interface

• Input: docker.Image
• Output: aci.Deployment

Examples

deploy {
  use "azure-container-instance" {
    resource_group = "resource-group-name"
    location       = "westus"
    ports          = [8080]

    capacity {
      memory = "1024"
      cpu_count = 4
    }

    volume {
      name = "vol1"
      path = "/consul"
      read_only = true

      git_repo {
        repository = "https://github.com/hashicorp/consul"
        revision = "v1.8.3"
      }
    }
  }
}

deploy {
  use "azure-container-instance" {
    resource_group = "resource-group-name"
    location       = "westus"
    ports          = [8080]

    capacity {
      memory = "1024"
      cpu_count = 4
    }

    volume {
      name = "vol1"
      path = "/consul"
      read_only = true

      git_repo {
        repository = "https://github.com/hashicorp/consul"
        revision = "v1.8.3"
      }
    }
  }
}

Required Parameters

These parameters are used in the use stanza for this plugin.

capacity (category)

The capacity details for the container.

capacity.cpu

Number of CPUs to allocate the container, min 1, max based on resource availability of the region.

capacity.cpu_count

• Type: int

capacity.memory

Memory to allocate the container specified in MB, min 1024, max based on resource availability of the region.

• Type: int

resource_group

The resource group to deploy the container to.

• Type: string

volume (category)

The volume details for a container.

volume.azure_file_share

The details for the Azure file share volume.

• Type: aci.AzureFileShareVolume

volume.git_repo

The details for GitHub repo to mount as a volume.

• Type: aci.GitRepoVolume

volume.name

The name of the volume to mount into the container.

• Type: string

volume.path

The path to mount the volume to in the container.

• Type: string

volume.read_only

Specify if the volume is read only.

• Type: bool

Optional Parameters

These parameters are used in the use stanza for this plugin.

location

The resource location to deploy the container instance to.

• Type: string
• Optional

managed_identity

The managed identity assigned to the container group.

• Type: string
• Optional

ports

The ports the container is listening on, the first port in this list will be used by the entrypoint binary to direct traffic to your application.

• Type: list of int
• Optional

static_environment

Environment variables to control broad modes of the application.

Environment variables that are meant to configure the application in a static way. This might be control an image that has multiple modes of operation, selected via environment variable. Most configuration should use the waypoint config commands.

• Type: map of string to string
• Optional

subscription_id

The Azure subscription id.

If not set uses the environment variable AZURE_SUBSCRIPTION_ID.

• Type: string
• Optional
• Environment Variable: AZURE_SUBSCRIPTION_ID

Output Attributes

Output attributes can be used in your waypoint.hcl as variables via artifact or deploy.

container_group

• Type: aci.Deployment_ContainerGroup

id

• Type: string

url

• Type: string