Azure ハンズオン事前準備手順書

Azure

Posted at 2026-04-12

～ゼロから前提条件を満たすまでの完全ガイド～

📋 この資料でできるようになること

#	やること	所要時間の目安
1	Azure アカウント・サブスクリプションの作成	約15〜30分
2	サブスクリプションの権限確認・設定	約5分
3	Azure CLI のインストールと設定	約15分
4	Java（JDK 11以上）のインストール	約10分
5	Maven または Gradle のインストール	約10分
6	PowerShell 7 のインストール	約10分
7	Az モジュールのインストール	約5分
8	全項目の動作確認	約5分

💻 対象OS: Windows 11 / macOS 14以降 / Ubuntu 22.04
各手順にはOS別のコマンドを記載しています。

STEP 1：Azure アカウント・サブスクリプションの作成

1-1. Microsoft アカウントの準備

Azure を使うには、Microsoft アカウントが必要です。

すでに持っている場合 → そのまま STEP 1-2 に進みます。

持っていない場合 → 以下のURLから作成します。

https://account.microsoft.com/

「Microsoftアカウントを作成」 をクリック
メールアドレスを入力（GmailなどでもOK）
パスワードを設定して登録を完了させます

1-2. Azure 無料アカウントの作成

ブラウザで以下のURLにアクセスします。
```
https://azure.microsoft.com/ja-jp/free/
```
「無料で始める」 をクリックします。
Microsoft アカウントでサインインします。

以下の情報を入力します。

入力項目	内容
国/地域	日本
名前・姓	ご自身の氏名
電話番号	SMS認証に使用
クレジットカード情報	本人確認用（無料期間中は課金されません）

利用規約に同意して 「サインアップ」 をクリックします。
登録完了後、Azure Portal にログインできることを確認します。
```
https://portal.azure.com/
```

⚠️ 無料アカウントには 200ドル分の無料クレジット（30日間） と 12ヶ月間の無料サービス が含まれます。ハンズオン終了後はリソースを削除して意図しない課金を防いでください。

1-3. サブスクリプション情報の確認・メモ

ログイン後、以降の手順で必要になる情報をメモしておきます。

Azure Portal での確認方法

Azure Portal（https://portal.azure.com/）にログイン
上部の検索バーに 「サブスクリプション」 と入力してクリック
一覧に表示されたサブスクリプションをクリック
「サブスクリプション ID」 をコピーしてメモ

メモ欄：
サブスクリプション ID : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
テナント ID          : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

テナント ID は同じ画面の 「ディレクトリ ID」 として表示されます。

STEP 2：サブスクリプションの権限確認・設定

ハンズオンでは 「所有者」または「共同作成者」 の権限が必要です。

2-1. 自分の権限を確認する

Azure Portal での確認方法

「サブスクリプション」 → 対象のサブスクリプションをクリック
左メニューの 「アクセス制御 (IAM)」 をクリック
「自分のアクセスの表示」 をクリック
自分のユーザーに 「所有者」 または 「共同作成者」 のロールが付与されているか確認

Azure CLI での確認方法（STEP 3 完了後に実行）

az role assignment list \
  --assignee $(az ad signed-in-user show --query id -o tsv) \
  --all \
  --query "[].{Role:roleDefinitionName, Scope:scope}" \
  -o table

2-2. 権限が付与されていない場合

無料アカウントを自分で作成した場合は、作成者が自動的に「所有者」になるため、この手順は不要です。

社内や組織のサブスクリプションを使用する場合は、管理者に以下を依頼します。

対象サブスクリプションスコープで 「所有者」 または 「共同作成者」 ロールの付与

管理者が権限を付与する手順（Azure Portal）

「サブスクリプション」 → 対象サブスクリプション → 「アクセス制御 (IAM)」
「+ 追加」 → 「ロールの割り当ての追加」 をクリック
「共同作成者」 を選択して 「次へ」
「+ メンバーを選択する」 で対象ユーザーを検索して選択
「レビューと割り当て」 をクリックして完了

STEP 3：Azure CLI のインストールと設定

3-1. Azure CLI のインストール

Windows の場合

PowerShell を 管理者として起動 して以下を実行します。

# winget でインストール（推奨）
winget install Microsoft.AzureCLI

または以下のURLからインストーラーをダウンロードして実行します。

https://aka.ms/installazurecliwindows

インストール完了後、PowerShell またはコマンドプロンプトを 再起動 します。

macOS の場合

# Homebrew でインストール（推奨）
brew update
brew install azure-cli

Homebrew がインストールされていない場合は先に以下を実行します。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Linux (Ubuntu) の場合

# Microsoftの署名キーとリポジトリを登録してインストール
curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

✅ インストール確認

az --version
# 出力例: azure-cli 2.x.x

3-2. Azure CLI でのサインイン

az login

ブラウザが自動的に開き、Microsoft アカウントのログイン画面が表示されます。
サインインが完了すると、ターミナルにサブスクリプション情報が表示されます。

[
  {
    "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "Azure subscription 1",
    "state": "Enabled",
    "tenantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
]

ブラウザが開かない環境（サーバー等）の場合は以下を使います。

az login --use-device-code

3-3. 使用するサブスクリプションの設定

複数のサブスクリプションがある場合は、使用するものを明示的に設定します。

# サブスクリプションの一覧を確認
az account list -o table

# 使用するサブスクリプションを設定
az account set --subscription "<サブスクリプション ID またはサブスクリプション名>"

# 設定の確認
az account show -o table

3-4. Azure CLI の接続確認

# リソースグループの一覧を取得して接続確認
az group list -o table

エラーなく一覧（または空の結果）が返ってきたら接続成功です。

STEP 4：Java（JDK 11以上）のインストール

4-1. JDK のインストール

Windows の場合

# winget でMicrosoft Build of OpenJDK 17をインストール
winget install Microsoft.OpenJDK.17

または以下のURLからインストーラーをダウンロードします。

https://learn.microsoft.com/ja-jp/java/openjdk/download

JDK 17 の Windows x64 MSI をダウンロードしてインストーラーを実行します。
インストール時に 「Add to PATH」 にチェックが入っていることを確認してください。

macOS の場合

# Homebrew でインストール
brew install openjdk@17

# パスを通す（zsh の場合）
echo 'export PATH="/opt/homebrew/opt/openjdk@17/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Linux (Ubuntu) の場合

sudo apt update
sudo apt install -y openjdk-17-jdk

4-2. JAVA_HOME 環境変数の設定

Windows の場合

# 管理者PowerShellで実行
[System.Environment]::SetEnvironmentVariable(
    "JAVA_HOME",
    "C:\Program Files\Microsoft\jdk-17.0.x.x-hotspot",
    "Machine"
)
# ターミナルを再起動して反映

macOS の場合

echo 'export JAVA_HOME=$(/usr/libexec/java_home -v 17)' >> ~/.zshrc
source ~/.zshrc

Linux (Ubuntu) の場合

echo 'export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64' >> ~/.bashrc
source ~/.bashrc

4-3. インストール確認

java -version
echo $JAVA_HOME   # macOS / Linux

# 期待される出力例
openjdk version "17.0.x" 202x-xx-xx
OpenJDK Runtime Environment Microsoft-xxxxxxxx
OpenJDK 64-Bit Server VM Microsoft-xxxxxxxx (build 17.0.x+x, mixed mode, sharing)

⚠️ バージョンが 11以上 であることを確認してください。

STEP 5：Maven または Gradle のインストール

Maven と Gradle はどちらか一方のインストールで構いません。
迷った場合は Maven を選んでください（ハンズオンのサンプルコードはMavenを基本としています）。

5-A. Maven のインストール

Windows の場合

winget install Apache.Maven

または以下のURLからバイナリ zip をダウンロードして C:\Program Files\Maven\ に展開し、PATH に C:\Program Files\Maven\bin を追加します。

https://maven.apache.org/download.cgi

macOS の場合

brew install maven

Linux (Ubuntu) の場合

sudo apt install -y maven

Maven の確認

mvn -version

# 期待される出力例
Apache Maven 3.9.x (...)
Maven home: /usr/share/maven
Java version: 17.0.x, vendor: Microsoft Build of OpenJDK, ...

⚠️ Java version が 11以上 であることを確認してください。

5-B. Gradle のインストール（Maven の代わりに使う場合）

Windows の場合

winget install Gradle.Gradle

macOS の場合

brew install gradle

Linux (Ubuntu) の場合

# SDKMAN 経由でインストール（推奨）
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"
sdk install gradle

Gradle の確認

gradle --version

# 期待される出力例
------------------------------------------------------------
Gradle 8.x
------------------------------------------------------------
JVM: 17.0.x (Microsoft ...)
OS: ...

STEP 6：PowerShell 7 のインストール

6-1. PowerShell 7 のインストール

Windows の場合

Windows には PowerShell 5.1 が標準搭載されていますが、PowerShell 7（pwsh） は別途インストールが必要です。

# PowerShell 5.1 のウィンドウで実行
winget install Microsoft.PowerShell

または Microsoft Store から 「PowerShell」 を検索してインストールします。

インストール後はスタートメニューから 「PowerShell 7」 を起動します（pwsh コマンドでも起動できます）。

macOS の場合

brew install --cask powershell

Linux (Ubuntu) の場合

# Microsoft GPGキーとリポジトリを登録
sudo apt update
sudo apt install -y wget apt-transport-https software-properties-common
wget -q "https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb"
sudo dpkg -i packages-microsoft-prod.deb
sudo apt update
sudo apt install -y powershell

6-2. インストール確認

pwsh --version

# 期待される出力例
PowerShell 7.4.x

⚠️ powershell（バージョン5.1）ではなく pwsh（バージョン7以上） で動作していることを確認してください。

STEP 7：Az モジュールのインストール

PowerShell 7（pwsh）を起動してから以下を実行します。

7-1. PowerShell 7 の起動

pwsh

7-2. Az モジュールのインストール

# NuGet プロバイダーのインストール（初回のみ）
Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force

# Az モジュールのインストール
Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

⏳ Az モジュールは多数のサブモジュールを含むため、インストールに 5〜15分程度 かかる場合があります。

7-3. Az モジュールのインポートと Azure サインイン

# モジュールのインポート
Import-Module Az

# Azure にサインイン
Connect-AzAccount

ブラウザが開き、Microsoft アカウントのログイン画面が表示されます。
サインインが完了するとターミナルにサブスクリプション情報が表示されます。

Account          SubscriptionName    TenantId
-------          ----------------    --------
user@example.com Azure subscription  xxxxxxxx-xxxx-...

7-4. Az モジュールの接続確認

# サブスクリプションの一覧を取得して接続確認
Get-AzSubscription

# 期待される出力例
Name                  Id                                   TenantId
----                  --                                   --------
Azure subscription 1  xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-...

STEP 8：全項目の動作確認

すべての前提条件が整ったか、以下のスクリプトでまとめて確認します。

確認スクリプト

bash / zsh（macOS・Linux・Windows WSL）

echo "=== Azure ハンズオン 前提条件 確認レポート ==="
echo ""

echo "【1】Azure CLI"
az --version 2>/dev/null | head -1 && echo "✅ OK" || echo "❌ 未インストール"
echo ""

echo "【2】Azure CLI サインイン確認"
az account show --query "{name:name, id:id}" -o table 2>/dev/null \
  && echo "✅ OK（Azureへの接続成功）" \
  || echo "❌ 未サインイン（az login を実行してください）"
echo ""

echo "【3】Java"
java -version 2>&1 | head -1 && echo "✅ OK" || echo "❌ 未インストール"
echo ""

echo "【4-A】Maven"
mvn -version 2>&1 | head -1 && echo "✅ OK" || echo "⚠️  未インストール（Gradleを使う場合は不要）"
echo ""

echo "【4-B】Gradle"
gradle --version 2>/dev/null | head -3 && echo "✅ OK" || echo "⚠️  未インストール（Mavenを使う場合は不要）"
echo ""

echo "【5】PowerShell 7"
pwsh --version 2>/dev/null && echo "✅ OK" || echo "❌ 未インストール"
echo ""

echo "【6】Az モジュール"
pwsh -c "Get-Module -ListAvailable Az.Accounts | Select-Object Name,Version" 2>/dev/null \
  && echo "✅ OK" \
  || echo "❌ 未インストール（Install-Module -Name Az を実行してください）"

PowerShell（Windows・pwsh で実行）

Write-Host "=== Azure ハンズオン 前提条件 確認レポート ===" -ForegroundColor Cyan
Write-Host ""

# Azure CLI
Write-Host "【1】Azure CLI" -ForegroundColor Yellow
$azVersion = az --version 2>&1 | Select-Object -First 1
if ($LASTEXITCODE -eq 0) { Write-Host "✅ OK: $azVersion" -ForegroundColor Green }
else { Write-Host "❌ 未インストール" -ForegroundColor Red }
Write-Host ""

# Azure CLI サインイン確認
Write-Host "【2】Azure CLI サインイン確認" -ForegroundColor Yellow
$account = az account show --query "name" -o tsv 2>&1
if ($LASTEXITCODE -eq 0) { Write-Host "✅ OK: サブスクリプション '$account' に接続中" -ForegroundColor Green }
else { Write-Host "❌ 未サインイン（az login を実行してください）" -ForegroundColor Red }
Write-Host ""

# Java
Write-Host "【3】Java" -ForegroundColor Yellow
$javaVersion = java -version 2>&1 | Select-Object -First 1
if ($LASTEXITCODE -eq 0) { Write-Host "✅ OK: $javaVersion" -ForegroundColor Green }
else { Write-Host "❌ 未インストール" -ForegroundColor Red }
Write-Host ""

# Maven
Write-Host "【4-A】Maven" -ForegroundColor Yellow
$mvnVersion = mvn -version 2>&1 | Select-Object -First 1
if ($LASTEXITCODE -eq 0) { Write-Host "✅ OK: $mvnVersion" -ForegroundColor Green }
else { Write-Host "⚠️  未インストール（Gradleを使う場合は不要）" -ForegroundColor Yellow }
Write-Host ""

# Gradle
Write-Host "【4-B】Gradle" -ForegroundColor Yellow
$gradleVersion = gradle --version 2>&1 | Select-String "Gradle"
if ($LASTEXITCODE -eq 0) { Write-Host "✅ OK: $gradleVersion" -ForegroundColor Green }
else { Write-Host "⚠️  未インストール（Mavenを使う場合は不要）" -ForegroundColor Yellow }
Write-Host ""

# PowerShell 7
Write-Host "【5】PowerShell 7" -ForegroundColor Yellow
$pshVersion = $PSVersionTable.PSVersion
if ($pshVersion.Major -ge 7) { Write-Host "✅ OK: PowerShell $pshVersion" -ForegroundColor Green }
else { Write-Host "⚠️  PowerShell $pshVersion（バージョン7以上が必要です）" -ForegroundColor Yellow }
Write-Host ""

# Az モジュール
Write-Host "【6】Az モジュール" -ForegroundColor Yellow
$azModule = Get-Module -ListAvailable Az.Accounts
if ($azModule) { Write-Host "✅ OK: Az $($azModule.Version)" -ForegroundColor Green }
else { Write-Host "❌ 未インストール（Install-Module -Name Az を実行してください）" -ForegroundColor Red }
Write-Host ""

# Az モジュール サインイン確認
Write-Host "【7】Az モジュール サインイン確認" -ForegroundColor Yellow
try {
    Import-Module Az.Accounts -ErrorAction Stop
    $ctx = Get-AzContext
    if ($ctx) { Write-Host "✅ OK: '$($ctx.Subscription.Name)' に接続中" -ForegroundColor Green }
    else { Write-Host "❌ 未サインイン（Connect-AzAccount を実行してください）" -ForegroundColor Red }
} catch {
    Write-Host "❌ Az モジュールが見つかりません" -ForegroundColor Red
}

✅ 全項目OKの場合の出力例

=== Azure ハンズオン 前提条件 確認レポート ===

【1】Azure CLI
✅ OK: azure-cli 2.61.0

【2】Azure CLI サインイン確認
✅ OK: サブスクリプション 'Azure subscription 1' に接続中

【3】Java
✅ OK: openjdk version "17.0.11" 2024-04-16

【4-A】Maven
✅ OK: Apache Maven 3.9.6

【4-B】Gradle
⚠️  未インストール（Mavenを使う場合は不要）

【5】PowerShell 7
✅ OK: PowerShell 7.4.2

【6】Az モジュール
✅ OK: Az 12.0.0

【7】Az モジュール サインイン確認
✅ OK: 'Azure subscription 1' に接続中

🛠️ よくあるトラブルと対処法

`az login` でブラウザが開かない

対処法： デバイスコードでのログインを使います。

az login --use-device-code
# 表示されたURLにアクセスし、コードを入力する

`az account show` で権限エラーが出る

ERROR: The subscription ... could not be found.

対処法： 正しいサブスクリプションが選択されているか確認します。

az account list -o table
az account set --subscription "<サブスクリプションID>"

Java インストール後に `java: command not found` が出る

対処法： PATH が通っていないためターミナルを再起動します。
それでも解決しない場合は以下を確認します。

# パスを手動で確認
which java        # macOS / Linux
where java        # Windows (コマンドプロンプト)

`mvn -version` で `Java version: 1.8.x` と表示される

対処法： 複数のJavaがインストールされており、古いものが使われています。
JAVA_HOME を正しく設定します。

# macOS: 使用できるJavaバージョンを確認
/usr/libexec/java_home -V

# バージョン17を明示的に設定
export JAVA_HOME=$(/usr/libexec/java_home -v 17)

PowerShell で `Install-Module` が遅い・タイムアウトする

対処法： 必要なサブモジュールのみ個別にインストールします。

# ハンズオンで最低限必要なモジュール
Install-Module -Name Az.Accounts  -Force -Scope CurrentUser
Install-Module -Name Az.KeyVault  -Force -Scope CurrentUser
Install-Module -Name Az.Compute   -Force -Scope CurrentUser
Install-Module -Name Az.Websites  -Force -Scope CurrentUser

Windows で `pwsh` コマンドが見つからない

対処法： PowerShell 7のインストール先にパスが通っていない可能性があります。

# PowerShell 7 のインストール先を確認
where.exe pwsh
# 通常: C:\Program Files\PowerShell\7\pwsh.exe

パスが通っていない場合は C:\Program Files\PowerShell\7 をシステム環境変数 PATH に追加します。

✅ 前提条件チェックリスト

すべてに✅がついたら、ハンズオン本編に進めます。

Azure アカウントが作成済みで、Portal にログインできる
サブスクリプションの「所有者」または「共同作成者」権限がある
az --version でバージョンが表示される
az account show でサブスクリプション情報が表示される
java -version でバージョン11以上が表示される
mvn -version または gradle --version でバージョンが表示される
pwsh --version でバージョン7以上が表示される
Get-Module -ListAvailable Az.Accounts でモジュールが表示される
Connect-AzAccount でAzureにサインインできる

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up

Azure ハンズオン 事前準備手順書

～ゼロから前提条件を満たすまでの完全ガイド～

📋 この資料でできるようになること

STEP 1：Azure アカウント・サブスクリプションの作成

1-1. Microsoft アカウントの準備

1-2. Azure 無料アカウントの作成

1-3. サブスクリプション情報の確認・メモ

Azure Portal での確認方法

STEP 2：サブスクリプションの権限確認・設定

2-1. 自分の権限を確認する

Azure Portal での確認方法

Azure CLI での確認方法（STEP 3 完了後に実行）

2-2. 権限が付与されていない場合

管理者が権限を付与する手順（Azure Portal）

STEP 3：Azure CLI のインストールと設定

3-1. Azure CLI のインストール

Windows の場合

macOS の場合

Linux (Ubuntu) の場合

✅ インストール確認

3-2. Azure CLI でのサインイン

3-3. 使用するサブスクリプションの設定

3-4. Azure CLI の接続確認

STEP 4：Java（JDK 11以上）のインストール

4-1. JDK のインストール

Windows の場合

macOS の場合

Linux (Ubuntu) の場合

4-2. JAVA_HOME 環境変数の設定

Windows の場合

macOS の場合

Linux (Ubuntu) の場合

4-3. インストール確認

STEP 5：Maven または Gradle のインストール

5-A. Maven のインストール

Windows の場合

macOS の場合

Linux (Ubuntu) の場合

Maven の確認

5-B. Gradle のインストール（Maven の代わりに使う場合）

Windows の場合

macOS の場合

Linux (Ubuntu) の場合

Gradle の確認

STEP 6：PowerShell 7 のインストール

6-1. PowerShell 7 のインストール

Windows の場合

macOS の場合

Linux (Ubuntu) の場合

6-2. インストール確認

STEP 7：Az モジュールのインストール

7-1. PowerShell 7 の起動

7-2. Az モジュールのインストール

7-3. Az モジュールのインポートと Azure サインイン

7-4. Az モジュールの接続確認

STEP 8：全項目の動作確認

確認スクリプト

bash / zsh（macOS・Linux・Windows WSL）

PowerShell（Windows・pwsh で実行）

✅ 全項目OKの場合の出力例

🛠️ よくあるトラブルと対処法

az login でブラウザが開かない

az account show で権限エラーが出る

Java インストール後に java: command not found が出る

mvn -version で Java version: 1.8.x と表示される

PowerShell で Install-Module が遅い・タイムアウトする

Windows で pwsh コマンドが見つからない

✅ 前提条件チェックリスト

Azure ハンズオン事前準備手順書

`az login` でブラウザが開かない

`az account show` で権限エラーが出る

Java インストール後に `java: command not found` が出る

`mvn -version` で `Java version: 1.8.x` と表示される

PowerShell で `Install-Module` が遅い・タイムアウトする

Windows で `pwsh` コマンドが見つからない