Azure CLI の環境を準備する
このチュートリアル手順では、初めての Azure CLI コマンドを実行します。 これには、アクティブなサブスクリプションの検索と設定、既定値の設定が含まれます。 また、ランダム ID を含むリソース グループを作成して、一意のリソース名を常に保証する方法についても学習します。
Azure サブスクリプションをお持ちでない場合は、開始する前に Azure 無料アカウントを作成してください。
このチュートリアル手順を完了するには、サブスクリプションに対する contributor 以上のアクセス許可が必要です。
Azure CLI のインストール
まず、環境を選択することから始めます。
各 Azure CLI コード ブロックの右上隅にある [Cloud Shell を開く] ボタンを選択することで、Azure Cloud Shell の Bash 環境を使用します。
Azure CLI リファレンス コマンドをローカルで実行したい場合は、Azure CLI をインストールします。
Azure CLI の現在のバージョンは 2.66.0です。 最新リリースについては、リリース ノートをご覧ください。 インストール済みのバージョンを見つけ、更新する必要があるかどうかを確認するには、az version を実行します。
Azure CLI を使用して Azure にサインインする
Azure CLI を使用する際には、いくつかの認証オプションがあります。 Azure CLI のログインのための既定の認証方法では、サインインに Web ブラウザーとアクセス トークンを使用します。
az loginコマンドを実行します。az loginAzure CLI が既定のブラウザーを開くことができる場合、認可コード フローを開始し、既定のブラウザーを開いて Azure サインイン ページを読み込みます。
それ以外の場合は、デバイス コード フローを開始し、ユーザーにブラウザーのページで https://aka.ms/devicelogin を開くように指示します。 次に、ご利用のターミナル内に表示されたコードを入力します。
Web ブラウザーが使用できないか、Web ブラウザーを開けない場合は、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 リソース用のコンテナーです。 リソース グループを作成するには、サブスクリプションでの contributor 以上のアクセス許可が必要です。
リソース グループを作成する
リソース グループ名はサブスクリプション内で一意である必要があります。 まず、az group exists コマンドを使用して、目的の名前が使用できるかどうかを確認します。
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>
ランダム ID を含むリソース グループを作成する
テストの際には、名前にランダム ID を含むリソース グループを作成することが最善です。 リソース グループ名にランダム ID を追加すると、同じ名前の以前のリソース グループが Azure から削除されるのを待つ必要なくコードを再テストできます。
Bash と PowerShell の変数の構文は異なります。 環境に適したスクリプトをコピーします。
let "randomIdentifier=$RANDOM*$RANDOM"
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 パラメーターは、スペースで区切られた複数の値を受け取ります。 構成値は、そのようなインスタンスの 1 つです。 次の例は、すべての Azure CLI コマンドの
--locationおよび--resource-groupパラメーターによって使用される.locationおよび.groupの既定値を両方とも設定します。az config set defaults.location=westus2 defaults.group=<msdocs-tutorial-rg-0000000>既定の出力を設定します。
Azure Cloud Shell で作業するか、Azure CLI をローカルにインストールすることを選択した場合、既定の出力は自動的に
jsonに設定されます。 しかし、これは、理解して設定するべき最も重要な既定値の 1 つです。 出力は、コンソールに表示される内容とログ ファイルに書き込まれる内容を決定します。 キー、パスワード、シークレットを返すリソースを作成するときは、常に出力noneを使用します。az config set core.output=noneこのチュートリアルでは、シークレットは扱いません。 このチュートリアルでは返される各リファレンス コマンドの出力を確認できるように、既定値を
jsonに設定し直します。az config set core.output=jsonaz initを使用する方法を学習します。Azure CLI には、利用者が環境の構成を行うのをサポートするリファレンス コマンドがあります。 コンソールで「
az init」と入力してから、Enter キーを押します。 現れたプロンプトに従います。az initaz 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の既定値は、Linux と macOS の場合は$HOME/.azure、Windows の場合は%USERPROFILE%\.azureです。 ここで構成ファイルを見つけて、それに含まれる内容を確認します。
詳細を取得する
このチュートリアル手順で説明したテーマのいずれかについてさらなる詳細が必要ですか? 次の表のリンクを使用してさらに学習してください。
| サブジェクト | 詳細情報 |
|---|---|
| 環境 | 適切な Azure コマンドライン ツールを選ぶ |
| サインイン オプション | Azure CLI を使用してサインインする |
| 条件 | Azure CLI の用語とサポート レベル |
| サブスクリプション | Azure CLI を使用してサブスクリプションを管理する |
| リソース グループ | Azure CLI を使用してリソース グループを管理する |
| 構成 | Azure CLI を構成する |
| Azure ロール | Azure ロール、Microsoft Entra ロール、従来のサブスクリプション管理者ロール |
次の手順
環境を構成する方法を学習したので、次の手順に進み、Bash、PowerShell、Cmd のスクリプトの違いについて学習してください。
Azure CLI