Подготовка среды к работе с Azure CLI

Статья
12/06/2023

На этом шаге руководства вы выполните первые команды Azure CLI! Это включает поиск и настройку активной подписки и настройки значений по умолчанию. Вы также узнаете, как создавать группы ресурсов, содержащие случайный идентификатор, чтобы всегда гарантировать уникальное имя ресурса.

Если у вас еще нет подписки Azure, создайте бесплатную учетную запись Azure, прежде чем начинать работу.

Чтобы выполнить этот шаг руководства, вам нужны contributor или более высокие разрешения для подписки.

Установка расширения для Azure CLI

Начните, сначала выбрав среду.

Используйте среду Bash в Azure Cloud Shell, нажав кнопку Open Cloud Shell в правом верхнем углу каждого блока кода Azure CLI.
Если вы предпочитаете локально запускать справочные команды Azure CLI, установите Azure CLI.

Текущая версия Azure CLI — 2.60.0. Сведения о последнем выпуске см. в заметках о выпуске. Чтобы узнать, какая версия установлена и нужно ли ее обновить, выполните команду az version.

Существует несколько вариантов проверки подлинности при работе с Azure CLI. Метод проверки подлинности для входа в систему, используемый в Azure CLI по умолчанию, — вход с помощью веб-браузера и маркера доступа.

Выполните команду az login.
```
az login
```
Если Azure CLI может открыть браузер по умолчанию, он инициирует поток кода авторизации и открывает браузер по умолчанию для загрузки страницы входа Azure.

В противном случае он инициирует поток кода устройства и указывает, на что вы откроете страницу браузера.https://aka.ms/devicelogin Затем введите код, отображаемый в терминале.

Если веб-браузер недоступен или его не удается открыть, вы можете использовать поток кода устройства с применением az login --use-device-code.
Выполните вход в браузере с помощью учетных данных.

Поиск и изменение активной подписки

После входа в Azure CLI всегда проверка текущей подписке. Если вы не работаете в выбранной подписке, измените подписку с помощью az account set. Ниже приведен пример кода для использования:

# 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>

Выходные данные консоли для 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"
  }
}

Сведения о группах ресурсов

Группа ресурсов Azure служит контейнером для ресурсов Azure. Чтобы создать группу ресурсов, вам потребуются contributor разрешения или более высокие разрешения в подписке.

Создание или изменение группы ресурсов

В подписке имя группы ресурсов должно быть уникальным. Сначала проверка, если нужное имя доступно с помощью команды az group существует. Выходное значение false означает, что имя доступно.
```
az group exists --name <myUniqueRGname>
```
Получите список поддерживаемых регионов для подписки с помощью команды az account list-locations . Список доступных расположений Azure см. в разделе "Выбор подходящего региона Azure".
```
az account list-locations --query "[].{Region:name}" --output table
```
Пришло время создать группу ресурсов! Используйте команду az group create.
```
az group create --location <myLocation> --name <myUniqueRGname>
```

Создание группы ресурсов, содержащей случайный идентификатор

При тестировании рекомендуется создать группу ресурсов, содержащую случайный идентификатор в имени. Добавление случайного идентификатора в имя группы ресурсов позволяет повторно тестировать код, не ожидая удаления предыдущей группы ресурсов с тем же именем из Azure.

Синтаксис переменных Bash и PowerShell отличаются. Скопируйте правильный скрипт для вашей среды.

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

Выходные данные консоли Bash и 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"
}

Настройка переменных среды

Azure CLI предлагает несколько вариантов, позволяющих повторно использовать общие значения параметров. Эти значения по умолчанию хранятся в переменных среды и уникальны для каждого входа.

Задайте группу ресурсов по умолчанию.
```
az config set defaults.group=<msdocs-tutorial-rg-0000000>
```
Задайте сразу несколько переменных среды.

Многие параметры Azure CLI принимают несколько значений, разделенных пробелом. Значения конфигурации являются одним из таких экземпляров. В следующем примере задаются .location как значения, так и .group значения по умолчанию, используемые --location--resource-group каждой командой Azure CLI.
```
az config set defaults.location=westus2 defaults.group=<msdocs-tutorial-rg-0000000>
```
Задайте выходные данные по умолчанию.

Если вы решили работать в Azure Cloud Shell или установить Azure CLI локально, выходные данные по умолчанию автоматически устанавливаются json. Однако это один из наиболее важных по умолчанию по умолчанию для понимания и задания. Выходные данные определяют, что отображается в консоли и что записывается в файл журнала. Всегда используйте выходные данные none при создании ресурсов, возвращающих ключи, пароли и секреты.
```
az config set core.output=none
```
В этом руководстве мы не работаем с секретами. Задайте значение по умолчанию, json чтобы просмотреть возвращаемые выходные данные каждой справочной команды в этом руководстве.
```
az config set core.output=json
```

Узнайте, как использовать az init.

Azure CLI содержит справочную команду, которая описывает настройку среды. Введите az init консоль и нажмите клавишу ВВОД. Следуйте предоставленным запросам.

az init

Первое приятное о az init заключается в том, что он дает вам все ваши текущие параметры! Ниже приведен пример выходных данных:

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:

Поиск и чтение файла конфигурации.

Если вы работаете под "доверием, но проверьте" мышление, вы хотите знать, где хранятся файлы конфигурации и что они содержат. Файл конфигурации расположен здесь: $AZURE_CONFIG_DIR/config. По умолчанию для AZURE_CONFIG_DIR устанавливается значение $HOME/.azure в Linux и macOS и %USERPROFILE%\.azure в Windows. Найдите файл конфигурации и посмотрите, что он содержит.

Дополнительные сведения

Хотите подробнее об одном из тем, описанных на этом шаге руководства? Чтобы узнать больше, воспользуйтесь ссылками в этой таблице.

Тема	Подробнее
Среды	Выбор программы командной строки Azure
Параметры входа	Вход с помощью Azure CLI
Условия	Терминология и уровни поддержки Azure CLI
Подписки	Управление подписками с помощью Azure CLI
Группы ресурсов	Управление группами ресурсов с помощью Azure CLI
Конфигурации	Настройка Azure CLI
Роли в Azure	Роли Azure, роли Microsoft Entra и роли администратора классической подписки

Следующий шаг

Теперь, когда вы узнали, как настроить среду, перейдите к следующему шагу, чтобы узнать о различиях сценариев между Bash, PowerShell и Cmd.

Сведения о различиях синтаксиса Azure CLI в Bash, PowerShell и Cmd