Installieren der AKS-Engine unter Windows in Azure Stack Hub

  • Artikel
  • 4 Minuten Lesedauer

Sie können einen Windows-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 unter Azure Stack Hub eine Windows-VM. Anweisungen dazu finden Sie unter Schnellstart: Erstellen eines virtuellen Windows Server-Computers mit dem Azure Stack Hub-Portal.

  2. Stellen Sie eine Verbindung mit Ihrer VM her.

  3. Installieren Sie Chocolatey mithilfe der PowerShell-Anweisungen.

    Gemäß der Chocolatey-Website: Chocolatey ist ein Paket-Manager wie z. B. apt-get oder yum, aber für Windows. Er wurde als dezentralisiertes Framework für die schnelle Installation von Anwendungen und Tools konzipiert, die Sie benötigen. Er basiert auf der NuGet-Infrastruktur und verwendet derzeit schwerpunktmäßig PowerShell zur Bereitstellung von Paketen aus den Distributionen für Ihren Computer.

  4. Installieren Sie die Azure-Befehlszeilenschnittstelle. Wählen Sie den Downloadlink und dann Ausführen aus. Wählen Sie die erforderlichen Setupschritte aus.

  5. Suchen Sie in der Tabelle Versionszuordnung für AKS-Engine und Azure Stack nach der Version der AKS-Engine. Die AKS-Basis-Engine 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 erfordert, 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 an einer Eingabeaufforderung mit erhöhten Rechten aus, und beziehen Sie die Versionsnummer ein:

        choco install aks-engine --version 0.xx.x -y

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 Windows-Computer herunter, z. B. aks-engine-v0.xx.x-windows-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 unter Azure Stack Hub eine Windows-VM. Anweisungen dazu finden Sie unter Schnellstart: Erstellen eines virtuellen Windows Server-Computers 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 ein Verzeichnis, auf das Sie über die Eingabeaufforderung zugreifen können.

  5. Stellen Sie eine Verbindung mit Ihrer VM her.

  6. Installieren Sie Chocolatey mithilfe der PowerShell-Anweisungen.

  7. Führen Sie den folgenden Befehl in einer Eingabeaufforderung mit erhöhten Rechten aus. Beziehen Sie die richtige Versionsnummer ein:

        choco install aks-engine --version 0.xx.x -y

Ü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

Wenn Sie nicht überprüfen können, ob die AKS-Engine auf der Client-VM installiert ist, 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 auf einem außerhalb des ASDK befindlichen Computer ausführen, müssen Sie ein Zertifikat hinzufügen. Wenn Sie eine Windows-VM in der ASDK-Umgebung selbst verwenden, vertraut der Computer bereits dem ASDK-Zertifikat. Wenn sich der Clientcomputer außerhalb des ASDK befindet, müssen Sie das Zertifikat aus dem ASDK extrahieren und dem Windows-Computer 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.

  1. Exportieren Sie das Zertifizierungsstellen-Stammzertifikat. Anweisungen finden Sie unter Exportieren des Azure Stack Hub-Zertifizierungsstellen-Stammzertifikats.
  2. Stufen Sie das Zertifizierungsstellen-Stammzertifikat für Azure Stack Hub als vertrauenswürdig ein. Anweisungen finden Sie unter Einstufen des Zertifizierungsstellen-Stammzertifikats für Azure Stack Hub als vertrauenswürdig.

Nächste Schritte

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