Microsoft.ContainerInstance/containerGroups 2018-10-01 - Bicep, ARM template & Terraform AzAPI reference

Definición de recursos de Bicep

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

grupos de recursos: consulte comandos de implementación de grupos de recursos

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-10-01' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  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
              gpu: {
                count: int
                sku: 'string'
              }
              memoryInGB: int
            }
            requests: {
              cpu: int
              gpu: {
                count: int
                sku: 'string'
              }
              memoryInGB: int
            }
          }
          volumeMounts: [
            {
              mountPath: 'string'
              name: 'string'
              readOnly: bool
            }
          ]
        }
      }
    ]
    diagnostics: {
      logAnalytics: {
        logType: 'string'
        metadata: {
          {customized property}: 'string'
        }
        workspaceId: 'string'
        workspaceKey: 'string'
      }
    }
    dnsConfig: {
      nameServers: [
        'string'
      ]
      options: 'string'
      searchDomains: 'string'
    }
    imageRegistryCredentials: [
      {
        password: 'string'
        server: 'string'
        username: 'string'
      }
    ]
    ipAddress: {
      dnsNameLabel: 'string'
      ip: 'string'
      ports: [
        {
          port: int
          protocol: 'string'
        }
      ]
      type: 'string'
    }
    networkProfile: {
      id: '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

AzureFileVolume

Nombre	Descripción	Valor
readOnly	Marca que indica si el recurso compartido de Azure File montado como volumen es de solo lectura.	Bool
shareName	Nombre del recurso compartido de archivos de Azure que se va a montar como un volumen.	string (obligatorio)
storageAccountKey	La clave de acceso de la cuenta de almacenamiento que se usa para acceder al recurso compartido de archivos de Azure.	cuerda
storageAccountName	Nombre de la cuenta de almacenamiento que contiene el recurso compartido de archivos de Azure.	string (obligatorio)

Components10Wh5UdSchemasContainergroupidentityPropertiesUserassignedidentitiesAdditionalproperties

Nombre	Descripción	Valor

Contenedor

Nombre	Descripción	Valor
nombre	Nombre proporcionado por el usuario de la instancia de contenedor.	string (obligatorio)
Propiedades	Propiedades de la instancia de contenedor.	ContainerProperties (obligatorio)

ContainerExec

Nombre	Descripción	Valor
mandar	Comandos que se van a ejecutar en el contenedor.	string[]

ContainerGroupDiagnostics

Nombre	Descripción	Valor
logAnalytics	Información de log analytics del grupo de contenedores.	LogAnalytics

ContainerGroupIdentity

Nombre	Descripción	Valor
tipo	Tipo de identidad que se usa para el grupo de contenedores. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará las identidades del grupo de contenedores.	'Ninguno' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
userAssignedIdentities	Lista de identidades de usuario asociadas al grupo de contenedores. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	containerGroupIdentityUserAssignedIdentities

ContainerGroupIdentityUserAssignedIdentities

Nombre	Descripción	Valor

ContainerGroupNetworkProfile

Nombre	Descripción	Valor
identificación	Identificador de un perfil de red.	string (obligatorio)

ContainerGroupProperties

Nombre	Descripción	Valor
recipientes	Contenedores dentro del grupo de contenedores.	container[] (obligatorio)
diagnósticos	Información de diagnóstico de un grupo de contenedores.	containerGroupDiagnostics
dnsConfig	Información de configuración de DNS para un grupo de contenedores.	DnsConfiguration
imageRegistryCredentials	Credenciales del Registro de imágenes a partir de las cuales se crea el grupo de contenedores.	ImageRegistryCredential[]
ipAddress	Tipo de dirección IP del grupo de contenedores.	IpAddress
networkProfile	La información del perfil de red de un grupo de contenedores.	containerGroupNetworkProfile
osType	Tipo de sistema operativo requerido por los contenedores del grupo de contenedores.	"Linux" 'Windows' (obligatorio)
restartPolicy	Reinicie la directiva para todos los contenedores del grupo de contenedores. - `Always` reiniciar siempre - `OnFailure` Reiniciar en caso de error - `Never` no reiniciar nunca	'Always' 'Nunca' 'OnFailure'
Volúmenes	Lista de volúmenes que pueden montar los contenedores de este grupo de contenedores.	volumen[]

ContainerHttpGet

Nombre	Descripción	Valor
camino	Ruta de acceso al sondeo.	cuerda
puerto	Número de puerto que se va a sondear.	int (obligatorio)
esquema	El esquema.	'http' 'https'

ContainerPort

Nombre	Descripción	Valor
puerto	Número de puerto expuesto en el grupo de contenedores.	int (obligatorio)
protocolo	Protocolo asociado al puerto.	'TCP' 'UDP'

ContainerProbe

Nombre	Descripción	Valor
Exec	Comando de ejecución que se va a sondear	ContainerExec
failureThreshold	Umbral de error.	Int
httpGet	Configuración de Http Get que se va a sondear	ContainerHttpGet
initialDelaySeconds	Segundos de retraso inicial.	Int
periodSeconds	Segundos de período.	Int
successThreshold	Umbral de éxito.	Int
timeoutSeconds	Los segundos de tiempo de espera.	Int

ContainerProperties

Nombre	Descripción	Valor
mandar	Los comandos que se van a ejecutar dentro de la instancia de contenedor en formato exec.	string[]
environmentVariables	Variables de entorno que se van a establecer en la instancia de contenedor.	EnvironmentVariable[]
imagen	Nombre de la imagen utilizada para crear la instancia del contenedor.	string (obligatorio)
livenessProbe	Sondeo de ejecución.	ContainerProbe
Puertos	Puertos expuestos en la instancia de contenedor.	ContainerPort[]
readinessProbe	Sondeo de preparación.	ContainerProbe
Recursos	Requisitos de recursos de la instancia de contenedor.	resourceRequirements (obligatorio)
volumeMounts	El volumen monta los montajes disponibles para la instancia de contenedor.	VolumeMount[]

DnsConfiguration

Nombre	Descripción	Valor
nameServers	Los servidores DNS para el grupo de contenedores.	string[] (obligatorio)
Opciones	Opciones de DNS para el grupo de contenedores.	cuerda
searchDomains	Dominios de búsqueda DNS para la búsqueda de nombres de host en el grupo de contenedores.	cuerda

EnvironmentVariable

Nombre	Descripción	Valor
nombre	Nombre de la variable de entorno.	string (obligatorio)
secureValue	Valor de la variable de entorno segura.	cuerda
valor	Valor de la variable de entorno.	cuerda

GitRepoVolume

Nombre	Descripción	Valor
directorio	Nombre del directorio de destino. No debe contener ni comenzar con '..'. Si se proporciona '.', el directorio de volúmenes será el repositorio git. De lo contrario, si se especifica, el volumen contendrá el repositorio git en el subdirectorio con el nombre especificado.	cuerda
depósito	Dirección URL del repositorio	string (obligatorio)
revisión	Hash de confirmación para la revisión especificada.	cuerda

GpuResource

Nombre	Descripción	Valor
contar	Recuento del recurso de GPU.	int (obligatorio)
Sku	SKU del recurso de GPU.	'K80' 'P100' 'V100' (obligatorio)

ImageRegistryCredential

Nombre	Descripción	Valor
contraseña	Contraseña del registro privado.	cuerda
servidor	El servidor del Registro de imágenes de Docker sin un protocolo como "http" y "https".	string (obligatorio)
nombre de usuario	Nombre de usuario del registro privado.	string (obligatorio)

IpAddress

Nombre	Descripción	Valor
dnsNameLabel	Etiqueta de nombre DNS para la dirección IP.	cuerda
IP	Dirección IP expuesta a la red pública de Internet.	cuerda
Puertos	Lista de puertos expuestos en el grupo de contenedores.	puerto[] (obligatorio)
tipo	Especifica si la dirección IP se expone a la red virtual pública de Internet o privada.	"Privado" 'Public' (obligatorio)

LogAnalytics

Nombre	Descripción	Valor
logType	Tipo de registro que se va a usar.	"ContainerInsights" 'ContainerInstanceLogs'
metadatos	Metadatos de Log Analytics.	LogAnalyticsMetadata
workspaceId	Identificador del área de trabajo para Log Analytics	string (obligatorio)
workspaceKey	La clave del área de trabajo para Log Analytics	string (obligatorio)

LogAnalyticsMetadata

Nombre	Descripción	Valor

Microsoft.ContainerInstance/containerGroups

Nombre	Descripción	Valor
identidad	Identidad del grupo de contenedores, si está configurada.	containerGroupIdentity
ubicación	Ubicación del recurso.	cuerda
nombre	El nombre del recurso	string (obligatorio)
Propiedades		containerGroupProperties (obligatorio)
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

Puerto

Nombre	Descripción	Valor
puerto	Número de puerto.	int (obligatorio)
protocolo	Protocolo asociado al puerto.	'TCP' 'UDP'

ResourceLimits

Nombre	Descripción	Valor
CPU	Límite de CPU de esta instancia de contenedor.	Int
Gpu	Límite de GPU de esta instancia de contenedor.	gpuResource de
memoryInGB	Límite de memoria en GB de esta instancia de contenedor.	Int

ResourceRequests

Nombre	Descripción	Valor
CPU	Solicitud de CPU de esta instancia de contenedor.	int (obligatorio)
Gpu	Solicitud de GPU de esta instancia de contenedor.	gpuResource de
memoryInGB	Solicitud de memoria en GB de esta instancia de contenedor.	int (obligatorio)

ResourceRequirements

Nombre	Descripción	Valor
Límites	Límites de recursos de esta instancia de contenedor.	ResourceLimits
Solicitudes	Solicitudes de recursos de esta instancia de contenedor.	resourceRequests (obligatorio)

ResourceTags

Nombre	Descripción	Valor

SecretVolume

Nombre	Descripción	Valor

Volumen

Nombre	Descripción	Valor
azureFile	El volumen de Azure File.	AzureFileVolume
emptyDir	Volumen de directorio vacío.	cualquier
gitRepo	El volumen del repositorio de Git.	gitRepoVolume
nombre	Nombre del volumen.	string (obligatorio)
secreto	Volumen secreto.	SecretVolume

VolumeMount

Nombre	Descripción	Valor
mountPath	Ruta de acceso dentro del contenedor donde se debe montar el volumen. No debe contener dos puntos (:).	string (obligatorio)
nombre	Nombre del montaje del volumen.	string (obligatorio)
readOnly	Marca que indica si el montaje del volumen es de solo lectura.	Bool

Ejemplos de uso

Módulos comprobados de Azure

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

Módulo	Descripción
Container Instance	Módulo de recursos de AVM para la instancia de contenedor

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.

Archivo de Bicep	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 secretos	Implemente un contenedor de Linux que tenga un volumen secreto 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 sitio de WordPress	Esta plantilla crea un sitio de WordPress en Container Instance
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.
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.

Definición de recursos de plantilla de ARM

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

grupos de recursos: consulte comandos de implementación de grupos de recursos

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-10-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "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",
              "gpu": {
                "count": "int",
                "sku": "string"
              },
              "memoryInGB": "int"
            },
            "requests": {
              "cpu": "int",
              "gpu": {
                "count": "int",
                "sku": "string"
              },
              "memoryInGB": "int"
            }
          },
          "volumeMounts": [
            {
              "mountPath": "string",
              "name": "string",
              "readOnly": "bool"
            }
          ]
        }
      }
    ],
    "diagnostics": {
      "logAnalytics": {
        "logType": "string",
        "metadata": {
          "{customized property}": "string"
        },
        "workspaceId": "string",
        "workspaceKey": "string"
      }
    },
    "dnsConfig": {
      "nameServers": [ "string" ],
      "options": "string",
      "searchDomains": "string"
    },
    "imageRegistryCredentials": [
      {
        "password": "string",
        "server": "string",
        "username": "string"
      }
    ],
    "ipAddress": {
      "dnsNameLabel": "string",
      "ip": "string",
      "ports": [
        {
          "port": "int",
          "protocol": "string"
        }
      ],
      "type": "string"
    },
    "networkProfile": {
      "id": "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

AzureFileVolume

Nombre	Descripción	Valor
readOnly	Marca que indica si el recurso compartido de Azure File montado como volumen es de solo lectura.	Bool
shareName	Nombre del recurso compartido de archivos de Azure que se va a montar como un volumen.	string (obligatorio)
storageAccountKey	La clave de acceso de la cuenta de almacenamiento que se usa para acceder al recurso compartido de archivos de Azure.	cuerda
storageAccountName	Nombre de la cuenta de almacenamiento que contiene el recurso compartido de archivos de Azure.	string (obligatorio)

Components10Wh5UdSchemasContainergroupidentityPropertiesUserassignedidentitiesAdditionalproperties

Nombre	Descripción	Valor

Contenedor

Nombre	Descripción	Valor
nombre	Nombre proporcionado por el usuario de la instancia de contenedor.	string (obligatorio)
Propiedades	Propiedades de la instancia de contenedor.	ContainerProperties (obligatorio)

ContainerExec

Nombre	Descripción	Valor
mandar	Comandos que se van a ejecutar en el contenedor.	string[]

ContainerGroupDiagnostics

Nombre	Descripción	Valor
logAnalytics	Información de log analytics del grupo de contenedores.	LogAnalytics

ContainerGroupIdentity

Nombre	Descripción	Valor
tipo	Tipo de identidad que se usa para el grupo de contenedores. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará las identidades del grupo de contenedores.	'Ninguno' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
userAssignedIdentities	Lista de identidades de usuario asociadas al grupo de contenedores. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	containerGroupIdentityUserAssignedIdentities

ContainerGroupIdentityUserAssignedIdentities

Nombre	Descripción	Valor

ContainerGroupNetworkProfile

Nombre	Descripción	Valor
identificación	Identificador de un perfil de red.	string (obligatorio)

ContainerGroupProperties

Nombre	Descripción	Valor
recipientes	Contenedores dentro del grupo de contenedores.	container[] (obligatorio)
diagnósticos	Información de diagnóstico de un grupo de contenedores.	containerGroupDiagnostics
dnsConfig	Información de configuración de DNS para un grupo de contenedores.	DnsConfiguration
imageRegistryCredentials	Credenciales del Registro de imágenes a partir de las cuales se crea el grupo de contenedores.	ImageRegistryCredential[]
ipAddress	Tipo de dirección IP del grupo de contenedores.	IpAddress
networkProfile	La información del perfil de red de un grupo de contenedores.	containerGroupNetworkProfile
osType	Tipo de sistema operativo requerido por los contenedores del grupo de contenedores.	"Linux" 'Windows' (obligatorio)
restartPolicy	Reinicie la directiva para todos los contenedores del grupo de contenedores. - `Always` reiniciar siempre - `OnFailure` Reiniciar en caso de error - `Never` no reiniciar nunca	'Always' 'Nunca' 'OnFailure'
Volúmenes	Lista de volúmenes que pueden montar los contenedores de este grupo de contenedores.	volumen[]

ContainerHttpGet

Nombre	Descripción	Valor
camino	Ruta de acceso al sondeo.	cuerda
puerto	Número de puerto que se va a sondear.	int (obligatorio)
esquema	El esquema.	'http' 'https'

ContainerPort

Nombre	Descripción	Valor
puerto	Número de puerto expuesto en el grupo de contenedores.	int (obligatorio)
protocolo	Protocolo asociado al puerto.	'TCP' 'UDP'

ContainerProbe

Nombre	Descripción	Valor
Exec	Comando de ejecución que se va a sondear	ContainerExec
failureThreshold	Umbral de error.	Int
httpGet	Configuración de Http Get que se va a sondear	ContainerHttpGet
initialDelaySeconds	Segundos de retraso inicial.	Int
periodSeconds	Segundos de período.	Int
successThreshold	Umbral de éxito.	Int
timeoutSeconds	Los segundos de tiempo de espera.	Int

ContainerProperties

Nombre	Descripción	Valor
mandar	Los comandos que se van a ejecutar dentro de la instancia de contenedor en formato exec.	string[]
environmentVariables	Variables de entorno que se van a establecer en la instancia de contenedor.	EnvironmentVariable[]
imagen	Nombre de la imagen utilizada para crear la instancia del contenedor.	string (obligatorio)
livenessProbe	Sondeo de ejecución.	ContainerProbe
Puertos	Puertos expuestos en la instancia de contenedor.	ContainerPort[]
readinessProbe	Sondeo de preparación.	ContainerProbe
Recursos	Requisitos de recursos de la instancia de contenedor.	resourceRequirements (obligatorio)
volumeMounts	El volumen monta los montajes disponibles para la instancia de contenedor.	VolumeMount[]

DnsConfiguration

Nombre	Descripción	Valor
nameServers	Los servidores DNS para el grupo de contenedores.	string[] (obligatorio)
Opciones	Opciones de DNS para el grupo de contenedores.	cuerda
searchDomains	Dominios de búsqueda DNS para la búsqueda de nombres de host en el grupo de contenedores.	cuerda

EnvironmentVariable

Nombre	Descripción	Valor
nombre	Nombre de la variable de entorno.	string (obligatorio)
secureValue	Valor de la variable de entorno segura.	cuerda
valor	Valor de la variable de entorno.	cuerda

GitRepoVolume

Nombre	Descripción	Valor
directorio	Nombre del directorio de destino. No debe contener ni comenzar con '..'. Si se proporciona '.', el directorio de volúmenes será el repositorio git. De lo contrario, si se especifica, el volumen contendrá el repositorio git en el subdirectorio con el nombre especificado.	cuerda
depósito	Dirección URL del repositorio	string (obligatorio)
revisión	Hash de confirmación para la revisión especificada.	cuerda

GpuResource

Nombre	Descripción	Valor
contar	Recuento del recurso de GPU.	int (obligatorio)
Sku	SKU del recurso de GPU.	'K80' 'P100' 'V100' (obligatorio)

ImageRegistryCredential

Nombre	Descripción	Valor
contraseña	Contraseña del registro privado.	cuerda
servidor	El servidor del Registro de imágenes de Docker sin un protocolo como "http" y "https".	string (obligatorio)
nombre de usuario	Nombre de usuario del registro privado.	string (obligatorio)

IpAddress

Nombre	Descripción	Valor
dnsNameLabel	Etiqueta de nombre DNS para la dirección IP.	cuerda
IP	Dirección IP expuesta a la red pública de Internet.	cuerda
Puertos	Lista de puertos expuestos en el grupo de contenedores.	puerto[] (obligatorio)
tipo	Especifica si la dirección IP se expone a la red virtual pública de Internet o privada.	"Privado" 'Public' (obligatorio)

LogAnalytics

Nombre	Descripción	Valor
logType	Tipo de registro que se va a usar.	"ContainerInsights" 'ContainerInstanceLogs'
metadatos	Metadatos de Log Analytics.	LogAnalyticsMetadata
workspaceId	Identificador del área de trabajo para Log Analytics	string (obligatorio)
workspaceKey	La clave del área de trabajo para Log Analytics	string (obligatorio)

LogAnalyticsMetadata

Nombre	Descripción	Valor

Microsoft.ContainerInstance/containerGroups

Nombre	Descripción	Valor
apiVersion	La versión de api	'2018-10-01'
identidad	Identidad del grupo de contenedores, si está configurada.	containerGroupIdentity
ubicación	Ubicación del recurso.	cuerda
nombre	El nombre del recurso	string (obligatorio)
Propiedades		containerGroupProperties (obligatorio)
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo	El tipo de recurso	'Microsoft.ContainerInstance/containerGroups'

Puerto

Nombre	Descripción	Valor
puerto	Número de puerto.	int (obligatorio)
protocolo	Protocolo asociado al puerto.	'TCP' 'UDP'

ResourceLimits

Nombre	Descripción	Valor
CPU	Límite de CPU de esta instancia de contenedor.	Int
Gpu	Límite de GPU de esta instancia de contenedor.	gpuResource de
memoryInGB	Límite de memoria en GB de esta instancia de contenedor.	Int

ResourceRequests

Nombre	Descripción	Valor
CPU	Solicitud de CPU de esta instancia de contenedor.	int (obligatorio)
Gpu	Solicitud de GPU de esta instancia de contenedor.	gpuResource de
memoryInGB	Solicitud de memoria en GB de esta instancia de contenedor.	int (obligatorio)

ResourceRequirements

Nombre	Descripción	Valor
Límites	Límites de recursos de esta instancia de contenedor.	ResourceLimits
Solicitudes	Solicitudes de recursos de esta instancia de contenedor.	resourceRequests (obligatorio)

ResourceTags

Nombre	Descripción	Valor

SecretVolume

Nombre	Descripción	Valor

Volumen

Nombre	Descripción	Valor
azureFile	El volumen de Azure File.	AzureFileVolume
emptyDir	Volumen de directorio vacío.	cualquier
gitRepo	El volumen del repositorio de Git.	gitRepoVolume
nombre	Nombre del volumen.	string (obligatorio)
secreto	Volumen secreto.	SecretVolume

VolumeMount

Nombre	Descripción	Valor
mountPath	Ruta de acceso dentro del contenedor donde se debe montar el volumen. No debe contener dos puntos (:).	string (obligatorio)
nombre	Nombre del montaje del volumen.	string (obligatorio)
readOnly	Marca que indica si el montaje del volumen es de solo lectura.	Bool

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:

grupos de recursos de

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-10-01"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  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
                gpu = {
                  count = int
                  sku = "string"
                }
                memoryInGB = int
              }
              requests = {
                cpu = int
                gpu = {
                  count = int
                  sku = "string"
                }
                memoryInGB = int
              }
            }
            volumeMounts = [
              {
                mountPath = "string"
                name = "string"
                readOnly = bool
              }
            ]
          }
        }
      ]
      diagnostics = {
        logAnalytics = {
          logType = "string"
          metadata = {
            {customized property} = "string"
          }
          workspaceId = "string"
          workspaceKey = "string"
        }
      }
      dnsConfig = {
        nameServers = [
          "string"
        ]
        options = "string"
        searchDomains = "string"
      }
      imageRegistryCredentials = [
        {
          password = "string"
          server = "string"
          username = "string"
        }
      ]
      ipAddress = {
        dnsNameLabel = "string"
        ip = "string"
        ports = [
          {
            port = int
            protocol = "string"
          }
        ]
        type = "string"
      }
      networkProfile = {
        id = "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

AzureFileVolume

Nombre	Descripción	Valor
readOnly	Marca que indica si el recurso compartido de Azure File montado como volumen es de solo lectura.	Bool
shareName	Nombre del recurso compartido de archivos de Azure que se va a montar como un volumen.	string (obligatorio)
storageAccountKey	La clave de acceso de la cuenta de almacenamiento que se usa para acceder al recurso compartido de archivos de Azure.	cuerda
storageAccountName	Nombre de la cuenta de almacenamiento que contiene el recurso compartido de archivos de Azure.	string (obligatorio)

Components10Wh5UdSchemasContainergroupidentityPropertiesUserassignedidentitiesAdditionalproperties

Nombre	Descripción	Valor

Contenedor

Nombre	Descripción	Valor
nombre	Nombre proporcionado por el usuario de la instancia de contenedor.	string (obligatorio)
Propiedades	Propiedades de la instancia de contenedor.	ContainerProperties (obligatorio)

ContainerExec

Nombre	Descripción	Valor
mandar	Comandos que se van a ejecutar en el contenedor.	string[]

ContainerGroupDiagnostics

Nombre	Descripción	Valor
logAnalytics	Información de log analytics del grupo de contenedores.	LogAnalytics

ContainerGroupIdentity

Nombre	Descripción	Valor
tipo	Tipo de identidad que se usa para el grupo de contenedores. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará las identidades del grupo de contenedores.	'Ninguno' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
userAssignedIdentities	Lista de identidades de usuario asociadas al grupo de contenedores. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	containerGroupIdentityUserAssignedIdentities

ContainerGroupIdentityUserAssignedIdentities

Nombre	Descripción	Valor

ContainerGroupNetworkProfile

Nombre	Descripción	Valor
identificación	Identificador de un perfil de red.	string (obligatorio)

ContainerGroupProperties

Nombre	Descripción	Valor
recipientes	Contenedores dentro del grupo de contenedores.	container[] (obligatorio)
diagnósticos	Información de diagnóstico de un grupo de contenedores.	containerGroupDiagnostics
dnsConfig	Información de configuración de DNS para un grupo de contenedores.	DnsConfiguration
imageRegistryCredentials	Credenciales del Registro de imágenes a partir de las cuales se crea el grupo de contenedores.	ImageRegistryCredential[]
ipAddress	Tipo de dirección IP del grupo de contenedores.	IpAddress
networkProfile	La información del perfil de red de un grupo de contenedores.	containerGroupNetworkProfile
osType	Tipo de sistema operativo requerido por los contenedores del grupo de contenedores.	"Linux" 'Windows' (obligatorio)
restartPolicy	Reinicie la directiva para todos los contenedores del grupo de contenedores. - `Always` reiniciar siempre - `OnFailure` Reiniciar en caso de error - `Never` no reiniciar nunca	'Always' 'Nunca' 'OnFailure'
Volúmenes	Lista de volúmenes que pueden montar los contenedores de este grupo de contenedores.	volumen[]

ContainerHttpGet

Nombre	Descripción	Valor
camino	Ruta de acceso al sondeo.	cuerda
puerto	Número de puerto que se va a sondear.	int (obligatorio)
esquema	El esquema.	'http' 'https'

ContainerPort

Nombre	Descripción	Valor
puerto	Número de puerto expuesto en el grupo de contenedores.	int (obligatorio)
protocolo	Protocolo asociado al puerto.	'TCP' 'UDP'

ContainerProbe

Nombre	Descripción	Valor
Exec	Comando de ejecución que se va a sondear	ContainerExec
failureThreshold	Umbral de error.	Int
httpGet	Configuración de Http Get que se va a sondear	ContainerHttpGet
initialDelaySeconds	Segundos de retraso inicial.	Int
periodSeconds	Segundos de período.	Int
successThreshold	Umbral de éxito.	Int
timeoutSeconds	Los segundos de tiempo de espera.	Int

ContainerProperties

Nombre	Descripción	Valor
mandar	Los comandos que se van a ejecutar dentro de la instancia de contenedor en formato exec.	string[]
environmentVariables	Variables de entorno que se van a establecer en la instancia de contenedor.	EnvironmentVariable[]
imagen	Nombre de la imagen utilizada para crear la instancia del contenedor.	string (obligatorio)
livenessProbe	Sondeo de ejecución.	ContainerProbe
Puertos	Puertos expuestos en la instancia de contenedor.	ContainerPort[]
readinessProbe	Sondeo de preparación.	ContainerProbe
Recursos	Requisitos de recursos de la instancia de contenedor.	resourceRequirements (obligatorio)
volumeMounts	El volumen monta los montajes disponibles para la instancia de contenedor.	VolumeMount[]

DnsConfiguration

Nombre	Descripción	Valor
nameServers	Los servidores DNS para el grupo de contenedores.	string[] (obligatorio)
Opciones	Opciones de DNS para el grupo de contenedores.	cuerda
searchDomains	Dominios de búsqueda DNS para la búsqueda de nombres de host en el grupo de contenedores.	cuerda

EnvironmentVariable

Nombre	Descripción	Valor
nombre	Nombre de la variable de entorno.	string (obligatorio)
secureValue	Valor de la variable de entorno segura.	cuerda
valor	Valor de la variable de entorno.	cuerda

GitRepoVolume

Nombre	Descripción	Valor
directorio	Nombre del directorio de destino. No debe contener ni comenzar con '..'. Si se proporciona '.', el directorio de volúmenes será el repositorio git. De lo contrario, si se especifica, el volumen contendrá el repositorio git en el subdirectorio con el nombre especificado.	cuerda
depósito	Dirección URL del repositorio	string (obligatorio)
revisión	Hash de confirmación para la revisión especificada.	cuerda

GpuResource

Nombre	Descripción	Valor
contar	Recuento del recurso de GPU.	int (obligatorio)
Sku	SKU del recurso de GPU.	'K80' 'P100' 'V100' (obligatorio)

ImageRegistryCredential

Nombre	Descripción	Valor
contraseña	Contraseña del registro privado.	cuerda
servidor	El servidor del Registro de imágenes de Docker sin un protocolo como "http" y "https".	string (obligatorio)
nombre de usuario	Nombre de usuario del registro privado.	string (obligatorio)

IpAddress

Nombre	Descripción	Valor
dnsNameLabel	Etiqueta de nombre DNS para la dirección IP.	cuerda
IP	Dirección IP expuesta a la red pública de Internet.	cuerda
Puertos	Lista de puertos expuestos en el grupo de contenedores.	puerto[] (obligatorio)
tipo	Especifica si la dirección IP se expone a la red virtual pública de Internet o privada.	"Privado" 'Public' (obligatorio)

LogAnalytics

Nombre	Descripción	Valor
logType	Tipo de registro que se va a usar.	"ContainerInsights" 'ContainerInstanceLogs'
metadatos	Metadatos de Log Analytics.	LogAnalyticsMetadata
workspaceId	Identificador del área de trabajo para Log Analytics	string (obligatorio)
workspaceKey	La clave del área de trabajo para Log Analytics	string (obligatorio)

LogAnalyticsMetadata

Nombre	Descripción	Valor

Microsoft.ContainerInstance/containerGroups

Nombre	Descripción	Valor
identidad	Identidad del grupo de contenedores, si está configurada.	containerGroupIdentity
ubicación	Ubicación del recurso.	cuerda
nombre	El nombre del recurso	string (obligatorio)
Propiedades		containerGroupProperties (obligatorio)
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta.
tipo	El tipo de recurso	"Microsoft.ContainerInstance/containerGroups@2018-10-01"

Puerto

Nombre	Descripción	Valor
puerto	Número de puerto.	int (obligatorio)
protocolo	Protocolo asociado al puerto.	'TCP' 'UDP'

ResourceLimits

Nombre	Descripción	Valor
CPU	Límite de CPU de esta instancia de contenedor.	Int
Gpu	Límite de GPU de esta instancia de contenedor.	gpuResource de
memoryInGB	Límite de memoria en GB de esta instancia de contenedor.	Int

ResourceRequests

Nombre	Descripción	Valor
CPU	Solicitud de CPU de esta instancia de contenedor.	int (obligatorio)
Gpu	Solicitud de GPU de esta instancia de contenedor.	gpuResource de
memoryInGB	Solicitud de memoria en GB de esta instancia de contenedor.	int (obligatorio)

ResourceRequirements

Nombre	Descripción	Valor
Límites	Límites de recursos de esta instancia de contenedor.	ResourceLimits
Solicitudes	Solicitudes de recursos de esta instancia de contenedor.	resourceRequests (obligatorio)

ResourceTags

Nombre	Descripción	Valor

SecretVolume

Nombre	Descripción	Valor

Volumen

Nombre	Descripción	Valor
azureFile	El volumen de Azure File.	AzureFileVolume
emptyDir	Volumen de directorio vacío.	cualquier
gitRepo	El volumen del repositorio de Git.	gitRepoVolume
nombre	Nombre del volumen.	string (obligatorio)
secreto	Volumen secreto.	SecretVolume

VolumeMount

Nombre	Descripción	Valor
mountPath	Ruta de acceso dentro del contenedor donde se debe montar el volumen. No debe contener dos puntos (:).	string (obligatorio)
nombre	Nombre del montaje del volumen.	string (obligatorio)
readOnly	Marca que indica si el montaje del volumen es de solo lectura.	Bool

Ejemplos de uso

Módulos comprobados de Azure

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

Módulo	Descripción
Container Instance	Módulo de recursos de AVM para la instancia de contenedor

Compartir a través de

Microsoft.ContainerInstance containerGroups 2018-10-01

Definición de recursos de Bicep

Formato de recurso

Valores de propiedad

AzureFileVolume

Components10Wh5UdSchemasContainergroupidentityPropertiesUserassignedidentitiesAdditionalproperties

Contenedor

ContainerExec

ContainerGroupDiagnostics

ContainerGroupIdentity

ContainerGroupIdentityUserAssignedIdentities

ContainerGroupNetworkProfile

ContainerGroupProperties

ContainerHttpGet

ContainerPort

ContainerProbe

ContainerProperties

DnsConfiguration

EnvironmentVariable

GitRepoVolume

GpuResource

ImageRegistryCredential

IpAddress

LogAnalytics

LogAnalyticsMetadata

Microsoft.ContainerInstance/containerGroups

Puerto

ResourceLimits

ResourceRequests

ResourceRequirements

ResourceTags

SecretVolume

Volumen

VolumeMount

Ejemplos de uso

Módulos comprobados de Azure

Ejemplos de inicio rápido de Azure

Definición de recursos de plantilla de ARM

Formato de recurso

Valores de propiedad

AzureFileVolume

Components10Wh5UdSchemasContainergroupidentityPropertiesUserassignedidentitiesAdditionalproperties

Contenedor

ContainerExec

ContainerGroupDiagnostics

ContainerGroupIdentity

ContainerGroupIdentityUserAssignedIdentities

ContainerGroupNetworkProfile

ContainerGroupProperties

ContainerHttpGet

ContainerPort

ContainerProbe

ContainerProperties

DnsConfiguration

EnvironmentVariable

GitRepoVolume

GpuResource

ImageRegistryCredential

IpAddress

LogAnalytics

LogAnalyticsMetadata

Microsoft.ContainerInstance/containerGroups

Puerto

ResourceLimits

ResourceRequests

ResourceRequirements

ResourceTags

SecretVolume

Volumen

VolumeMount

Ejemplos de uso

Plantillas de inicio rápido de Azure

Definición de recursos de Terraform (proveedor AzAPI)

Formato de recurso

Valores de propiedad

AzureFileVolume

Components10Wh5UdSchemasContainergroupidentityPropertiesUserassignedidentitiesAdditionalproperties

Contenedor

ContainerExec