Azure Kubernetes Service (AKS) および Arc 対応 Kubernetes 用の Dapr 拡張機能をインストールする

開始する前に

クラスター拡張機能用の Azure CLI 拡張機能を追加する

次のコマンドを実行して、k8s-extension Azure CLI 拡張機能をインストールします。

az extension add --name k8s-extension

k8s-extension 拡張機能が既にインストールされている場合は、次のコマンドを使用して最新バージョンに更新できます。

az extension update --name k8s-extension

KubernetesConfiguration リソース プロバイダーを登録する

まだクラスター拡張機能を使用していない場合は、リソース プロバイダーをサブスクリプションに登録することが必要になる場合があります。 プロバイダー登録の状態は、次の例で示すように az provider list コマンドを使用して確認できます。

az provider list --query "[?contains(namespace,'Microsoft.KubernetesConfiguration')]" -o table

"Microsoft.KubernetesConfiguration" プロバイダーが、次の出力例に示すように "Registered" と報告されます。

Namespace                          RegistrationState    RegistrationPolicy
---------------------------------  -------------------  --------------------
Microsoft.KubernetesConfiguration  Registered           RegistrationRequired

プロバイダーが NotRegistered として示される場合は、次の例で示すように az provider register を使用してプロバイダーを登録します。

az provider register --namespace Microsoft.KubernetesConfiguration

Azure サブスクリプションに ExtenstionTypes 機能を登録する

ExtensionTypes 機能を Azure サブスクリプションに登録する必要があります。 ターミナルで、正しいサブスクリプションを使用していることを確認します。

az account set --subscription <YOUR-AZURE-SUBSCRIPTION-ID>

ExtenstionTypes 機能を登録します。

az feature registration create --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

機能の登録には、しばらく時間がかかる場合があります。 数分後、次のコマンドを使用して登録の状態を確認します。

az feature show --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

拡張機能を作成して AKS または Arc 対応 Kubernetes クラスターに Dapr をインストールする

Dapr 拡張機能をインストールするときは、クラスターの種類に対応するフラグ値を使用します。

• AKS クラスター: --cluster-type managedClusters.
• Arc 対応 Kubernetes クラスター: --cluster-type connectedClusters.

Dapr 拡張機能を作成します。この拡張機能により、AKS または Arc 対応 Kubernetes クラスターに Dapr がインストールされます。

たとえば、AKS クラスターに Dapr 拡張機能を使って最新バージョンの Dapr をインストールします。

az k8s-extension create --cluster-type managedClusters \
--cluster-name <myAKSCluster> \
--resource-group <myResourceGroup> \
--name dapr \
--extension-type Microsoft.Dapr \
--auto-upgrade-minor-version false

マネージド AKS クラスターを最新バージョンに保つ

環境 (開発、テスト、または運用環境) に基づいて、最新の安定した Dapr バージョンを使用することができます。

リリース トレーニングの選択

拡張機能を構成するときに、特定のリリース トレインから Dapr をインストールすることを選択できます。 次の 2 つのリリース トレイン値のいずれかを指定します。

次に例を示します。

--release-train stable

Dapr コントロール プレーンへの自動更新の構成

バージョンを指定せずに Dapr をインストールすると、--auto-upgrade-minor-version が "自動的に有効になり"、新しいリリース時にマイナー バージョンを自動的に更新するように Dapr コントロール プレーンが構成されます。

--auto-upgrade-minor-version パラメーターを指定し、値を false に設定することで、自動更新を無効にできます。

Dapr のバージョン管理は MAJOR.MINOR.PATCH 形式です。つまり、1.11.0 から 1.12.0 は "マイナー" バージョン アップグレードです。

--auto-upgrade-minor-version true

利用可能な最新の安定した Dapr バージョンの表示

運用環境で最新の Dapr バージョンにアップグレードするには、手動でアップグレードする必要があります。 まず、マネージド AKS クラスターで利用できる安定した Dapr バージョンの一覧を表示します。 次のコマンドを実行します。

az k8s-extension extension-types list-versions-by-cluster --resource-group <myResourceGroup> --cluster-name <myCluster> --cluster-type managedClusters --extension-type microsoft.dapr --release-train stable

マネージド AKS クラスターで利用できる最新の安定した Dapr バージョンを確認するには、次のコマンドを実行します。

az k8s-extension extension-types list-versions-by-cluster --resource-group <myResourceGroup> --cluster-name <myCluster> --cluster-type managedClusters --extension-type microsoft.dapr  --release-train stable --show-latest

使用できる安定した Dapr バージョンの一覧を "場所ごと" で表示するには、以下を行います。

1. ExtenstionTypes 機能が Azure サブスクリプションに登録されていることを確認します。
2. 次のコマンドを実行します。

az k8s-extension extension-types list-versions-by-location --location westus --extension-type microsoft.dapr

次に、Dapr を最新の安定バージョンに手動で更新します。

特定の Dapr バージョンを対象とする

特定のバージョンの Dapr をインストールしたり、以前のバージョンにロールバックしたりするには、同じコマンド ライン引数を使用します。 --auto-upgrade-minor-version を false に、--version をインストールする Dapr のバージョンに設定します。 version パラメーターを省略すると、拡張機能で最新バージョンの Dapr がインストールされます。 たとえば、Dapr 1.13.5 を使用するには、以下のようにします。

az k8s-extension create --cluster-type managedClusters \
--cluster-name <myAKSCluster> \
--resource-group <myResourceGroup> \
--name dapr \
--extension-type Microsoft.Dapr \
--auto-upgrade-minor-version false \
--version 1.13.5

開始する前に

KubernetesConfiguration リソース プロバイダーを登録する

まだクラスター拡張機能を使用していない場合は、リソース プロバイダーをサブスクリプションに登録することが必要になる場合があります。 プロバイダー登録の状態は、次の例で示すように az provider list コマンドを使用して確認できます。

az provider list --query "[?contains(namespace,'Microsoft.KubernetesConfiguration')]" -o table

"Microsoft.KubernetesConfiguration" プロバイダーが、次の出力例に示すように "Registered" と報告されます。

Namespace                          RegistrationState    RegistrationPolicy
---------------------------------  -------------------  --------------------
Microsoft.KubernetesConfiguration  Registered           RegistrationRequired

プロバイダーが NotRegistered として示される場合は、次の例で示すように az provider register を使用してプロバイダーを登録します。

az provider register --namespace Microsoft.KubernetesConfiguration

Azure サブスクリプションに ExtenstionTypes 機能を登録する

ExtensionTypes 機能を Azure サブスクリプションに登録する必要があります。 ターミナルで、正しいサブスクリプションを使用していることを確認します。

az account set --subscription <YOUR-AZURE-SUBSCRIPTION-ID>

ExtenstionTypes 機能を登録します。

az feature registration create --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

機能の登録には、しばらく時間がかかる場合があります。 数分後、次のコマンドを使用して登録の状態を確認します。

az feature show --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

AKS または Arc 対応 Kubernetes クラスターに Dapr 拡張機能をデプロイする

次の例と同様の Bicep テンプレートを作成して、Dapr 拡張機能を既存のクラスターにデプロイします。

@description('The name of the Managed Cluster resource.')
param clusterName string

resource existingManagedClusters 'Microsoft.ContainerService/managedClusters@2023-05-02-preview' existing = {
  name: clusterName
}

resource daprExtension 'Microsoft.KubernetesConfiguration/extensions@2022-11-01' = {
  name: 'dapr'
  scope: existingManagedClusters
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    autoUpgradeMinorVersion: true
    configurationProtectedSettings: {}
    configurationSettings: {
      'global.clusterType': 'managedclusters'
    }
    extensionType: 'microsoft.dapr'
    releaseTrain: 'stable'
    scope: {
      cluster: {
        releaseNamespace: 'dapr-system'
      }
    }
    version: '1.11.2'
  }
}

以下の変数を設定し、以下の値を実際のリソース グループとクラスター名に変更します。

MY_RESOURCE_GROUP=<myResourceGroup>
MY_AKS_CLUSTER=<myAKSCluster>

az deployment group コマンドを使用して Bicep テンプレートをデプロイします。

az deployment group create \
  --resource-group $MY_RESOURCE_GROUP \
  --template-file ./my-bicep-file-path.bicep \
  --parameters clusterName=$MY_AKS_CLUSTER

Dapr コントロール プレーンへの自動更新の構成

バージョンを指定せずに Dapr をデプロイすると、autoUpgradeMinorVersion が "自動的に有効になり"、新しいリリース時にマイナー バージョンを自動的に更新するように Dapr コントロール プレーンが構成されます。

autoUpgradeMinorVersion パラメーターを指定し、値を false に設定することで、自動更新を無効にできます。

Dapr のバージョン管理は MAJOR.MINOR.PATCH 形式です。つまり、1.11.0 から 1.12.0 は "マイナー" バージョン アップグレードです。

properties {
  autoUpgradeMinorVersion: true
}

特定の Dapr バージョンを対象とする

autoUpgradeMinorVersion を false に、version をインストールする Dapr のバージョンに設定します。 autoUpgradeMinorVersion パラメーターを true に設定し、version パラメーターを省略すると、拡張機能で最新バージョンの Dapr がインストールされます。

たとえば、Dapr 1.11.2 を使用するには、次のようにします。

properties: {
  autoUpgradeMinorVersion: false
  version: '1.11.2'
}

リリース トレーニングの選択

拡張機能を構成するときに、特定のリリース トレインから Dapr をインストールすることを選択できます。 次の 2 つのリリース トレイン値のいずれかを指定します。

次に例を示します。

properties: {
  releaseTrain: 'stable'
}