Instalar CLI do Azure no Hub Azure StackInstall Azure CLI on Azure Stack Hub

Você pode instalar o CLI do Azure para gerenciar o Hub de Azure Stack com computadores Windows ou Linux.You can install the Azure CLI to manage Azure Stack Hub with a Windows or Linux machines. Este artigo orienta você pelas etapas de instalação e configuração do CLI do Azure.This article walks you through the steps of installing and setting up Azure CLI.

Instalar a CLI do Azure.Install Azure CLI

  1. Entre em sua estação de trabalho de desenvolvimento e instale a CLI.Sign in to your development workstation and install CLI. Azure Stack Hub requer a versão 2,0 ou posterior do CLI do Azure.Azure Stack Hub requires version 2.0 or later of Azure CLI.

  2. Você pode instalar a CLI usando as etapas descritas no artigo instalar o CLI do Azure .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 terminal ou de prompt 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
    

    Você deve ver a versão do CLI do Azure 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.

    CLI do Azure no local do Python do Hub Azure Stack

  4. Anote a localização do Python da CLI.Make a note of the CLI's Python location. Se estiver executando o ASDK, você precisará usar esse local para adicionar seu certificado.If you're running the ASDK, you need to use this location to add your certificate. Para obter instruções sobre como configurar certificados para instalar a CLI no ASDK, consulte Configurando certificados para CLI do Azure em kit de desenvolvimento do Azure Stack.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.

Configurar a CLI do AzureSet up Azure CLI

Esta seção orienta você pela configuração da CLI se você estiver usando o Azure AD como seu serviço de gerenciamento de identidade e estiver usando a CLI em um computador 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.

Conectar-se ao Hub de Azure StackConnect to Azure Stack Hub

  1. Se você estiver usando o ASDK, confie no certificado raiz da AC do hub de Azure Stack.If you are using the ASDK, trust the Azure Stack Hub CA root certificate. Para obter instruções, consulte confiar no certificado.For instruction, see Trust the certificate.

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

  3. Registre seu ambiente.Register your environment. Use os seguintes parâmetros ao executar az cloud register :Use the following parameters when running az cloud register:

    ValorValue ExemploExample DescriçãoDescription
    Nome do ambienteEnvironment name AzureStackUserAzureStackUser Use AzureStackUser para o ambiente do usuário.Use AzureStackUser for the user environment. Se você for o operador, especifique AzureStackAdmin .If you're operator, specify AzureStackAdmin.
    Ponto de extremidade do Resource ManagerResource Manager endpoint https://management.local.azurestack.external O ResourceManagerUrl no ASDK é: https://management.local.azurestack.external/ o ResourceManagerUrl em sistemas integrados é: https://management.<region>.<fqdn>/ se você tiver uma pergunta sobre o ponto de extremidade do sistema integrado, entre em contato com seu operador de nuvem.The ResourceManagerUrl in the ASDK is: https://management.local.azurestack.external/ 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 de extremidade de armazenamentoStorage endpoint local. azurestack. externallocal.azurestack.external local.azurestack.external é para o ASDK.local.azurestack.external is for the ASDK. Para um sistema integrado, use um ponto de extremidade para seu sistema.For an integrated system, use an endpoint for your system.
    Sufixo de keyvaultKeyvault suffix . Vault. local. azurestack. external.vault.local.azurestack.external .vault.local.azurestack.external é para o ASDK..vault.local.azurestack.external is for the ASDK. Para um sistema integrado, use um ponto de extremidade para seu sistema.For an integrated system, use an endpoint for your system.
    Ponto de extremidade do documento do alias de imagem da VM-VM image alias doc endpoint- https://raw.githubusercontent.com/Azure/azure-rest-api-specs/master/arm-compute/quickstart-templates/aliases.json URI do documento, que contém aliases de imagem de VM.URI of the document, which contains VM image aliases. Para obter mais informações, consulte Configurar o ponto de extremidade do alias da máquina virtual.For more info, see Set up the virtual machine alias endpoint.
    az cloud register -n <environmentname> --endpoint-resource-manager "https://management.local.azurestack.external" --suffix-storage-endpoint "local.azurestack.external" --suffix-keyvault-dns ".vault.local.azurestack.external" --endpoint-vm-image-alias-doc <URI of the document which contains VM image aliases>
    
  4. Defina o ambiente ativo usando os comandos a seguir.Set the active environment by using the following commands.

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

    az cloud update --profile 2019-03-01-hybrid
    

    Observação

    Se você estiver executando uma versão do hub de Azure Stack antes da compilação 1808, deverá usar o perfil de versão de API 2017-03-09-Profile em vez do perfil de versão de API 2019-03-01-híbrido.If you're running a version of Azure Stack Hub before the 1808 build, you must use the API version profile 2017-03-09-profile rather than the API version profile 2019-03-01-hybrid. Você também precisa usar uma versão recente do CLI do Azure.You also need to use a recent version of the Azure CLI.

  6. Entre em seu ambiente de Hub de Azure Stack usando o az login comando.Sign in to your Azure Stack Hub environment by using the az login command. Entre no ambiente de Hub de Azure Stack como um usuário ou como uma entidade de serviço.Sign in to the Azure Stack Hub environment either as a user or as a service principal.

    • Entrar como um usuário :Sign in as a user :

      Especifique o nome de usuário e a senha diretamente no comando az login ou autentique-se usando um navegador.You can either specify the username and password directly within the az login command, or authenticate by using a browser. Você deve fazer o último se sua conta tiver a autenticação multifator habilitada:You must do the latter if your account has multi-factor authentication enabled:

      az login -u <Active directory global administrator or user account. For example: username@<aadtenant>.onmicrosoft.com> --tenant <Azure Active Directory Tenant name. For example: myazurestack.onmicrosoft.com>
      

      Observação

      Se sua conta de usuário tiver a autenticação multifator habilitada, use 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. A execução desse comando fornece uma URL e um código que você deve usar para autenticar.Running this command gives you a URL and a code that you must use to authenticate.

    • Entrar como uma entidade de serviço :Sign in as a service principal :

      Antes de entrar, crie uma entidade de serviço por meio do portal do Azure ou da CLI e atribua a ela uma função.Before you sign in, create a service principal through the Azure portal or CLI and assign it a role. Agora, entre usando 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>
      

Testar a conectividadeTest the connectivity

Com tudo configurado, use a CLI para criar recursos dentro de Azure Stack Hub.With everything set up, use CLI to create resources within Azure Stack Hub. Por exemplo, você pode criar um grupo de recursos para um aplicativo e adicionar uma VM.For example, you can create a resource group for an app and add a VM. Use o comando a seguir para criar um grupo de recursos chamado "MyResource Group":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 êxito, o comando anterior produzirá 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:

Saída de criação do grupo de recursos

Próximas etapasNext steps