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.
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:
- Stellen Sie sicher, dass Sie das Feature
ExtenstionTypes
für Ihr Azure-Abonnement registriert haben. - 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
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
Azure Kubernetes Service