Aggiungere i prerequisiti del motore di Azure Kubernetes Services (AKS) al Marketplace di hub Azure StackAdd the Azure Kubernetes Services (AKS) engine prerequisites to the Azure Stack Hub Marketplace

È possibile configurare il motore di Azure Kubernetes Services (AKS) per gli utenti.You can set up the Azure Kubernetes Services (AKS) Engine for your users. Aggiungere gli elementi descritti in questo articolo all'hub Azure Stack.Add the items described in this article to your Azure Stack Hub. Gli utenti possono quindi distribuire un cluster Kubernetes in un'unica operazione coordinata.Your users can then deploy a Kubernetes cluster in a single, coordinated operation. Questo articolo illustra i passaggi necessari per rendere disponibile il motore AKS per gli utenti in ambienti connessi e disconnessi.This article walks you through the steps you need to make the AKS engine available to your users in both connected and disconnected environments. Il motore AKS dipende da un'identità del principio di servizio e nel Marketplace, un'estensione di script personalizzata e l'immagine di base AKS.The AKS engine depends on a service principle identity, and in the marketplace, a Custom Script extension and the AKS Base Image. Il motore AKS richiede che sia in esecuzione Azure stack Hub 1910 o versione successiva.The AKS engine requires that you're running Azure Stack Hub 1910 or greater.

Nota

È possibile trovare il mapping di Azure Stack Hub al numero di versione del motore AKS nelle note sulla versione del motore AKS.You can find the mapping of Azure Stack Hub to AKS engine version number in the AKS engine release notes.

Controllare l'offerta di servizio dell'utenteCheck your user's service offering

Gli utenti dovranno disporre di un piano, un'offerta e una sottoscrizione per Azure Stack Hub con spazio sufficiente.Your users will need a plan, offer, and subscription to Azure Stack Hub with enough space. Spesso gli utenti vogliono distribuire cluster di un massimo di sei macchine virtuali, costituito da tre master e tre nodi di lavoro.Users will often want to deploy clusters of up to six virtual machines, made of three masters and three worker nodes. È necessario assicurarsi che dispongano di una quota sufficientemente grande.You will want to make sure they have a large enough quota.

Se sono necessarie altre informazioni sulla pianificazione e sulla configurazione di un'offerta di servizio, vedere Panoramica dell'offerta di servizi nell'Hub Azure stackIf you need more information about planning and setting up a service offering, see Overview of offering services in Azure Stack Hub

Creare un'entità servizio e le credenzialiCreate a service principal and credentials

Il cluster Kubernetes necessita di autorizzazioni di entità servizio (SPN) e basate sui ruoli nell'hub Azure Stack.The Kubernetes cluster will need service principal (SPN) and role-based permissions in Azure Stack Hub.

Creazione di un nome SPN in Azure ADCreate an SPN in Azure AD

Se si usa Azure Active Directory (Azure AD) per il servizio di gestione delle identità, sarà necessario creare un'entità servizio per gli utenti che distribuiscono un cluster Kubernetes.If you use Azure Active Directory (Azure AD) for your identity management service, you will need to create a service principal for users deploying a Kubernetes cluster. Creare un'entità servizio usando un segreto client.Create a service principal using a client secret. Per istruzioni, vedere creare un'entità servizio che usa una credenziale privata del client.For instructions, see Create a service principal that uses a client secret credential.

Creazione di un nome SPN in AD FSCreate an SPN in AD FS

Se si usa Active Directory servizi federati (AD FS) per il servizio di gestione delle identità, sarà necessario creare un'entità servizio per gli utenti che distribuiscono un cluster Kubernetes.If you use Active Directory Federated Services (AD FS) for your identity management service, you will need to create a service principal for users deploying a Kubernetes cluster. Creare un'entità servizio usando un segreto client.Create a service principal using a client secret. Per istruzioni, vedere creare un'entità servizio usando un segreto client.For instructions, see Create a service principal using a client secret.

Aggiungere l'immagine di base AKSAdd the AKS Base Image

È possibile aggiungere l'immagine di base AKS al Marketplace ottenendo l'elemento da Azure.You can add the AKS Base Image to the marketplace by getting the item from Azure. Tuttavia, se l'hub Azure Stack è disconnesso, usare queste istruzioni per scaricare gli elementi del Marketplace da Azure per aggiungere l'elemento.However, if your Azure Stack Hub is disconnected, use these instructions Download marketplace items from Azure to add the item. Aggiungere l'elemento specificato nel passaggio 5.Add the item specified in step 5.

Aggiungere il seguente elemento al Marketplace:Add the following item to the marketplace:

  1. Accedere al portale di amministrazione https://adminportal.local.azurestack.external .Sign in to the Administration portal https://adminportal.local.azurestack.external.

  2. Selezionare tutti i servizi, quindi nella categoria Amministrazione selezionare gestione del Marketplace.Select All services, and then under the ADMINISTRATION category, select Marketplace management.

  3. Selezionare + Aggiungi da Azure.Select + Add from Azure.

  4. Immettere AKS Base.Enter AKS Base.

  5. Selezionare la versione dell'immagine che corrisponde alla versione del motore AKS.Select the image version that matches the version of the AKS engine. È possibile trovare un elenco di immagini di base AKS per la versione del motore AKS in versioni di Kubernetes supportate.You can find listing of AKS Base Image to AKS engine version at Supported Kubernetes Versions.

    Nell'elenco selezionare:In the list, select:

    • Server di pubblicazione: servizio Azure KubernetesPublisher: Azure Kubernetes Service
    • Offerta: AKSOffer: aks
    • Nome: AKS Base Ubuntu 16,04-LTS image distro, agosto 2020 (2020.09.14 o versione che esegue il mapping al motore AKS)Name: AKS Base Ubuntu 16.04-LTS Image Distro, August 2020 (2020.09.14 or version that maps to AKS engine)
    • Versione: 2020.09.14Version: 2020.09.14
  6. Selezionare download.Select Download.

Aggiungere un'estensione di script personalizzataAdd a Custom Script extension

È possibile aggiungere lo script personalizzato al Marketplace ottenendo l'elemento da Azure.You can add the custom script to the marketplace by getting the item from Azure. Tuttavia, se l'hub Azure Stack è disconnesso, usare le istruzioni scaricare gli elementi del Marketplace da Azure per aggiungere l'elemento.However, if your Azure Stack Hub is disconnected, use the instructions Download marketplace items from Azure to add the item. Aggiungere l'elemento specificato nel passaggio 5.Add the item specified in step 5.

  1. Aprire il portale di amministrazione https://adminportal.local.azurestack.external .Open the Administration portal https://adminportal.local.azurestack.external.

  2. Selezionare tutti i servizi e quindi nella categoria Amministrazione selezionare gestione del Marketplace.Select ALL services and then under the ADMINISTRATION category, select Marketplace Management.

  3. Selezionare + Aggiungi da Azure.Select + Add from Azure.

  4. Immettere Custom Script for Linux.Enter Custom Script for Linux.

  5. Selezionare lo script con il profilo seguente:Select the script with the following profile:

    • Offerta: script personalizzato per Linux 2,0Offer: Custom Script for Linux 2.0

    • Versione: 2.0.6 (o versione più recente)Version: 2.0.6 (or latest version)

    • Server di pubblicazione: Microsoft CorpPublisher: Microsoft Corp

      Nota

      Potrebbe essere elencata più di una versione dello script personalizzato per Linux.More than one version of the Custom Script for Linux may be listed. Sarà necessario aggiungere l'ultima versione dell'elemento.You will need to add the last version of the item.

  6. Selezionare download.Select Download.

Passaggi successiviNext steps

Qual è il motore AKS nell'hub Azure Stack?What is the AKS engine on Azure Stack Hub?

Panoramica dei servizi offerti nell'hub Azure StackOverview of offering services in Azure Stack Hub