De AKS-engine installeren in Linux in Azure Stack Hub

  • Artikel
  • 4 minuten om te lezen

U kunt een Linux-computer in uw Azure Stack Hub de AKS-engine te hosten om een Kubernetes-cluster te implementeren en te beheren. In dit artikel kijken we naar het voorbereiden van de client-VM voor het beheren van uw cluster voor zowel verbonden als niet-verbonden Azure Stack Hub-exemplaren, het controleren van de installatie en het instellen van de client-VM op de ASDK.

De client-VM voorbereiden

De AKS-engine is een opdrachtregelprogramma dat wordt gebruikt voor het implementeren en beheren van uw Kubernetes-cluster. U kunt de engine uitvoeren op een computer in uw Azure Stack Hub. Vanaf deze computer voert u de AKS-engine uit om de IaaS-resources en -software te implementeren die nodig zijn om uw cluster uit te voeren. Vervolgens kunt u de machine met de engine gebruiken om beheertaken uit te voeren op uw cluster.

Wanneer u uw clientmachine kiest, kunt u het volgende overwegen:

  1. Als de clientmachine herstelbaar moet zijn in geval van een noodgeval.
  2. Hoe u verbinding maakt met de clientmachine en hoe de machine met uw cluster communiceert.

Installeren in een verbonden omgeving

U kunt de client-VM installeren om uw Kubernetes-cluster te beheren op een Azure Stack Hub verbonden met internet.

  1. Maak een linux-VM in uw Azure Stack Hub. Zie Quickstart: Create a Linux server VM by using the Azure Stack Hub portal (Snelstart: Een linux-server-VM maken met behulp van Azure Stack Hub portal).

  2. Verbinding maken aan uw VM.

  3. Gebruik pakketbeheer om te controleren of u de volgende hulpprogramma's hebt geïnstalleerd:

    • jq een JSON-processor.
    • curl : een hulpprogramma voor het overdragen van bestanden met behulp van verschillende netwerkprotocollen.
    • openssh een ssh-client.
    • tar een hulpprogramma dat wordt gebruikt om te werken met TAR-archieven.

  4. Installeer Azure CLI. Pakketten voor Azure CLI zijn beschikbaar voor de meeste distributies. U vindt instructies in De Azure CLI installeren op Linux.

  5. Zoek de versie van de AKS-engine in de AKS-engine en Azure Stack tabel met versietoewijzingen . De AKS-basisafbeelding moet beschikbaar zijn in uw Azure Stack Hub Marketplace. Bij het uitvoeren van de opdracht moet u de versie opgeven --version v0.xx.x. Als u de versie niet opgeeft, wordt met de opdracht de nieuwste versie geïnstalleerd. Mogelijk is er een VHD-installatie afbeelding nodig die niet beschikbaar is in uw marketplace.

    Notitie

    U vindt de toewijzing van Azure Stack Hub aan het versienummer van de AKS-engine in de opmerkingen bij de release van de AKS-engine.

  6. Voer de volgende opdracht uit:

    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

    Notitie

    U vindt de toewijzing van Azure Stack Hub aan het versienummer van de AKS-engine in de opmerkingen bij de release van de AKS-engine.

    Notitie

    Als de installatiemethode mislukt, kunt u de stappen in de niet-verbonden omgeving uitvoeren.

Installeren in een niet-verbonden omgeving

U kunt de client-VM installeren om uw Kubernetes-cluster te beheren op een Azure Stack Hub is verbonden met internet.

  1. Ga vanaf een computer met toegang tot internet naar GitHub Azure/aks-engine. Download een archief (*.tar.gz) voor een Linux-machine, bijvoorbeeld aks-engine-v0.xx.x-linux-amd64.tar.gz. Zoek de versie van de AKS-engine in de tabel Ondersteunde Kubernetes-versies.

  2. Maak een opslagaccount in uw Azure Stack Hub om het archiefbestand (*.tar.gz) te uploaden met het binaire bestand van de AKS-engine. Zie Azure Storage Explorer with Azure Stack Hub (Informatie over het gebruik van Azure Storage Explorer met Azure Stack Hub) voor instructies over het gebruik van Azure Stack Hub.

  3. Maak een linux-VM in uw Azure Stack Hub. Zie Quickstart: Create a Linux server VM by using the Azure Stack Hub portal (Snelstart: Een linux-server-VM maken met behulp van Azure Stack Hub portal).

  4. Download het bestand Azure Stack Hub de blob-URL van het opslagaccount waar u het archiefbestand hebt geüpload (*.tar.gz). Extraheerde het archief naar de map /usr/local/bin.

  5. Verbinding maken aan uw VM.

  6. Voer de volgende opdracht uit:

    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

De installatie controleren

Nadat de client-VM is ingesteld, controleert u of u de AKS-engine hebt geïnstalleerd.

  1. Verbinding maken aan uw client-VM.

  2. Voer de volgende opdracht uit:

    aks-engine version

  3. Als Azure Resource Manager eindpunt een zelf-ondertekend certificaat gebruikt, moet u het basiscertificaat expliciet toevoegen aan het vertrouwde certificaatopslag van de computer. U vindt het basiscertificaat in de VM in deze map: /var/lib/waagent/Certificates.pem. Kopieer het certificaatbestand met de volgende opdracht:

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

Zie Problemen met de installatie van de AKS-engine oplossen als u niet kunt controleren of u de AKS-engine op uw client-VM hebt geïnstalleerd

ASDK-installatie

U moet een certificaat toevoegen bij het uitvoeren van de client-VM voor de AKS-engine op de ASDK.

Wanneer u een ASDK gebruikt die Azure Resource Manager eindpunt een zelf-ondertekend certificaat gebruikt, moet u dit certificaat expliciet toevoegen aan het vertrouwde certificaatopslag van de computer. U vindt het ASDK-basiscertificaat in elke VM die u in de ASDK implementeert. In een Ubuntu-VM vindt u deze bijvoorbeeld in deze map /var/lib/waagent/Certificates.pem.

Kopieer het certificaatbestand met de volgende opdracht:

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

sudo update-ca-certificates

Volgende stappen

Een Kubernetes-cluster implementeren met de AKS-engine op Azure Stack Hub