Microsoft.ContainerInstance containerGroups 2018-02-01-preview
Artículo 05/11/2023
1 colaborador
Comentarios
En este artículo
Definición de recursos de Bicep
El tipo de recurso containerGroups se puede implementar con operaciones destinadas a:
Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios .
Para crear un recurso Microsoft.ContainerInstance/containerGroups, agregue el siguiente bicep a la plantilla.
resource symbolicname 'Microsoft.ContainerInstance/containerGroups@2018-02-01-preview' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
properties: {
containers: [
{
name: 'string'
properties: {
command: [
'string'
]
environmentVariables: [
{
name: 'string'
value: 'string'
}
]
image: 'string'
ports: [
{
port: int
protocol: 'string'
}
]
resources: {
limits: {
cpu: int
memoryInGB: json('decimal-as-string')
}
requests: {
cpu: int
memoryInGB: json('decimal-as-string')
}
}
volumeMounts: [
{
mountPath: 'string'
name: 'string'
readOnly: bool
}
]
}
}
]
imageRegistryCredentials: [
{
password: 'string'
server: 'string'
username: 'string'
}
]
ipAddress: {
dnsNameLabel: 'string'
ip: 'string'
ports: [
{
port: int
protocol: 'string'
}
]
type: 'Public'
}
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: {}
}
]
}
}
Valores de propiedad
containerGroups
Nombre
Descripción
Value
name
El nombre del recurso
string (obligatorio) Límite de caracteres: 1-63 Caracteres válidos: Letras minúsculas, números y guiones. No puede comenzar ni terminar con un guion. No se permiten guiones consecutivos.
ubicación
Ubicación del recurso.
string
etiquetas
Etiquetas del recurso.
Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
properties
ContainerGroupProperties (obligatorio)
ContainerGroupProperties
Nombre
Descripción
Value
containers
Contenedores del grupo de contenedores.
Container [] (obligatorio)
imageRegistryCredentials
Credenciales del registro de imágenes por las que se crea el grupo de contenedores.
ImageRegistryCredential []
ipAddress
Tipo de dirección IP del grupo de contenedores.
IpAddress
osType
Tipo de sistema operativo requerido por los contenedores del grupo de contenedores.
"Linux" 'Windows' (obligatorio)
restartPolicy
Directiva de reinicio para todos los contenedores del grupo de contenedores. - Always
Reiniciar siempre - OnFailure
Reinicio en caso de error - Never
No reiniciar nunca
"Siempre" 'Nunca' "OnFailure"
volumes
Lista de volúmenes que pueden montar los contenedores de este grupo de contenedores.
Volumen []
Contenedor
Nombre
Descripción
Value
name
Nombre proporcionado por el usuario de la instancia de contenedor.
string (obligatorio)
properties
Propiedades de la instancia de contenedor.
ContainerProperties (obligatorio)
ContainerProperties
Nombre
Descripción
Value
command
Comandos para ejecutar dentro de la instancia de contenedor en el formato de ejecución.
string[]
environmentVariables
Variables de entorno para establecer en la instancia de contenedor.
EnvironmentVariable []
imagen
Nombre de la imagen utilizada para crear la instancia de contenedor.
string (obligatorio)
ports
Puertos expuestos en la instancia de contenedor.
ContainerPort []
resources
Requisitos de los recursos de la instancia de contenedor.
ResourceRequirements (obligatorio)
volumeMounts
Montajes de volumen disponibles para la instancia de contenedor.
VolumeMount []
EnvironmentVariable
Nombre
Descripción
Value
name
Nombre de la variable de entorno.
string (obligatorio)
value
Valor de la variable de entorno.
string (obligatorio)
ContainerPort
Nombre
Descripción
Valor
port
Número de puerto expuesto en el grupo de contenedores.
int (obligatorio)
protocol
Protocolo asociado al puerto.
'TCP' 'UDP'
ResourceRequirements
Nombre
Descripción
Valor
límites
Límites de los recursos de la instancia de contenedor.
ResourceLimits
Solicitudes
Solicitudes de los recursos de la instancia de contenedor.
ResourceRequests (obligatorio)
ResourceLimits
Nombre
Descripción
Valor
cpu
Límite de CPU de esta instancia de contenedor.
int
memoryInGB
Límite de memoria en GB de esta instancia de contenedor. Para especificar un valor decimal, use la función json().
int o json decimal
ResourceRequests
Nombre
Descripción
Valor
cpu
Solicitud de CPU de esta instancia de contenedor.
int (obligatorio)
memoryInGB
Solicitud de memoria en GB de esta instancia de contenedor. Para especificar un valor decimal, use la función json().
int o json decimal (obligatorio)
VolumeMount
Nombre
Descripción
Valor
mountPath
La ruta de acceso dentro del contenedor en la que se debe montar el volumen. No debe contener dos puntos (:).
string (obligatorio)
name
Nombre del montaje de volumen.
string (obligatorio)
readOnly
Marca que indica si el montaje del volumen es de solo lectura.
bool
ImageRegistryCredential
Nombre
Descripción
Valor
password
Contraseña del registro privado.
string
server
Servidor de registro de imagen de Docker sin un protocolo como "http" y "https".
string (obligatorio)
username
Nombre de usuario del registro privado.
string (obligatorio)
IpAddress
Nombre
Descripción
Valor
dnsNameLabel
Etiqueta del nombre DNS para la IP.
string
ip
Dirección IP expuesta a la red pública de Internet.
string
ports
Lista de puertos expuestos en el grupo de contenedores.
Port [] (obligatorio)
tipo
Especifica si la dirección IP se expone a la red pública de Internet.
'Public' (obligatorio)
Port
Nombre
Descripción
Valor
port
Número del puerto.
int (obligatorio)
protocol
Protocolo asociado al puerto.
'TCP' 'UDP'
Volumen
Nombre
Descripción
Valor
azureFile
Volumen de archivos de Azure.
AzureFileVolume
emptyDir
Volumen de directorio vacío.
Para Bicep, puede usar la función any().
gitRepo
Volumen de repositorio GIT.
GitRepoVolume
name
El nombre del objeto visual.
string (obligatorio)
secret
Volumen secreto.
object
AzureFileVolume
Nombre
Descripción
Valor
readOnly
Marca que indica si el recurso compartido de archivos de Azure montado como un 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
Clave de acceso de la cuenta de almacenamiento utilizada para acceder al recurso compartido de archivos de Azure.
string
storageAccountName
Nombre de la cuenta de almacenamiento que contiene el recurso compartido de archivos de Azure.
string (obligatorio)
GitRepoVolume
Nombre
Descripción
Value
directory
Nombre del directorio de destino. No debe contener ".." ni empezar así. Si se proporciona ".", el directorio de volumen será el repositorio de GIT. De lo contrario, si se especifica, el volumen contendrá el repositorio de GIT en el subdirectorio con el nombre especificado.
string
repository
Dirección URL del repositorio
string (obligatorio)
revision
Hash de confirmación para la revisión especificada.
string
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
Definición de recursos de plantilla de ARM
El tipo de recurso containerGroups se puede implementar con operaciones destinadas a:
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios .
Para crear un recurso Microsoft.ContainerInstance/containerGroups, agregue el siguiente JSON a la plantilla.
{
"type": "Microsoft.ContainerInstance/containerGroups",
"apiVersion": "2018-02-01-preview",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"properties": {
"containers": [
{
"name": "string",
"properties": {
"command": [ "string" ],
"environmentVariables": [
{
"name": "string",
"value": "string"
}
],
"image": "string",
"ports": [
{
"port": "int",
"protocol": "string"
}
],
"resources": {
"limits": {
"cpu": "int",
"memoryInGB": "[json('decimal-as-string')]"
},
"requests": {
"cpu": "int",
"memoryInGB": "[json('decimal-as-string')]"
}
},
"volumeMounts": [
{
"mountPath": "string",
"name": "string",
"readOnly": "bool"
}
]
}
}
],
"imageRegistryCredentials": [
{
"password": "string",
"server": "string",
"username": "string"
}
],
"ipAddress": {
"dnsNameLabel": "string",
"ip": "string",
"ports": [
{
"port": "int",
"protocol": "string"
}
],
"type": "Public"
},
"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": {}
}
]
}
}
Valores de propiedad
containerGroups
Nombre
Descripción
Value
type
Tipo de recurso
'Microsoft.ContainerInstance/containerGroups'
apiVersion
La versión de la API de recursos
"2018-02-01-preview"
name
El nombre del recurso
string (obligatorio) Límite de caracteres: 1-63 Caracteres válidos: Letras minúsculas, números y guiones. No puede comenzar ni terminar con un guion. No se permiten guiones consecutivos.
ubicación
Ubicación del recurso.
string
etiquetas
Etiquetas del recurso.
Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
properties
ContainerGroupProperties (obligatorio)
ContainerGroupProperties
Nombre
Descripción
Value
containers
Contenedores del grupo de contenedores.
Container [] (obligatorio)
imageRegistryCredentials
Credenciales del registro de imágenes por las que se crea el grupo de contenedores.
ImageRegistryCredential []
ipAddress
Tipo de dirección IP del grupo de contenedores.
IpAddress
osType
Tipo de sistema operativo requerido por los contenedores del grupo de contenedores.
'Linux' 'Windows' (obligatorio)
restartPolicy
Directiva de reinicio para todos los contenedores del grupo de contenedores. - Always
Reiniciar siempre - OnFailure
Reinicio en caso de error - Never
No reiniciar nunca
"Siempre" 'Nunca' 'OnFailure'
volumes
Lista de volúmenes que pueden montar los contenedores de este grupo de contenedores.
Volumen []
Contenedor
Nombre
Descripción
Value
name
Nombre proporcionado por el usuario de la instancia de contenedor.
string (obligatorio)
properties
Propiedades de la instancia de contenedor.
ContainerProperties (obligatorio)
ContainerProperties
Nombre
Descripción
Value
command
Comandos para ejecutar dentro de la instancia de contenedor en el formato de ejecución.
string[]
environmentVariables
Variables de entorno para establecer en la instancia de contenedor.
EnvironmentVariable []
imagen
Nombre de la imagen utilizada para crear la instancia de contenedor.
string (obligatorio)
ports
Puertos expuestos en la instancia de contenedor.
ContainerPort []
resources
Requisitos de los recursos de la instancia de contenedor.
ResourceRequirements (obligatorio)
volumeMounts
Montajes de volumen disponibles para la instancia de contenedor.
VolumeMount []
EnvironmentVariable
Nombre
Descripción
Value
name
Nombre de la variable de entorno.
string (obligatorio)
value
Valor de la variable de entorno.
string (obligatorio)
ContainerPort
Nombre
Descripción
Valor
port
Número de puerto expuesto en el grupo de contenedores.
int (obligatorio)
protocol
Protocolo asociado al puerto.
'TCP' 'UDP'
ResourceRequirements
Nombre
Descripción
Valor
límites
Límites de los recursos de la instancia de contenedor.
ResourceLimits
Solicitudes
Solicitudes de los recursos de la instancia de contenedor.
ResourceRequests (obligatorio)
ResourceLimits
Nombre
Descripción
Valor
cpu
Límite de CPU de esta instancia de contenedor.
int
memoryInGB
Límite de memoria en GB de esta instancia de contenedor. Para especificar un valor decimal, use la función json().
int o json decimal
ResourceRequests
Nombre
Descripción
Valor
cpu
Solicitud de CPU de esta instancia de contenedor.
int (obligatorio)
memoryInGB
Solicitud de memoria en GB de esta instancia de contenedor. Para especificar un valor decimal, use la función json().
int o json decimal (obligatorio)
VolumeMount
Nombre
Descripción
Valor
mountPath
La ruta de acceso dentro del contenedor en la que se debe montar el volumen. No debe contener dos puntos (:).
string (obligatorio)
name
Nombre del montaje de volumen.
string (obligatorio)
readOnly
Marca que indica si el montaje del volumen es de solo lectura.
bool
ImageRegistryCredential
Nombre
Descripción
Valor
password
Contraseña del registro privado.
string
server
Servidor de registro de imagen de Docker sin un protocolo como "http" y "https".
string (obligatorio)
username
Nombre de usuario del registro privado.
string (obligatorio)
IpAddress
Nombre
Descripción
Valor
dnsNameLabel
Etiqueta del nombre DNS para la IP.
string
ip
Dirección IP expuesta a la red pública de Internet.
string
ports
Lista de puertos expuestos en el grupo de contenedores.
Port [] (obligatorio)
tipo
Especifica si la dirección IP se expone a la red pública de Internet.
'Public' (obligatorio)
Port
Nombre
Descripción
Valor
port
Número del puerto.
int (obligatorio)
protocol
Protocolo asociado al puerto.
'TCP' 'UDP'
Volumen
Nombre
Descripción
Valor
azureFile
Volumen de archivos de Azure.
AzureFileVolume
emptyDir
Volumen de directorio vacío.
gitRepo
Volumen de repositorio GIT.
GitRepoVolume
name
El nombre del objeto visual.
string (obligatorio)
secret
Volumen secreto.
object
AzureFileVolume
Nombre
Descripción
Valor
readOnly
Marca que indica si el recurso compartido de archivos de Azure montado como un 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
Clave de acceso de la cuenta de almacenamiento utilizada para acceder al recurso compartido de archivos de Azure.
string
storageAccountName
Nombre de la cuenta de almacenamiento que contiene el recurso compartido de archivos de Azure.
string (obligatorio)
GitRepoVolume
Nombre
Descripción
Value
directory
Nombre del directorio de destino. No debe contener ".." ni empezar así. Si se proporciona ".", el directorio de volumen será el repositorio de GIT. De lo contrario, si se especifica, el volumen contendrá el repositorio de GIT en el subdirectorio con el nombre especificado.
string
repository
Dirección URL del repositorio
string (obligatorio)
revision
Hash de confirmación para la revisión especificada.
string
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
El tipo de recurso containerGroups se puede implementar con operaciones destinadas a:
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios .
Para crear un recurso Microsoft.ContainerInstance/containerGroups, agregue el siguiente terraform a la plantilla.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ContainerInstance/containerGroups@2018-02-01-preview"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
containers = [
{
name = "string"
properties = {
command = [
"string"
]
environmentVariables = [
{
name = "string"
value = "string"
}
]
image = "string"
ports = [
{
port = int
protocol = "string"
}
]
resources = {
limits = {
cpu = int
memoryInGB = "decimal-as-string"
}
requests = {
cpu = int
memoryInGB = "decimal-as-string"
}
}
volumeMounts = [
{
mountPath = "string"
name = "string"
readOnly = bool
}
]
}
}
]
imageRegistryCredentials = [
{
password = "string"
server = "string"
username = "string"
}
]
ipAddress = {
dnsNameLabel = "string"
ip = "string"
ports = [
{
port = int
protocol = "string"
}
]
type = "Public"
}
osType = "string"
restartPolicy = "string"
volumes = [
{
azureFile = {
readOnly = bool
shareName = "string"
storageAccountKey = "string"
storageAccountName = "string"
}
gitRepo = {
directory = "string"
repository = "string"
revision = "string"
}
name = "string"
secret = {}
}
]
}
})
}
Valores de propiedad
containerGroups
Nombre
Descripción
Value
type
Tipo de recurso
"Microsoft.ContainerInstance/containerGroups@2018-02-01-preview"
name
El nombre del recurso
string (obligatorio) Límite de caracteres: 1-63 Caracteres válidos: Letras minúsculas, números y guiones. No puede comenzar ni terminar con un guion. No se permiten guiones consecutivos.
ubicación
Ubicación del recurso.
string
parent_id
Para realizar la implementación en un grupo de recursos, use el identificador de ese grupo de recursos.
string (obligatorio)
etiquetas
Etiquetas del recurso.
Diccionario de nombres y valores de etiqueta.
properties
ContainerGroupProperties (obligatorio)
ContainerGroupProperties
Nombre
Descripción
Value
containers
Contenedores del grupo de contenedores.
Container [] (obligatorio)
imageRegistryCredentials
Credenciales del registro de imágenes por las que se crea el grupo de contenedores.
ImageRegistryCredential []
ipAddress
Tipo de dirección IP del grupo de contenedores.
IpAddress
osType
Tipo de sistema operativo requerido por los contenedores del grupo de contenedores.
"Linux" "Windows" (obligatorio)
restartPolicy
Directiva de reinicio para todos los contenedores del grupo de contenedores. - Always
Reiniciar siempre - OnFailure
Reinicio en caso de error - Never
No reiniciar nunca
"Siempre" "Nunca" "OnFailure"
volumes
Lista de volúmenes que pueden montar los contenedores de este grupo de contenedores.
Volumen []
Contenedor
Nombre
Descripción
Value
name
Nombre proporcionado por el usuario de la instancia de contenedor.
string (obligatorio)
properties
Propiedades de la instancia de contenedor.
ContainerProperties (obligatorio)
ContainerProperties
Nombre
Descripción
Value
command
Comandos para ejecutar dentro de la instancia de contenedor en el formato de ejecución.
string[]
environmentVariables
Variables de entorno para establecer en la instancia de contenedor.
EnvironmentVariable []
imagen
Nombre de la imagen utilizada para crear la instancia de contenedor.
string (obligatorio)
ports
Puertos expuestos en la instancia de contenedor.
ContainerPort []
resources
Requisitos de los recursos de la instancia de contenedor.
ResourceRequirements (obligatorio)
volumeMounts
Montajes de volumen disponibles para la instancia de contenedor.
VolumeMount []
EnvironmentVariable
Nombre
Descripción
Value
name
Nombre de la variable de entorno.
string (obligatorio)
value
Valor de la variable de entorno.
string (obligatorio)
ContainerPort
Nombre
Descripción
Valor
port
Número de puerto expuesto en el grupo de contenedores.
int (obligatorio)
protocol
Protocolo asociado al puerto.
"TCP" "UDP"
ResourceRequirements
Nombre
Descripción
Valor
límites
Límites de los recursos de la instancia de contenedor.
ResourceLimits
Solicitudes
Solicitudes de los recursos de la instancia de contenedor.
ResourceRequests (obligatorio)
ResourceLimits
Nombre
Descripción
Valor
cpu
Límite de CPU de esta instancia de contenedor.
int
memoryInGB
Límite de memoria en GB de esta instancia de contenedor. Especifique un valor decimal como una cadena.
int o json decimal
ResourceRequests
Nombre
Descripción
Valor
cpu
Solicitud de CPU de esta instancia de contenedor.
int (obligatorio)
memoryInGB
Solicitud de memoria en GB de esta instancia de contenedor. Especifique un valor decimal como una cadena.
int o json decimal (obligatorio)
VolumeMount
Nombre
Descripción
Valor
mountPath
La ruta de acceso dentro del contenedor en la que se debe montar el volumen. No debe contener dos puntos (:).
string (obligatorio)
name
Nombre del montaje de volumen.
string (obligatorio)
readOnly
Marca que indica si el montaje del volumen es de solo lectura.
bool
ImageRegistryCredential
Nombre
Descripción
Valor
password
Contraseña del registro privado.
string
server
Servidor de registro de imagen de Docker sin un protocolo como "http" y "https".
string (obligatorio)
username
Nombre de usuario del registro privado.
string (obligatorio)
IpAddress
Nombre
Descripción
Valor
dnsNameLabel
Etiqueta del nombre DNS para la IP.
string
ip
Dirección IP expuesta a la red pública de Internet.
string
ports
Lista de puertos expuestos en el grupo de contenedores.
Port [] (obligatorio)
tipo
Especifica si la dirección IP se expone a la red pública de Internet.
"Público" (obligatorio)
Port
Nombre
Descripción
Valor
port
Número del puerto.
int (obligatorio)
protocol
Protocolo asociado al puerto.
"TCP" "UDP"
Volumen
Nombre
Descripción
Valor
azureFile
Volumen de archivos de Azure.
AzureFileVolume
emptyDir
Volumen de directorio vacío.
gitRepo
Volumen de repositorio GIT.
GitRepoVolume
name
El nombre del objeto visual.
string (obligatorio)
secret
Volumen secreto.
object
AzureFileVolume
Nombre
Descripción
Valor
readOnly
Marca que indica si el recurso compartido de archivos de Azure montado como un 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
Clave de acceso de la cuenta de almacenamiento utilizada para acceder al recurso compartido de archivos de Azure.
string
storageAccountName
Nombre de la cuenta de almacenamiento que contiene el recurso compartido de archivos de Azure.
string (obligatorio)
GitRepoVolume
Nombre
Descripción
Value
directory
Nombre del directorio de destino. No debe contener ".." ni empezar así. Si se proporciona ".", el directorio de volumen será el repositorio de GIT. De lo contrario, si se especifica, el volumen contendrá el repositorio de GIT en el subdirectorio con el nombre especificado.
string
repository
Dirección URL del repositorio
string (obligatorio)
revision
Hash de confirmación para la revisión especificada.
string