az (Azure CLI)コマンド チートシート

Azure CLIを使用するための最初のステップです。

Azureリソースのコンテナであるリソースグループを管理します。

使用例

# 新しいリソースグループを作成
az group create --name MyResourceGroup --location japaneast

# リソースグループ一覧をテーブル形式で表示
az group list -o table

# 特定のリソースグループを削除 (確認あり)
# az group delete --name MyResourceGroup

# リソースグループを削除 (確認なし)
# az group delete --name MyResourceGroup --yes

LinuxおよびWindows仮想マシンを作成、管理します。

使用例

# Ubuntu VMを作成 (SSHキーは自動生成)
az vm create \
  --resource-group MyResourceGroup \
  --name MyVM \
  --image UbuntuLTS \
  --size Standard_B1s \
  --admin-username azureuser \
  --generate-ssh-keys

# VMの一覧と状態を表示
az vm list -g MyResourceGroup -d -o table

# VMを停止して割り当て解除
az vm deallocate -g MyResourceGroup -n MyVM

# VMを起動
az vm start -g MyResourceGroup -n MyVM

Blob、File、Queue、Tableストレージを含むストレージアカウントを管理します。

使用例

# Standard_LRS SKUでストレージアカウントを作成
az storage account create \
  --name mystorageaccount$RANDOM \
  --resource-group MyResourceGroup \
  --location japaneast \
  --sku Standard_LRS

# ストレージアカウントのキーを取得 (例: 最初のキー)
STORAGE_KEY=$(az storage account keys list \
  --resource-group MyResourceGroup \
  --account-name <ストレージアカウント名> \
  --query "[0].value" -o tsv)

# 'mycontainer' という名前のコンテナを作成 (キー認証)
az storage container create \
  --account-name <ストレージアカウント名> \
  --name mycontainer \
  --account-key $STORAGE_KEY

# 'myfile.txt' を 'mycontainer' に 'myblob.txt' としてアップロード
# echo "Hello Azure" > myfile.txt
# az storage blob upload \
#   --account-name <ストレージアカウント名> \
#   --container-name mycontainer \
#   --name myblob.txt \
#   --file myfile.txt \
#   --account-key $STORAGE_KEY

仮想ネットワーク (VNet)、サブネット、ネットワークセキュリティグループ (NSG)、パブリックIPアドレスなどを管理します。

使用例

# 仮想ネットワークとサブネットを作成
az network vnet create \
  -g MyResourceGroup -n MyVNet -l japaneast \
  --address-prefixes 10.1.0.0/16 \
  --subnet-name MySubnet --subnet-prefix 10.1.0.0/24

# NSGを作成
az network nsg create -g MyResourceGroup -n MyNSG -l japaneast

# SSH (ポート22) を許可する受信規則をNSGに追加
az network nsg rule create \
  -g MyResourceGroup --nsg-name MyNSG -n AllowSSH \
  --priority 100 --protocol Tcp --direction Inbound \
  --access Allow --source-address-prefixes '*' \
  --destination-address-prefixes '*' --destination-port-ranges 22

# 静的なStandard SKUのパブリックIPを作成
az network public-ip create \
  -g MyResourceGroup -n MyPublicIP -l japaneast \
  --allocation-method Static --sku Standard

Webアプリ、APIアプリ、モバイルバックエンドをホストするためのApp Serviceとプランを管理します。

使用例

# Linux用のFreeプランを作成
az appservice plan create -g MyResourceGroup -n MyLinuxPlan -l japaneast --is-linux --sku F1

# Node.js 16 LTSランタイムでLinux Webアプリを作成
az webapp create -g MyResourceGroup -n MyUniqueWebAppName -p MyLinuxPlan --runtime "NODE|16-lts"

# アプリケーション設定を追加
az webapp config appsettings set -g MyResourceGroup -n MyUniqueWebAppName --settings MySetting=MyValue ANOTHER_SETTING="Value with spaces"

# ZIPファイルでデプロイ (事前に app.zip を作成しておく)
# az webapp deployment source config-zip -g MyResourceGroup -n MyUniqueWebAppName --src app.zip

Azure Container Registry (ACR), Azure Kubernetes Service (AKS), Azure Container Instances (ACI) を管理します。

使用例

# Standard SKUのACRを作成
az acr create -g MyResourceGroup -n myuniqueacrname -l japaneast --sku Standard

# ACRにDocker CLIでログイン
az acr login -n myuniqueacrname

# (Dockerイメージをビルドしてプッシュする例 - Dockerfileがあるディレクトリで実行)
# docker build -t myuniqueacrname.azurecr.io/myimage:v1 .
# docker push myuniqueacrname.azurecr.io/myimage:v1

# 2ノードのAKSクラスターを作成
az aks create -g MyResourceGroup -n MyAKSCluster --node-count 2 --generate-ssh-keys

# kubectlがAKSクラスターを操作できるように認証情報を取得
az aks get-credentials -g MyResourceGroup -n MyAKSCluster

# (kubectlコマンドを実行して確認)
# kubectl get nodes

# ACIでNginxコンテナを起動
az container create -g MyResourceGroup --name myacicontainer --image nginx --dns-name-label myuniqueacicontainer --ports 80

Azure SQL Database, Azure Cosmos DBなどのデータベースサービスを管理します。

使用例

# SQL Database サーバーを作成
az sql server create -g MyResourceGroup -n mysqlserver$RANDOM -l japaneast \
  --admin-user myadmin --admin-password 'ComplexP@ssw0rd!'

# 現在のクライアントIPを許可するファイアウォールルールを作成
az sql server firewall-rule create -g MyResourceGroup -s <サーバー名> -n AllowMyIP \
  --start-ip-address <あなたのIP> --end-ip-address <あなたのIP>

# Standard S0エディションでSQL Databaseを作成
az sql db create -g MyResourceGroup -s <サーバー名> -n MyDatabase \
  --edition Standard --service-objective S0

# Cosmos DB (SQL API) アカウントを作成
az cosmosdb create -g MyResourceGroup -n myuniquecosmosdb -l japaneast \
  --capabilities EnableSql

# Cosmos DBデータベースとコンテナを作成
az cosmosdb sql database create -g MyResourceGroup -a myuniquecosmosdb -n MyCosmosDB
az cosmosdb sql container create -g MyResourceGroup -a myuniquecosmosdb -d MyCosmosDB -n MyContainer --partition-key-path /myPartitionKey

コマンドの出力を整形したり、特定の情報だけを抽出したりします。

使用例

# VMの一覧をテーブル形式で表示
az vm list -o table

# VMの一覧から名前だけをTSV形式で表示
az vm list --query "[].name" -o tsv

# 特定のリソースグループにあるVMの名前とOSの種類をテーブル表示用に整形
az vm list -g MyResourceGroup --query "[].{Name:name, OSType:storageProfile.osDisk.osType}" -o table

# japaneastリージョンにあるリソースグループの名前一覧を取得
az group list --query "[?location=='japaneast'].name" -o tsv

JMESPathの詳細は JMESPath Tutorial を参照してください。

• 変数を使う: シェル変数を使用して、繰り返し使う値（リソースグループ名、場所など）を格納します。

  RG_NAME="MyResourceGroup"
  LOCATION="japaneast"
  VM_NAME="MyVM"
  
  az group create -n $RG_NAME -l $LOCATION
  az vm create -g $RG_NAME -n $VM_NAME --image UbuntuLTS ... # 他のオプション
  

• コマンドの結果を変数に格納する: --query と -o tsv を使って特定の値を抽出し、シェルのコマンド置換（$(...) や “` `…` “`）で変数に格納します。

  PUBLIC_IP=$(az vm show -g $RG_NAME -n $VM_NAME -d --query publicIps -o tsv)
  echo "VM Public IP: $PUBLIC_IP"
  
  STORAGE_KEY=$(az storage account keys list -g $RG_NAME -n mystorageaccount --query "[0].value" -o tsv)
  echo "Storage Key: $STORAGE_KEY"
  

• ループ処理: 複数のリソースに対して同じ操作を行う場合に、シェルのループ構文 (for など) と組み合わせます。

  # リソースグループ内の全VMを停止する (例)
  VM_NAMES=$(az vm list -g $RG_NAME --query "[].name" -o tsv)
  for vm in $VM_NAMES; do
    echo "Stopping VM: $vm"
    az vm stop -g $RG_NAME -n $vm
    az vm deallocate -g $RG_NAME -n $vm
  done
  

• 冪等性 (Idempotency): az ... create コマンドは、リソースが既に存在する場合でもエラーにならないことが多いです（設定が同じ場合）。スクリプトを何度実行しても同じ状態になるように意識します。存在確認が必要な場合は az ... show や az ... list --query を利用します。
• エラーハンドリング: シェルの機能 (set -e など) を利用して、コマンドが失敗した場合にスクリプトを停止するようにします。
• --yes (-y) オプション: 削除コマンドなどで確認プロンプトをスキップし、自動実行を可能にします。⚠️ 注意して使用してください。
• az find コマンド: キーワードに関連するAzure CLIコマンドを検索するのに役立ちます。

  az find "create vm"
  az find "list storage accounts in resource group"