Importante
Para que os pools em espera criem e gerenciem recursos com êxito, é necessário acesso aos recursos associados em sua assinatura. Verifique se as permissões corretas estão atribuídas ao provedor de recursos do pool em espera para que o pool em espera funcione corretamente. Para obter instruções detalhadas, consulte Configurar permissões de função para pools em espera.
Este artigo descreve como criar um perfil de grupo de contêineres e usar esse perfil para configurar um pool de espera para Instâncias de Contêiner do Azure.
Pré-requisitos
Antes de utilizar pools em espera, conclua o registro de recursos e configure os controles de acesso baseados em função. Para obter mais informações, consulte Configurar permissões de função para pools em espera em instâncias de contêiner do Azure
Criar um perfil de grupo de contêineres
O perfil do 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 seu pool em espera para garantir que as atualizações sejam aplicadas às instâncias no pool.
Para usar contêineres confidenciais, atualize o sku tipo para Confidential durante a criação do perfil do seu grupo de contêineres.
Crie um perfil de grupo de contêineres 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 mapas de configuração, consulte usar mapas de configuração.
az container container-group-profile create \
--resource-group myResourceGroup \
--name mycontainergroupprofile \
--location WestCentralUS \
--image mcr.microsoft.com/azuredocs/aci-helloworld \
--os-type Linux \
--ip-address Public \
--ports 8000 \
--cpu 1 \
--memory 1.5 \
--restart-policy Never
Crie 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 mapas de configuração, consulte usar mapas de configuração.
$port1 = New-AzContainerInstancePortObject -Port 8000 -Protocol TCP
$port2 = New-AzContainerInstancePortObject -Port 8001 -Protocol TCP
$container = New-AzContainerInstanceObject -Name mycontainer -Image mcr.microsoft.com/azuredocs/aci-helloworld -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 mapas de configuração, consulte usar 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"
}
}
}
}
Crie 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 mapas de configuração, consulte usar 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 reserva
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-group-profile-id "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/containerGroupProfiles/mycontainergroupprofile" \
--container-group-profile-revision 1
Crie um pool em espera e associe-o a um perfil de grupo de contêineres usando New-AzStandbyContainerGroupPool.
New-AzStandbyContainerGroupPool `
-ResourceGroupName myResourceGroup `
-Location "westcentralus" `
-Name myStandbyPool `
-MaxReadyCapacity 20 `
-RefillPolicy "always" `
-ContainerGroupProfileId "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/containerGroupProfiles/mycontainergroupprofile" `
-ContainerGroupProfileRevision 1
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"
},
"containerGroupProfileId": {
"type": "string",
"defaultValue": "/subscriptions/{SubscriptionID}/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/containerGroupProfiles/mycontainergroupprofile"
},
"containerGroupProfileRevision": {
"type": "int",
"defaultValue": 1
}
},
"resources": [
{
"type": "Microsoft.StandbyPool/standbyContainerGroupPools",
"apiVersion": "2025-03-01",
"name": "[parameters('name')]",
"location": "[parameters('location')]",
"properties": {
"elasticityProfile": {
"maxReadyCapacity": "[parameters('maxReadyCapacity')]",
"refillPolicy": "[parameters('refillPolicy')]"
},
"containerGroupProperties": {
"containerGroupProfile": {
"id": "[parameters('containerGroupProfileId')]",
"revision": "[parameters('containerGroupProfileRevision')]"
}
}
}
}
]
}
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óximos passos
Solicite um contentor do pool de espera.