Microsoft.ContainerInstance containerGroups 2017-12-01-preview
Artículo 12/21/2024
2 colaboradores
Comentarios
En este artículo
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 .
Para crear un recurso Microsoft.ContainerInstance/containerGroups, agregue el siguiente bicep a la plantilla.
resource symbolicname 'Microsoft.ContainerInstance/containerGroups@2017-12-01-preview' = {
location: 'string'
name: 'string'
properties: {
containers: [
{
name: 'string'
properties: {
command: [
'string'
]
environmentVariables: [
{
name: 'string'
value: 'string'
}
]
image: 'string'
ports: [
{
port: int
protocol: 'string'
}
]
resources: {
limits: {
cpu: int
memoryInGB: int
}
requests: {
cpu: int
memoryInGB: int
}
}
volumeMounts: [
{
mountPath: 'string'
name: 'string'
readOnly: bool
}
]
}
}
]
imageRegistryCredentials: [
{
password: 'string'
server: 'string'
username: 'string'
}
]
ipAddress: {
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(Azure.Bicep.Types.Concrete.AnyType)
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)
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)
ContainerGroupProperties
Nombre
Descripción
Valor
recipientes
Contenedores dentro del grupo de contenedores.
container [] (obligatorio)
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
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 []
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'
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)
Puertos
Puertos expuestos en la instancia de contenedor.
ContainerPort []
Recursos
Requisitos de recursos de la instancia de contenedor.
resourceRequirements (obligatorio)
volumeMounts
El volumen monta los montajes disponibles para la instancia de contenedor.
VolumeMount []
EnvironmentVariable
Nombre
Descripción
Valor
nombre
Nombre de la variable de entorno.
string (obligatorio)
valor
Valor de la variable de entorno.
string (obligatorio)
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
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
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 pública de Internet.
'Public' (obligatorio)
Microsoft.ContainerInstance/containerGroups
Nombre
Descripción
Valor
ubicación
Ubicación del recurso.
string (obligatorio)
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
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)
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)
SecretVolume
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 inicio rápido
En los ejemplos de inicio rápido siguientes se implementa 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 .
Para crear un recurso Microsoft.ContainerInstance/containerGroups, agregue el siguiente JSON a la plantilla.
{
"type": "Microsoft.ContainerInstance/containerGroups",
"apiVersion": "2017-12-01-preview",
"name": "string",
"location": "string",
"properties": {
"containers": [
{
"name": "string",
"properties": {
"command": [ "string" ],
"environmentVariables": [
{
"name": "string",
"value": "string"
}
],
"image": "string",
"ports": [
{
"port": "int",
"protocol": "string"
}
],
"resources": {
"limits": {
"cpu": "int",
"memoryInGB": "int"
},
"requests": {
"cpu": "int",
"memoryInGB": "int"
}
},
"volumeMounts": [
{
"mountPath": "string",
"name": "string",
"readOnly": "bool"
}
]
}
}
],
"imageRegistryCredentials": [
{
"password": "string",
"server": "string",
"username": "string"
}
],
"ipAddress": {
"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
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)
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)
ContainerGroupProperties
Nombre
Descripción
Valor
recipientes
Contenedores dentro del grupo de contenedores.
container [] (obligatorio)
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
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 []
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'
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)
Puertos
Puertos expuestos en la instancia de contenedor.
ContainerPort []
Recursos
Requisitos de recursos de la instancia de contenedor.
resourceRequirements (obligatorio)
volumeMounts
El volumen monta los montajes disponibles para la instancia de contenedor.
VolumeMount []
EnvironmentVariable
Nombre
Descripción
Valor
nombre
Nombre de la variable de entorno.
string (obligatorio)
valor
Valor de la variable de entorno.
string (obligatorio)
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
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
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 pública de Internet.
'Public' (obligatorio)
Microsoft.ContainerInstance/containerGroups
Nombre
Descripción
Valor
apiVersion
La versión de api
'2017-12-01-preview'
ubicación
Ubicación del recurso.
string (obligatorio)
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
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)
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)
SecretVolume
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
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 que tienen como destino:
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@2017-12-01-preview"
name = "string"
location = "string"
tags = {
{customized property} = "string"
}
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 = int
}
requests = {
cpu = int
memoryInGB = int
}
}
volumeMounts = [
{
mountPath = "string"
name = "string"
readOnly = bool
}
]
}
}
]
imageRegistryCredentials = [
{
password = "string"
server = "string"
username = "string"
}
]
ipAddress = {
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
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)
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)
ContainerGroupProperties
Nombre
Descripción
Valor
recipientes
Contenedores dentro del grupo de contenedores.
container [] (obligatorio)
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
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 []
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'
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)
Puertos
Puertos expuestos en la instancia de contenedor.
ContainerPort []
Recursos
Requisitos de recursos de la instancia de contenedor.
resourceRequirements (obligatorio)
volumeMounts
El volumen monta los montajes disponibles para la instancia de contenedor.
VolumeMount []
EnvironmentVariable
Nombre
Descripción
Valor
nombre
Nombre de la variable de entorno.
string (obligatorio)
valor
Valor de la variable de entorno.
string (obligatorio)
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
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
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 pública de Internet.
'Public' (obligatorio)
Microsoft.ContainerInstance/containerGroups
Nombre
Descripción
Valor
ubicación
Ubicación del recurso.
string (obligatorio)
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@2017-12-01-preview"
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
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)
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)
SecretVolume
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