Prepare o seu ambiente para o CLI do Azure

Nesta etapa do tutorial, você executa seus primeiros comandos da CLI do Azure! Isso inclui localizar e definir sua assinatura ativa e definir valores padrão. Você também aprende a criar grupos de recursos contendo uma ID aleatória para sempre garantir um nome de recurso exclusivo.

Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.

Para concluir esta etapa do tutorial, você precisa de contributor permissões ou permissões superiores em sua assinatura.

Instalar a CLI do Azure

Comece selecionando primeiro seu ambiente.

• Use o ambiente Bash no Azure Cloud Shell selecionando o botão Open 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.63.0. Para obter informações sobre a versão mais recente, veja as notas de versão. Para encontrar sua versão instalada e ver se você precisa atualizar, execute az version.

Entrar no Azure usando a CLI do Azure

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 um token de acesso para entrar.

1. 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, ele inicia o fluxo de código do dispositivo e instrui você a abrir uma página do navegador em https://aka.ms/devicelogin. Em seguida, insira o código exibido no seu terminal.

   Se nenhum navegador da Web estiver disponível ou o navegador da Web não abrir, você pode forçar o fluxo de código do dispositivo com az login --use-device-code.

2. Inicie sessão com as credenciais da sua conta no browser.

Localizar e alterar a sua subscrição ativa

Depois de iniciar sessão na CLI do Azure, verifique sempre a sua subscrição atual. Se você não estiver trabalhando com a assinatura de sua preferência, altere sua assinatura usando o conjunto de contas az. Aqui está um exemplo de código a ser usado:

# 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 az account show comando:

{
  "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 grupos de recursos

Um grupo de recursos é um contentor de recursos do Azure. Para criar um grupo de recursos, você precisa de contributor permissões ou superiores em sua assinatura.

Criar um grupo de recursos

1. Dentro de uma assinatura, um nome de 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>
   

2. Recupere uma lista de regiões suportadas para sua assinatura com o comando az account list-locations . Para obter uma lista de locais do Azure disponíveis, consulte Escolher a região do Azure certa para você.

   az account list-locations --query "[].{Region:name}" --output table
   

3. É hora de criar o 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 seu grupo de recursos permite que você teste novamente seu código sem ter que esperar que um grupo de recursos anterior com o mesmo nome seja removido do Azure.

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

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 Bash e 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 que você reutilize valores de parâmetros comuns. Esses valores padrão são armazenados em variáveis de ambiente e são exclusivos para cada entrada.

1. Defina seu grupo de recursos padrão.

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

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

   Muitos parâmetros da CLI do Azure usam vários valores separados por um espaço. Os valores de configuração são uma dessas instâncias. O próximo exemplo define os .location e .group os padrões que são usados pelos --location parâmetros e --resource-group de cada comando da CLI do Azure.

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

3. Defina sua saída padrão.

   Quando você escolhe trabalhar no Azure Cloud Shell ou instalar a CLI do Azure localmente, a saída padrão é definida automaticamente como json. No entanto, este é 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. Use sempre uma saída de none quando estiver criando 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 ver a saída retornada de cada comando de referência neste tutorial.

   az config set core.output=json
   

4. Aprenda a usar az inito .

   A CLI do Azure tem um comando de referência que o orienta na configuração do seu ambiente. Digite az init no console e pressione Enter. Siga as instruções fornecidas.

   az init
   

   A primeira coisa legal sobre az init é que ele lhe dá todas as suas configurações atuais! Aqui está o 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: 
   

5. Localize e leia seu arquivo de configuração.

   Se você trabalha sob uma mentalidade de "confiar, mas verificar", você quer saber onde seus arquivos de configuração estão armazenados e o que eles contêm. O próprio ficheiro de configuração está localizado em $AZURE_CONFIG_DIR/config. O valor predefinido de AZURE_CONFIG_DIR é $HOME/.azure em Linux e macOS, e %USERPROFILE%\.azure no Windows. Encontre seu arquivo de configuração agora e veja o que ele contém.

Obtenha mais detalhes

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

Passo Seguinte

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