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.

Configurar a CLI do AzureSet up 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 DescriptionDescription
    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.local.azurestack.external O ResourceManagerUrl na ASDK é: https://management.local.azurestack.external/ 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.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 final 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, utilize um ponto final para o seu sistema.For an integrated system, use an endpoint for your system.
    Sufixo 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, utilize um ponto final para o seu sistema.For an integrated system, use an endpoint for your system.
    Imagem VM pseudónimo doc ponto final-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 pseudónimos de imagem VM.URI of the document, which contains VM image aliases. Para obter mais informações, consulte Configurar o ponto final do pseudónimo 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. 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
    

    Nota

    Se estiver a executar uma versão do Azure Stack Hub antes da construção de 1808, tem de utilizar o perfil da versão API 2017-03-09 em vez do perfil da versão 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. Também precisa de utilizar uma versão recente do Azure CLI.You also need to use a recent version of the Azure CLI.

  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. Inscreva-se no ambiente Azure Stack Hub, quer como utilizador, quer como diretor de serviço.Sign in to the Azure Stack Hub environment either as a user or as a service principal.

    • 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 <Active directory global administrator or user account. For example: username@<aadtenant>.onmicrosoft.com> --tenant <Azure Active Directory Tenant name. For example: myazurestack.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>
      

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