Criar um pool em espera para Instâncias de Contêiner do Azure (Visualização)

Importante

Os pools em espera para Instâncias de Contêiner do Azure estão atualmente em visualização. As pré-visualizações são disponibilizadas a si na condição de concordar com os termos suplementares de utilização. Alguns aspetos desta funcionalidade podem alterar-se após a disponibilidade geral (GA).

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 listados na página de visão geral de Pools de espera para 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.

Nota

Para usar contêineres confidenciais, atualize o sku tipo para ao criar seu perfil de grupo de Confidential contêineres.

CLI

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 nginx \
    --os-type Linux \ 
    --ip-address Public \ 
    --ports 8000 \ 
    --cpu 1 \
    --memory 1.5 \
    --restart-policy Never

PowerShell

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 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

Modelo ARM

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/containerGroups",
      "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"
      }
    }
  }
}

REST

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 em espera

CLI

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"

PowerShell

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"

Modelo ARM

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": "2024-03-01",
            "name": "[parameters('name')]",
            "location": "[parameters('location')]",
            "properties": {
               "elasticityProfile": {
                   "maxReadyCapacity": "[parameters('maxReadyCapacity')]",
                   "refillPolicy": "[parameters('refillPolicy')]"
               },
               "containerGroupProfile": "[parameters('containerGroupProfile')]"
            }
        }
    ]
   }

REST

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=2024-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 contêiner do pool de espera.