Installare l'estensione Dapr per il servizio Azure Kubernetes (AKS) e Kubernetes abilitato per Arc

Operazioni preliminari

Aggiungere l'estensione dell'interfaccia della riga di comando di Azure per le estensioni del cluster

Installare l’estensione dell'k8s-extensioninterfaccia della riga di comando di Azure eseguendo questi comandi:

az extension add --name k8s-extension

Se l'estensione k8s-extension è già installata, è possibile aggiornarla alla versione più recente usando il comando seguente:

az extension update --name k8s-extension

Registrare il provider di risorse KubernetesConfiguration

Se non si usano già estensioni del cluster, può essere necessario registrare il provider di risorse con la sottoscrizione. È possibile controllare lo stato di registrazione del provider usando il comando az provider list, come illustrato nell'esempio seguente:

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

Il provider Microsoft.KubernetesConfiguration deve essere contrassegnato come Registrato, come spiegato nell'output di esempio seguente:

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

Se il provider viene visualizzato come NotRegistered, registrare il provider usando az provider register come illustrato nell'esempio seguente:

az provider register --namespace Microsoft.KubernetesConfiguration

Registrare la funzionalità ExtenstionTypes nella sottoscrizione di Azure

La funzionalità ExtensionTypes deve essere registrata nella sottoscrizione di Azure. Nel terminale verificare di essere nella sottoscrizione corretta:

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

Registrare la funzionalità ExtenstionTypes.

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

La registrazione della funzionalità può richiedere del tempo. Dopo alcuni minuti, controllare lo stato della registrazione usando il comando seguente:

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

Creare l'estensione e installare Dapr nel cluster Kubernetes abilitato per Arc o del servizio Azure Kubernetes

Quando si installa l'estensione Dapr, usare il valore del flag corrispondente al tipo di cluster:

• Cluster del servizio Azure Kubernetes: --cluster-type managedClusters.
• Cluster Kubernetes con abilitazione di Arc: --cluster-type connectedClusters.

Creare l'estensione Dapr, che installa Dapr nel cluster Kubernetes abilitato per Il servizio Azure Kubernetes o per Arc.

Ad esempio, installare la versione più recente di Dapr tramite l'estensione Dapr nel cluster del servizio Azure Kubernetes:

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

Mantenere aggiornato il cluster del servizio Azure Kubernetes gestito all'ultima versione

In base all'ambiente (sviluppo, test o produzione), è possibile restare aggiornati alle ultime versioni di Dapr stabili.

Scelta di un training di rilascio

Quando si configura l'estensione, è possibile scegliere di installare Dapr da un particolare treno di rilasci. Specificare uno dei due valori del training della versione:

Ad esempio:

--release-train stable

Configurazione degli aggiornamenti automatici al piano di controllo Dapr

Se si installa Dapr senza specificare una versione, --auto-upgrade-minor-versionviene abilitato automaticamente, configurando il piano di controllo Dapr per aggiornare automaticamente la versione secondaria nelle nuove versioni.

È possibile disabilitare l'aggiornamento automatico specificando il parametro --auto-upgrade-minor-version e impostando il valore su false.

Il controllo delle versioni di Dapr è in MAJOR.MINOR.PATCH formato, il che significa che da 1.11.0 a 1.12.0 è un aggiornamento della versione secondaria.

--auto-upgrade-minor-version true

Visualizzazione delle ultime versioni stabili di Dapr disponibili

Per eseguire l'aggiornamento all'ultima versione di Dapr in un ambiente di produzione, è necessario procedere manualmente. Per iniziare, visualizzare un elenco delle versioni di Dapr stabili disponibili per il cluster del servizio Azure Kubernetes gestito. Esegui questo comando:

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

Per visualizzare l'ultima versione stabile di Dapr disponibile per il cluster del servizio Azure Kubernetes gestito, eseguire il comando seguente:

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

Per visualizzare un elenco delle versioni di Dapr stabili disponibili in base alla posizione:

1. Assicurarsi di aver registrato la funzionalità ExtenstionTypes nella sottoscrizione di Azure.
2. Esegui il comando seguente:

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

Aggiornare quindi manualmente Dapr all'ultima versione stabile.

Destinazione di una versione Dapr specifica

Lo stesso argomento della riga di comando viene usato per installare una versione specifica di Dapr o eseguire il rollback a una versione precedente. Impostare --auto-upgrade-minor-version su false e --version sulla versione di Dapr da installare. Se il parametro version viene omesso, l'estensione installa la versione più recente di Dapr. Ad esempio, per usare 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

Operazioni preliminari

Registrare il provider di risorse KubernetesConfiguration

Se non si usano già estensioni del cluster, può essere necessario registrare il provider di risorse con la sottoscrizione. È possibile controllare lo stato di registrazione del provider usando il comando az provider list, come illustrato nell'esempio seguente:

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

Il provider Microsoft.KubernetesConfiguration deve essere contrassegnato come Registrato, come spiegato nell'output di esempio seguente:

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

Se il provider viene visualizzato come NotRegistered, registrare il provider usando az provider register come illustrato nell'esempio seguente:

az provider register --namespace Microsoft.KubernetesConfiguration

Registrare la funzionalità ExtenstionTypes nella sottoscrizione di Azure

La funzionalità ExtensionTypes deve essere registrata nella sottoscrizione di Azure. Nel terminale verificare di essere nella sottoscrizione corretta:

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

Registrare la funzionalità ExtenstionTypes.

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

La registrazione della funzionalità può richiedere del tempo. Dopo alcuni minuti, controllare lo stato della registrazione usando il comando seguente:

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

Distribuire l'estensione Dapr nel cluster Kubernetes abilitato per Arc o del servizio Azure Kubernetes

Creare un modello Bicep simile all'esempio seguente per distribuire l'estensione Dapr nel cluster esistente.

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

Impostare le variabili seguenti, modificando i valori in base ai nomi effettivi del gruppo di risorse effettivo e del cluster.

MY_RESOURCE_GROUP=<myResourceGroup>
MY_AKS_CLUSTER=<myAKSCluster>

Distribuire il modello Bicep usando il comando az deployment group.

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

Configurazione degli aggiornamenti automatici al piano di controllo Dapr

Se si distribuisce Dapr senza specificare una versione, autoUpgradeMinorVersionviene abilitato automaticamente, configurando il piano di controllo Dapr per aggiornare automaticamente la versione secondaria nelle nuove versioni.

È possibile disabilitare l'aggiornamento automatico specificando il parametro autoUpgradeMinorVersion e impostando il valore su false.

Il controllo delle versioni di Dapr è in MAJOR.MINOR.PATCH formato, il che significa che da 1.11.0 a 1.12.0 è un aggiornamento della versione secondaria.

properties {
  autoUpgradeMinorVersion: true
}

Destinazione di una versione Dapr specifica

Impostare autoUpgradeMinorVersion su false e version sulla versione di Dapr da installare. Se il parametro autoUpgradeMinorVersion è impostato su true e il parametro version è omesso, l'estensione installa l'ultima versione di Dapr.

Ad esempio, per usare Dapr 1.11.2:

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

Scelta di un training di rilascio

Quando si configura l'estensione, è possibile scegliere di installare Dapr da un particolare treno di rilasci. Specificare uno dei due valori del training della versione:

Ad esempio:

properties: {
  releaseTrain: 'stable'
}