Importante
Os pools em espera para as Instâncias de Contêiner do Azure estão atualmente em versão prévia. As versões prévias são disponibilizadas com a condição de que você concorde com os termos de uso complementares. Alguns aspectos desse recurso podem alterar antes da GA (disponibilidade geral).
Este artigo explica como criar um perfil de grupo de contêineres e usar esse perfil para configurar um pool em espera para as Instâncias de Contêiner do Azure.
Pré-requisitos
Antes de utilizar pools de espera, conclua o registro do recurso e configure controles de acesso baseados em função. Para obter mais informações, consulte Configurar permissões de função para pools em espera nas Instâncias de Contêiner do Azure
Criar um perfil de grupo de contêineres
O perfil de grupo de contêineres informa ao pool em espera como configurar os contêineres no pool. Se você fizer alterações no perfil do grupo de contêineres, também precisará atualizar o pool em espera para garantir que as atualizações sejam aplicadas às instâncias no pool.
Observação
Para usar contêineres confidenciais atualize o tipo de sku para Confidential ao criar seu perfil de grupo de contêineres.
Criar um perfil de grupo de contêineres com as configurações do mapa de configuração usando az container container-group-profile create. Opcionalmente, você pode incluir detalhes do mapa de configuração no perfil do grupo de contêineres. Para obter mais informações sobre os mapas de configuração, confira Usar os mapas de configuração.
az container container-group-profile create \
--resource-group myResourceGroup \
--name mycontainergroupprofile \
--___location WestCentralUS \
--image nginx \
--os-type Linux \
--ip-address Public \
--ports 8000 \
--cpu 1 \
--memory 1.5 \
--restart-policy Never
Criar um perfil de grupo de contêineres usando New-AzContainerInstanceContainerGroupProfile. Opcionalmente, você pode incluir detalhes do mapa de configuração no perfil do grupo de contêineres. Para obter mais informações sobre os mapas de configuração, confira Usar os mapas de configuração.
$port1 = New-AzContainerInstancePortObject -Port 8000 -Protocol TCP
$port2 = New-AzContainerInstancePortObject -Port 8001 -Protocol TCP
$container = New-AzContainerInstanceObject -Name mycontainer -Image nginx -RequestCpu 1 -RequestMemoryInGb 1.5 -Port @($port1, $port2)
New-AzContainerInstanceContainerGroupProfile `
-ResourceGroupName myResourceGroup `
-Name mycontainergroupprofile `
-Location WestCentralUS `
-Container $container `
-OsType Linux `
-RestartPolicy "Never" `
-IpAddressType Public
Crie um perfil de grupo de contêineres e salve o arquivo de modelo. Implante o modelo usando az deployment group create ou New-AzResourceGroupDeployment. Opcionalmente, você pode incluir detalhes do mapa de configuração no perfil do grupo de contêineres. Para obter mais informações sobre os mapas de configuração, confira Usar os mapas de configuração.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"resources": [
{
"type": "Microsoft.ContainerInstance/containerGroupProfiles",
"apiVersion": "2024-05-01-preview",
"name": "[parameters('profileName')]",
"___location": "[parameters('___location')]",
"properties": {
"containers": [
{
"name": "mycontainergroupprofile",
"properties": {
"image": "[parameters('containerImage')]",
"ports": [
{
"port": 8000
}
],
"resources": {
"requests": {
"cpu": 1,
"memoryInGB": 1.5
}
},
"command": [],
"environmentVariables": []
}
}
],
"osType": "Linux",
"ipAddress": {
"type": "Public",
"ports": [
{
"protocol": "TCP",
"port": 8000
}
]
},
"imageRegistryCredentials": [],
"sku": "Standard"
}
}
],
"parameters": {
"profileName": {
"type": "string",
"defaultValue": "mycontainergroupprofile",
"metadata": {
"description": "Name of the container profile"
}
},
"___location": {
"type": "string",
"defaultValue": "West Central US",
"metadata": {
"description": "Location for the resource"
}
},
"containerImage": {
"type": "string",
"defaultValue": "mcr.microsoft.com/azuredocs/aci-helloworld:latest",
"metadata": {
"description": "The container image to use"
}
}
}
}
Criar um perfil de grupo de contêineres usando Criar ou Atualizar. Opcionalmente, você pode incluir detalhes do mapa de configuração no perfil do grupo de contêineres. Para obter mais informações sobre os mapas de configuração, confira Usar os mapas de configuração.
PUT https://management.azure.com/subscriptions/{SubscriptionID}/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/containerGroupProfiles/myContainerGroupProfile?api-version=2024-05-01-preview
Request Body
{
"___location": "West Central US",
"properties":{
"containers": [
{
"name":"mycontainergroupprofile",
"properties": {
"command":[],
"environmentVariables":[],
"image":"mcr.microsoft.com/azuredocs/aci-helloworld:latest",
"ports":[
{
"port":8000
}
],
"resources": {
"requests": {
"cpu":1,
"memoryInGB":1.5
}
}
}
}
],
"imageRegistryCredentials":[],
"ipAddress":{
"ports":[
{
"protocol":"TCP",
"port":8000
}
],
"type":"Public"
},
"osType":"Linux",
"sku":"Standard"
}
}
Criar um pool de espera
Crie um pool em espera e associe-o a um perfil de grupo de contêineres usando az standby-container-group-pool create.
az standby-container-group-pool create \
--resource-group myResourceGroup \
--___location WestCentralUS \
--name myStandbyPool \
--max-ready-capacity 20 \
--refill-policy always \
--container-profile-id "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/containerGroupProfiles/mycontainergroupprofile"
Crie um pool em espera e associe-o a um perfil de grupo de contêineres usando New-AzStandbyContainerGroupPool.
New-AzStandbyContainerGroupPool `
-ResourceGroup myResourceGroup `
-Location "WestCentralUS" `
-Name myStandbyPool `
-MaxReadyCapacity 20 `
-RefillPolicy always `
-ContainerProfileId "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/containerGroupProfiles/mycontainergroupprofile"
Crie um pool em espera e associe-o a um perfil de grupo de contêineres. Crie um modelo e implante-o usando az deployment group create ou New-AzResourceGroupDeployment.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"___location": {
"type": "string",
"defaultValue": "West Central US"
},
"name": {
"type": "string",
"defaultValue": "myStandbyPool"
},
"maxReadyCapacity" : {
"type": "int",
"defaultValue": 10
},
"refillPolicy" : {
"type": "string",
"defaultValue": "always"
},
"containerGroupProfile" : {
"type": "string",
"defaultValue": "/subscriptions/{SubscriptionID}/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/containerGroupProfiles/mycontainergroupprofile"
}
},
"resources": [
{
"type": "Microsoft.StandbyPool/standbyContainerGroupPools",
"apiVersion": "2025-03-01",
"name": "[parameters('name')]",
"___location": "[parameters('___location')]",
"properties": {
"elasticityProfile": {
"maxReadyCapacity": "[parameters('maxReadyCapacity')]",
"refillPolicy": "[parameters('refillPolicy')]"
},
"containerGroupProfile": "[parameters('containerGroupProfile')]"
}
}
]
}
Crie um pool em espera e associe-o a um perfil de grupo de contêineres usando Criar ou Atualizar.
PUT https://management.azure.com/subscriptions/{SubscriptionID}/resourceGroups/myResourceGroup/providers/Microsoft.StandbyPool/standbyContainerGroupPools/myStandbyPool?api-version=2025-03-01
Request Body
{
"properties": {
"elasticityProfile": {
"maxReadyCapacity": 20,
"refillPolicy": "always"
},
"containerGroupProperties": {
"containerGroupProfile": {
"id": "/subscriptions/{SubscriptionID}/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/containerGroupProfiles/mycontainergroupprofile",
"revision": 1
}
}
},
"___location": "West Central US"
}
Próximas etapas
Solicitar um contêiner do pool em espera.