Installation der verwalteten KubeRay-Erweiterung auf Azure Kubernetes Service (AKS) (Vorschau)

Important

AKS-Preview-Funktionen stehen auf Selbstbedienungs- und Opt-in-Basis zur Verfügung. Vorschauversionen werden „im Istzustand“ und „wie verfügbar“ bereitgestellt und sind von den Service Level Agreements und der eingeschränkten Garantie ausgeschlossen. AKS-Vorschauversionen werden teilweise vom Kundensupport auf Grundlage der bestmöglichen Leistung abgedeckt. Daher sind diese Funktionen nicht für die Verwendung in der Produktion vorgesehen. Weitere Informationen finden Sie in den folgenden Supportartikeln:

Die verwaltete KubeRay-Erweiterung für Azure Kubernetes Service (AKS) befindet sich in der Vorschau. Es installiert und verwaltet den KubeRay-Operator und die benutzerdefinierten Ray-Ressourcendefinitionen (CRDs) auf Ihrem Cluster: RayCluster, RayJob, RayCronJob und RayService.

In diesem Artikel erfahren Sie, wie Sie die Erweiterung mithilfe der Azure CLI installieren, überprüfen, aktualisieren und entfernen. Sie verwalten Ihre Ray-Workloads und deren Laufzeitimages separat.

Prerequisites

Limitations

  • Vorhandene Open-Source-Software (OSS) KubeRay-Installationen:Deinstallieren Sie alle vorhandenen selbst gehosteten KubeRay-Operatoren , bevor Sie die verwaltete KubeRay-Erweiterung (microsoft.kuberay) installieren. Eine abgelehnte Installation kann weiterhin Ray CRD-Schemas und die Eigentümerschaft ändern, und das Löschen der fehlgeschlagenen Erweiterung macht diese Änderungen nicht rückgängig. Bewahren Sie CRDs und Workload-Ressourcen auf. Wenn eine Installation bereits fehlgeschlagen ist, befolgen Sie die Anleitungen zur Wiederherstellung , bevor Sie den Vorgang wiederholen.

Vorbereiten der Umgebung

In den folgenden Beispielen wird Bash verwendet. Legen Sie Ihr Abonnement und vorhandene Clusterdetails fest, und melden Sie sich dann an:

SUBSCRIPTION_ID="<subscription-id>"
RESOURCE_GROUP="<existing-resource-group>"
CLUSTER_NAME="<existing-aks-cluster>"
EXTENSION_NAME="kuberay"
RELEASE_TRAIN="preview"

az login
az account set --subscription "$SUBSCRIPTION_ID"

Überprüfen Sie die Kubernetes-Version des Clusters. Vergewissern Sie sich, dass die zurückgegebene Version 1.34 oder höher ist, bevor Sie fortfahren:

az aks show \
  --resource-group "$RESOURCE_GROUP" \
  --name "$CLUSTER_NAME" \
  --query kubernetesVersion \
  --output tsv

Stellen Sie eine Verbindung mit dem Cluster her:

az aks get-credentials \
  --resource-group "$RESOURCE_GROUP" \
  --name "$CLUSTER_NAME"

Installieren oder aktualisieren Sie die CLI-Erweiterung, und registrieren Sie die erforderlichen Ressourcenanbieter:

az extension add --name k8s-extension --upgrade

az provider register --namespace Microsoft.ContainerService --wait
az provider register --namespace Microsoft.KubernetesConfiguration --wait

Überprüfen Sie die installierte CLI-Erweiterungsversion:

az extension show --name k8s-extension --query version --output tsv

Die Installation der CLI-Erweiterung bietet Verwaltungsbefehle; Es installiert KubeRay nicht auf Ihrem Cluster.

Vorhandenen OSS KubeRay-Operator deinstallieren

Überspringen Sie diesen Schritt, wenn Sie keinen selbst gehosteten Operator haben. Sichern Sie andernfalls Workloaddaten und Manifeste, setzen Sie RayCronJob-Zeitpläne aus, und warten Sie, bis die Ausführung von Aufträgen abgeschlossen ist, bevor Sie den Operator entfernen.

Suchen Sie für eine Helm-Installation den Release-Namen und den Namespace:

helm list --all-namespaces

Entfernen Sie nur die Operatorfreigabe, und vergewissern Sie sich, dass die Bereitstellung nicht mehr vorhanden ist:

OSS_RELEASE_NAME="<existing-kuberay-release-name>"
OSS_RELEASE_NAMESPACE="<existing-kuberay-release-namespace>"

helm uninstall "$OSS_RELEASE_NAME" --namespace "$OSS_RELEASE_NAMESPACE"
kubectl get deployments --namespace "$OSS_RELEASE_NAMESPACE"

Überprüfen Sie, ob der beibehaltene Namespace Active anzeigt und jede beibehaltene *.ray.io-CRD True in der Spalte ESTABLISHED anzeigt:

kubectl get namespace "$OSS_RELEASE_NAMESPACE"
kubectl get crds \
  --output='custom-columns=NAME:.metadata.name,ESTABLISHED:.status.conditions[?(@.type=="Established")].status'

Wenn der Namespace beendet wird oder keine Ray-CRD eingerichtet wurde, beheben Sie das Problem, bevor Sie die Erweiterung aktivieren.

Verwenden Sie für andere Installationsmethoden das jeweilige Verfahren zum Entfernen des Operators. Behalten Sie Ray-CRDs und Workload-Ressourcen bei; löschen Sie ihre Namespaces oder CRDs nicht.

Verwaltete KubeRay-Erweiterung installieren

Listen Sie die für Ihren Cluster und den preview Release-Train verfügbaren Erweiterungsversionen auf:

az k8s-extension extension-types list-versions-by-cluster \
  --resource-group "$RESOURCE_GROUP" \
  --cluster-name "$CLUSTER_NAME" \
  --cluster-type managedClusters \
  --extension-type microsoft.kuberay \
  --release-train "$RELEASE_TRAIN" \
  --output table

Vergewissern Sie sich, dass eine kompatible Version zurückgegeben wird. Wenn keine zurückgegeben wird, lesen Sie die Problembehandlung bei der Versionsermittlung der Erweiterung.

Erstellen Sie die Erweiterung mit aktivierten automatischen Upgrades. Der Befehl verwendet die folgenden Werte:

  • --extension-type microsoft.kuberay installiert die verwaltete KubeRay-Erweiterung.
  • --scope cluster installiert die Erweiterung für den gesamten Cluster.
  • --release-namespace kuberay-system legt den Namespace für die kuberay-operator Bereitstellung fest.
  • --release-train "$RELEASE_TRAIN" wählt den preview Release Train aus.
  • --auto-upgrade-minor-version true ermöglicht automatische Upgrades. Geben Sie --version mit dieser Einstellung nicht an.
az k8s-extension create \
  --resource-group "$RESOURCE_GROUP" \
  --cluster-name "$CLUSTER_NAME" \
  --cluster-type managedClusters \
  --name "$EXTENSION_NAME" \
  --extension-type microsoft.kuberay \
  --scope cluster \
  --release-namespace kuberay-system \
  --release-train "$RELEASE_TRAIN" \
  --auto-upgrade-minor-version true

Überprüfen der Erweiterungsinstallation

Überprüfen Sie die installierte Version und den Bereitstellungsstatus:

az k8s-extension show \
  --resource-group "$RESOURCE_GROUP" \
  --cluster-name "$CLUSTER_NAME" \
  --cluster-type managedClusters \
  --name "$EXTENSION_NAME" \
  --query "{name:name,version:currentVersion,provisioningState:provisioningState,extensionState:extensionState}" \
  --output table

Die Installation kann bis zu 15 Minuten dauern. Warten Sie, bis die Befehlsausgabe die folgenden Werte anzeigt, und stellen Sie sicher, dass die Operatorbereitstellung verfügbar ist und die Ray CRDs installiert sind:

  • provisioningState ist Succeeded.
  • extensionState ist Available oder Ready.
kubectl wait \
  --for=condition=Available \
  deployment/kuberay-operator \
  --namespace kuberay-system \
  --timeout=5m

kubectl get crds \
  rayclusters.ray.io \
  raycronjobs.ray.io \
  rayjobs.ray.io \
  rayservices.ray.io \
  --output name

Wenn bereitstellungs- oder Bereitschaftsprüfungen fehlschlagen, lesen Sie die Problembehandlung für die verwaltete KubeRay-Erweiterung.

Aktualisieren der verwalteten KubeRay-Erweiterung

Verwenden Sie den az k8s-extension extension-types list-versions-by-cluster Befehl unter Installieren Sie die verwaltete KubeRay-Erweiterung, um zu überprüfen, welche Versionen für Ihren Cluster verfügbar sind.

Aktivieren Sie in derselben Shellsitzung oder nachdem Sie RESOURCE_GROUP, CLUSTER_NAME, EXTENSION_NAME und RELEASE_TRAIN wie in Vorbereiten Ihrer Umgebung beschrieben neu definiert haben, automatische Upgrades für eine vorhandene Erweiterung:

az k8s-extension update \
  --resource-group "$RESOURCE_GROUP" \
  --cluster-name "$CLUSTER_NAME" \
  --cluster-type managedClusters \
  --name "$EXTENSION_NAME" \
  --release-train "$RELEASE_TRAIN" \
  --auto-upgrade-minor-version true \
  --yes

Geben Sie --version nicht an, wenn automatische Upgrades aktiviert sind. Wiederholen Sie nach dem Update die Überprüfungsschritte , und bestätigen Sie die installierte Version.

Deinstallieren Sie die verwaltete KubeRay-Erweiterung

Bevor Sie die verwaltete KubeRay-Erweiterung entfernen, stellen Sie sicher, dass RESOURCE_GROUP, CLUSTER_NAME und EXTENSION_NAME weiterhin wie in Ihre Umgebung vorbereiten beschrieben festgelegt sind. Überprüfen Sie dann vorhandene Ray-Ressourcen:

kubectl get rayclusters,raycronjobs,rayjobs,rayservices --all-namespaces
  • Halten Sie geplante Aufträge an, lassen Sie laufende Aufträge zu Ende ausführen, und behalten Sie erforderliche Daten und Manifeste bei.
  • Wenn Sie Ray-Workloads löschen möchten, löschen Sie sie, während der Operator noch ausgeführt wird, damit er die Bereinigung abschließen kann.

Entfernen Sie die Erweiterungsinstanz:

az k8s-extension delete \
  --resource-group "$RESOURCE_GROUP" \
  --cluster-name "$CLUSTER_NAME" \
  --cluster-type managedClusters \
  --name "$EXTENSION_NAME" \
  --yes

Important

Durch das Entfernen der Erweiterung bleiben Ray CRDs und Workloads vorhanden, der Operator verwaltet sie jedoch nicht mehr. Löschen Sie CRDs nicht als Abkürzung für die Bereinigung, da dadurch auch ihre benutzerdefinierten Ressourcen gelöscht werden.

Vergewissern Sie sich, dass die kuberay Erweiterung nicht mehr in der Erweiterungsliste angezeigt wird und dass die kuberay-operator Bereitstellung entfernt wurde:

az k8s-extension list \
  --resource-group "$RESOURCE_GROUP" \
  --cluster-name "$CLUSTER_NAME" \
  --cluster-type managedClusters \
  --output table

kubectl get deployments --namespace kuberay-system

Nächste Schritte

  • Zuletzt aktualisiert um