Installieren der Dapr-Erweiterung für Azure Kubernetes Service (AKS) und Kubernetes mit Arc-Unterstützung

Dapr vereinfacht das Erstellen robuster, zustandsloser und zustandsbehafteter Anwendungen, die in der Cloud und am Rand ausgeführt werden und die Vielfalt von Sprachen und Entwickler-Frameworks umfassen. Mit der Sidecar-Architektur von Dapr können Sie Ihre Codeplattform agnostisch halten und gleichzeitig Herausforderungen beim Aufbau von Microservices bewältigen, z. B.:

• Andere Dienste zuverlässig und sicher anrufen
• Erstellen ereignisgesteuerter Apps mit Pub-Sub
• Erstellen von Anwendungen, die über mehrere Clouddienste und Hosts hinweg portierbar sind (z. B. Kubernetes im Vergleich zu einer VM)

Hinweis

Wenn Sie Dapr in einer Kubernetes-Produktionsumgebung installieren möchten, lesen Sie die Dokumentationsseite Dapr-Richtlinien für die Produktionsnutzung.

Funktionsweise

Die Dapr-Erweiterung verwendet die Azure-Befehlszeilenschnittstelle, um die Dapr-Steuerungsebene in Ihrem AKS-Cluster oder Kubernetes-Cluster mit Arc-Unterstützung bereitzustellen, wobei die folgenden Dapr-Dienste erstellt werden:

Dapr-Dienst	BESCHREIBUNG
dapr-operator	Verwaltet Komponentenupdates und Kubernetes-Dienstendpunkte für Dapr (Zustandsspeicher, Pub/Subs usw.).
dapr-sidecar-injector	Fügt Dapr in bereitstellungspods mit Anmerkungen ein und fügt die Umgebungsvariablen DAPR_HTTP_PORT und DAPR_GRPC_PORT hinzu, um benutzerdefinierten Anwendungen die problemlose Kommunikation mit Dapr zu erlauben, ohne Dapr-Portwerte hart codieren zu müssen.
dapr-placement	Wird nur für Akteure verwendet. Erstellt Zuordnungstabellen, die Actor-Instanzen zu Pods zuordnen.
dapr-sentry	Verwaltet mTLS zwischen Diensten und fungiert als Zertifizierungsstelle. Weitere Informationen finden Sie in der Sicherheitsübersicht.

Nachdem Dapr auf Ihrem Cluster installiert wurde, können Sie mit der Entwicklung mithilfe der Dapr-Baustein-APIs beginnen, indem Sie Ihren Bereitstellungen einige Anmerkungen hinzufügen. Eine ausführlichere Übersicht über die Baustein-APIs und deren optimale Verwendung finden Sie in der Übersicht über die Bausteine von Dapr.

Warnung

Wenn Sie Dapr über die Erweiterung für AKS oder Kubernetes mit Arc-Unterstützung installieren, wird empfohlen, die Erweiterung weiterhin anstelle der Dapr-CLI für die zukünftige Verwaltung von Dapr zu verwenden. Das Kombinieren der beiden Tools kann Konflikte verursachen und zu unerwünschtem Verhalten führen.

Voraussetzungen

• Ein Azure-Abonnement. Sie haben keine? Erstellen Sie ein kostenloses Konto.
• Die aktuelle Version der Azure-Befehlszeilenschnittstelle.
• Ein vorhandener AKS-Cluster oder verbundener Arc-fähiger Kubernetes-Cluster.
• Eine Administratorrolle für die rollenbasierte Zugriffssteuerung des Azure Kubernetes Service

Wählen Sie aus, wie Sie die Dapr-Erweiterung installieren, bereitstellen und konfigurieren möchten.

Azure-Befehlszeilenschnittstelle

Voraussetzungen

Hinzufügen der Azure CLI-Erweiterung für Clustererweiterungen

Installieren Sie die Azure CLI-Erweiterung k8s-extension, indem Sie die folgenden Befehle ausführen:

az extension add --name k8s-extension

Wenn die Erweiterung k8s-extension bereits installiert ist, können Sie sie mit dem folgenden Befehl auf die neueste Version aktualisieren:

az extension update --name k8s-extension

Registrieren des Ressourcenanbieters KubernetesConfiguration

Wenn Sie bislang noch keine Clustererweiterungen verwendet haben, müssen Sie den Ressourcenanbieter möglicherweise in Ihrem Abonnement registrieren. Sie können den Status der Anbieterregistrierung mithilfe des Befehls az provider list überprüfen, wie im folgenden Beispiel gezeigt:

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

Der Microsoft.KubernetesConfiguration-Anbieter sollte als Registriert gemeldet werden, wie in der folgenden Beispielausgabe gezeigt:

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

Wenn der Anbieter als Nicht registriert angezeigt wird, registrieren Sie den Anbieter mit dem az provider register, wie im folgenden Beispiel gezeigt:

az provider register --namespace Microsoft.KubernetesConfiguration

Registrieren der ExtenstionTypes-Funktion in Ihrem Azure-Abonnement

Das Feature ExtensionTypes muss für Ihr Azure-Abonnement registriert werden. Überprüfen im Terminal, ob Sie das richtige Abonnement haben:

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

Registrieren Sie das Feature ExtenstionTypes:

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

Die Featureregistrierung kann einige Zeit dauern. Überprüfen Sie nach einigen Minuten den Registrierungsstatus mit dem folgenden Befehl:

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

Erstellen der Erweiterung und Installieren von Dapr auf Ihrem AKS-Cluster oder Arc-fähigen Kubernetes-Cluster

Verwenden Sie bei der Installation der Dapr-Erweiterung den Flagwert, der Ihrem Clustertyp entspricht:

• AKS-Cluster: --cluster-type managedClusters.
• Arc-fähiges Kubernetes-Cluster: --cluster-type connectedClusters.

Hinweis

Wenn Sie Dapr OSS auf Ihrem AKS-Cluster verwenden und die Dapr-Erweiterung für AKS installieren möchten, lesen Sie mehr über wie Sie erfolgreich zur Dapr-Erweiterung migrieren.

Erstellen Sie die Dapr-Erweiterung, die Dapr auf Ihrem AKS-Cluster oder Arc-fähigen Kubernetes-Cluster installiert.

Installieren Sie beispielsweise die neueste Version von Dapr über die Dapr-Erweiterung auf Ihrem AKS-Cluster:

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

Halten Sie Ihren verwalteten AKS-Cluster durch Updates auf der neuesten Version

Basierend auf Ihrer Umgebung (Entwicklungs-, Test- oder Produktionsumgebung) können Sie mit den neuesten stabilen Dapr-Versionen auf dem neuesten Stand bleiben.

Auswählen eines Release Train

Beim Konfigurieren der Erweiterung können Sie sich zur Installation von Dapr aus einem bestimmten Release Train entschließen. Geben Sie einen der beiden Release-Train-Werte an:

Wert	Beschreibung
stable	Standard.
dev	Frühe Releases, die experimentelle Features enthalten können Nicht geeignet für die Produktion.

Zum Beispiel:

--release-train stable

Konfigurieren automatischer Updates für Dapr-Steuerungsebene

Warnung

Das automatische Upgrade eignet sich nicht für Produktionsumgebungen. Aktivieren Sie nur automatische Updates für die Dapr-Steuerungsebene in Entwicklungs- oder Testumgebungen. Erfahren Sie, wie Sie ein manuelles Upgrade auf die neueste Dapr-Version für Produktionsumgebungen durchführen.

Wenn Sie Dapr ohne Angabe einer Version installieren, wird --auto-upgrade-minor-version automatisch aktiviert. Damit wird die Dapr-Steuerungsebene so konfiguriert, dass ihre Nebenversion in neuen Versionen automatisch aktualisiert wird.

Sie können die automatische Aktualisierung deaktivieren, indem Sie den --auto-upgrade-minor-version-Parameter angeben und den Wert auf false festlegen.

Dapr-Versionsverwaltung ist im MAJOR.MINOR.PATCH-Format, was bedeutet, dass es sich bei 1.11.0 auf 1.12.0 um ein kleineres Versionsupgrade handelt.

--auto-upgrade-minor-version true

Anzeigen der neuesten verfügbaren stabilen Dapr-Versionen

In einer Produktionsumgebung muss ein Upgrade auf die neueste Dapr-Version manuell durchgeführt werden. Zeigen Sie zunächst eine Liste der stabilen Dapr-Versionen an, die für Ihren verwalteten AKS-Cluster verfügbar sind. Führen Sie den folgenden Befehl aus:

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

Führen Sie den folgenden Befehl aus, um die neueste stabile Dapr-Version anzuzeigen, die für Ihren verwalteten AKS-Cluster verfügbar ist:

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

So zeigen Sie eine Liste der verfügbaren stabilen Dapr-Versionen nach Speicherort an:

1. Stellen Sie sicher, dass Sie das Feature ExtenstionTypes für Ihr Azure-Abonnement registriert haben.
2. Führen Sie den folgenden Befehl aus.

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

Als Nächstes aktualisieren Sie Dapr manuell auf die neueste stabile Version.

Als Ziel für eine bestimmte Dapr-Version

Hinweis

Dapr wird mit einem rollierendem Fenster unterstützt, das nur die aktuelle und frühere Version enthält. Es liegt in Ihrer operativen Verantwortung, mit diesen unterstützten Versionen auf dem neuesten Stand zu bleiben. Wenn Sie über eine ältere Version von Dapr verfügen, müssen Sie möglicherweise Zwischenupgrades für eine unterstützte Version durchzuführen.

Dasselbe Befehlszeilenargument wird zum Installieren einer bestimmten Dapr-Version oder zum Roll back auf eine frühere Version verwendet. Legen --auto-upgrade-minor-version Sie auf false und --version auf die Version von Dapr fest, die Sie installieren möchten. Wenn der Parameter version weggelassen wird, installiert die Erweiterung die neueste Version von Dapr. So verwenden Sie z. B. 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

Bicep

Voraussetzungen

Registrieren des Ressourcenanbieters KubernetesConfiguration

Wenn Sie bislang noch keine Clustererweiterungen verwendet haben, müssen Sie den Ressourcenanbieter möglicherweise in Ihrem Abonnement registrieren. Sie können den Status der Anbieterregistrierung mithilfe des Befehls az provider list überprüfen, wie im folgenden Beispiel gezeigt:

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

Der Microsoft.KubernetesConfiguration-Anbieter sollte als Registriert gemeldet werden, wie in der folgenden Beispielausgabe gezeigt:

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

Wenn der Anbieter als Nicht registriert angezeigt wird, registrieren Sie den Anbieter mit dem az provider register, wie im folgenden Beispiel gezeigt:

az provider register --namespace Microsoft.KubernetesConfiguration

Registrieren der ExtenstionTypes-Funktion in Ihrem Azure-Abonnement

Das Feature ExtensionTypes muss für Ihr Azure-Abonnement registriert werden. Überprüfen im Terminal, ob Sie das richtige Abonnement haben:

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

Registrieren Sie das Feature ExtenstionTypes:

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

Die Featureregistrierung kann einige Zeit dauern. Überprüfen Sie nach einigen Minuten den Registrierungsstatus mit dem folgenden Befehl:

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

Bereitstellen der Dapr-Erweiterung in Ihrem AKS- oder Arc-fähigen Kubernetes-Cluster

Erstellen Sie eine Bicep-Vorlage ähnlich dem folgenden Beispiel, uns stellen Sie die Dapr-Erweiterung in Ihrem vorhandenen Cluster bereit.

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

Legen Sie die folgenden Variablen fest, wobei Sie die folgenden Werte in die tatsächlichen Namen Ihrer Ressourcengruppen und Cluster ändern.

MY_RESOURCE_GROUP=<myResourceGroup>
MY_AKS_CLUSTER=<myAKSCluster>

Stellen Sie die Bicep-Vorlage mithilfe des Befehls az deployment group bereit.

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

Konfigurieren automatischer Updates für Dapr-Steuerungsebene

Warnung

Sie können automatische Updates für die Dapr-Steuerungsebene nur in Entwicklungs- oder Testumgebungen aktivieren. Das automatische Upgrade eignet sich nicht für Produktionsumgebungen.

Wenn Sie Dapr ohne Angabe einer Version bereitstellen, wird autoUpgradeMinorVersion automatisch aktiviert. Damit wird die Dapr-Steuerungsebene so konfiguriert, dass ihre Nebenversion in neuen Versionen automatisch aktualisiert wird.

Sie können die automatische Aktualisierung deaktivieren, indem Sie den autoUpgradeMinorVersion-Parameter angeben und den Wert auf false festlegen.

Dapr-Versionsverwaltung ist im MAJOR.MINOR.PATCH-Format, was bedeutet, dass es sich bei 1.11.0 auf 1.12.0 um ein kleineres Versionsupgrade handelt.

properties {
  autoUpgradeMinorVersion: true
}

Als Ziel für eine bestimmte Dapr-Version

Hinweis

Dapr wird mit einem rollierendem Fenster unterstützt, das nur die aktuelle und frühere Version enthält. Es liegt in Ihrer operativen Verantwortung, mit diesen unterstützten Versionen auf dem neuesten Stand zu bleiben. Wenn Sie über eine ältere Version von Dapr verfügen, müssen Sie möglicherweise Zwischenupgrades für eine unterstützte Version durchzuführen.

Legen autoUpgradeMinorVersion Sie auf false und version auf die Version von Dapr fest, die Sie installieren möchten. Wenn der autoUpgradeMinorVersion-Parameter auf true festgelegt und der version-Parameter ausgelassen wird, installiert die Erweiterung die neueste Version von Dapr.

So verwenden Sie z. B. Dapr 1.11.2

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

Auswählen eines Release Train

Beim Konfigurieren der Erweiterung können Sie sich zur Installation von Dapr aus einem bestimmten Release Train entschließen. Geben Sie einen der beiden Release-Train-Werte an:

Wert	Beschreibung
stable	Standard.
dev	Frühe Releases, die experimentelle Features enthalten können Nicht geeignet für die Produktion.

Beispiel:

properties: {
  releaseTrain: 'stable'
}

Problembehandlung bei Erweiterungsfehlern

Wenn die Erweiterung nicht erstellt oder aktualisiert werden kann, versuchen Sie Vorschläge und Lösungen im Dapr-Erweiterungshandbuch zur Problembehandlung.

Behandlung von Problemen mit Dapr

Sie können Dapr-Fehler anhand des Lösungsleitfadens für gängige Dapr-Probleme behandeln.

Entfernen der Erweiterung

Wenn Sie die Erweiterung löschen und Dapr aus Ihrem AKS-Cluster entfernen müssen, können Sie den folgenden Befehl verwenden:

az k8s-extension delete --resource-group <myResourceGroup> --cluster-name <myAKSCluster> --cluster-type managedClusters --name dapr

Sie können auch die Bicep-Vorlage entfernen.

Nächste Schritte

Konfigurieren der Dapr-Erweiterung für Ihr spezifisches Szenario