Início Rápido: Criar um painel do portal do Azure com a CLI do Azure

Um painel no portal do Azure é uma exibição concentrada e organizada dos seus recursos da nuvem. O foco deste artigo é o processo de usar a CLI do Azure para criar um painel. O painel mostra o desempenho de uma VM (máquina virtual), bem como algumas informações e links estáticos.

Pré-requisitos

  • Use o ambiente Bash no Azure Cloud Shell.

    Inicie o Cloud Shell em uma nova janela

  • Se preferir, instale a CLI do Azure para executar comandos de referência da CLI.

    • Se estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para mais opções de entrada, confira Entrar com a CLI do Azure.

    • Quando solicitado, instale as extensões da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar extensões com a CLI do Azure.

    • Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.

  • Se tiver várias assinaturas do Azure, escolha a que for adequada para a cobrança dos recursos. Selecione uma assinatura usando o comando az account set:

    az account set --subscription 00000000-0000-0000-0000-000000000000
    
  • Crie um grupo de recursos do Azure usando o comando az group create ou use um grupo de recursos existente:

    az group create --name myResourceGroup --location centralus
    

    Um grupo de recursos é um contêiner lógico no qual os recursos do Azure são implantados e gerenciados como um grupo.

Criar uma máquina virtual

Crie uma máquina virtual usando o comando az vm create:

az vm create --resource-group myResourceGroup --name SimpleWinVM --image win2016datacenter \
   --admin-username azureuser --admin-password 1StrongPassword$

Observação

A senha deve ser complexa. Esse é um novo nome de usuário e uma nova senha. Não é, por exemplo, a conta que você usa para entrar no Azure. Para obter mais informações, confira Requisitos de nome de usuário e Requisitos de senha.

A implantação é iniciada e normalmente leva alguns minutos para ser concluída. Após a conclusão da implantação, vá para a próxima seção.

Baixar o modelo de painel

Como os painéis do Azure são recursos, eles podem ser representados como JSON. Para obter mais informações, confira A estrutura de Painéis do Azure.

Baixe o seguinte arquivo: portal-dashboard-template-testvm.json.

Personalize o modelo baixado alterando os seguintes valores para seus valores:

  • <subscriptionID>: Sua assinatura
  • <rgName>: grupo de Recursos, por exemplo, myResourceGroup
  • <vmName>: nome da máquina virtual, por exemplo, SimpleWinVM
  • <dashboardTitle>: título do painel, por exemplo, Simple VM Dashboard
  • <location>: sua região do Azure, por exemplo, centralus

Para obter mais informações, confira Referência de modelos de painéis no portal da Microsoft.

Implantar o modelo de painel

Agora você pode implantar o modelo de dentro da CLI do Azure.

  1. Execute o comando az portal dashboard create para implantar o modelo:

    az portal dashboard create --resource-group myResourceGroup --name 'Simple VM Dashboard' \
       --input-path portal-dashboard-template-testvm.json --location centralus
    
  2. Verifique se o painel foi criado com êxito executando o comando az portal dashboard show:

    az portal dashboard show --resource-group myResourceGroup --name 'Simple VM Dashboard'
    

Para ver todos os painéis para a assinatura atual, use az portal dashboard list:

az portal dashboard list

Você também pode ver todos os painéis de um grupo de recursos:

az portal dashboard list --resource-group myResourceGroup

Você pode atualizar um painel usando o comando az portal dashboard update:

az portal dashboard update --resource-group myResourceGroup --name 'Simple VM Dashboard' \
   --input-path portal-dashboard-template-testvm.json --location centralus

Verifique se você pode ver dados sobre a máquina virtual de dentro do painel do portal do Azure.

  1. No portal do Azure, selecione Painel.

    Navegação do portal do Azure até o painel

  2. Na página do painel, selecione Painel de VM Simples.

    Navegar até o Painel de VM Simples

  3. Examine o painel que o modelo do ARM (Azure Resource Manager) criou. Você pode ver que parte do conteúdo é estático, mas também há gráficos que mostram o desempenho da VM que você criou no início.

    Examinar o Painel de VM Simples

Limpar os recursos

Para remover a máquina virtual e o painel associado, exclua o grupo de recursos que os contém.

Cuidado

O exemplo a seguir exclui o grupo de recursos especificado e todos os recursos contidos nele. Se existirem recursos fora do escopo deste artigo no grupo de recursos especificado, eles também serão excluídos.

az group delete --name myResourceGroup

Para remover apenas o painel, use o comando az portal dashboard delete:

az portal dashboard delete --resource-group myResourceGroup --name "Simple VM Dashboard"

Próximas etapas

Para obter mais informações sobre o suporte à CLI do Azure para painéis, confira az portal dashboard.