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 サブスクリプションに ExtensionTypes 機能を登録する

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

az account set --subscription <your-azure-subscription-ID>

ExtensionTypes 機能を登録します。

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 <your-AKS-cluster> \
--resource-group <your-resource-group> \
--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 <your-resource-group> --cluster-name <your-AKS-cluster> --cluster-type managedClusters --extension-type microsoft.dapr --release-train stable

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

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

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

1. ExtensionTypes機能が 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 がインストールされます。 次のコマンド例では、AKS クラスターに Dapr バージョンの 1.14.4-msft.10 をインストールします。

az k8s-extension create --cluster-type managedClusters \
--cluster-name <your-AKS-cluster> \
--resource-group <your-resource-group> \
--name dapr \
--extension-type Microsoft.Dapr \
--auto-upgrade-minor-version false \
--version 1.14.4-msft.10

開始する前に

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 サブスクリプションに ExtensionTypes 機能を登録する

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=<your-resource-group>
MY_AKS_CLUSTER=<your-AKS-cluster>

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'
}