Installieren der AKS-Engine unter Linux in Azure Stack Hub

  • Artikel
  • 3 Minuten Lesedauer

Sie können einen Linux-Computer in Ihrer Azure Stack Hub-Instanz zum Hosten der AKS-Engine verwenden, um einen Kubernetes-Cluster bereitzustellen und zu verwalten. In diesem Artikel wird beschrieben, wie Sie die Client-VM für die Verwaltung Ihres Clusters für verbundene und nicht verbundene Azure Stack Hub-Instanzen vorbereiten, die Installation überprüfen und die Client-VM auf dem ASDK einrichten.

Vorbereiten der Client-VM

Die AKS-Engine ist ein Befehlszeilentool, das zum Bereitstellen und Verwalten Ihres Kubernetes-Clusters verwendet wird. Sie können die Engine auf einem Computer in Ihrer Azure Stack Hub-Instanz ausführen. Auf diesem Computer führen Sie die AKS-Engine zum Bereitstellen der IaaS-Ressourcen und Software aus, die für die Ausführung des 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. Ob der Clientcomputer im Notfall wiederherstellbar sein soll.
  2. Wie Sie eine Verbindung mit dem Clientcomputer herstellen werden, und wie der Computer mit Ihrem Cluster interagieren wird.

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 ihrer Azure Stack Hub-Instanz. Anweisungen dazu finden Sie unter Schnellstart: Erstellen eines virtuellen Linux-Server mit dem Azure Stack Hub-Portal.

  2. Stellen Sie eine Verbindung mit Ihrer VM her.

  3. Überprüfen Sie mithilfe Ihres Paket-Managers, ob die folgenden Tools installiert sind:

    • jq: Ein JSON-Prozessor
    • curl: Ein Tool zum Übertragen von Dateien mithilfe verschiedener Netzwerkprotokolle
    • openssh: Ein SSH-Client
    • tar: Ein Tool für die Verwendung mit TAR-Archiven

  4. Installieren Sie Azure CLI. Pakete für die Azure CLI sind für die meisten Distributionen 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, wird mit dem Befehl die neueste Version installiert. Diese erfordert unter Umständen ein VHD-Image, 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:

    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

    Hinweis

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

    Hinweis

    Wenn bei dieser Installationsmethode ein Fehler auftritt, können Sie die Schritte in der getrennten Umgebung ausprobieren.

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. Wechseln Sie von einem Computer mit Internetzugriff zu GitHub Azure/aks-engine. Laden Sie ein Archiv (*.tar.gz) für einen Linux-Computer herunter, z. B. aks-engine-v0.xx.x-linux-amd64.tar.gz. 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 ihrer Azure Stack Hub-Instanz. Anweisungen dazu finden Sie unter Schnellstart: Erstellen eines virtuellen Linux-Server mit dem Azure Stack Hub-Portal.

  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 /usr/local/bin-Verzeichnis.

  5. Stellen Sie eine Verbindung mit Ihrer VM her.

  6. Führen Sie den folgenden Befehl aus:

    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

Überprüfen der Installation

Nachdem die Client-VM eingerichtet ist, überprüfen Sie, ob Sie die AKS-Engine 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 dem vertrauenswürdigen Zertifikatspeicher des Computers hinzufügen. Sie finden das Stammzertifikat auf der VM in diesem Verzeichnis: „/var/lib/waagent/certificates.pem“. Kopieren Sie die Zertifikatsdatei mit folgendem 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 die AKS-Engine auf Ihrer Client-VM installiert haben, finden Sie weitere Informationen unter Problembehandlung bei der AKS-Engine unter Azure Stack.

ASDK-Installation

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

Wenn Sie ein ASDK verwenden und Ihr Azure Resource Manager-Endpunkt ein selbstsigniertes Zertifikat verwendet, 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. Auf einer Ubuntu-VM finden Sie es beispielsweise im Verzeichnis /var/lib/waagent/Certificates.pem.

Kopieren Sie die Zertifikatsdatei mit folgendem Befehl:

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

sudo update-ca-certificates

Nächste Schritte

Bereitstellen eines Kubernetes-Cluster mit der AKS-Engine in Azure Stack Hub