Instale o Azure CLI no Azure Stack HubInstall Azure CLI on Azure Stack Hub

Pode instalar o Azure CLI para gerir o Azure Stack Hub com máquinas Windows ou Linux.You can install the Azure CLI to manage Azure Stack Hub with a Windows or Linux machines. Este artigo acompanha-o através dos passos de instalação e instalação do Azure CLI.This article walks you through the steps of installing and setting up Azure CLI.

Instalar a CLI do AzureInstall Azure CLI

  1. Inscreva-se na sua estação de trabalho de desenvolvimento e instale o CLI.Sign in to your development workstation and install CLI. O Azure Stack Hub requer a versão 2.0 ou mais tarde do Azure CLI.Azure Stack Hub requires version 2.0 or later of Azure CLI.

  2. Pode instalar o CLI utilizando os passos descritos no artigo Azure CLI.You can install the CLI by using the steps described in the Install the Azure CLI article.

  3. Para verificar se a instalação foi bem sucedida, abra uma janela de solicitação de terminal ou de comando e execute o seguinte comando:To verify whether the installation was successful, open a terminal or command prompt window and run the following command:

    az --version
    

    Deverá ver a versão do Azure CLI e outras bibliotecas dependentes que estão instaladas no seu computador.You should see the version of Azure CLI and other dependent libraries that are installed on your computer.

    Azure CLI na localização do Hub Python de Azure Stack

  4. Tome nota da localização da CLI Python.Make a note of the CLI's Python location. Se estiver a executar o ASDK, tem de usar este local para adicionar o seu certificado.If you're running the ASDK, you need to use this location to add your certificate. Para obter instruções sobre a criação de certificados para a instalação do CLI no ASDK, consulte a configuração dos certificados para O Azure CLI no Kit de Desenvolvimento da Pilha Azure.For instructions on setting up certificates for installing the CLI on the ASDK, see Setting up certificates for Azure CLI on Azure Stack Development Kit.

Conecte-se com Azure CLIConnect with Azure CLI

Esta secção acompanha-o através da configuração do CLI se estiver a utilizar o Azure AD como serviço de gestão de identidade, e estiver a utilizar o CLI numa máquina Windows.This section walks you through setting up CLI if you're using Azure AD as your identity management service, and are using CLI on a Windows machine.

Ligue-se ao Azure Stack HubConnect to Azure Stack Hub

  1. Se estiver a utilizar o ASDK, confie no certificado raiz Azure Stack Hub CA.If you are using the ASDK, trust the Azure Stack Hub CA root certificate. Para instruções, consulte Trust o certificado.For instruction, see Trust the certificate.

  2. Registe o seu ambiente Azure Stack Hub executando o az cloud register comando.Register your Azure Stack Hub environment by running the az cloud register command.

  3. Registe o seu ambiente.Register your environment. Utilize os seguintes parâmetros ao az cloud register correr:Use the following parameters when running az cloud register:

    ValorValue ExemploExample DescriçãoDescription
    Nome do ambienteEnvironment name AzureStackUserAzureStackUser Utilizar AzureStackUser para o ambiente de utilizador.Use AzureStackUser for the user environment. Se for o operador, especifique AzureStackAdmin .If you're operator, specify AzureStackAdmin.
    Ponto final do Gestor de RecursosResource Manager endpoint https://management.contoso.onmicrosoft.com O ResourceManagerUrl na ASDK é: https://management.contoso.onmicrosoft.com/ O ResourceManagerUrl em sistemas integrados é: https://management.<region>.<fqdn>/ Se tiver alguma dúvida sobre o ponto final integrado do sistema, contacte o seu operador de nuvem.The ResourceManagerUrl in the ASDK is: https://management.contoso.onmicrosoft.com/ The ResourceManagerUrl in integrated systems is: https://management.<region>.<fqdn>/ If you have a question about the integrated system endpoint, contact your cloud operator.
    Ponto final de armazenamentoStorage endpoint local.contoso.onmicrosoft.comlocal.contoso.onmicrosoft.com local.azurestack.external é para o ASDK.local.azurestack.external is for the ASDK. Para um sistema integrado, utilize um ponto final para o seu sistema.For an integrated system, use an endpoint for your system.
    Sufixo keyvaultKeyvault suffix .vault.contoso.onmicrosoft.com.vault.contoso.onmicrosoft.com .vault.local.azurestack.external é para o ASDK..vault.local.azurestack.external is for the ASDK. Para um sistema integrado, utilize um ponto final para o seu sistema.For an integrated system, use an endpoint for your system.
    ID de recurso de gráfico de diretório ativo endpointEndpoint active directory graph resource ID https://graph.windows.net/ O ID de recurso do Active Directory.The Active Directory resource ID.
    az cloud register `
        -n <environmentname> `
        --endpoint-resource-manager "https://management.<region>.<fqdn>" `
        --suffix-storage-endpoint "<fqdn>" `
        --suffix-keyvault-dns ".vault.<fqdn>" `
        --endpoint-active-directory-graph-resource-id "https://graph.windows.net/"
    

    Pode encontrar uma referência para o comando de registo na documentação de referência do Azure CLI.You can find a reference for the register command in the Azure CLI reference documentation.

  4. Desaprote o ambiente ativo utilizando os seguintes comandos.Set the active environment by using the following commands.

    az cloud set -n <environmentname>
    
  5. Atualize a configuração do ambiente para utilizar o perfil de versão API específico do Azure Stack Hub.Update your environment configuration to use the Azure Stack Hub specific API version profile. Para atualizar a configuração, executar o seguinte comando:To update the configuration, run the following command:

    az cloud update --profile 2019-03-01-hybrid
    
  6. Inscreva-se no ambiente Azure Stack Hub utilizando o az login comando.Sign in to your Azure Stack Hub environment by using the az login command.

    Pode iniciar sôms no ambiente Azure Stack Hub utilizando as credenciais do utilizador, ou com um principal de serviço (SPN) fornecido pelo seu operador de nuvem.You can sign in to the Azure Stack Hub environment using your user credentials, or with a service principal (SPN) provided to you by your cloud operator.

    • Inscreva-se como utilizador:Sign in as a user:

      Pode especificar o nome de utilizador e a palavra-passe diretamente dentro do az login comando, ou autenticar utilizando um browser.You can either specify the username and password directly within the az login command, or authenticate by using a browser. Tem de fazer este último caso a sua conta tenha a autenticação de vários fatores ativada:You must do the latter if your account has multi-factor authentication enabled:

      az login -u "user@contoso.onmicrosoft.com" -p 'Password123!' --tenant contoso.onmicrosoft.com
      

      Nota

      Se a sua conta de utilizador tiver a autenticação multi-factor ativada, utilize o az login comando sem fornecer o -u parâmetro.If your user account has multi-factor authentication enabled, use the az login command without providing the -u parameter. Executar este comando dá-lhe um URL e um código que deve usar para autenticar.Running this command gives you a URL and a code that you must use to authenticate.

    • Inscreva-se como diretor de serviço:Sign in as a service principal:

      Antes de iniciar sessão, crie um principal de serviço através do portal Azure ou CLI e atribua-lhe um papel.Before you sign in, create a service principal through the Azure portal or CLI and assign it a role. Agora, inscreva-se utilizando o seguinte comando:Now, sign in by using the following command:

      az login `
        --tenant <Azure Active Directory Tenant name. `
                  For example: myazurestack.onmicrosoft.com> `
      --service-principal `
        -u <Application Id of the Service Principal> `
        -p <Key generated for the Service Principal>
      
  7. Verifique se o seu ambiente está corretamente definido e se o seu ambiente é a nuvem ativa.Verify that your environment is set correctly and that your environment is the active cloud.

        az cloud list --output table
    

Deve ver que o seu ambiente está listado e o IsActive true está.You should see that your environment is listed and IsActive is true. Por exemplo:For example:

IsActive    Name               Profile
----------  -----------------  -----------------
False       AzureCloud         2019-03-01-hybrid
False       AzureChinaCloud    latest
False       AzureUSGovernment  latest
False       AzureGermanCloud   latest
True        AzureStackUser     2019-03-01-hybrid

Testar a conectividadeTest the connectivity

Com tudo configurado, use o CLI para criar recursos dentro do Azure Stack Hub.With everything set up, use CLI to create resources within Azure Stack Hub. Por exemplo, pode criar um grupo de recursos para uma aplicação e adicionar um VM.For example, you can create a resource group for an app and add a VM. Utilize o seguinte comando para criar um grupo de recursos chamado "MyResourceGroup":Use the following command to create a resource group named "MyResourceGroup":

az group create -n MyResourceGroup -l local

Se o grupo de recursos for criado com sucesso, o comando anterior produz as seguintes propriedades do recurso recém-criado:If the resource group is created successfully, the previous command outputs the following properties of the newly created resource:

Grupo de recursos cria saída

Passos seguintesNext steps