Skip to content

📚 Comprehensive deployment guide and documentation for Azure Arc Jumpstart ArcBox ITPro. Includes step-by-step tutorials, deployment checklists, architecture details, and best practices. Complete Japanese documentation for learning and implementing Azure Arc enabled servers.

License

Notifications You must be signed in to change notification settings

ylearning86/arcbox-itpro-deployment-guide

Repository files navigation

ArcBox ITPro - Bicep デプロイメント

License: MIT Azure Bicep Documentation Language

Azure Arc Jumpstart ArcBox ITPro のデプロイ用ドキュメントとガイドです。

⚠️ 注意: このリポジトリには完全な Bicep テンプレートは含まれていません。デプロイには公式の Azure Arc リポジトリを使用してください。

🎯 プロジェクトナビゲーション: PROJECT_OVERVIEW.md でドキュメント全体のガイドを確認できます。

📚 ドキュメント一覧

ドキュメント 説明 対象者
QUICKSTART.md 5分でデプロイ開始 すべて
DEPLOYMENT_GUIDE.md 詳細なデプロイ手順 初心者
DEPLOYMENT_CHECKLIST.md 実行チェックリスト 実行者
docs/ARCHITECTURE.md システムアーキテクチャ 上級者
PROJECT_OVERVIEW.md プロジェクト概要 すべて

概要

ArcBox は、Azure Arc enabled servers の機能を実践的に学習できるサンドボックス環境です。このリポジトリには、ITPro フレーバー用の Bicep テンプレートが含まれています。

デプロイされるリソース

  • クライアント VM (Windows Server)
  • 仮想ネットワークとサブネット
  • Log Analytics ワークスペース
  • ストレージアカウント
  • Azure Arc enabled servers (6台のサーバー)
  • オプション: Azure Bastion

前提条件

  1. Azure サブスクリプション: アクティブな Azure サブスクリプションが必要です
  2. Azure CLI: バージョン 2.53.0 以降
    az --version
  3. Bicep CLI: Azure CLI に含まれています
  4. 権限: サブスクリプションレベルで Contributor 以上のロールが必要
  5. クォータ: 以下のリソースに対する十分なクォータ
    • vCPUs: 約 16 個
    • Storage accounts
    • Public IP addresses

デプロイ手順

1. リポジトリのクローン(またはファイルのダウンロード)

cd c:\git\ArcBox

2. パラメータファイルの編集

main.bicepparam ファイルを編集して、以下の値を設定してください:

param tenantId = '<your-tenant-id>' // Azure AD テナント ID param windowsAdminUsername = 'arcdemo' // 管理者ユーザー名 param windowsAdminPassword = '<your-secure-password>' // 強力なパスワード param logAnalyticsWorkspaceName = 'ArcBox-Workspace-001' // 一意のワークスペース名

パスワード要件

  • 12-123 文字
  • 以下のうち3つを含む:
    • 小文字
    • 大文字
    • 数字
    • 特殊文字

3. Azure へのログイン

az login az account set --subscription "<your-subscription-id>"

4. リソースグループの作成

az group create --name ArcBox-RG --location japaneast

5. デプロイの実行

注意: 現在、このリポジトリには基本的な main.bicep のみが含まれています。完全なデプロイには、公式の Azure Arc Jumpstart リポジトリからモジュールファイルをダウンロードする必要があります。

オプション A: 公式リポジトリを使用(推奨)

# 公式リポジトリをクローン git clone https://github.com/microsoft/azure_arc.git cd azure_arc/azure_jumpstart_arcbox/bicep # パラメータファイルを編集 code main.bicepparam # デプロイ az deployment group create \ --resource-group ArcBox-RG \ --template-file main.bicep \ --parameters main.bicepparam

オプション B: リモートテンプレートを使用

az deployment group create \ --resource-group ArcBox-RG \ --template-uri "https://raw.githubusercontent.com/microsoft/azure_arc/main/azure_jumpstart_arcbox/bicep/main.bicep" \ --parameters @main.bicepparam

6. デプロイの監視

デプロイには約 60-90 分かかります。

# デプロイ状態の確認 az deployment group show \ --resource-group ArcBox-RG \ --name main \ --query properties.provisioningState

デプロイ後の確認

  1. Azure Portal でリソースを確認

  2. クライアント VM に接続

    # パブリック IP アドレスの取得 az vm show -d -g ArcBox-RG -n ArcBox-Client --query publicIps -o tsv
  3. Azure Arc enabled servers の確認

    • Azure Portal > Azure Arc > Servers
    • 6台のサーバーが登録されているか確認

パラメータの説明

パラメータ 説明 デフォルト値
tenantId Azure AD テナント ID -
windowsAdminUsername VM の管理者ユーザー名 arcdemo
windowsAdminPassword VM の管理者パスワード -
logAnalyticsWorkspaceName Log Analytics ワークスペース名 -
flavor デプロイするフレーバー ITPro
deployBastion Azure Bastion をデプロイするか false
location デプロイ先のリージョン japaneast
rdpPort RDP ポート番号 3389

カスタマイズ

Bastion のデプロイ

より安全なアクセスのために Azure Bastion を使用する場合:

param deployBastion = true param bastionSku = 'Basic'

自動シャットダウンの設定

コスト削減のために VM の自動シャットダウンを設定:

param autoShutdownEnabled = true param autoShutdownTime = '1800' // 18:00 (24時間形式) param autoShutdownTimezone = 'Tokyo Standard Time'

トラブルシューティング

デプロイエラー

  1. クォータ不足

    az vm list-usage --location japaneast -o table
  2. 名前の競合

    • logAnalyticsWorkspaceName を一意の名前に変更
  3. ログの確認

    az deployment group show \ --resource-group ArcBox-RG \ --name main \ --query properties.error

VM 接続の問題

  1. NSG ルールの確認

    az network nsg rule list \ --resource-group ArcBox-RG \ --nsg-name ArcBox-NSG \ -o table
  2. VM の状態確認

    az vm get-instance-view \ --resource-group ArcBox-RG \ --name ArcBox-Client

クリーンアップ

デプロイしたリソースを削除する場合:

az group delete --name ArcBox-RG --yes --no-wait

参考リンク

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。

サポート

問題や質問がある場合は、Azure Arc Jumpstart GitHub Issues で報告してください。

About

📚 Comprehensive deployment guide and documentation for Azure Arc Jumpstart ArcBox ITPro. Includes step-by-step tutorials, deployment checklists, architecture details, and best practices. Complete Japanese documentation for learning and implementing Azure Arc enabled servers.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages