Adicionar os pré-requisitos do mecanismo do AKS (serviços Kubernetess do Azure) ao Marketplace do hub de Azure StackAdd the Azure Kubernetes Services (AKS) engine prerequisites to the Azure Stack Hub Marketplace

Você pode configurar o mecanismo do AKS (serviços de kubernetes do Azure) para seus usuários.You can set up the Azure Kubernetes Services (AKS) Engine for your users. Adicione os itens descritos neste artigo ao seu hub de Azure Stack.Add the items described in this article to your Azure Stack Hub. Os usuários podem então implantar um cluster kubernetes em uma única operação coordenada.Your users can then deploy a Kubernetes cluster in a single, coordinated operation. Este artigo orienta você pelas etapas necessárias para disponibilizar o mecanismo do AKS para os usuários em ambientes conectados e desconectados.This article walks you through the steps you need to make the AKS engine available to your users in both connected and disconnected environments. O mecanismo AKS depende de uma identidade de princípio de serviço e no Marketplace, uma extensão de script personalizado e a imagem de base AKS.The AKS engine depends on a service principle identity, and in the marketplace, a Custom Script extension and the AKS Base Image. O mecanismo AKS requer que você esteja executando Azure Stack Hub 1910 ou superior.The AKS engine requires that you're running Azure Stack Hub 1910 or greater.

Observação

Você pode encontrar o mapeamento do hub de Azure Stack para o número de versão do mecanismo do AKS nas notas de versão do mecanismo do AKS.You can find the mapping of Azure Stack Hub to AKS engine version number in the AKS engine release notes.

Verificar a oferta de serviço do usuárioCheck your user's service offering

Os usuários precisarão de um plano, oferta e assinatura para Azure Stack Hub com espaço suficiente.Your users will need a plan, offer, and subscription to Azure Stack Hub with enough space. Geralmente, os usuários desejarão implantar clusters de até seis máquinas virtuais, feitas de três mestres e três nós de trabalho.Users will often want to deploy clusters of up to six virtual machines, made of three masters and three worker nodes. Você desejará garantir que eles tenham uma cota grande o suficiente.You will want to make sure they have a large enough quota.

Se você precisar de mais informações sobre o planejamento e a configuração de uma oferta de serviço, consulte visão geral da oferta de serviços no Hub de Azure StackIf you need more information about planning and setting up a service offering, see Overview of offering services in Azure Stack Hub

Criar uma entidade de serviço e credenciaisCreate a service principal and credentials

O cluster kubernetes precisará de uma entidade de serviço (SPN) e permissões baseadas em função no Hub Azure Stack.The Kubernetes cluster will need service principal (SPN) and role-based permissions in Azure Stack Hub.

Criar um SPN no Azure ADCreate an SPN in Azure AD

Se você usar Azure Active Directory (AD do Azure) para o serviço de gerenciamento de identidade, será necessário criar uma entidade de serviço para usuários que implantam um 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. Crie uma entidade de serviço usando um segredo do cliente.Create a service principal using a client secret. Para obter instruções, consulte criar uma entidade de serviço que usa uma credencial de segredo do cliente.For instructions, see Create a service principal that uses a client secret credential.

Criar um SPN no AD FSCreate an SPN in AD FS

Se você usar Active Directory serviços federados (AD FS) para o serviço de gerenciamento de identidade, será necessário criar uma entidade de serviço para usuários que implantam um 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. Crie uma entidade de serviço usando um segredo do cliente.Create a service principal using a client secret. Para obter instruções, consulte criar uma entidade de serviço usando um segredo do cliente.For instructions, see Create a service principal using a client secret.

Adicionar a imagem base AKSAdd the AKS Base Image

Você pode adicionar a imagem base do AKS ao Marketplace obtendo o item do Azure.You can add the AKS Base Image to the marketplace by getting the item from Azure. No entanto, se o Hub de Azure Stack estiver desconectado, use estas instruções para baixar itens do Marketplace do Azure para adicionar o item.However, if your Azure Stack Hub is disconnected, use these instructions Download marketplace items from Azure to add the item. Adicione o item especificado na etapa 5.Add the item specified in step 5.

Adicione o seguinte item ao Marketplace:Add the following item to the marketplace:

  1. Entre no portal de administração https://adminportal.local.azurestack.external .Sign in to the Administration portal https://adminportal.local.azurestack.external.

  2. Selecione todos os serviçose, na categoria Administração , selecione Gerenciamento do Marketplace.Select All services, and then under the ADMINISTRATION category, select Marketplace management.

  3. Selecione + Adicionar do Azure.Select + Add from Azure.

  4. Insira AKS Base.Enter AKS Base.

  5. Selecione a versão da imagem que corresponde à versão do mecanismo AKS.Select the image version that matches the version of the AKS engine. Você pode encontrar a listagem da imagem base do AKS na versão do mecanismo do AKS em versões do kubernetes com suporte.You can find listing of AKS Base Image to AKS engine version at Supported Kubernetes Versions.

    Na lista, selecione:In the list, select:

    • Editor: serviço kubernetes do AzurePublisher: Azure Kubernetes Service
    • Oferta: AKsOffer: aks
    • Nome: AKs Base Ubuntu 16, 4-LTS Image distribuição, agosto 2020 (2020.09.14 ou versão que MAPEIA para AKs Engine)Name: AKS Base Ubuntu 16.04-LTS Image Distro, August 2020 (2020.09.14 or version that maps to AKS engine)
    • Versão: 2020.09.14Version: 2020.09.14
  6. Selecione baixar.Select Download.

Adicionar uma extensão de script personalizadoAdd a Custom Script extension

Você pode adicionar o script personalizado ao Marketplace obtendo o item do Azure.You can add the custom script to the marketplace by getting the item from Azure. No entanto, se o Hub de Azure Stack estiver desconectado, use as instruções baixar itens do Marketplace do Azure para adicionar o item.However, if your Azure Stack Hub is disconnected, use the instructions Download marketplace items from Azure to add the item. Adicione o item especificado na etapa 5.Add the item specified in step 5.

  1. Abra o portal de administração https://adminportal.local.azurestack.external .Open the Administration portal https://adminportal.local.azurestack.external.

  2. Selecione todos os serviços e, na categoria Administração , selecione Gerenciamento do Marketplace.Select ALL services and then under the ADMINISTRATION category, select Marketplace Management.

  3. Selecione + Adicionar do Azure.Select + Add from Azure.

  4. Insira Custom Script for Linux.Enter Custom Script for Linux.

  5. Selecione o script com o seguinte perfil:Select the script with the following profile:

    • Oferta: script personalizado para Linux 2,0Offer: Custom Script for Linux 2.0

    • Versão: 2.0.6 (ou versão mais recente)Version: 2.0.6 (or latest version)

    • Publicador: Microsoft CorpPublisher: Microsoft Corp

      Observação

      Mais de uma versão do script personalizado para Linux pode ser listada.More than one version of the Custom Script for Linux may be listed. Será necessário adicionar a última versão do item.You will need to add the last version of the item.

  6. Selecione baixar.Select Download.

Próximas etapasNext steps

O que é o mecanismo AKS no Hub Azure Stack?What is the AKS engine on Azure Stack Hub?

Visão geral da oferta de serviços no Hub de Azure StackOverview of offering services in Azure Stack Hub