Compartilhar via

Gerenciar e implantar recursos no Azure Stack Hub com a CLI do Azure

  • Artigo

Aplica-se a: sistemas integrados do Azure Stack Hub

Siga as etapas neste artigo para configurar a CLI (Interface Command-Line) do Azure para gerenciar recursos do Azure Stack Hub das plataformas de cliente Linux, Mac e Windows.

Preparar para a CLI do Azure

O ponto de extremidade de aliases de máquina virtual fornece um alias, como "UbuntuLTS" ou "Win2012Datacenter". Esse alias faz referência a um editor de imagens, oferta, SKU e versão como um único parâmetro ao implantar VMs.

A seção a seguir descreve como configurar o ponto de extremidade de aliases da máquina virtual.

Configurar o ponto de extremidade de aliases da máquina virtual

Você pode configurar um ponto de extremidade publicamente acessível que hospeda um arquivo de alias de VM. O arquivo de alias da VM é um arquivo JSON que fornece um nome comum para uma imagem. Você usa o nome ao implantar uma VM como um parâmetro da CLI do Azure.

  1. Se você publicar uma imagem personalizada, anote as informações de editor, oferta, SKU e versão especificadas durante a publicação. Se for uma imagem do Marketplace, você poderá exibir as informações usando o Get-AzureVMImage cmdlet .

  2. Baixe o arquivo de exemplo do GitHub.

  3. Crie uma conta de armazenamento no Azure Stack Hub. Quando isso for feito, crie um contêiner de blob. Defina a política de acesso como "pública".

  4. Carregue o arquivo JSON no novo contêiner. Quando isso for concluído, você poderá exibir a URL do blob. Selecione o nome do blob e, em seguida, selecione a URL nas propriedades do blob.

Instalar ou atualizar a CLI

Entre em sua estação de trabalho de desenvolvimento e instale a CLI. O Azure Stack Hub requer a versão 2.0 ou posterior da CLI do Azure. A versão mais recente dos Perfis de API requer uma versão atual da CLI. Instale a CLI usando as etapas descritas no artigo Instalar a CLI do Azure .

Para verificar se a instalação foi bem-sucedida, abra uma janela de terminal ou prompt de comando e execute o seguinte comando:

az --version

Você deve ver a versão da CLI do Azure e outras bibliotecas dependentes instaladas em seu computador.

CLI do Azure no local do Python do Azure Stack Hub

Windows/Linux (ID do Microsoft Entra)

Esta seção orienta você na configuração da CLI se você estiver usando Microsoft Entra ID como seu serviço de gerenciamento de identidade e estiver usando a CLI em um computador Windows/Linux.

Conectar-se ao Azure Stack Hub

  1. Registre seu ambiente do Azure Stack Hub executando o az cloud register comando .

  2. Registre seu ambiente. Use os seguintes parâmetros ao executar az cloud register:

    Valor Exemplo Descrição
    Nome do ambiente AzureStackUser Use AzureStackUser para o ambiente do usuário. Se você for operador, especifique AzureStackAdmin.
    Ponto de extremidade do Resource Manager 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 o operador de nuvem.
    Ponto de extremidade de armazenamento local.azurestack.external Para um sistema integrado, use um ponto de extremidade para seu sistema.
    Sufixo keyvault .vault.local.azurestack.external Para um sistema integrado, use um ponto de extremidade para seu sistema.
    Ponto de extremidade do documento do alias de imagem da VM- 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. Para obter mais informações, consulte Configurar o ponto de extremidade de aliases da VM. 
    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>

  3. Defina o ambiente ativo usando os comandos a seguir.

    az cloud set -n <environmentname>

  4. Atualize sua configuração de ambiente para usar o perfil de versão da API específica do Azure Stack Hub. Para atualizar a configuração, execute o seguinte comando:

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

  5. Entre no ambiente do Azure Stack Hub usando o az login comando . Entre no ambiente do Azure Stack Hub como usuário ou como uma entidade de serviço.

    • Entre como um usuário:

      Especifique o nome de usuário e a senha diretamente no comando az login ou autentique-se usando um navegador. Você deverá fazer o último se sua conta tiver a autenticação multifator habilitada:

      az login -u <Microsoft Entra 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 . Executar esse comando fornece uma URL e um código que você deve usar para autenticar.

    • Entre como uma entidade de serviço:

      Antes de entrar, crie uma entidade de serviço por meio do portal do Azure ou da CLI e atribua uma função a ela. Agora, entre usando o seguinte comando:

      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 conectividade

Com tudo configurado, use a CLI para criar recursos no Azure Stack Hub. Por exemplo, você pode criar um grupo de recursos para um aplicativo e adicionar uma VM. Use o seguinte comando para criar um grupo de recursos chamado "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:

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

Windows/Linux (AD FS)

Esta seção orienta você pela configuração da CLI se você estiver usando os Serviços Federados do Active Directory (AD FS) como seu serviço de gerenciamento de identidade e estiver usando a CLI em um computador Windows/Linux.

Conectar-se ao Azure Stack Hub

  1. Registre seu ambiente do Azure Stack Hub executando o az cloud register comando .

  2. Registre seu ambiente. Use os seguintes parâmetros ao executar az cloud register:

    Valor Exemplo Descrição
    Nome do ambiente AzureStackUser Use AzureStackUser para o ambiente do usuário. Se você for operador, especifique AzureStackAdmin.
    Ponto de extremidade do Resource Manager 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 o operador de nuvem.
    Ponto de extremidade de armazenamento local.azurestack.external Para um sistema integrado, use um ponto de extremidade para seu sistema.
    Sufixo keyvault .vault.local.azurestack.external Para um sistema integrado, use um ponto de extremidade para seu sistema.
    Ponto de extremidade do documento do alias de imagem da VM- 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. Para obter mais informações, consulte Configurar o ponto de extremidade de aliases da VM. 
    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>

  3. Defina o ambiente ativo usando os comandos a seguir.

    az cloud set -n <environmentname>

  4. Atualize sua configuração de ambiente para usar o perfil de versão da API específica do Azure Stack Hub. Para atualizar a configuração, execute o seguinte comando:

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

  5. Entre no ambiente do Azure Stack Hub usando o az login comando . Você pode entrar no ambiente do Azure Stack Hub como usuário ou como uma entidade de serviço.

    • Entre como um usuário:

      Especifique o nome de usuário e a senha diretamente no comando az login ou autentique-se usando um navegador. Você deverá fazer o último se sua conta tiver a autenticação multifator habilitada:

      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>   --profile "2019-03-01-hybrid"

      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 . A execução desse comando fornece uma URL e um código que você deve usar para autenticar.

    • Entre como uma entidade de serviço:

      Prepare o arquivo .pem a ser usado para o logon da entidade de serviço.

      No computador cliente em que a entidade de segurança foi criada, exporte o certificado da entidade de serviço como um pfx com a chave privada localizada em cert:\CurrentUser\My. O nome do certificado tem o mesmo nome que o principal.

      Converta o pfx em pem (use o utilitário OpenSSL).

      Entre na CLI:

      az login --service-principal \
-u <Client ID from the Service Principal details> \
-p <Certificate's fully qualified name, such as, C:\certs\spn.pem>
--tenant <Tenant ID> \
--debug

Testar a conectividade

Com tudo configurado, use a CLI para criar recursos no Azure Stack Hub. Por exemplo, você pode criar um grupo de recursos para um aplicativo e adicionar uma VM. Use o seguinte comando para criar um grupo de recursos chamado "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:

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

Problemas conhecidos

Há problemas conhecidos ao usar a CLI no Azure Stack Hub:

  • O modo interativo da CLI. Por exemplo, o az interactive comando ainda não tem suporte no Azure Stack Hub.
  • Para obter a lista de imagens de VM disponíveis no Azure Stack Hub, use o az vm image list --all comando em vez do az vm image list comando . Especificar a opção --all garante que a resposta retorne apenas as imagens disponíveis em seu ambiente do Azure Stack Hub.
  • Os aliases de imagem da VM que estão disponíveis no Azure podem não ser aplicáveis ao Azure Stack Hub. Ao usar imagens de VM, você deve usar todo o parâmetro URN (Canonical:UbuntuServer:14.04.3-LTS:1.0.0) em vez do alias da imagem. Esse URN deve corresponder às especificações de imagem, conforme derivado do az vm images list comando .

Próximas etapas