Microsoft.ContainerInstance containerGroups 01/06/2018

Definición de recursos de Bicep

El tipo de recurso containerGroups se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.ContainerInstance/containerGroups, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.ContainerInstance/containerGroups@2018-06-01' = {
  scope: resourceSymbolicName or scope
  location: 'string'
  name: 'string'
  properties: {
    containers: [
      {
        name: 'string'
        properties: {
          command: [
            'string'
          ]
          environmentVariables: [
            {
              name: 'string'
              secureValue: 'string'
              value: 'string'
            }
          ]
          image: 'string'
          livenessProbe: {
            exec: {
              command: [
                'string'
              ]
            }
            failureThreshold: int
            httpGet: {
              path: 'string'
              port: int
              scheme: 'string'
            }
            initialDelaySeconds: int
            periodSeconds: int
            successThreshold: int
            timeoutSeconds: int
          }
          ports: [
            {
              port: int
              protocol: 'string'
            }
          ]
          readinessProbe: {
            exec: {
              command: [
                'string'
              ]
            }
            failureThreshold: int
            httpGet: {
              path: 'string'
              port: int
              scheme: 'string'
            }
            initialDelaySeconds: int
            periodSeconds: int
            successThreshold: int
            timeoutSeconds: int
          }
          resources: {
            limits: {
              cpu: int
              memoryInGB: int
            }
            requests: {
              cpu: int
              memoryInGB: int
            }
          }
          volumeMounts: [
            {
              mountPath: 'string'
              name: 'string'
              readOnly: bool
            }
          ]
        }
      }
    ]
    diagnostics: {
      logAnalytics: {
        workspaceId: 'string'
        workspaceKey: 'string'
      }
    }
    imageRegistryCredentials: [
      {
        password: 'string'
        server: 'string'
        username: 'string'
      }
    ]
    ipAddress: {
      dnsNameLabel: 'string'
      ip: 'string'
      ports: [
        {
          port: int
          protocol: 'string'
        }
      ]
      type: 'string'
    }
    osType: 'string'
    restartPolicy: 'string'
    volumes: [
      {
        azureFile: {
          readOnly: bool
          shareName: 'string'
          storageAccountKey: 'string'
          storageAccountName: 'string'
        }
        emptyDir: any(...)
        gitRepo: {
          directory: 'string'
          repository: 'string'
          revision: 'string'
        }
        name: 'string'
        secret: {
          {customized property}: 'string'
        }
      }
    ]
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propiedad

Microsoft.ContainerInstance/containerGroups

AzureFileVolume

Contenedor

ContainerExec

ContainerGroupDiagnostics

ContainerGroupProperties

ContenedorHttpGet

ContainerPort (Puerto de contenedor)

ContainerProbe

PropiedadesDelContenedor

EnvironmentVariable

GitRepoVolume

ImageRegistryCredential

Dirección IP

Análisis de registros

Puerto

Límites de recursos

ResourceRequests (Solicitudes de recursos)

ResourceRequirements (Requisitos de recursos)

ResourceTags (Etiquetas de recurso)

Volumen secreto

Volumen

VolumeMount

Ejemplos de uso

Módulos comprobados de Azure

Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.

Ejemplos de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure contienen ejemplos de Bicep para implementar este tipo de recurso.

Definición de recursos de plantilla de ARM

El tipo de recurso containerGroups se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.ContainerInstance/containerGroups, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.ContainerInstance/containerGroups",
  "apiVersion": "2018-06-01",
  "name": "string",
  "location": "string",
  "properties": {
    "containers": [
      {
        "name": "string",
        "properties": {
          "command": [ "string" ],
          "environmentVariables": [
            {
              "name": "string",
              "secureValue": "string",
              "value": "string"
            }
          ],
          "image": "string",
          "livenessProbe": {
            "exec": {
              "command": [ "string" ]
            },
            "failureThreshold": "int",
            "httpGet": {
              "path": "string",
              "port": "int",
              "scheme": "string"
            },
            "initialDelaySeconds": "int",
            "periodSeconds": "int",
            "successThreshold": "int",
            "timeoutSeconds": "int"
          },
          "ports": [
            {
              "port": "int",
              "protocol": "string"
            }
          ],
          "readinessProbe": {
            "exec": {
              "command": [ "string" ]
            },
            "failureThreshold": "int",
            "httpGet": {
              "path": "string",
              "port": "int",
              "scheme": "string"
            },
            "initialDelaySeconds": "int",
            "periodSeconds": "int",
            "successThreshold": "int",
            "timeoutSeconds": "int"
          },
          "resources": {
            "limits": {
              "cpu": "int",
              "memoryInGB": "int"
            },
            "requests": {
              "cpu": "int",
              "memoryInGB": "int"
            }
          },
          "volumeMounts": [
            {
              "mountPath": "string",
              "name": "string",
              "readOnly": "bool"
            }
          ]
        }
      }
    ],
    "diagnostics": {
      "logAnalytics": {
        "workspaceId": "string",
        "workspaceKey": "string"
      }
    },
    "imageRegistryCredentials": [
      {
        "password": "string",
        "server": "string",
        "username": "string"
      }
    ],
    "ipAddress": {
      "dnsNameLabel": "string",
      "ip": "string",
      "ports": [
        {
          "port": "int",
          "protocol": "string"
        }
      ],
      "type": "string"
    },
    "osType": "string",
    "restartPolicy": "string",
    "volumes": [
      {
        "azureFile": {
          "readOnly": "bool",
          "shareName": "string",
          "storageAccountKey": "string",
          "storageAccountName": "string"
        },
        "emptyDir": {},
        "gitRepo": {
          "directory": "string",
          "repository": "string",
          "revision": "string"
        },
        "name": "string",
        "secret": {
          "{customized property}": "string"
        }
      }
    ]
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propiedad

Microsoft.ContainerInstance/containerGroups

AzureFileVolume

Contenedor

ContainerExec

ContainerGroupDiagnostics

ContainerGroupProperties

ContenedorHttpGet

ContainerPort (Puerto de contenedor)

ContainerProbe

PropiedadesDelContenedor

EnvironmentVariable

GitRepoVolume

ImageRegistryCredential

Dirección IP

Análisis de registros

Puerto

Límites de recursos

ResourceRequests (Solicitudes de recursos)

ResourceRequirements (Requisitos de recursos)

ResourceTags (Etiquetas de recurso)

Volumen secreto

Volumen

VolumeMount

Ejemplos de uso

Plantillas de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.

Plantilla	Descripción
Azure Container Instances: BC con SQL Server e IIS	Implemente un único contenedor de Windows con un entorno de Microsoft Dynamics 365 Business Central totalmente destacado en Azure Container Instances.
Azure Container Instances: contenedor con de sondeo de estado	Implemente un contenedor de Linux que tenga un sondeo de estado mediante Azure Container Instances.
Azure Container Instances: contenedor con secretos	Implemente un contenedor de Linux que tenga un volumen secreto mediante Azure Container Instances.
Azure Container Instances: contenedor con envVar seguro	Implemente un contenedor de Linux que tenga una variable de entorno segura mediante Azure Container Instances.
Azure Container Instances: contenedor de Linux con emptyDir	Implemente dos contenedores de Linux que comparten un volumen emptyDir mediante Azure Container Instances.
Azure Container Instances: contenedor linux con gitRepo	Implemente un contenedor de Linux que use un volumen gitRepo mediante Azure Container Instances.
Azure Container Instances: contenedor de Linux con ip pública	Implemente un único contenedor de Linux accesible a través de una dirección IP pública mediante Azure Container Instances.
Azure Container Instances: de red virtual	Implemente una instancia de contenedor en una red virtual de Azure.
Crear un recurso compartido de archivos de cuenta de almacenamiento a través de contenedores	Esta plantilla crea una cuenta de almacenamiento y un recurso compartido de archivos a través de azure-cli en una instancia de contenedor.
Crear un sitio de WordPress	Esta plantilla crea un sitio de WordPress en Container Instance
Crear un sitio de WordPress en una red virtual	Esta plantilla crea un sitio de WordPress en Container Instance en una red virtual. Y genera un FQDN de sitio público que podría acceder al sitio de WordPress.
Crear un servidor SFTP a petición con de almacenamiento persistente	Esta plantilla muestra un servidor SFTP a petición mediante una instancia de Azure Container Instance (ACI).
crear Application Gateway con certificados	Esta plantilla muestra cómo generar certificados autofirmados de Key Vault y, a continuación, hacer referencia desde Application Gateway.
Front Door Standard/Premium con Azure Container Instances	Esta plantilla crea una instancia de Front Door Standard/Premium con un grupo de contenedores.
Front Door con instancias de contenedor y Application Gateway	Esta plantilla crea una instancia de Front Door Standard/Premium con un grupo de contenedores y Application Gateway.
servidor SFTP a petición mediante una cuenta de almacenamiento existente	Esta plantilla muestra un servidor SFTP a petición mediante una instancia de Azure Container Instance (ACI).
grupo de disponibilidad de SQL Server en AKS	Esto crea un nuevo clúster de AKS y, a continuación, implementa grupos de disponibilidad de SQL Server en él mediante un paquete CNAB implementado mediante Duffle y ACI.
contenedor UDP en ACI	Estas plantillas crean un recurso de ACI y exponen un contenedor a través de UDP.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso containerGroups se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.ContainerInstance/containerGroups, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerInstance/containerGroups@2018-06-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      containers = [
        {
          name = "string"
          properties = {
            command = [
              "string"
            ]
            environmentVariables = [
              {
                name = "string"
                secureValue = "string"
                value = "string"
              }
            ]
            image = "string"
            livenessProbe = {
              exec = {
                command = [
                  "string"
                ]
              }
              failureThreshold = int
              httpGet = {
                path = "string"
                port = int
                scheme = "string"
              }
              initialDelaySeconds = int
              periodSeconds = int
              successThreshold = int
              timeoutSeconds = int
            }
            ports = [
              {
                port = int
                protocol = "string"
              }
            ]
            readinessProbe = {
              exec = {
                command = [
                  "string"
                ]
              }
              failureThreshold = int
              httpGet = {
                path = "string"
                port = int
                scheme = "string"
              }
              initialDelaySeconds = int
              periodSeconds = int
              successThreshold = int
              timeoutSeconds = int
            }
            resources = {
              limits = {
                cpu = int
                memoryInGB = int
              }
              requests = {
                cpu = int
                memoryInGB = int
              }
            }
            volumeMounts = [
              {
                mountPath = "string"
                name = "string"
                readOnly = bool
              }
            ]
          }
        }
      ]
      diagnostics = {
        logAnalytics = {
          workspaceId = "string"
          workspaceKey = "string"
        }
      }
      imageRegistryCredentials = [
        {
          password = "string"
          server = "string"
          username = "string"
        }
      ]
      ipAddress = {
        dnsNameLabel = "string"
        ip = "string"
        ports = [
          {
            port = int
            protocol = "string"
          }
        ]
        type = "string"
      }
      osType = "string"
      restartPolicy = "string"
      volumes = [
        {
          azureFile = {
            readOnly = bool
            shareName = "string"
            storageAccountKey = "string"
            storageAccountName = "string"
          }
          emptyDir = ?
          gitRepo = {
            directory = "string"
            repository = "string"
            revision = "string"
          }
          name = "string"
          secret = {
            {customized property} = "string"
          }
        }
      ]
    }
  }
}

Valores de propiedad

Microsoft.ContainerInstance/containerGroups

AzureFileVolume

Contenedor

ContainerExec

ContainerGroupDiagnostics

ContainerGroupProperties

ContenedorHttpGet

ContainerPort (Puerto de contenedor)

ContainerProbe

PropiedadesDelContenedor

EnvironmentVariable

GitRepoVolume

ImageRegistryCredential

Dirección IP

Análisis de registros

Puerto

Límites de recursos

ResourceRequests (Solicitudes de recursos)

ResourceRequirements (Requisitos de recursos)

ResourceTags (Etiquetas de recurso)

Volumen secreto

Volumen

VolumeMount

Ejemplos de uso

Ejemplos de Terraform

Un ejemplo básico de implementación de una instancia de Azure Container Group.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "containerGroup" {
  type      = "Microsoft.ContainerInstance/containerGroups@2023-05-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      containers = [
        {
          name = "hw"
          properties = {
            command = [
            ]
            environmentVariables = [
            ]
            image = "ubuntu:20.04"
            ports = [
              {
                port     = 80
                protocol = "TCP"
              },
            ]
            resources = {
              requests = {
                cpu        = 0.5
                memoryInGB = 0.5
              }
            }
          }
        },
      ]
      initContainers = [
      ]
      ipAddress = {
        autoGeneratedDomainNameLabelScope = "Unsecure"
        ports = [
          {
            port     = 80
            protocol = "TCP"
          },
        ]
        type = "Public"
      }
      osType        = "Linux"
      restartPolicy = "Always"
      volumes = [
      ]
    }
    tags = {
      environment = "Testing"
    }
    zones = [
    ]
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Módulos comprobados de Azure

Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.