Installieren des AKS-Moduls unter Linux im Azure Stack Hub

Sie können einen Linux-Computer in Ihrem Azure Stack Hub zum Hosten des AKS-Moduls verwenden, um einen Kubernetes-Cluster bereitzustellen und zu verwalten. In diesem Artikel befassen wir uns mit der Vorbereitung der Client-VM zur Verwaltung Ihres Clusters für verbundene und getrennte Azure Stack Hub-Instanzen, der Überprüfung der Installation und dem Einrichten der Client-VM auf dem ASDK.

Vorbereiten der Client-VM

Das AKS Engine ist ein Kommandozeilen-Tool zum Bereitstellen und Verwalten Ihres Kubernetes-Clusters. Sie können die Engine auf einem Computer in Ihrer Azure Stack Hub-Instanz ausführen. Von diesem Computer aus verwenden Sie das AKS-Modul, um die IaaS-Ressourcen und -Software bereitzustellen, die zum Ausführen ihres Clusters erforderlich sind. Anschließend können Sie den Computer, auf dem die Engine ausgeführt wird, zum Ausführen von Verwaltungsaufgaben auf Ihrem Cluster verwenden.

Wenn Sie Ihren Clientcomputer auswählen, sollten Sie Folgendes beachten:

1. Gibt an, ob der Clientcomputer in einem Notfall wiederhergestellt werden kann.
2. Wie Sie eine Verbindung mit dem Clientcomputer herstellen und wie der Computer mit Ihrem Cluster interagiert.

Installieren in einer verbundenen Umgebung

Sie können die Client-VM installieren, um Ihren Kubernetes-Cluster in einer mit dem Internet verbundenen Azure Stack Hub-Instanz zu verwalten.

1. Erstellen Sie eine Linux-VM in Ihrem Azure Stack Hub. Anweisungen finden Sie in der Schnellstartanleitung: Erstellen eines virtuellen Linux-Servers mithilfe des Azure Stack Hub-Portals.

2. Stellen Sie eine Verbindung mit Ihrer VM her.

3. Verwenden Sie den Paket-Manager, um zu überprüfen, ob die folgenden Tools installiert sind:

   • jq ein JSON-Prozessor.
   • curl - ein Tool zum Übertragen von Dateien mithilfe einer Vielzahl von Netzwerkprotokollen.
   • openssh ein SSH-Client.
   • tar ein Tool, das für die Arbeit mit TAR-Archiven verwendet wird.

4. Installieren Sie die Azure-Befehlszeilenschnittstelle. Pakete für Azure CLI sind für die meisten Verteilungen verfügbar. Anweisungen finden Sie unter Installieren der Azure CLI unter Linux.

5. Suchen Sie in der Tabelle Versionszuordnung für AKS-Engine und Azure Stack nach der Version der AKS-Engine. Das AKS-Basisimage muss in Ihrem Azure Stack Hub Marketplace verfügbar sein. Beim Ausführen des Befehls müssen Sie die Version --version v0.xx.x angeben. Wenn Sie die Version nicht angeben, installiert der Befehl die neueste Version, die möglicherweise ein VHD-Image benötigt, das in Ihrem Marketplace nicht verfügbar ist.

   Hinweis

   Die Zuordnung von Azure Stack Hub zur AKS-Engine-Versionsnummer finden Sie in den Anmerkungen zur Version der AKS-Engine.

6. Führen Sie den folgenden Befehl aus:

   Für AKS Engine-Versionen 0.73.0 und unten:

   sudo apt update
   sudo apt install jq
   curl -o get-akse.sh https://raw.githubusercontent.com/Azure/aks-engine/master/scripts/get-akse.sh
   chmod 700 get-akse.sh
   ./get-akse.sh --version v0.xx.x
   

   Für AKS Engine-Versionen 0.75.3 und höher:

   sudo apt update
   sudo apt install jq
   curl -o get-akse.sh https://raw.githubusercontent.com/Azure/aks-engine-azurestack/master/scripts/get-akse.sh
   chmod 700 get-akse.sh
   ./get-akse.sh --version v0.xx.x
   

   Hinweis

   Wenn die Installationsmethode fehlschlägt, probieren Sie die Schritte in der getrennten Umgebung aus.

Installieren in einer getrennten Umgebung

Sie können die Client-VM installieren, um Ihren Kubernetes-Cluster in einer Azure Stack Hub-Instanz zu verwalten, die vom Internet getrennt ist.

1. Von einem Computer mit Zugriff auf das Internet:

   Wechseln Sie für die AKS Engine-Versionen 0.73.0 und unten zu GitHub Azure/aks-Engine. Laden Sie ein Archiv (*.tar.gz) für einen Linux-Computer herunter, zum Beispiel aks-engine-v0.xx.x-linux-amd64.tar.gz.

   Wechseln Sie für die AKS Engine-Versionen 0.75.3 und höher zu GitHub Azure/aks-engine-azurestack. Laden Sie beispielsweiseaks-engine-azurestack-v0.xx.x-linux-amd64.tar.gz ein Archiv (*.tar.gz) für einen Linux-Computer herunter.

   Suchen Sie in der Tabelle Unterstützte Kubernetes-Versionen nach der Version der AKS-Engine.

2. Erstellen Sie ein Speicherkonto in ihrer Azure Stack Hub-Instanz, um die Archivdatei (*.tar.gz) mit der AKS-Engine-Binärdatei hochzuladen. Anweisungen zur Verwendung von Azure Storage-Explorer finden Sie unter Herstellen einer Verbindung von Storage-Explorer mit einem Azure Stack-Abonnement oder -Speicherkonto.

3. Erstellen Sie eine Linux-VM in Ihrem Azure Stack Hub. Anweisungen finden Sie in der Schnellstartanleitung: Erstellen eines virtuellen Linux-Servers mithilfe des Azure Stack Hub-Portals.

4. Laden Sie die Datei von der Blob-URL des Azure Stack Hub-Speicherkontos, wo Sie die Archivdatei (*.tar.gz) hochgeladen haben, auf Ihre Verwaltungs-VM herunter. Extrahieren Sie das Archiv in das Verzeichnis /usr/local/bin.

5. Stellen Sie eine Verbindung mit Ihrer VM her.

6. Führen Sie den folgenden Befehl aus:

   Für AKS Engine-Versionen 0.73.0 und unten:

   curl -o aks-engine-v0.xx.x-linux-amd64.tar.gz <httpurl/aks-engine-v0.xx.x-linux-amd64.tar.gz>
   tar xvzf aks-engine-v0.xx.x-linux-amd64.tar.gz -C /usr/local/bin
   

   Für AKS Engine-Versionen 0.75.3 und höher:

   curl -o aks-engine-azurestack-v0.xx.x-linux-amd64.tar.gz <httpurl/aks-engine-azurestack-v0.xx.x-linux-amd64.tar.gz>
   tar xvzf aks-engine-azurestack-v0.xx.x-linux-amd64.tar.gz -C /usr/local/bin
   

Überprüfen der Installation

Überprüfen Sie nach der Einrichtung des virtuellen Clientcomputers, ob Sie das AKS-Modul installiert haben.

1. Stellen Sie eine Verbindung mit Ihrer Client-VM her.
2. Führen Sie den folgenden Befehl aus:

aks-engine version

3. Wenn der Azure Resource Manager-Endpunkt ein selbstsigniertes Zertifikat verwendet, müssen Sie das Stammzertifikat explizit zum vertrauenswürdigen Zertifikatspeicher des Computers hinzufügen. Sie finden das Stammzertifikat in der VM in diesem Verzeichnis: /var/lib/waagent/Certificates.pem. Kopieren Sie die Zertifikatdatei mit dem folgenden Befehl:

   sudo cp /var/lib/waagent/Certificates.pem /usr/local/share/ca-certificates/azurestackca.crt 
   sudo update-ca-certificates
   

Wenn Sie nicht überprüfen können, ob Sie das AKS-Modul auf Ihrem virtuellen Clientcomputer installiert haben, lesen Sie die Problembehandlung bei der Installation des AKS-Moduls.

ASDK-Installation

Sie müssen ein Zertifikat hinzufügen, wenn Sie die Client-VM für das AKS-Modul auf dem ASDK ausführen.

Wenn Sie einen ASDK verwenden, verwendet Ihr Azure Resource Manager-Endpunkt ein selbstsigniertes Zertifikat, müssen Sie dieses Zertifikat explizit dem vertrauenswürdigen Zertifikatspeicher des Computers hinzufügen. Sie finden das ASDK-Stammzertifikat auf jedem virtuellen Computer, den Sie im ASDK bereitstellen. In einer Ubuntu-VM finden Sie ihn z. B. in diesem Verzeichnis /var/lib/waagent/Certificates.pem.

Kopieren Sie die Zertifikatdatei mit dem folgenden Befehl:

sudo cp /var/lib/waagent/Certificates.pem /usr/local/share/ca-certificates/azurestackca.crt

sudo update-ca-certificates

Nächste Schritte