Установка правил масштабирования в Контейнерах приложений Azure

В http разделе определяется правило масштабирования HTTP.

{
  ...
  "resources": {
    ...
    "properties": {
      ...
      "template": {
        ...
        "scale": {
          "minReplicas": 0,
          "maxReplicas": 5,
          "rules": [{
            "name": "http-rule",
            "http": {
              "metadata": {
                "concurrentRequests": "100"
              }
            }
          }]
        }
      }
    }
  }
}

Определите правило масштабирования HTTP с помощью --scale-rule-http-concurrency параметра в create командах или update командах.

az containerapp create \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --environment <ENVIRONMENT_NAME> \
  --image <CONTAINER_IMAGE_LOCATION>
  --min-replicas 0 \
  --max-replicas 5 \
  --scale-rule-name azure-http-rule \
  --scale-rule-type http \
  --scale-rule-http-concurrency 100

1. Перейдите в приложение-контейнер в портал Azure

2. Выберите "Масштаб".

3. Выберите Изменить и развернуть.

4. Выберите вкладку "Масштаб ".

5. Выберите минимальный и максимальный диапазон реплик.

   

6. Выберите Добавить.

7. В поле "Имя правила" введите имя правила.

8. В раскрывающемся списке "Тип" выберите "Масштабирование HTTP".

9. В поле "Одновременные запросы" введите требуемое количество одновременных запросов для приложения контейнера.

В tcp разделе определяется правило масштабирования TCP.

{
  ...
  "resources": {
    ...
    "properties": {
      ...
      "template": {
        ...
        "scale": {
          "minReplicas": 0,
          "maxReplicas": 5,
          "rules": [{
            "name": "tcp-rule",
            "tcp": {
              "metadata": {
                "concurrentConnections": "100"
              }
            }
          }]
        }
      }
    }
  }
}

Определите правило масштабирования TCP с помощью --scale-rule-tcp-concurrency параметра в create командах или update командах.

az containerapp create \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --environment <ENVIRONMENT_NAME> \
  --image <CONTAINER_IMAGE_LOCATION>
  --min-replicas 0 \
  --max-replicas 5 \
  --transport tcp \
  --ingress <external/internal> \
  --target-port <CONTAINER_TARGET_PORT> \
  --scale-rule-name azure-tcp-rule \
  --scale-rule-type tcp \
  --scale-rule-tcp-concurrency 100

Не поддерживается в портал Azure. Используйте Azure CLI или Azure Resource Manager для настройки правила масштабирования TCP.

В следующей процедуре показано, как преобразовать масштабировщик KEDA в правило масштабирования приложения-контейнера. Этот фрагмент является фрагментом шаблона ARM, чтобы показать, где каждый раздел подходит в контексте общего шаблона.

{
  ...
  "resources": {
    ...
    "properties": {
      ...
      "configuration": {
        ...
        "secrets": [
          {
            "name": "<NAME>",
            "value": "<VALUE>"
          }
        ]
      },
      "template": {
        ...
        "scale": {
          "minReplicas": 0,
          "maxReplicas": 5,
          "rules": [
            {
              "name": "<RULE_NAME>",
              "custom": {
                "metadata": {
                  ...
                },
                "auth": [
                  {
                    "secretRef": "<NAME>",
                    "triggerParameter": "<PARAMETER>"
                  }
                ]
              }
            }
          ]
        }
      }
    }
  }
}

Ознакомьтесь с этим фрагментом контекста о том, как приведенные ниже примеры соответствуют шаблону ARM.

Сначала необходимо определить тип и метаданные правила масштабирования.

1. В спецификации масштабировщика KEDA найдите type значение.

   triggers:
   - type: azure-servicebus
     metadata:
       queueName: my-queue
       namespace: service-bus-namespace
       messageCount: "5"
   

2. В шаблоне ARM введите значение масштабировщика type в custom.type свойство правила масштабирования.

   ...
   "rules": [
     {
       "name": "azure-servicebus-queue-rule",
       "custom": {
         "type": "azure-servicebus",
         "metadata": {
           "queueName": "my-queue",
           "namespace": "service-bus-namespace",
           "messageCount": "5"
         }
       }
     }
   ]
   ...
   

3. В спецификации масштабировщика KEDA найдите metadata значения.

   triggers:
   - type: azure-servicebus
     metadata:
       queueName: my-queue
       namespace: service-bus-namespace
       messageCount: "5"
   

4. В шаблоне ARM добавьте все значения custom.metadata метаданных в раздел правила масштабирования.

   ...
   "rules": [
     {
       "name": "azure-servicebus-queue-rule",
       "custom": {
         "type": "azure-servicebus",
         "metadata": {
           "queueName": "my-queue",
           "namespace": "service-bus-namespace",
           "messageCount": "5"
         }
       }
     }
   ]
   ...
   

Проверка подлинности

Правила масштабирования контейнеров поддерживают проверку подлинности на основе секретов. Правила масштабирования ресурсов Azure, включая хранилище очередей Azure, Служебная шина Azure и Центры событий Azure, также поддерживают управляемое удостоверение. По возможности используйте проверку подлинности управляемого удостоверения, чтобы избежать хранения секретов в приложении.

Использование секретов

Чтобы использовать секреты для проверки подлинности, необходимо создать секрет в массиве приложения secrets контейнера. Значение секрета используется в auth массиве правила масштабирования.

Масштабировщики KEDA могут использовать секреты в триггераAuthentication , на которое ссылается authenticationRef свойство. Объект TriggerAuthentication можно сопоставить с правилом масштабирования приложений контейнеров.

1. TriggerAuthentication Найдите объект, на который ссылается спецификация KEDAScaledObject.

2. В объекте TriggerAuthentication найдите каждый secretTargetRef и связанный с ним секрет.

   apiVersion: v1
   kind: Secret
   metadata:
     name: my-secrets
     namespace: my-project
   type: Opaque
   data:
     connection-string-secret: <SERVICE_BUS_CONNECTION_STRING>
   ---
   apiVersion: keda.sh/v1alpha1
   kind: TriggerAuthentication
   metadata:
     name: azure-servicebus-auth
   spec:
     secretTargetRef:
     - parameter: connection
       name: my-secrets
       key: connection-string-secret
   ---
   apiVersion: keda.sh/v1alpha1
   kind: ScaledObject
   metadata:
     name: azure-servicebus-queue-rule
     namespace: default
   spec:
     scaleTargetRef:
       name: my-scale-target
     triggers:
     - type: azure-servicebus
       metadata:
         queueName: my-queue
         namespace: service-bus-namespace
         messageCount: "5"
       authenticationRef:
           name: azure-servicebus-auth
   

3. В шаблоне ARM для каждого секрета:

   1. Добавьте секрет в массив приложения secrets контейнера, содержащий имя и значение секрета.

   2. Добавьте запись в auth массив правила масштабирования.

      1. Задайте для свойства значение triggerParameter secretTargetRefparameter свойства.

      2. Задайте для свойства значение secretRef имени secretTargetRefkey свойства.

   {
     ...
     "resources": {
       ...
       "properties": {
         ...
         "configuration": {
           ...
           "secrets": [
             {
               "name": "connection-string-secret",
               "value": "<SERVICE_BUS_CONNECTION_STRING>"
             }
           ]
         },
         "template": {
           ...
           "scale": {
             "minReplicas": 0,
             "maxReplicas": 5,
             "rules": [
               {
                 "name": "azure-servicebus-queue-rule",
                 "custom": {
                   "type": "azure-servicebus",
                   "metadata": {
                     "queueName": "my-queue",
                     "namespace": "service-bus-namespace",
                     "messageCount": "5"
                   },
                   "auth": [
                     {
                       "secretRef": "connection-string-secret",
                       "triggerParameter": "connection"
                     }
                   ]
                 }
               }
             ]
           }
         }
       }
     }
   }
   

   Некоторые масштабировщики поддерживают метаданные с суффиксом FromEnv для ссылки на значение в переменной среды. Приложения-контейнеры рассматривают первый контейнер, указанный в шаблоне ARM для переменной среды.

   Дополнительные сведения о безопасности см. в разделе "Рекомендации".

Использование управляемого удостоверения

Правила масштабирования контейнерных приложений могут использовать управляемое удостоверение для проверки подлинности с помощью служб Azure. Следующий шаблон ARM передает управляемое удостоверение на основе системы для проверки подлинности для масштабировщика очередей Azure.

"scale": {
  "minReplicas": 0,
  "maxReplicas": 4,
  "rules": [
    {
      "name": "azure-queue",
      "custom": {
        "type": "azure-queue",
        "metadata": {
          "accountName": "apptest123",
          "queueName": "queue1",
          "queueLength": "1"
        },
        "identity": "system"
      }
    }
  ]
}

Дополнительные сведения об использовании управляемого удостоверения с правилами масштабирования см. в разделе "Управляемое удостоверение".

1. В спецификации масштабировщика KEDA найдите type значение.

   triggers:
   - type: azure-servicebus
     metadata:
       queueName: my-queue
       namespace: service-bus-namespace
       messageCount: "5"
   

2. В команде CLI задайте --scale-rule-type параметр значению спецификации type .

   az containerapp create \
     --name <CONTAINER_APP_NAME> \
     --resource-group <RESOURCE_GROUP> \
     --environment <ENVIRONMENT_NAME> \
     --image <CONTAINER_IMAGE_LOCATION>
     --min-replicas 0 \
     --max-replicas 5 \
     --secrets "connection-string-secret=<SERVICE_BUS_CONNECTION_STRING>" \
     --scale-rule-name azure-servicebus-queue-rule \
     --scale-rule-type azure-servicebus \
     --scale-rule-metadata "queueName=my-queue" \
                           "namespace=service-bus-namespace" \
                           "messageCount=5" \
     --scale-rule-auth "connection=connection-string-secret"
   

3. В спецификации масштабировщика KEDA найдите metadata значения.

   triggers:
   - type: azure-servicebus
     metadata:
       queueName: my-queue
       namespace: service-bus-namespace
       messageCount: "5"
   

4. В команде CLI задайте --scale-rule-metadata для параметра значения метаданных.

   Необходимо преобразовать значения из формата YAML в пару "ключ-значение" для использования в командной строке. Разделите каждую пару "ключ-значение" с пробелом.

   az containerapp create \
     --name <CONTAINER_APP_NAME> \
     --resource-group <RESOURCE_GROUP> \
     --environment <ENVIRONMENT_NAME> \
     --image <CONTAINER_IMAGE_LOCATION>
     --min-replicas 0 \
     --max-replicas 5 \
     --secrets "connection-string-secret=<SERVICE_BUS_CONNECTION_STRING>" \
     --scale-rule-name azure-servicebus-queue-rule \
     --scale-rule-type azure-servicebus \
     --scale-rule-metadata "queueName=my-queue" \
                           "namespace=service-bus-namespace" \
                           "messageCount=5" \
     --scale-rule-auth "connection=connection-string-secret"
   

Проверка подлинности

Правила масштабирования контейнеров поддерживают проверку подлинности на основе секретов. Правила масштабирования ресурсов Azure, включая хранилище очередей Azure, Служебная шина Azure и Центры событий Azure, также поддерживают управляемое удостоверение. По возможности используйте проверку подлинности управляемого удостоверения, чтобы избежать хранения секретов в приложении.

Использование секретов

Чтобы настроить проверку подлинности на основе секретов для правила масштабирования контейнерных приложений, необходимо настроить секреты в приложении контейнера и ссылаться на них в правиле масштабирования.

Масштабировщик KEDA поддерживает секреты в триггераAuthentication , которое authenticationRef свойство использует для ссылки. Объект можно сопоставить TriggerAuthentication с правилом масштабирования контейнерных приложений.

1. TriggerAuthentication Найдите объект, на который ссылается спецификация KEDAScaledObject. Определите каждый secretTargetRef TriggerAuthentication объект.

   apiVersion: v1
   kind: Secret
   metadata:
     name: my-secrets
     namespace: my-project
   type: Opaque
   data:
     connection-string-secret: <SERVICE_BUS_CONNECTION_STRING>
   ---
   apiVersion: keda.sh/v1alpha1
   kind: TriggerAuthentication
   metadata:
     name: azure-servicebus-auth
   spec:
     secretTargetRef:
     - parameter: connection
       name: my-secrets
       key: connection-string-secret
   ---
   apiVersion: keda.sh/v1alpha1
   kind: ScaledObject
   metadata:
     name: azure-servicebus-queue-rule
     namespace: default
   spec:
     scaleTargetRef:
       name: my-scale-target
     triggers:
     - type: azure-servicebus
       metadata:
         queueName: my-queue
         namespace: service-bus-namespace
         messageCount: "5"
       authenticationRef:
           name: azure-servicebus-auth
   

2. В приложении-контейнере создайте секреты , соответствующие свойствам secretTargetRef .

3. В команде CLI задайте параметры для каждой secretTargetRef записи.

   1. Создайте запись секрета с параметром --secrets . Если существует несколько секретов, разделите их пробелом.

   2. Создайте запись проверки подлинности с параметром --scale-rule-auth . Если есть несколько записей, разделите их пробелом.

   az containerapp create \
     --name <CONTAINER_APP_NAME> \
     --resource-group <RESOURCE_GROUP> \
     --environment <ENVIRONMENT_NAME> \
     --image <CONTAINER_IMAGE_LOCATION>
     --min-replicas 0 \
     --max-replicas 5 \
     --secrets "connection-string-secret=<SERVICE_BUS_CONNECTION_STRING>" \
     --scale-rule-name azure-servicebus-queue-rule \
     --scale-rule-type azure-servicebus \
     --scale-rule-metadata "queueName=my-queue" \
                           "namespace=service-bus-namespace" \
                           "messageCount=5" \
     --scale-rule-auth "connection=connection-string-secret"
   

Использование управляемого удостоверения

Правила масштабирования контейнерных приложений могут использовать управляемое удостоверение для проверки подлинности с помощью служб Azure. Следующая команда создает приложение-контейнер с управляемым удостоверением, назначаемое пользователем, и использует его для проверки подлинности для масштабировщика очередей Azure.

az containerapp create \
  --resource-group <RESOURCE_GROUP> \
  --name <APP_NAME> \
  --environment <ENVIRONMENT_ID> \
  --user-assigned <USER_ASSIGNED_IDENTITY_ID> \
  --scale-rule-name azure-queue \
  --scale-rule-type azure-queue \
  --scale-rule-metadata "accountName=<AZURE_STORAGE_ACCOUNT_NAME>" "queueName=queue1" "queueLength=1" \
  --scale-rule-identity <USER_ASSIGNED_IDENTITY_ID>

Замените заполнители значениями.

1. Перейдите в приложение-контейнер в портал Azure.

2. Выберите "Масштаб".

3. Выберите Изменить и развернуть.

4. Перейдите на вкладку "Масштаб и реплики ".

5. Выберите минимальный и максимальный диапазон реплик.

   

6. Выберите Добавить.

7. В поле "Имя правила" введите имя правила.

8. В раскрывающемся списке "Тип" выберите "Настраиваемый".

9. В спецификации масштабировщика KEDA найдите type значение.

   triggers:
   - type: azure-servicebus
     metadata:
       queueName: my-queue
       namespace: service-bus-namespace
       messageCount: "5"
   

10. В поле "Настраиваемый тип правила" введите значение масштабировщика type .

11. В спецификации масштабировщика KEDA найдите metadata значения.

    triggers:
    - type: azure-servicebus
      metadata:
        queueName: my-queue
        namespace: service-bus-namespace
        messageCount: "5"
    

12. На портале найдите раздел метаданных и нажмите кнопку "Добавить". Введите имя и значение для каждого элемента в разделе метаданных спецификации KEDA ScaledObject .

Проверка подлинности

Правила масштабирования контейнеров поддерживают проверку подлинности на основе секретов. Правила масштабирования ресурсов Azure, включая хранилище очередей Azure, Служебная шина Azure и Центры событий Azure, также поддерживают управляемое удостоверение. По возможности используйте проверку подлинности управляемого удостоверения, чтобы избежать хранения секретов в приложении.

Использование секретов

1. В приложении-контейнере создайте секреты , на которые вы хотите ссылаться.

2. TriggerAuthentication Найдите объект, на который ссылается спецификация KEDAScaledObject. Определите каждый secretTargetRef TriggerAuthentication объект.

   apiVersion: v1
   kind: Secret
   metadata:
     name: my-secrets
     namespace: my-project
   type: Opaque
   data:
     connection-string-secret: <SERVICE_BUS_CONNECTION_STRING>
   ---
   apiVersion: keda.sh/v1alpha1
   kind: TriggerAuthentication
   metadata:
     name: azure-servicebus-auth
   spec:
     secretTargetRef:
     - parameter: connection
       name: my-secrets
       key: connection-string-secret
   ---
   apiVersion: keda.sh/v1alpha1
   kind: ScaledObject
   metadata:
     name: azure-servicebus-queue-rule
     namespace: default
   spec:
     scaleTargetRef:
       name: my-scale-target
     triggers:
     - type: azure-servicebus
       metadata:
         queueName: my-queue
         namespace: service-bus-namespace
         messageCount: "5"
       authenticationRef:
           name: azure-servicebus-auth
   

3. В разделе "Проверка подлинности" выберите "Добавить", чтобы создать запись для каждого параметра KEDAsecretTargetRef.

Использование управляемого удостоверения

Проверка подлинности управляемого удостоверения не поддерживается в портал Azure. Используйте Azure CLI или Azure Resource Manager для проверки подлинности с помощью управляемого удостоверения.