サービス検出の回復性 (プレビュー)

次の回復性の例では、使用可能なすべての構成を示しています。

resource myPolicyDoc 'Microsoft.App/containerApps/resiliencyPolicies@2023-11-02-preview' = {
  name: 'my-app-resiliency-policies'
  parent: '${appName}'
  properties: {
    timeoutPolicy: {
        responseTimeoutInSeconds: 15
        connectionTimeoutInSeconds: 5
    }
    httpRetryPolicy: {
        maxRetries: 5
        retryBackOff: {
          initialDelayInMilliseconds: 1000
          maxIntervalInMilliseconds: 10000
        }
        matches: {
            headers: [
                {
                    header: 'x-ms-retriable'
                    match: { 
                        exactMatch: 'true'
                    }
                }
            ]
            httpStatusCodes: [
                502
                503
            ]
            errors: [
                'retriable-status-codes'
                '5xx'
                'reset'
                'connect-failure'
                'retriable-4xx'
            ]
        }
    } 
    tcpRetryPolicy: {
        maxConnectAttempts: 3
    }
    circuitBreakerPolicy: {
        consecutiveErrors: 5
        intervalInSeconds: 10
        maxEjectionPercent: 50
    }
    tcpConnectionPool: {
        maxConnections: 100
    }
    httpConnectionPool: {
        http1MaxPendingRequests: 1024
        http2MaxRequests: 1024
    }
  }
}

開始する前に

Azure CLI にログインする:

az login

Azure Container App 拡張機能の最新バージョンがインストールされていることを確認します。

az extension show --name containerapp
az extension update --name containerapp

推奨設定を使用してポリシーを作成する

タイムアウト、再試行、サーキット ブレーカーの推奨設定を使用して回復性ポリシーを作成するには、--recommended フラグを指定して resiliency create コマンドを実行します。

az containerapp resiliency create --group MyResourceGroup --name MyResiliencyName --container-app-name MyContainerApp --recommended

このコマンドは、次の例に示すように、推奨される回復性ポリシー構成を渡します。

httpRetryPolicy:
  matches:
    errors:
    - 5xx
  maxRetries: 3
  retryBackOff:
    initialDelayInMilliseconds: 1000
    maxIntervalInMilliseconds: 10000
tcpRetryPolicy:
  maxConnectAttempts: 3
timeoutPolicy:
  connectionTimeoutInSeconds: 5
  responseTimeoutInSeconds: 60
circuitBreakerPolicy:
  consecutiveErrors: 5
  intervalInSeconds: 10
  maxEjectionPercent: 100

特定のポリシーを作成する

個々のポリシーをターゲットにして、回復性ポリシーを作成します。 たとえば、Timeout ポリシーを作成するには、次のコマンドを実行します。

az containerapp resiliency update --group MyResourceGroup --name MyResiliency --container-app-name MyContainerApp --timeout 20 --timeout-connect 5

パラメーターのすべての一覧を表示するには、CLI リファレンス ガイドを確認します。

回復性 YAML を使用してポリシーを作成する

YAML ファイルから回復性ポリシーを適用するには、次のコマンドを実行します。

az containerapp resiliency create --group MyResourceGroup –n MyResiliency --container-app-name MyContainerApp –yaml <MY_YAML_FILE>

このコマンドは、回復性ポリシーの YAML ファイルを渡します。これは、次の例のようになります。

timeoutPolicy:
  responseTimeoutInSeconds: 30
  connectionTimeoutInSeconds: 5
httpRetryPolicy:
  maxRetries: 5
  retryBackOff:
    initialDelayInMilliseconds: 1000
    maxIntervalInMilliseconds: 10000
  matches:
    errors:
      - retriable-headers
      - retriable-status-codes
tcpRetryPolicy:
  maxConnectAttempts: 3
circuitBreakerPolicy:
  consecutiveErrors: 5
  intervalInSeconds: 10
  maxEjectionPercent: 50
tcpConnectionPool:
  maxConnections: 100
httpConnectionPool:
  http1MaxPendingRequests: 1024
  http2MaxRequests: 1024

特定のポリシーを更新する

個々のポリシーをターゲットにして、回復性ポリシーを更新します。 たとえば、Timeout ポリシーの応答タイムアウトを更新するには、次のコマンドを実行します。

az containerapp resiliency update --group MyResourceGroup --name MyResiliency --container-app-name MyContainerApp --timeout 20

回復性 YAML を使用してポリシーを更新する

前に作成した回復性 YAML を更新することで、既存の回復性ポリシーを更新することもできます。

az containerapp resiliency update --name MyResiliency --group MyResourceGroup --container-app-name MyContainerApp --yaml <MY_YAML_FILE>

ポリシーの表示

コンテナー アプリにアタッチされているすべての回復性ポリシーを一覧表示するには、resiliency list コマンドを使用します。

az containerapp resiliency list --group MyResourceGroup --container-app-name MyContainerApp​

名前によって 1 つのポリシーを表示するには、resiliency show コマンドを使用します。

az containerapp resiliency show --group MyResourceGroup --name MyResiliency --container-app-name ​MyContainerApp

ポリシーを削除する

回復性ポリシーを削除するには、次のコマンドを実行します。

az containerapp resiliency delete --group MyResourceGroup --name MyResiliency --container-app-name ​MyContainerApp

Azure portal でコンテナー アプリに移動します。 左側のメニューの [設定]で、[回復性 (プレビュー)] 選択して回復性ペインを開きます。

回復性ポリシーを追加するには、対応するチェック ボックスをオンにし、パラメーターを入力します。 たとえば、タイムアウト ポリシーを設定するには、[タイムアウト] を選択して、接続タイムアウト、応答タイムアウト、またはその両方の期間を秒単位で入力します。

[適用] を選択して、選択したすべてのポリシーをコンテナー アプリに適用します。 [続行] を選択して確定します。