Preparar o ambiente para a CLI do Azure

Artigo
12/07/2023

Nesta etapa do tutorial, você executará os primeiros comandos da CLI do Azure. Isso inclui localizar e definir a assinatura ativa e definir valores padrão. Você também aprenderá a criar grupos de recursos que contêm uma ID aleatória para sempre garantir um nome de recurso exclusivo.

Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.

Para concluir esta etapa do tutorial, você precisará de contributor ou de permissões mais altas na assinatura.

Instalar a CLI do Azure

Introdução ao selecionar o primeiro ambiente.

Use o ambiente Bash no Azure Cloud Shell selecionando o botão Abrir Cloud Shell, no canto superior direito de cada bloco de código da CLI do Azure.
Se preferir executar os comandos de referência da CLI do Azure localmente, instale a CLI do Azure.

A versão atual da CLI do Azure é 2.60.0. Para saber mais sobre a versão mais recente, veja as notas de versão. Para localizar a versão instalada e ver se você precisa atualizá-la, execute az version.

Há várias opções de autenticação ao trabalhar com a CLI do Azure. O método de autenticação padrão da CLI do Azure para logons usa um navegador da Web e token de acesso para entrar.

Execute o comando az login.
```
az login
```
Se a CLI do Azure puder abrir seu navegador padrão, ela iniciará o fluxo de código de autorização e abrirá o navegador padrão para carregar uma página de entrada do Azure.

Caso contrário, ela iniciará o fluxo de código do dispositivo e instruirá você a abrir uma página do navegador em https://aka.ms/devicelogin. Em seguida, insira o código exibido no terminal.

Se nenhum navegador da Web estiver disponível ou se houver falha ao abrir o navegador, você poderá forçar o fluxo de código do dispositivo com az login --use-device-code.
Entre com suas credenciais de conta no navegador.

Localizar e alterar a assinatura ativa

Depois de fazer logon na CLI do Azure, sempre verifique a assinatura atual. Caso não esteja trabalhando com a assinatura que preferir, altere-a usando az account set. Veja um exemplo de código para usar:

# see your current/default subscription
az account show

# find the list of subscriptions available to you
az account list --output table

# change your current/default subscription
az account set --subscription <mySubscriptionName>

# you can also set your subscription using a subscription ID
az account set --subscription <00000000-0000-0000-0000-000000000000>

Saída do console para comando az account show:

{
  "environmentName": "AzureCloud",
  "homeTenantId": "00000000-0000-0000-0000-000000000000",
  "id": "00000000-0000-0000-0000-000000000000",
  "isDefault": true,
  "managedByTenants": [],
  "name": "Your storage account name",
  "state": "Enabled",
  "tenantId": "00000000-0000-0000-0000-000000000000",
  "user": {
    "name": "yourName@contoso.com",
    "type": "user"
  }
}

Saiba mais sobre os grupos de recursos

Um grupo de recursos é um contêiner para os recursos do Azure. Para criar um grupo de recursos, você precisará de permissões de contributor ou superiores na assinatura.

Criar um grupo de recursos

Em uma assinatura, o nome de um grupo de recursos deve ser exclusivo. Primeiro, verifique se o nome desejado está disponível usando o comando az group exists. Um valor de saída de false significa que o nome está disponível.
```
az group exists --name <myUniqueRGname>
```
Recupere uma lista de regiões com suporte para a assinatura com o comando az account list-locations. Para obter uma lista dos locais disponíveis do Azure, consulte Escolher a região do Azure certa para você.
```
az account list-locations --query "[].{Region:name}" --output table
```

Crie seu grupo de recursos. Use o comando az group create.

az group create --location <myLocation> --name <myUniqueRGname>

Criar um grupo de recursos contendo uma ID aleatória

Ao testar, é melhor criar um grupo de recursos que contenha uma ID aleatória no nome. Adicionar uma ID aleatória ao nome do grupo de recursos permite retestar o código sem precisar esperar que um grupo de recursos anterior com o mesmo nome seja removido do Azure.

A sintaxe das variáveis do Bash e do PowerShell é diferente. Copie o script correto para o ambiente.

Bash
PowerShell

let "randomIdentifier=$RANDOM*$RANDOM"
location="eastus"
resourceGroup="msdocs-tutorial-rg-$randomIdentifier"
az group create --name $resourceGroup --location $location --output json

$randomIdentifier = (New-Guid).ToString().Substring(0,8)
$location="eastus"
$resourceGroup="msdocs-tutorial-rg-$randomIdentifier"
az group create --name $resourceGroup --location $location --output json

Saída do console do Bash e do PowerShell:

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/msdocs-tutorial-rg-000000000",
  "location": "eastus",
  "managedBy": null,
  "name": "msdocs-tutorial-rg-000000000",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null,
  "type": "Microsoft.Resources/resourceGroups"
}

Definir variáveis de ambiente

A CLI do Azure oferece várias opções para permitir reutilizar valores comuns de parâmetro. Esses valores padrão são armazenados em variáveis de ambiente e são exclusivos para cada entrada.

Defina o grupo de recursos padrão.

az config set defaults.group=<msdocs-tutorial-rg-0000000>

Defina várias variáveis de ambiente ao mesmo tempo.

Muitos parâmetros da CLI do Azure têm vários valores separados por um espaço. Os valores de configuração são uma dessas instâncias. O exemplo a seguir define os padrões .location e .group usados pelos parâmetros --location e --resource-group de cada comando da CLI do Azure.
```
az config set defaults.location=westus2 defaults.group=<msdocs-tutorial-rg-0000000>
```
Defina a saída padrão.

Quando você opta por trabalhar no Azure Cloud Shell ou instalar a CLI do Azure localmente, a saída padrão é definida automaticamente como json. No entanto, esse é um dos padrões mais importantes para entender e definir. A saída determina o que aparece no console e o que é gravado no arquivo de log. Sempre use uma saída de none ao criar recursos que retornam chaves, senhas e segredos.
```
az config set core.output=none
```
Neste tutorial, não estamos trabalhando com segredos. Defina o padrão de volta para json que você possa visualizar a saída retornada de cada comando de referência neste tutorial.
```
az config set core.output=json
```

Saiba como usar az init.

A CLI do Azure tem um comando de referência que orienta você na configuração do ambiente. Digite az init no console e pressione Enter. Siga os prompts fornecidos.

az init

Uma coisa legal sobre o az init é que ele lhe dá todas as configurações atuais. Este é um exemplo de saída:

Your current config settings:

  Output format: JSON 
  [core.output = json]

  Standard error stream (stderr): All events 
  [core.only_show_errors = false]

  Error output: Show recommendations 
  [core.error_recommendation = on]

  Syntax highlighting: On 
  [core.no_color = false]

  Progress Bar: On 
  [core.disable_progress_bar = false]


Select an option by typing it's number

  [1] Optimize for interaction
      These settings improve the output legibility and optimize for human interaction

  [2] Optimize for automation
      These settings optimize for machine efficiency

  [3] Customize settings
      A walk through to customize common configurations

  [4] Exit (default)
      Return to the command prompt

? Your selection:

Localize e leia o arquivo de configuração.

Caso trabalhe com uma lógica de "confiar, mas verificar", você precisa saber onde seus arquivos de configuração são armazenados e o que eles contêm. O arquivo de configuração em si está localizado em $AZURE_CONFIG_DIR/config. O valor padrão de AZURE_CONFIG_DIR é $HOME/.azure no Linux e macOS, e %USERPROFILE%\.azure no Windows. Localize o arquivo de configuração agora e veja o que ele contém.

Obtenha mais detalhes

Deseja obter mais detalhes sobre um dos assuntos abordados nesta etapa do tutorial? Use os links nesta tabela para saber mais.

Assunto	Saiba mais
Ambientes	Escolha a ferramenta de linha de comando certa do Azure
Opções de entrada	Entrar com a CLI do Azure
Termos	Terminologia e níveis de suporte da CLI do Azure
Assinaturas	Gerenciar assinaturas usando a CLI do Azure
Grupos de recursos	Gerenciar grupos de recursos usando a CLI do Azure
Configurações	Configurar a CLI do Azure
Funções do Azure	Funções do Azure, funções do Microsoft Entra e funções clássicas de administrador de assinatura

Próxima Etapa

Agora que você aprendeu a configurar o ambiente, prossiga para a próxima etapa para saber as diferenças de script entre Bash, PowerShell e Cmd.

Conheça as diferenças de sintaxe da CLI do Azure em Bash, PowerShell e Cmd