Installera AKS-motorn på Linux i Azure Stack Hub

  • Artikel

Du kan använda en Linux-dator i Azure Stack Hub som värd för AKS-motorn för att distribuera och hantera ett Kubernetes-kluster. I den här artikeln tittar vi på hur du förbereder den virtuella klientdatorn för att hantera klustret för både anslutna och frånkopplade Azure Stack Hub-instanser, kontrollerar installationen och konfigurerar den virtuella klientdatorn i ASDK.

Förbereda den virtuella klientdatorn

AKS-motorn är ett kommandoradsverktyg som används för att distribuera och hantera ditt Kubernetes-kluster. Du kan köra motorn på en dator i Azure Stack Hub. Från den här datorn använder du AKS-motorn för att distribuera de IaaS-resurser och den programvara som behövs för att köra klustret. Du kan sedan använda datorn som kör motorn för att utföra hanteringsuppgifter i klustret.

Tänk på följande när du väljer klientdator:

  1. Om klientdatorn ska kunna återställas vid en katastrof.
  2. Hur du ansluter till klientdatorn och hur datorn interagerar med klustret.

Installera i en ansluten miljö

Du kan installera den virtuella klientdatorn för att hantera ditt Kubernetes-kluster på en Azure Stack Hub som är ansluten till Internet.

  1. Skapa en virtuell Linux-dator i Azure Stack Hub. Anvisningar finns i Snabbstart: Skapa en virtuell Linux-serverdator med hjälp av Azure Stack Hub-portalen.

  2. Anslut till den virtuella datorn.

  3. Använd pakethanteraren för att kontrollera att följande verktyg är installerade:

    • jq en JSON-processor.
    • curl – ett verktyg för att överföra filer med hjälp av en mängd olika nätverksprotokoll.
    • openssh en ssh-klient.
    • tar ett verktyg som används för att arbeta med TAR-arkiv.

  4. Installera Azure CLI. Paket för Azure CLI är tillgängliga för de flesta distributioner. Du hittar instruktioner i Installera Azure CLI på Linux.

  5. Hitta versionen av AKS-motorn i tabelltabelltabellen för AKS-motorn och Azure Stack-versionen . AKS-basavbildningen måste vara tillgänglig på Azure Stack Hub Marketplace. När du kör kommandot måste du ange versionen --version v0.xx.x. Om du inte anger versionen installerar kommandot den senaste versionen, som kan behöva en VHD-avbildning som inte är tillgänglig på marknadsplatsen.

    Anteckning

    Du hittar mappningen av Versionsnumret för Azure Stack Hub till AKS-motorn i viktig information om AKS-motorn.

  6. Kör följande kommando:

    För AKS Engine-versionerna 0.73.0 och senare:

    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-versionerna 0.75.3 och senare:

    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

    Anteckning

    Om installationsmetoden misslyckas kan du prova stegen i den frånkopplade miljön.

Installera i en frånkopplad miljö

Du kan installera den virtuella klientdatorn för att hantera ditt Kubernetes-kluster på en Azure Stack Hub frånkopplad från Internet.

  1. Från en dator med åtkomst till Internet:

    För AKS Engine-versionerna 0.73.0 och senare går du till GitHub Azure/aks-engine. Ladda ned ett arkiv (*.tar.gz) för en Linux-dator, aks-engine-v0.xx.x-linux-amd64.tar.gztill exempel .

    För AKS Engine-versionerna 0.75.3 och senare går du till GitHub Azure/aks-engine-azurestack. Ladda ned ett arkiv (*.tar.gz) för en Linux-dator, till exempelaks-engine-azurestack-v0.xx.x-linux-amd64.tar.gz.

    Hitta versionen av AKS-motorn i tabellen Kubernetes-versioner som stöds.

  2. Skapa ett lagringskonto i din Azure Stack Hub-instans för att ladda upp arkivfilen (*.tar.gz) med AKS-motorbinärfilen. Anvisningar om hur du använder Azure Storage Explorer finns i Azure Storage Explorer med Azure Stack Hub.

  3. Skapa en virtuell Linux-dator i Azure Stack Hub. Anvisningar finns i Snabbstart: Skapa en virtuell Linux-serverdator med hjälp av Azure Stack Hub-portalen.

  4. Från blob-URL:en för Azure Stack Hub-lagringskontot där du laddade upp arkivfilen (*.tar.gz) laddar du ned filen till den virtuella hanteringsdatorn. Extrahera arkivet till katalogen /usr/local/bin.

  5. Anslut till den virtuella datorn.

  6. Kör följande kommando:

    För AKS Engine-versionerna 0.73.0 och senare:

    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-versionerna 0.75.3 och senare:

    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

Verifiera installationen

När den virtuella klientdatorn har konfigurerats kontrollerar du att du har installerat AKS-motorn.

  1. Anslut till den virtuella klientdatorn.
  2. Kör följande kommando:

Anteckning

För AKSe version 0.75.3 och senare är aks-engine-azurestack versionkommandot för att kontrollera den aktuella versionen av AKS-motorn .

aks-engine version

  1. Om Azure Resource Manager slutpunkt använder ett självsignerat certifikat måste du uttryckligen lägga till rotcertifikatet i datorns betrodda certifikatarkiv. Du hittar rotcertifikatet på den virtuella datorn i den här katalogen: /var/lib/waagent/Certificates.pem. Kopiera certifikatfilen med följande kommando:

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

Om du inte kan kontrollera att du har installerat AKS-motorn på den virtuella klientdatorn läser du Felsöka aks-motorinstallation

ASDK-installation

Du måste lägga till ett certifikat när du kör den virtuella klientdatorn för AKS-motorn i ASDK:n.

När du använder en ASDK som din Azure-Resource Manager slutpunkt använder ett självsignerat certifikat måste du uttryckligen lägga till det här certifikatet i datorns betrodda certifikatarkiv. Du hittar ASDK-rotcertifikatet på alla virtuella datorer som du distribuerar i ASDK. I en virtuell Ubuntu-dator hittar du den till exempel i den här katalogen /var/lib/waagent/Certificates.pem.

Kopiera certifikatfilen med följande kommando:

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

sudo update-ca-certificates

Nästa steg

Distribuera ett Kubernetes-kluster med AKS-motorn på Azure Stack Hub