Installieren der AKS-Engine unter Windows in Azure Stack Hub

  • Artikel

Binäre Downloads für die neueste Version der AKS-Engine sind auf Github verfügbar. Laden Sie das Paket für Ihr Betriebssystem herunter, und extrahieren Sie die AKS-Engine-Datei für die AKS-Engine-Versionen 0.73.0 und höher. Extrahieren Sie für AKS Engine-Versionen 0.75.3 und höher die Datei aks-engine-azurestack (und fügen Sie sie optional zur $PATH Umgebungsvariablen für eine bequemere CLI-Verwendung hinzu).

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. Führen Sie auf diesem Computer die AKS-Engine aus, 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 Stellen Sie eine Verbindung mit dem Clientcomputer her, und wie interagiert der Computer mit Ihrem Cluster?

Installieren der AKS-Engine 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 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 an einer Eingabeaufforderung mit erhöhten Rechten aus, und beziehen Sie die Versionsnummer ein:

    Hinweis

    Für AKSe Version 0.75.3 und höher lautet choco install aks-engine-azurestackder Befehl zum Installieren der AKS-Engine .

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

    Hinweis

    Wenn bei dieser Installationsmethode ein Fehler auftritt, können Sie die unten aufgeführten Schritte für eine nicht verbundene Umgebung ausführen.

Installieren der AKS-Engine in einer nicht verbundenen 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:

    Hinweis

    Für AKSe Version 0.75.3 und höher lautet choco install aks-engine-azurestackder Befehl zum Installieren der AKS-Engine .

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

Überprüfen der Installation

Überprüfen Sie nach dem Einrichten Ihrer Client-VM, 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:

    Hinweis

    Für AKSe Version 0.75.3 und höher lautet aks-engine-azurestack versionder Befehl zum Überprüfen der aktuellen Version Ihrer AKS-Engine .

    aks-engine version

Wenn Sie nicht überprüfen können, ob Sie die AKS-Engine auf Ihrer Client-VM installiert haben, lesen Sie Problembehandlung bei der Installation der AKS-Engine.

ASDK-Installation

Sie müssen ein Zertifikat hinzufügen, wenn Sie die Client-VM für die AKS-Engine im ASDK auf einem Computer außerhalb des ASDK ausführen. 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-Clusters mit der AKS-Engine in Azure Stack Hub