Prepare o seu ambiente para a CLI do Azure

Neste passo tutorial, executa os seus primeiros comandos 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 Azure, crie uma conta gratuita Azure antes de começar.

Para concluir esta etapa do tutorial, precisas de permissões de nível contributor ou superiores na tua subscrição.

Instalar a CLI do Azure

Comece selecionando seu ambiente.

• Use o ambiente Bash em Azure Cloud Shell selecionando o botão Open Cloud Shell no canto superior direito de cada bloco de código CLI do Azure.

• Se preferir executar os comandos de referência da CLI do Azure localmente, instalar o CLI do Azure.

A versão atual do CLI do Azure é 2.85.0. Para obter informações sobre a versão mais recente, consulte as notas de versão. Para encontrar sua versão instalada e ver se você precisa atualizar, execute az version.

Inicie sessão no Azure usando a CLI do Azure

Existem várias opções autenticação ao trabalhar com o CLI do Azure. O método de autenticação padrão da CLI do Azure para iniciar sessão utiliza um navegador web e um token de acesso para iniciar sessão.

1. Execute o comando az login.

   az login
   

   Se o CLI do Azure conseguir abrir o seu navegador predefinido, ele inicia o fluxo de código de autorização e abre o navegador predefinido para carregar uma página de início de sessão 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 se o navegador da Web não abrir, você poderá 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 não estiver a trabalhar com a subscrição da sua preferência, altere a sua subscrição usando az account set. 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 para 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 uma lista de locais Azure disponíveis, veja Escolha a região Azure certa para si.

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

3. É hora de criar seu grupo de recursos. Utilize 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 em seu nome. Adicionar um ID aleatório ao nome do seu grupo de recursos permite-lhe voltar a testar o seu código sem ter de 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 de 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âmetros. 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 do CLI do Azure têm múltiplos valores separados por um espaço. Os valores de configuração são uma dessas instâncias. O exemplo seguinte define tanto os valores padrão .location como .group usados pelos parâmetros --location e --resource-group de cada comando CLI do Azure.

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

3. Defina sua saída padrão.

   Quando escolhe trabalhar em Azure Cloud Shell ou instalar o CLI do Azure localmente, a saída padrão é automaticamente definida para json. No entanto, essa configuração é um dos padrões mais importantes para entender e definir. A saída determina o que aparece no console e o que está gravado no arquivo de log. Use sempre uma saída de none quando estiver criando recursos que retornem 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 te guia na configuração do teu ambiente. Digite az init no console e pressione Enter. Siga as instruções fornecidas.

   az init
   

   Um aspeto importante do az init é que ele exibe todas as suas configurações atuais. Eis um exemplo do resultado:

   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 its 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 padrão de AZURE_CONFIG_DIR é $HOME/.azure no Linux e macOS, e %USERPROFILE%\.azure no Windows. Localize o arquivo de configuração e revise seu conteúdo.

Obtenha mais detalhes

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

Próximo Passo

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