Azure Container Apps でスケーリングルールを設定する

[アーティクル]
11/08/2023

Azure Container Apps では、宣言型スケーリングルールのセットにより、自動水平スケーリングが管理されます。コンテナーアプリのリビジョンがスケールアウトされるときは、リビジョンの新しいインスタンスがオンデマンドで作成されます。これらのインスタンスはレプリカと呼ばれます。

スケールルールを追加または編集すると、コンテナーアプリの新しいリビジョンが作成されます。リビジョンとは、コンテナーアプリの不変スナップショットです。リビジョンの変更の種類を参照して、新しいリビジョンをトリガーする変更の種類を確認します。

イベントドリブン Container Apps ジョブはスケーリングルールを使用し、イベントに基づいて実行をトリガーします。

スケール定義

スケーリングは、制限、ルール、動作の組み合わせによって定義されます。

制限は、コンテナーアプリがスケーリングする場合に可能なリビジョンあたりのレプリカの最小数と最大数です。

スケールの制限	既定値	最小値	最大値
リビジョンあたりのレプリカの最小数	0	0	構成可能なレプリカの最大数は、Azure portal では 300 個、Azure CLI では 1,000 個です。
リビジョンあたりのレプリカの最大数	10	1	構成可能なレプリカの最大数は、Azure portal では 300 個、Azure CLI では 1,000 個です。

詳細については、「Azure Container Apps のクォータ」を参照してください。

ルールとは、レプリカを追加または削除するタイミングを決定するためにコンテナーアプリによって使用される条件です。

スケールルールは、HTTP、TCP、またはカスタムとして実装されます。
動作は、ルールと制限を組み合わせて、時間の経過に伴うスケールの大きさを決定する方法です。

スケールの動作で、スケールの決定がどのように計算されるかについて説明します。

スケールルールを定義するときは、次の点に注意してください。

コンテナーアプリがゼロにスケーリングされている場合、利用料金は請求されません。
レプリカの処理は行われませんが、メモリ内に残っているレプリカは、より低い "アイドル" レートで課金される場合があります。詳細については、「課金」を参照してください。
リビジョンのインスタンスが常に実行されるようにする場合は、レプリカの最小数を 1 以上に設定します。

スケールルール

スケーリングは、3 つの異なるカテゴリのトリガーによって実行されます。

HTTP: リビジョンに対して同時に実行できる HTTP 要求数に基づくスケーリング。
TCP: リビジョンに対して同時に実行できる TCP 接続数に基づくスケーリング。
カスタム: CPU、メモリ、またはサポートされているイベントドリブンデータソースに基づいて、次のように示します。
- Azure Service Bus
- Azure Event Hubs
- Apache Kafka
- Redis

複数のスケールルールを定義すると、いずれかのルールの最初の条件が満たされたときにコンテナーアプリでスケーリングが開始されます。

HTTP

HTTP スケールルールを使用すると、コンテナーアプリのリビジョンのスケーリング方法を決定する同時 HTTP 要求のしきい値を制御できます。 15 秒ごとに、同時要求数は、過去 15 秒間の要求数を 15 で割った値として計算されます。 Container Apps ジョブは HTTP スケーリングルールをサポートしていません。

次の例では、リビジョンが最大 5 レプリカまでスケールアウトし、ゼロにスケールダウンできます。スケーリングプロパティで、1 秒あたりの同時要求数を 100 に設定します。

例

http セクションで、HTTP スケールルールを定義します。

スケーリングプロパティ	説明	既定値	最小値	最大値
`concurrentRequests`	HTTP 要求数がこの値を超えると、レプリカがもう 1 つ追加されます。レプリカは引き続き `maxReplicas` 量までプールに追加されます。	10	1	該当なし

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

Note

HTTP 以外のイベントスケールルールの使用時には、コンテナーアプリの properties.configuration.activeRevisionsMode プロパティを single に設定します。

create コマンドまたは update コマンドで --scale-rule-http-concurrency パラメーターを使用して、HTTP スケールルールを定義します。

CLI パラメーター	説明	既定値	最小値	最大値
`--scale-rule-http-concurrency`	同時に実行される HTTP 要求数がこの値を超えると、レプリカがもう 1 つ追加されます。レプリカは引き続き `max-replicas` 量までプールに追加されます。	10	1	該当なし

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

Azure portal でコンテナーアプリに移動します。
[スケール] を選択します。
[Edit and deploy](編集してデプロイ) を選択します。
[スケール] タブを選択します。
レプリカの最小範囲と最大範囲を選択します。
[追加] を選択します。
[ルール名] ボックスに、ルールの名前を入力します。
[種類] ドロップダウンから [HTTP スケーリング] を選びます。
[同時要求数] ボックスに、コンテナーアプリに指定する同時実行要求数を入力します。

TCP

TCP スケールルールを使用すると、アプリのスケーリング方法を決定する同時 TCP 接続のしきい値を制御できます。 15 秒ごとに、コンカレント接続数は、過去 15 秒間の接続数を 15 で割った値として計算されます。 Container Apps ジョブは TCP スケーリングルールをサポートしていません。

次の例では、コンテナーアプリのリビジョンが最大 5 レプリカまでスケールアウトし、ゼロにスケールダウンできます。スケーリングしきい値では、1 秒あたりのコンカレント接続が 100 に設定されています。

例

tcp セクションで、TCP スケールルールを定義します。

スケーリングプロパティ	説明	既定値	最小値	最大値
`concurrentConnections`	TCP のコンカレント接続数がこの値を超えると、レプリカがもう 1 つ追加されます。コンカレント接続の数が増えるにつれて、`maxReplicas` の数までレプリカが追加されます。	10	1	該当なし

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

create コマンドまたは update コマンドで --scale-rule-tcp-concurrency パラメーターを使用して、TCP スケールルールを定義します。

CLI パラメーター	説明	既定値	最小値	最大値
`--scale-rule-tcp-concurrency`	TCP のコンカレント接続数がこの値を超えると、レプリカがもう 1 つ追加されます。コンカレント接続の数が増えるにつれて、`max-replicas` の数までレプリカが追加されます。	10	1	該当なし

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-tcp-rule \
  --scale-rule-type tcp \
  --scale-rule-tcp-concurrency 100

Azure portal ではサポートされていません。 Azure CLI または Azure Resource Manager を使用して、TCP スケールルールを構成します。

Custom

次の既定値を使用して、任意の ScaledObject ベースの KEDA スケーラーを基にコンテナーアプリのカスタムスケールルールを作成できます。

既定値	秒
[ポーリング間隔]	30
クールダウン期間	300

イベントドリブン Container Apps ジョブの場合は、任意の ScaledJob ベースのKEDA スケーラーを基にカスタムスケールルールを作成できます。

カスタムスケールルールを作成する方法を、次の例に示します。

例

この例では、Azure Service Bus スケーラーをコンテナーアプリのスケールルールに変換する方法を示しますが、他の ScaledObject ベースの KEDA スケーラー仕様にも同じプロセスを使用します。

認証では、KEDA スケーラーの認証パラメーターをコンテナーアプリシークレットに変換します。

次の手順では、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 テンプレートにどのように適合するかについては、この抜粋を参照してください。

まず、スケールルールの種類とメタデータを定義します。

KEDA スケーラー仕様で、type 値を検索します。

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

ARM テンプレートで、スケールルールの custom.type プロパティにスケーラーの type 値を入力します。

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

KEDA スケーラー仕様で、metadata 値を検索します。

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

ARM テンプレートで、すべてのメタデータ値をスケールルールの custom.metadata セクションに追加します。

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

認証

KEDA スケーラーは、authenticationRef プロパティによって参照される TriggerAuthentication でのシークレットの使用をサポートする場合があります。 TriggerAuthentication オブジェクトをコンテナーアプリのスケールルールにマップできます。

Note

コンテナーアプリのスケールルールでは、シークレット参照のみがサポートされます。ポッド ID など、他の種類の認証はサポートされていません。

KEDA ScaledObject 仕様によって参照される TriggerAuthentication オブジェクトを検索します。

KEDA 仕様で、 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

ARM テンプレートで、スケールルールの auth 配列にすべてのエントリを追加します。

シークレット値を含むコンテナーアプリの secrets 配列に、シークレットを追加します。
triggerParameter プロパティの値を、TriggerAuthentication の key プロパティの値に設定します。
secretRef プロパティの値をコンテナーアプリシークレットの名前に設定します。

{
  ...
  "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 テンプレートにリストされている環境変数の最初のコンテナーを確認します。

セキュリティ関連の詳細については、「考慮事項」セクションを参照してください。

KEDA スケーラー仕様で、type 値を検索します。

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

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"

KEDA スケーラー仕様で、metadata 値を検索します。

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

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"

認証

KEDA スケーラーは、authenticationRef プロパティによって参照される TriggerAuthentication でのシークレットの使用をサポートする場合があります。 TriggerAuthentication オブジェクトをコンテナーアプリのスケールルールにマップできます。

Note

コンテナーアプリのスケールルールでは、シークレット参照のみがサポートされます。ポッド ID など、他の種類の認証はサポートされていません。

KEDA ScaledObject 仕様によって参照される TriggerAuthentication オブジェクトを検索します。 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

コンテナーアプリで、secretTargetRef プロパティに一致するシークレットを作成します。

CLI コマンドで、各 secretTargetRef エントリのパラメーターを設定します。

--secrets パラメーターを使用してシークレットエントリを作成します。シークレットが複数ある場合は、スペースで区切ります。
--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 portal でコンテナーアプリに移動します。
[スケール] を選択します。
[Edit and deploy](編集してデプロイ) を選択します。
スケールとレプリカ タブを選択します。
レプリカの最小範囲と最大範囲を選択します。
[追加] を選択します。
[ルール名] ボックスに、ルールの名前を入力します。
[種類] ドロップダウンから [カスタム] を選びます。

KEDA スケーラー仕様で、type 値を検索します。

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

[カスタムルールタイプ] ボックスに、スケーラー type 値を入力します。

KEDA スケーラー仕様で、metadata 値を検索します。

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

ポータルで、[メタデータ] セクションを検索し、[追加] を選択します。 KEDA の ScaledObject 仕様メタデータセクションに各項目の名前と値を入力します。

認証

Note

コンテナーアプリのスケールルールでは、シークレット参照のみがサポートされます。ポッド ID など、他の種類の認証はサポートされていません。

コンテナーアプリで、参照するシークレットを作成します。

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

[認証] セクションで [追加] を選択して、各 KEDA の secretTargetRef パラメーターに対するエントリを作成します。

既定のスケールルール

スケールルールを作成しない場合は、既定のスケールルールがコンテナーアプリに適用されます。

トリガー	最小レプリカ数	最大レプリカ数
HTTP	0	10

重要

イングレスを有効にしない場合は、スケールルールを作成するか、minReplicas を 1 以上に設定してください。イングレスが無効になっていて、minReplicas またはカスタムスケールルールを定義しない場合、コンテナーアプリはゼロにスケーリングされ、バックアップが開始されません。

スケーリングの動作

スケーリングには、以下の既定の動作があります。

パラメーター	値
[ポーリング間隔]	30 秒
クールダウン期間	300 秒
スケールアップ安定化期間	0 秒
スケールダウン安定化期間	300 秒
スケールアップステップ	1、4、電流の 100%
スケールダウンステップ	電流の 100%
スケーリングアルゴリズム	`desiredReplicas = ceil(currentMetricValue / targetMetricValue)`

ポーリング間隔 は、KEDA によってイベントソースが照会される頻度です。この値は、HTTP および TCP のスケールルールには適用されません。
クールダウン期間 は、最後のイベントが観察されてからアプリケーションが最小レプリカ数にスケールダウンするまでに経過した期間を示します。
スケールアップ安定化期間は、スケールアップ条件が満たされてからスケールアップの決定を実行するまでの待機期間です。
スケールダウン安定化期間は、スケールダウン条件が満たされてからスケールダウンの決定を実行するまでの待機期間です。
スケールアップステップは、新しいインスタンスが追加される比率です。 1、4、8、16、32、... と増えていき、設定された最大レプリカ数まで続きます。
スケールダウンステップ は、レプリカが削除される比率です。既定では、シャットダウンする必要があるすべてのレプリカが削除されます。
スケーリングアルゴリズムは、現在必要なレプリカ数を計算するために使用される計算式です。

例

次のスケールルールでは、

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

KEDA は空のキューから始めて、スケールアップシナリオで次の手順を実行します。

my-queue を 30 秒ごとにチェックします。
キューの長さが 0 の場合は、(1) に戻ります。
キューの長さが 0 より大きい場合は、アプリを 1 にスケーリングします。
キューの長さが 50 の場合は、desiredReplicas = ceil(50/5) = 10 と計算します。
アプリを min(maxReplicaCount, desiredReplicas, max(4, 2*currentReplicaCount)) にスケーリングします。
(1) に戻ります。

アプリが最大レプリカ数の 20 にスケーリングされた場合、スケーリングは同じ前の手順を実行します。スケールダウンは、条件が 300 秒間満たされた場合 (スケールダウン安定化期間) にのみ発生します。キューの長さが 0 になると、KEDA はアプリを 0 にスケーリングするまで 300 秒間 (クールダウン期間) 待機します。

考慮事項

"複数のリビジョン" モードでは、新しいスケールトリガーを追加するとアプリケーションの新しいリビジョンが作成されますが、古いリビジョンも引き続き前のスケールルールで使用できます。 [リビジョン管理] ページを使用してトラフィックの割り当てを管理してください。
アプリケーションがゼロにスケーリングされているとき、利用料金は発生しません。価格の詳細については、「Azure Container Apps での課金」を参照してください。
Azure Container Apps 上のすべての .NET アプリに対してデータ保護を有効にする必要があります。詳細については、「Azure Container Apps での ASP.NET Core アプリのデプロイとスケーリング」を参照してください。

既知の制限事項

垂直方向のスケーリングはサポートされていません。
レプリカの数は目標値であり、保証はされません。
Dapr アクターを使用して状態を管理しようとしている場合は、ゼロへのスケーリングがサポートされないことに注意してください。 Dapr では仮想アクターを使用して非同期呼び出しが管理されます。つまり、メモリ内表現は、ID や有効期間に関連付けられません。

次のステップ

シークレットを管理する

Azure Container Apps でスケーリング ルールを設定する

スケール定義

スケール ルール

HTTP

例

TCP

例

Custom

例

認証

認証

認証

既定のスケール ルール

スケーリングの動作

例

考慮事項

既知の制限事項

次のステップ

その他のリソース

Azure Container Apps でスケーリングルールを設定する

スケールルール

既定のスケールルール