このチュートリアルの手順では、最初のAzure CLI コマンドを実行します。 これには、アクティブなサブスクリプションの検索と設定、既定値の設定が含まれます。 また、ランダム ID を含むリソース グループを作成して、一意のリソース名を常に保証する方法についても学習します。
Azure サブスクリプションがない場合は、開始する前にAzure無料アカウントを作成します。
このチュートリアル手順を完了するには、サブスクリプションに対する 以上のアクセス許可が必要です。
Azure CLIをインストールする
まず、環境を選択します。
各Azure CLIコード ブロックの右上隅にある Open Cloud Shell ボタンを選択して、Azure Cloud Shell の Bash 環境を使用します。
Azure CLI参照コマンドをローカルで実行する場合は、Azure CLIinstallします。
Azure CLIの現在のバージョンは 2.84.0 です。 最新リリースについては、リリース ノートをご覧ください。 インストール済みのバージョンを見つけ、更新する必要があるかどうかを確認するには、az version を実行します。
Azure CLIを使用してAzureにサインインする
Azure CLIを操作する場合、認証オプションがいくつかあります。 ログインのAzure CLIの既定の認証方法では、Web ブラウザーとアクセス トークンを使用してサインインします。
コマンドを実行します。
az login既定Azure CLIブラウザーを開くことができる場合、認証コード フローが開始され、既定のブラウザーが開き、Azureサインイン ページが読み込まれます。
それ以外の場合は、 デバイス コード フロー を開始し、 でブラウザー ページを開くよう指示します。 次に、ご利用のターミナル内に表示されたコードを入力します。
Web ブラウザーが使用できない場合、または Web ブラウザーが開かない場合は、 を使用してデバイス コード フローを強制できます。
ブラウザーでアカウントの資格情報を使用してサインインします。
アクティブなサブスクリプションを見つけて変更する
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>
コマンドのコンソール出力:
{
"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 リソースのコンテナーです。 リソース グループを作成するには、サブスクリプションでの 以上のアクセス許可が必要です。
リソース グループを作成する
リソース グループ名はサブスクリプション内で一意である必要があります。 まず、 az group exists コマンドを使用して、目的の名前を使用できるかどうかを確認します。 という出力値は、名前が使用可能であることを意味します。
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 の変数の構文は異なります。 環境に適したスクリプトをコピーします。
- バッシュ
- 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 つです。 出力によって、本体に表示される内容とログ ファイルに書き込まれる内容が決まります。 キー、パスワード、シークレットを返すリソースを作成するときは、常に の出力を使用します。az config set core.output=noneこのチュートリアルでは、シークレットは扱いません。 このチュートリアルでは返される各リファレンス コマンドの出力を確認できるように、既定値を に設定し直します。
az config set core.output=jsonを使用する方法を学習します。
Azure CLIには、環境を構成する手順を示す参照コマンドがあります。 コンソールで「」と入力してから、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 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:構成ファイルを見つけて目を通します。
"信頼はするが検証は行う" の考え方で作業するなら、構成ファイルが保存されている場所と、それに含まれる内容を把握する必要があります。 構成ファイル自体は にあります。
AZURE_CONFIG_DIRの既定値は、Linux および macOS では$HOME/.azure、Windows では%USERPROFILE%\.azureです。 構成ファイルを見つけて、その内容を確認します。
詳細を取得する
このチュートリアル手順で説明したテーマのいずれかについてさらなる詳細が必要ですか? 次の表のリンクを使用してさらに学習してください。
| サブジェクト | 詳細情報 |
|---|---|
| 環境 | 適切な Azure コマンドライン ツールを選んでください |
| サインイン オプション | Azure CLI でサインインする |
| 条件 | Azure CLI用語とサポート レベル |
| サブスクリプション | |
| リソース グループ | |
| Configurations | |
| Azureのロール | Azure の役割、Microsoft Entra の役割、クラシック サブスクリプション管理者の役割 |
次の手順
環境を構成する方法を学習したら、次の手順に進み、Bash、PowerShell、 のスクリプトの違いを理解します。
Azure CLI