Azure Container Instances에 대한 대기 풀 만들기(미리 보기)

Important

Azure Container Instances의 대기 풀은 현재 미리 보기로 제공됩니다. 추가 사용 약관에 동의하는 조건으로 미리 보기를 사용할 수 있습니다. 이 기능의 몇 가지 측면은 일반 공급(GA) 전에 변경될 수 있습니다.

이 문서에서는 컨테이너 그룹 프로필을 만들고 해당 프로필을 사용하여 Azure Container Instances에 대한 대기 풀을 구성하는 단계를 안내합니다.

필수 조건

대기 풀을 활용하기 전에 기능 등록을 완료하고 Azure Container Instances용 대기 풀 개요 페이지에 나열된 역할 기반 액세스 제어를 구성합니다.

컨테이너 그룹 프로필 만들기

컨테이너 그룹 프로필은 대기 풀에서 컨테이너를 구성하는 방법을 알려줍니다. 컨테이너 그룹 프로필을 변경하는 경우 업데이트가 풀의 인스턴스에 적용되도록 대기 풀을 업데이트해야 합니다.

참고 항목

기밀 컨테이너를 사용하려면 컨테이너 그룹 프로필을 만들 때 형식을 Confidential 업데이트 sku 합니다.

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

다음 단계

대기 풀에서 컨테이너를 요청합니다.