Konfigurera förutsättningarna för AKS-motorn på Azure Stack Hub

Du kan installera AKS-motorn på en virtuell dator (VM) i din miljö eller en klientdator med åtkomst till din Azure Stack Hub-Resource Manager slutpunkt. Ha följande saker på plats innan du kör motorn: ett anpassat skripttillägg för AKS Base Ubuntu och ett anpassat Linux-skript som är tillgängligt i din prenumeration, en tjänsthuvudnamnsidentitet som har tilldelats till en deltagarroll och ett privat/offentligt nyckelpar för SSH-åtkomst till Ubuntu-servern. Om du använder Azure Stack Development Kit måste du dessutom ha datorns förtroende för lämpliga certifikat.

Om du har dina förutsättningar kan du börja definiera klustret.

Om du är molnoperatör för Azure Stack Hub och vill erbjuda AKS-motorn följer du anvisningarna i Lägg till AKS-motor på Azure Stack Hub Marketplace.

Krav för AKS-motorn

Om du vill använda AKS-motorn måste du ha följande resurser tillgängliga. Tänk på att AKS-motorn är avsedd att användas av klientorganisationer i Azure Stack Hub för att distribuera Kubernetes-kluster till klientprenumerationen. Den enda delen där azure stack hub-operatören kan krävas är för att ladda ned Marketplace-objekt och skapa en identitet för tjänstens huvudnamn. Du hittar information i följande tabell.

Molnoperatören måste ha följande objekt på plats.

Förutsättning	Description	Krävs	Instruktioner
Azure Stack Hub 1910 eller senare	AKS-motorn kräver Azure Stack Hub 1910 eller senare.	Obligatorisk	Om du är osäker på din version av Azure Stack Hub kontaktar du molnoperatören.
Tillägg för anpassat Linux-skript	Tillägg för anpassat Linux-skript 2.0 Erbjudande: Anpassat skript för Linux 2.0 Version: 2.0.6 (eller den senaste versionen) Utgivare: Microsoft Corp	Obligatorisk	Om du inte har det här objektet i din prenumeration kontaktar du molnoperatören.
AKS-basavbildningar	AKS Base Ubuntu och Windows Image Mer information om versionsberoendet finns i Matchande motor till basavbildningsversion	Obligatorisk	Om du inte har det här objektet i din prenumeration kontaktar du molnoperatören. Om du är molnoperatör för Azure Stack Hub och vill erbjuda AKS-motorn följer du anvisningarna i Lägg till AKS-motor på Azure Stack Hub Marketplace.
Tjänstens huvudnamnsidentitet (SPN)	Ett program som behöver distribuera eller konfigurera resurser via Azure Resource Manager måste representeras av ett huvudnamn för tjänsten.	Obligatorisk	Du kan behöva kontakta din Azure Stack Hub-molnoperatör för att få ett SPN och en aktuell hemlighet. Om en Microsoft Entra tjänsthuvudnamnsidentitet används krävs Internetåtkomst från de virtuella datorerna i Kubernetes-klustret så att tjänstens huvudnamn kan autentisera med Microsoft Entra-ID. Du behöver också en aktiv hemlighet. När hemligheten upphör att gälla fungerar inte klustret. Om din miljö inte har Internetåtkomst fungerar inte Kubernetes-klustret. Anvisningar finns i Använda en appidentitet för att komma åt resurser
(SPN) tilldelad deltagarroll	Om du vill tillåta att ett program får åtkomst till resurser i din prenumeration med hjälp av tjänstens huvudnamn måste du tilldela tjänstens huvudnamn till en roll för en specifik resurs.	Obligatorisk	Anvisningar finns i Tilldela en roll

Du kan ange följande objekt.

Förutsättning	Description	Krävs	Instruktioner
Azure Stack Hub-prenumeration	Du får åtkomst till erbjudanden i din Azure Stack Hub via prenumerationer. Erbjudandet innehåller de tjänster som är tillgängliga för dig.	Obligatorisk	För att kunna distribuera klientarbetsbelastningar i Azure Stack Hub måste du först skaffa en Azure Stack Hub-prenumeration.
Resursgrupp	En resursgrupp är en container som innehåller relaterade resurser för en Azure-lösning. Om du inte anger en befintlig resursgrupp skapar verktyget en åt dig.	Valfritt	Hantera Azure Resource Manager resursgrupper med hjälp av Azure Portal
Privat offentlig nyckel	Om du vill använda en öppen SSH-anslutning från utvecklingsdatorn till den virtuella serverdatorn i din Azure Stack Hub-instans som är värd för din webbapp måste du skapa ett offentligt och privat SSH-nyckelpar (Secure Shell).	Obligatorisk	Anvisningar om hur du genererar en nyckel finns i SSH-nyckelgenerering.

Anteckning

Du kan också skapa förutsättningarna för AKS-motorn med Azure CLI för Azure Stack Hub eller Azure Stack Hub PowerShell.

Matcha motor med basavbildningsversion

AKS-motorn distribuerar ett anpassat Ubuntu Server-operativsystem till varje klusternodavbildning, AKS Base Ubuntu och Windows Image Distro. Alla AKS-motorversioner är beroende av en specifik avbildningsversion som gjorts tillgänglig i din Azure Stack Hub av din Azure Stack Hub-operatör. Du hittar en tabell med AKS-motorversionerna och motsvarande Kubernetes-versioner som stöds i Kubernetes-versioner som stöds. AKS-motorns version v0.55.0 beror till exempel på versionen 2020.08.24 av AKS Base Ubuntu och Windows Image Distro. Be din Azure Stack Hub-operatör att ladda ned den specifika avbildningsversionen från Azure Marketplace till Azure Stack Hub Marketplace.

Du utlöser ett fel om avbildningen inte är tillgänglig på Azure Stack Hub Marketplace. Om du till exempel använder AKS-motorversion v0.55.0 och AKS Base Ubuntu och Windows Image Distro-versionen 2020.08.24 inte är tillgänglig visas följande fel när du kör AKS-motorn:

The platform image 'microsoft-aks:aks:aks-ubuntu-1604-202003:2020.08.24' is not available. 
Verify that all fields in the storage profile are correct.

Du kan kontrollera den aktuella versionen av AKS-motorn genom att köra 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
Version: v0.55.0
GitCommit: 44a35c00c
GitTreeState: clean

Nästa steg

Distribuera AKS-motorn i Windows i Azure Stack Hub
Distribuera AKS-motorn i Linux i Azure Stack Hub