Schnellstart: Bereitstellen eines Kubernetes-Clusters mithilfe einer Azure Resource Manager-Vorlage

Gilt für: Azure Local, Version 23H2

In dieser Schnellstartanleitung wird gezeigt, wie Sie einen Kubernetes-Cluster in AKS Arc mithilfe einer Azure Resource Manager (ARM)-Vorlage bereitstellen. Azure Arc erweitert Azure-Verwaltungsfunktionen auf Kubernetes-Cluster überall und bietet einen einheitlichen Ansatz für die Verwaltung verschiedener Umgebungen.

Voraussetzungen

Für diesen Artikel werden Grundkenntnisse in Bezug auf die Kubernetes-Konzepte vorausgesetzt.

Zum Bereitstellen einer ARM-Vorlage benötigen Sie Schreibzugriff auf die Ressourcen, die Sie bereitstellen, und Zugriff auf alle Vorgänge für den Ressourcentyp Microsoft.Resources/deployments. Um beispielsweise einen virtuellen Computer bereitzustellen, benötigen Sie Microsoft.Compute/virtualMachines/write und Microsoft.Resources/deployments/* Berechtigungen. Eine Liste der Rollen und Berechtigungen finden Sie unter Integrierte Azure-Rollen.

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement.
• Ein azure Local, Version 23H2-Cluster.
• Die neueste Azure CLI-Version.

Schritt 1: Vorbereiten Ihres Azure-Kontos

1. Melden Sie sich bei Azure an: Öffnen Sie Ihr Terminal oder ihre Eingabeaufforderung, und melden Sie sich mit der Azure CLI bei Ihrem Azure-Konto an:

   az login
   

2. Legen Sie Ihr Abonnement fest: Ersetzen Sie <your-subscription-id> das Abonnement durch Ihre Abonnement-ID:

   az account set --subscription "<your-subscription-id>"
   

Schritt 2: Erstellen eines SSH-Schlüsselpaars mit Azure CLI

az sshkey create --name "mySSHKey" --resource-group "myResourceGroup"

oder erstellen Sie ein SSH-Schlüsselpaar mit ssh-keygen:

ssh-keygen -t rsa -b 4096

Um die Vorlage bereitzustellen, müssen Sie den öffentlichen Schlüssel aus dem SSH-Paar bereitstellen. Um den öffentlichen Schlüssel abzurufen, verwenden Sie den az sshkey show Befehl:

az sshkey show --name "mySSHKey" --resource-group "myResourceGroup" --query "publicKey"

Die SSH-Schlüsseldateien werden standardmäßig im Verzeichnis ~/.ssh erstellt. Führen Sie den az sshkey create Befehl aus ssh-keygen , um ein vorhandenes SSH-Schlüsselpaar mit demselben Namen zu überschreiben.

Weitere Informationen zum Erstellen von SSH-Schlüsseln finden Sie unter Erstellen und Verwalten von SSH-Schlüsseln für die Authentifizierung in Azure.

Schritt 3: Überprüfen der Vorlage

Laden Sie die Vorlagen- und Parameterdateien aus dem AKSArc-Repository auf Ihren lokalen Computer herunter. Überprüfen Sie alle Standardwerte, und stellen Sie sicher, dass sie korrekt sind.

Schritt 4: Bereitstellen der Vorlage

Führen Sie zum Bereitstellen des Kubernetes-Clusters den folgenden Befehl aus:

az deployment group create \
--name "<deployment-name>" \
--resource-group "<resource-group-name>" \
--template-file "azuredeploy.json" \
--parameters "azuredeploy.parameters.json"

Die Erstellung des Clusters dauert einige Minuten. Warten Sie, bis der Cluster erfolgreich bereitgestellt wurde, bevor Sie mit dem nächsten Schritt fortfahren.

Schritt 5: Überprüfen der Bereitstellung

Nachdem die Bereitstellung abgeschlossen ist, verwenden Sie den folgenden Befehl, um zu überprüfen, ob Ihr Kubernetes-Cluster ausgeführt wird:

az aksarc show --resource-group "<resource-group-name>" --name "<cluster-name>" --output table

Schritt 6: Herstellen einer Verbindung mit dem Cluster

1. Führen Sie den az connectedk8s proxy Befehl aus, um eine Verbindung mit dem Cluster herzustellen. Der Befehl lädt eine Proxy-Binärdatei auf dem Clientcomputer herunter und führt sie aus und ruft eine kubeconfig-Datei ab, die dem Cluster zugeordnet ist:

   az connectedk8s proxy --name <cluster name> -g <resource group>
   

   Oder verwenden Sie den Kubernetes-Befehlszeilenclient kubectl. Wenn Sie Azure Cloud Shell verwenden, ist kubectl bereits installiert. Um Kubectl lokal zu installieren und auszuführen, führen Sie den az aksarc install-cli Befehl aus.

   Konfigurieren Sie kubectl , um mithilfe des az aksarc get-credentials Befehls eine Verbindung mit Ihrem Kubernetes-Cluster herzustellen. Mit diesem Befehl werden die Anmeldeinformationen heruntergeladen, und die Kubernetes-Befehlszeilenschnittstelle wird für deren Verwendung konfiguriert:

   az aksarc get-credentials --resource-group "<resource-group-name>" --name "<cluster-name>"
   

2. Überprüfen Sie die Verbindung mit dem Cluster mithilfe des Befehls kubectl get. Dieser Befehl gibt eine Liste der Clusterknoten zurück:

   kubectl get nodes -A --kubeconfig .\<path to kubecofig> 
   

   Die folgende Beispielausgabe zeigt die drei in den vorherigen Schritten erstellten Knoten. Stellen Sie sicher, dass der Knotenstatus Bereit lautet:

   NAME                                STATUS   ROLES   AGE   VERSION
   aks-agentpool-27442051-vmss000000   Ready    agent   10m   v1.27.7
   aks-agentpool-27442051-vmss000001   Ready    agent   10m   v1.27.7
   aks-agentpool-27442051-vmss000002   Ready    agent   11m   v1.27.7
   

Schritt 7: Bereitstellen des Knotenpools mithilfe einer Azure Resource Manager-Vorlage (optional)

Ähnlich wie in Schritt 3, laden Sie die Vorlage des Knotenpools und die Parameter aus dem AKSArc-Repository herunter, und überprüfen Sie die Standardwerte.

Bereitstellen der Vorlage und Überprüfen von Ergebnissen mithilfe der Azure CLI (optional)

Überprüfen sie die Vorlage, und wenden Sie sie an. Dieser Vorgang dauert einige Minuten. Sie können die Azure CLI verwenden, um zu überprüfen, ob der Knotenpool erfolgreich erstellt wird:

az deployment group create \
--name "<deployment-name>" \
--resource-group "<resource-group-name>" \
--template-file "azuredeploy.json" \
--parameters "azuredeploy.parameters.json"

az aksarc nodepool show --cluster-name "<cluster-name>" --resource-group "<resource-group-name>" --name "<nodepool-name>"

Vorlagenressourcen

connectedClusters

ProvisionedClusterInstances

ExtendedLocation

Nächste Schritte

Übersicht über AKS Arc