جلسات الحاوية المخصصة لتطبيقات حاويات Azure

لإنشاء تجمع جلسة حاوية مخصص باستخدام Azure CLI، تأكد من أن لديك أحدث إصدارات Azure CLI وملحق Azure Container Apps مع الأوامر التالية:

az upgrade
az extension add --name containerapp --upgrade --allow-preview true -y

تتطلب تجمعات جلسات الحاوية المخصصة بيئة Azure Container Apps الممكنة لملف تعريف حمل العمل. إذا لم يكن لديك بيئة، فاستخدم az containerapp env create -n <ENVIRONMENT_NAME> -g <RESOURCE_GROUP> --location <LOCATION> --enable-workload-profiles الأمر لإنشاء بيئة.

az containerapp sessionpool create استخدم الأمر لإنشاء تجمع جلسة حاوية مخصص.

ينشئ المثال التالي تجمع جلسة عمل باسم my-session-pool مع صورة myregistry.azurecr.io/my-container-image:1.0حاوية مخصصة .

قبل إرسال الطلب، استبدل العناصر النائبة بين الأقواس <> بالقيم المناسبة لتجمع جلسة العمل ومعرف الجلسة.

az containerapp sessionpool create \
    --name my-session-pool \
    --resource-group <RESOURCE_GROUP> \
    --environment <ENVIRONMENT> \
    --registry-server myregistry.azurecr.io \
    --registry-username <USER_NAME> \
    --registry-password <PASSWORD> \
    --container-type CustomContainer \
    --image myregistry.azurecr.io/my-container-image:1.0 \
    --cpu 0.25 --memory 0.5Gi \
    --target-port 80 \
    --cooldown-period 300 \
    --network-status EgressDisabled \
    --max-sessions 10 \
    --ready-sessions 5 \
    --env-vars "key1=value1" "key2=value2" \
    --location <LOCATION>

ينشئ هذا الأمر تجمع جلسة عمل بالإعدادات التالية:

للتحقق من حالة تجمع جلسة العمل، استخدم az containerapp sessionpool show الأمر :

az containerapp sessionpool show \
    --name <SESSION_POOL_NAME> \
    --resource-group <RESOURCE_GROUP> \
    --query "properties.poolManagementEndpoint" \
    --output tsv

لتحديث تجمع جلسة العمل، استخدم az containerapp sessionpool update الأمر .

لإنشاء تجمع جلسة حاوية مخصص باستخدام Azure Resource Manager، قم بإنشاء مورد تجمع جلسة عمل مع Microsoft.ContainerApps/sessionPools نوع المورد. يوضح المثال التالي مقتطف قالب ARM الذي ينشئ تجمع جلسة حاوية مخصص.

قبل إرسال الطلب، استبدل العناصر النائبة بين الأقواس <> بالقيم المناسبة لتجمع جلسة العمل ومعرف الجلسة.

{
  "type": "Microsoft.App/sessionPools",
  "apiVersion": "2024-08-02-preview",
  "name": "my-session-pool",
  "location": "westus2",
  "properties": {
    "environmentId": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/providers/Microsoft.ContainerApps/environments/<ENVIRONMENT_NAME>",
    "poolManagementType": "Dynamic",
    "containerType": "CustomContainer",
    "scaleConfiguration": {
      "maxConcurrentSessions": 10,
      "readySessionInstances": 5
    },
    "dynamicPoolConfiguration": {
      "executionType": "Timed",
      "cooldownPeriodInSeconds": 600
    },
    "secrets": [
      {
        "name": "registrypassword",
        "value": "<REGISTRY_PASSWORD>"
      }
    ],
    "customContainerTemplate": {
      "registryCredentials": {
          "server": "myregistry.azurecr.io",
          "username": "myregistry",
          "passwordSecretRef": "registrypassword"
      },
      "containers": [
        {
          "image": "myregistry.azurecr.io/my-container-image:1.0",
          "name": "mycontainer",
          "resources": {
            "cpu": 0.25,
            "memory": "0.5Gi"
          },
          "command": [
            "/bin/sh"
          ],
          "args": [
            "-c",
            "while true; do echo hello; sleep 10;done"
          ],
          "env": [
            {
              "name": "key1",
              "value": "value1"
            },
            {
              "name": "key2",
              "value": "value2"
            }
          ]
        }
      ],
      "ingress": {
        "targetPort": 80
      }
    },
    "sessionNetworkConfiguration": {
      "status": "EgressEnabled"
    }
  }
}

ينشئ هذا القالب تجمع جلسة عمل بالإعدادات التالية:

لتمكين الهوية المدارة لتجمع جلسة حاوية مخصص، استخدم Azure Resource Manager.

لتمكين الهوية المدارة لتجمع جلسة عمل حاوية مخصص، أضف خاصية identity إلى مورد تجمع جلسة العمل. identity يجب أن تحتوي الخاصية على type خاصية بالقيمة SystemAssigned أو UserAssigned. للحصول على تفاصيل حول كيفية تكوين هذه الخاصية، راجع تكوين الهويات المدارة.

يظهر المثال التالي مقتطف قالب ARM الذي يمكن هوية معينة من قبل المستخدم لتجمع جلسة حاوية مخصصة واستخدامها لمصادقة سحب الصورة. قبل إرسال الطلب، استبدل العناصر النائبة بين الأقواس <> بالقيم المناسبة لتجمع جلسة العمل ومعرف الجلسة.

{
  "type": "Microsoft.App/sessionPools",
  "apiVersion": "2024-08-02-preview",
  "name": "my-session-pool",
  "location": "westus2",
  "properties": {
    "environmentId": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/providers/Microsoft.ContainerApps/environments/<ENVIRONMENT_NAME>",
    "poolManagementType": "Dynamic",
    "containerType": "CustomContainer",
    "scaleConfiguration": {
      "maxConcurrentSessions": 10,
      "readySessionInstances": 5
    },
    "dynamicPoolConfiguration": {
      "executionType": "Timed",
      "cooldownPeriodInSeconds": 600
    },
    "customContainerTemplate": {
      "registryCredentials": {
          "server": "myregistry.azurecr.io",
          "identity": "<IDENTITY_RESOURCE_ID>"
      },
      "containers": [
        {
          "image": "myregistry.azurecr.io/my-container-image:1.0",
          "name": "mycontainer",
          "resources": {
            "cpu": 0.25,
            "memory": "0.5Gi"
          },
          "command": [
            "/bin/sh"
          ],
          "args": [
            "-c",
            "while true; do echo hello; sleep 10;done"
          ],
          "env": [
            {
              "name": "key1",
              "value": "value1"
            },
            {
              "name": "key2",
              "value": "value2"
            }
          ]
        }
      ],
      "ingress": {
        "targetPort": 80
      }
    },
    "sessionNetworkConfiguration": {
      "status": "EgressEnabled"
    },
    "managedIdentitySettings": [
      {
        "identity": "<IDENTITY_RESOURCE_ID>",
        "lifecycle": "None"
      }
    ]
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "<IDENTITY_RESOURCE_ID>": {}
    }
  }
}

يحتوي هذا القالب على الإعدادات الإضافية التالية للهوية المدارة: