Implantar kubernetes no Hub de Azure Stack usando Azure Active DirectoryDeploy Kubernetes to Azure Stack Hub using Azure Active Directory

Observação

Use apenas o item kubernetes Azure Stack Marketplace para implantar clusters como uma verificação de conceito.Only use the Kubernetes Azure Stack Marketplace item to deploy clusters as a proof-of-concept. Para os clusters kubernetes com suporte em Azure Stack, use o mecanismo AKs.For supported Kubernetes clusters on Azure Stack, use the AKS engine.

Você pode seguir as etapas neste artigo para implantar e configurar os recursos do kubernetes, ao usar o Azure Active Directory (Azure AD) como seu serviço de gerenciamento de identidade, em uma única operação coordenada.You can follow the steps in this article to deploy and set up the resources for Kubernetes, when using Azure Active Directory (Azure AD) as your identity management service, in a single, coordinated operation.

Pré-requisitosPrerequisites

Para começar, verifique se você tem as permissões corretas e se seu hub de Azure Stack está pronto.To get started, make sure you have the right permissions and that your Azure Stack Hub is ready.

  1. Verifique se você pode criar aplicativos em seu locatário do Azure Active Directory (Azure AD).Verify that you can create applications in your Azure Active Directory (Azure AD) tenant. Você precisa dessas permissões para a implantação do kubernetes.You need these permissions for the Kubernetes deployment.

    Para obter instruções sobre como verificar suas permissões, consulte verificar permissões de Azure Active Directory.For instructions on checking your permissions, see Check Azure Active Directory permissions.

  2. Gere um par de chaves SSH pública e privada para entrar na VM do Linux no Hub Azure Stack.Generate an SSH public and private key pair to sign in to the Linux VM on Azure Stack Hub. Você precisará da chave pública ao criar o cluster.You will need the public key when creating the cluster.

    Para obter instruções sobre como gerar uma chave, consulte geração de chave SSH.For instructions on generating a key, see SSH Key Generation.

  3. Verifique se você tem uma assinatura válida no portal de locatário do Hub Azure Stack e se tem endereços IP públicos suficientes disponíveis para adicionar novos aplicativos.Check that you have a valid subscription in your Azure Stack Hub tenant portal, and that you have enough public IP addresses available to add new applications.

    O cluster não pode ser implantado em uma assinatura de administrador de Hub Azure Stack.The cluster cannot be deployed to an Azure Stack Hub Administrator subscription. Você deve usar uma assinatura de usuário .You must use a User subscription.

  4. Se você não tiver o cluster kubernetes em seu Marketplace, fale com o administrador do Hub do Azure Stack.If you do not have Kubernetes Cluster in your marketplace, talk to your Azure Stack Hub administrator.

Criar uma entidade de serviçoCreate a service principal

Configure uma entidade de serviço no Azure.Set up a service principal in Azure. A entidade de serviço dá ao seu aplicativo acesso a Azure Stack recursos do Hub.The service principal gives your application access to Azure Stack Hub resources.

  1. Entre no portal do Azureglobal.Sign in to the global Azure portal.

  2. Verifique se você entrou usando o locatário do Azure AD associado à instância de Hub de Azure Stack.Check that you signed in using the Azure AD tenant associated with the Azure Stack Hub instance. Você pode alternar sua entrada clicando no ícone de filtro na barra de ferramentas do Azure.You can switch your sign-in by clicking the filter icon in the Azure toolbar.

    Selecione seu locatário do AD

  3. Criar um aplicativo Azure AD.Create an Azure AD application.

    a.a. Entre sua conta do Azure através do portal do Microsoft Azure.Sign in to your Azure Account through the Azure portal.
    b.b. Selecione Azure Active Directory > Registros do aplicativo > Novo registro.Select Azure Active Directory > App registrations > New registration.
    c.c. Forneça um nome e uma URL para o aplicativo.Provide a name and URL for the application.
    d.d. Selecione os tipos de conta com suporte.Select the Supported account types.
    e.e. Adicione http://localhost para o URI do aplicativo.Add http://localhost for the URI for the application. Selecione Web para o tipo de aplicativo que você deseja criar.Select Web for the type of application you want to create. Depois de definir os valores, selecione registrar.After setting the values, select Register.

  4. Anote a ID do aplicativo.Make note of the Application ID. Você precisará da ID ao criar o cluster.You will need the ID when creating the cluster. A ID é referenciada como ID do cliente da entidade de serviço.The ID is referenced as Service Principal Client ID.

  5. Na folha da entidade de serviço, selecione novo segredo do cliente.In the blade for the service principle, select New client secret. Configurações > do Chaves.Settings > Keys. Você precisa gerar uma chave de autenticação para a entidade de serviço.You need to generate an authentication key for the service principle.

    a.a. Insira a Descrição.Enter the Description.

    b.b. A seleção nunca expira para expirar.Select Never expires for Expires.

    c.c. Selecione Adicionar.Select Add. Anote a cadeia de caracteres de chave.Make note the key string. Você precisará da cadeia de caracteres de chave ao criar o cluster.You will need the key string when creating the cluster. A chave é referenciada como o segredo do cliente da entidade de serviço.The key is referenced as the Service Principal Client Secret.

Fornecer acesso à entidade de serviçoGive the service principal access

Conceda à entidade de serviço acesso à sua assinatura para que a entidade de segurança possa criar recursos.Give the service principal access to your subscription so that the principal can create resources.

  1. Entre no portal do hub de Azure Stack https://portal.local.azurestack.external/ .Sign in to the Azure Stack Hub portal https://portal.local.azurestack.external/.

  2. Selecione todas as > assinaturasde serviços.Select All services > Subscriptions.

  3. Selecione a assinatura criada pelo operador para usar o cluster kubernetes.Select the subscription created by your operator for using the Kubernetes Cluster.

  4. Selecione controle de acesso (iam) > selecione Adicionar atribuição de função.Select Access control (IAM) > Select Add role assignment.

  5. Selecione a função colaborador .Select the Contributor role.

  6. Selecione o nome do aplicativo criado para a entidade de serviço.Select the application name created for your service principal. Talvez seja necessário digitar o nome na caixa de pesquisa.You may have to type the name in the search box.

  7. Clique em Save (Salvar).Click Save.

Implantar kubernetesDeploy Kubernetes

  1. Abra o portal do Hub Azure Stack https://portal.local.azurestack.external .Open the Azure Stack Hub portal https://portal.local.azurestack.external.

  2. Selecione + criar um recurso de > computação > kubernetes cluster.Select + Create a resource > Compute > Kubernetes Cluster. Clique em Criar.Click Create.

    Captura de tela que mostra como criar um cluster kubernetes.

1. noções básicas1. Basics

  1. Selecione noções básicas em criar cluster kubernetes.Select Basics in Create Kubernetes Cluster.

    Captura de tela que mostra como adicionar informações básicas sobre o cluster kubernetes.

  2. Selecione sua ID de assinatura .Select your Subscription ID.

  3. Insira o nome de um novo grupo de recursos ou selecione um grupo de recursos existente.Enter the name of a new resource group or select an existing resource group. O nome do recurso precisa ser alfanumérico e minúsculo.The resource name needs to be alphanumeric and lowercase.

  4. Selecione o local do grupo de recursos.Select the Location of the resource group. Essa é a região que você escolhe para a instalação do hub de Azure Stack.This is the region you choose for your Azure Stack Hub installation.

2. kubernetes configurações de cluster2. Kubernetes Cluster Settings

  1. Selecione configurações de cluster kubernetes em criar cluster kubernetes.Select Kubernetes Cluster Settings in Create Kubernetes Cluster.

    Captura de tela que mostra onde fornecer informações sobre as configurações de cluster kubernetes.

  2. Insira o nome de usuário do administrador da VM do Linux.Enter the Linux VM admin username. Nome de usuário para o Máquinas Virtuais do Linux que fazem parte do cluster kubernetes e DVM.User name for the Linux Virtual Machines that are part of the Kubernetes cluster and DVM.

  3. Insira a chave pública SSH usada para autorização para todos os computadores Linux criados como parte do cluster KUBERNETES e DVM.Enter the SSH Public Key used for authorization to all Linux machines created as part of the Kubernetes cluster and DVM.

  4. Insira o prefixo DNS do perfil mestre que é exclusivo para a região.Enter the Master Profile DNS Prefix that is unique to the region. Deve ser um nome exclusivo de região, como k8s-12345 .This must be a region-unique name, such as k8s-12345. Tente escolher o mesmo nome do grupo de recursos como prática recomendada.Try to chose it same as the resource group name as best practice.

    Observação

    Para cada cluster, use um prefixo DNS novo e exclusivo do perfil mestre.For each cluster, use a new and unique master profile DNS prefix.

  5. Selecione a contagem de perfis do pool mestre kubernetes.Select the Kubernetes master pool profile count. A contagem contém o número de nós no pool mestre.The count contains the number of nodes in the master pool. Pode haver de 1 a 7.There can be from 1 to 7. Esse valor deve ser um número ímpar.This value should be an odd number.

  6. Selecione o VMSize das VMs do mestre do kubernetes.Select The VMSize of the Kubernetes master VMs. Isso especifica o tamanho da VM de VMs do mestre de kubernetes.This specifies the VM Size of Kubernetes master VMs.

  7. Selecione a contagem de perfis do pool de nós kubernetes.Select the Kubernetes node pool profile count. A contagem contém o número de agentes no cluster.The count contains the number of agents in the cluster.

  8. Selecione o VMSize das VMs do nó kubernetes.Select the VMSize of the Kubernetes node VMs. Isso especifica o tamanho da VM das VMs do nó kubernetes.This specifies the VM Size of Kubernetes node VMs.

  9. Selecione Azure ad para o Azure Stack sistema de identidade do Hub para a instalação do hub de Azure Stack.Select Azure AD for the Azure Stack Hub identity system for your Azure Stack Hub installation.

  10. Insira a entidade de serviço clientId que é usada pelo provedor de nuvem do kubernetes Azure.Enter the Service principal clientId This is used by the Kubernetes Azure cloud provider. A ID do cliente identificada como a ID do aplicativo quando o administrador do Hub Azure Stack criou a entidade de serviço.The Client ID identified as the Application ID when your Azure Stack Hub administrator created the service principal.

  11. Insira o segredo do cliente da entidade de serviço.Enter the Service principal client secret. Esse é o segredo do cliente que você configurou ao criar seu serviço.This is the client secret you set up when creating your service.

  12. Insira a versão do kubernetes.Enter the Kubernetes version. Esta é a versão para o provedor do kubernetes Azure.This is the version for the Kubernetes Azure provider. Azure Stack Hub lança uma compilação kubernetes personalizada para cada versão do hub de Azure Stack.Azure Stack Hub releases a custom Kubernetes build for each Azure Stack Hub version.

3. Resumo3. Summary

  1. Selecione Resumo.Select Summary. A folha exibe uma mensagem de validação para as configurações de cluster do kubernetes.The blade displays a validation message for your Kubernetes Cluster configurations settings.

    Implantar modelo de solução

  2. Examine suas configurações.Review your settings.

  3. Selecione OK para implantar o cluster.Select OK to deploy your cluster.

Dica

Se você tiver dúvidas sobre sua implantação, poderá postar sua pergunta ou ver se alguém já respondeu à pergunta no Fórum do hub de Azure Stack.If you have questions about your deployment, you can post your question or see if someone has already answered the question in the Azure Stack Hub Forum.

Próximas etapasNext steps

Conectar-se ao clusterConnect to your cluster

Habilitar o painel do kubernetesEnable the Kubernetes Dashboard