建立 Azure 容器執行個體 的待命集區 （預覽）

重要

Azure 容器執行個體 的待命集區目前為預覽狀態。 若您同意補充的使用規定即可取得預覽。 在公開上市 (GA) 之前，此功能的某些領域可能會變更。

本文逐步說明如何建立容器群組配置檔，並使用該配置檔來設定 Azure 容器執行個體 的待命集區。

必要條件

使用待命集區之前，請先完成功能註冊，並設定待命集區中所列的角色型訪問控制，以 Azure 容器執行個體 概觀頁面。

建立容器群組配置檔

容器群組配置檔會告知待命集區如何設定集區中的容器。 如果您變更容器群組配置檔，您也需要更新待命集區，以確保更新會套用至集區中的實例。

注意

若要使用 機密容器 ，請在建立容器群組設定檔時，將 sku 類型更新為 Confidential 。

CLI

使用 az container-group-profile create 建立容器群組配置檔。 您可以選擇性地在容器群組設定檔中包含組態對應詳細數據。 如需設定對應的詳細資訊，請參閱 使用設定對應。

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

使用 New-AzContainerInstanceContainerGroupProfile 建立容器群組配置檔。 您可以選擇性地在容器群組設定檔中包含組態對應詳細數據。 如需設定對應的詳細資訊，請參閱 使用設定對應。

$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

ARM 範本

建立容器群組配置檔並儲存範本檔案。 使用 az deployment group create 或 New-AzResourceGroupDeployment 部署範本。 您可以選擇性地在容器群組設定檔中包含組態對應詳細數據。 如需設定對應的詳細資訊，請參閱 使用設定對應。

{
  "$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

使用 建立或更新建立容器群組配置檔。 您可以選擇性地在容器群組設定檔中包含組態對應詳細數據。 如需設定對應的詳細資訊，請參閱 使用設定對應。

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

建立待命集區

CLI

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

使用 New-AzStandbyContainerGroupPool 建立待命集區，並將其與容器群組配置檔產生關聯。

New-AzStandbyContainerGroupPool `
   -ResourceGroup myResourceGroup `
   -Location "WestCentralUS" `
   -Name myStandbyPool `
   -MaxReadyCapacity 20 `
   -RefillPolicy always `
   -ContainerProfileId "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/containerGroupProfiles/mycontainergroupprofile"

ARM 範本

建立待命集區，並將它與容器群組配置檔產生關聯。 使用 az deployment group create 或 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

使用建立或更新建立待命集區，並將它與容器群組配置檔產生關聯。

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

下一步

從待命集區要求容器。