Azure Bicep テンプレートを使用したデプロイ

ラボの要件

このラボには、Microsoft Edge または Azure DevOps 対応ブラウザーが必要です。
Azure DevOps 組織を設定する: このラボで使用できる Azure DevOps 組織がまだない場合は、組織またはプロジェクトコレクションの作成に関するページの手順に従って作成してください。
既存の Azure サブスクリプションを識別するか、新しいものを作成します。
Azure サブスクリプションの所有者ロールと、Azure サブスクリプションに関連付けられた Microsoft Entra テナントの全体管理者ロールを持つ Microsoft アカウントまたは Microsoft Entra アカウントがあることを確認します。詳細については、「Azure portal を使用して Azure ロールの割り当てを一覧表示する」および「Azure Active Directory で管理者ロールを表示して割当てる」を参照してください。

ラボの概要

このラボでは、Azure Bicep テンプレートを作成し、Azure Bicep モジュールの概念を使ってそれをモジュール化します。次に、モジュールを使用するようにメインデプロイテンプレートを変更して、最後にすべてのリソースを Azure にデプロイします。

目標

このラボを完了すると、次のことができるようになります。

Azure Bicep テンプレートの構造を理解します。
再利用可能な Bicep モジュールを作成します。
モジュールを使うようにメインテンプレートを変更する
Azure YAML パイプラインを使って、すべてのリソースを Azure にデプロイします。

推定時間:45 分

手順

演習 0: ラボの前提条件を構成する (完了している場合はスキップしてください)

この演習では、ラボの前提条件を設定します。これは、eShopOnWeb に基づくリポジトリを含む新しい Azure DevOps プロジェクトで構成されます。

タスク 1: (完了している場合はスキップしてください) チームプロジェクトを作成して構成する

このタスクでは、複数のラボで使用される eShopOnWeb Azure DevOps プロジェクトを作成します。

ラボコンピューターのブラウザーウィンドウで、Azure DevOps 組織を開きます。 [新しいプロジェクト] をクリックします。プロジェクトに「eShopOnWeb」という名前を付け、他のフィールドは既定値のままにします。 [作成] をクリックします。

タスク 2: (完了している場合はスキップしてください) eShopOnWeb Git リポジトリをインポートする

このタスクでは、複数のラボで使用される eShopOnWeb Git リポジトリをインポートします。

ラボコンピューターのブラウザーウィンドウで、Azure DevOps 組織と、前に作成した eShopOnWeb プロジェクトを開きます。 [リポジトリ]、[ファイル]、[リポジトリをインポートする] の順にクリックします。 インポート を選択します。 [Git リポジトリをインポートする] ウィンドウで、URL https://github.com/MicrosoftLearning/eShopOnWeb.git を貼り付けて、 [インポート] をクリックします。
リポジトリは次のように編成されています。
- .ado フォルダーには、Azure DevOps の YAML パイプラインが含まれています。
- .devcontainer フォルダーには、コンテナーを使って開発するためのセットアップが含まれています (VS Code でローカルに、または GitHub Codespaces で)。
- infra フォルダーには、一部のラボシナリオで使用される Bicep および ARM のコードとしてのインフラストラクチャテンプレートが含まれています。
- .github フォルダーには、YAML GitHub ワークフローの定義が含まれています。
- src フォルダーには、ラボシナリオで使用される .NET 8 Web サイトが含まれています。

タスク 3: (完了している場合はスキップしてください) メインブランチを既定のブランチとして設定する

[リポジトリ]、ブランチ の順に移動します。
main ブランチをポイントし、列の右側に表示される省略記号をクリックします。
[既定のブランチとして設定] をクリックします。

演習 1: Azure Bicep テンプレートを理解し、再利用可能なモジュールを使って簡略化する

このラボでは、Azure Bicep テンプレートを確認し、再利用可能なモジュールを使って簡略化します。

タスク 1: Azure Bicep テンプレートを作成する

このタスクでは、Visual Studio Code を使って Azure Bicep テンプレートを作成します

Azure DevOps プロジェクトを開いているブラウザーのタブで、 [リポジトリ] と [ファイル] に移動します。 infra フォルダーを開き、simple-windows-vm.bicep ファイルを見つけます。
テンプレートをレビューし、その構造をよりよく把握します。型、既定値、検証を含むいくつかのパラメーター、いくつかの変数、以下の型を持つかなりの数のリソースがあります。
- Microsoft.Storage/storageAccounts
- Microsoft.Network/publicIPAddresses
- Microsoft.Network/virtualNetworks
- Microsoft.Network/networkInterfaces
- Microsoft.Compute/virtualMachines
リソース定義のシンプルさと、テンプレート全体を通して明示的な dependsOn ではなく暗黙的にシンボリック名を参照できることに注意してください。

タスク 2: ストレージリソースの Bicep モジュールを作成する

このタスクでは、ストレージテンプレートモジュール storage.bicep を作成します。これにより、ストレージアカウントのみが作成され、メインテンプレートによってインポートされます。ストレージテンプレートモジュールは、メインテンプレート main.bicep に値を戻す必要があります。この値は、ストレージテンプレートモジュールの出力要素で定義されます。

まず、メインテンプレートからストレージリソースを削除する必要があります。ブラウザーウィンドウの右上隅から [編集] ボタンをクリックします。

次にストレージリソースを削除します。

resource storageAccount 'Microsoft.Storage/storageAccounts@2022-05-01' = {
  name: storageAccountName
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'Storage'
}

20 行目の publicIPAllocationMethod パラメーターの既定値を Dynamic から Static に変更します
27 行目の publicIpSku パラメーターの既定値を Basic から Standard に変更します
ファイルをコミットしますが、まだこれで終わりではありません。
次に、Infra フォルダーをマウスでポイントして省略記号アイコンをクリックした後、[新規作成]、[ファイル] の順に選択します。名前に「storage.bicep」と入力し、[作成] をクリックします。

次に、次のコードスニペットをファイルにコピーし、変更をコミットします。

@description('Location for all resources.')
param location string = resourceGroup().location

@description('Name for the storage account.')
param storageAccountName string

resource storageAccount 'Microsoft.Storage/storageAccounts@2022-05-01' = {
  name: storageAccountName
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'Storage'
}

output storageURI string = storageAccount.properties.primaryEndpoints.blob

タスク 3:テンプレートモジュールを使用するように simple-windows-vm テンプレートを変更する

このタスクでは、前のタスクで作成したテンプレートモジュールを参照するように、simple-windows-vm.bicep テンプレートを変更します。

simple-windows-vm.bicep ファイルに戻り、 [編集] ボタンをもう一度クリックします。

次に、変数の後に次のコードを追加します。

module storageModule './storage.bicep' = {
  name: 'linkedTemplate'
  params: {
    location: location
    storageAccountName: storageAccountName
  }
}

また、代わりにモジュールの出力を使うように、仮想マシンリソースのストレージアカウント BLOB URI への参照を変更する必要があります。仮想マシンリソースを見つけて、diagnosticsProfile セクションを次のように置き換えます。
```
diagnosticsProfile: {
  bootDiagnostics: {
    enabled: true
    storageUri: storageModule.outputs.storageURI
  }
}
```
メインテンプレートで以下の詳細をレビューします:
- メインテンプレートのモジュールは、別のテンプレートにリンクするために使われます。
- モジュールのシンボル名は storageModule です。依存関係を構成する場合はこの名前を使います。
- テンプレートモジュールを使うときは、増分デプロイモードのみを使用できます。
- テンプレートモジュールには相対パスを使います。
- パラメーターを使って、メインテンプレートからテンプレートモジュールに値を渡します。
テンプレートをコミットします。

演習 2: YAML パイプラインを使って Azure にテンプレートをデプロイする

このラボでは、Azure DevOps YAML パイプラインを使用して、テンプレートを Azure 環境にデプロイします。

タスク 1: YAML パイプラインによって Azure にリソースをデプロイする

[パイプライン] ハブで [パイプライン] に戻ります。
[最初のパイプラインを作成] ウィンドウで、[パイプラインの作成] をクリックします。

注: ウィザードを使い、プロジェクトに基づいて新しい YAML パイプラインの定義を作成します。
[コードはどこにありますか?] ペインで [Azure Repos Git (YAML)] オプションをクリックします。
[リポジトリの選択] ペインで eShopOnWeb をクリックします。
[パイプラインを構成する] ペインで、 [既存の Azure Pipelines YAML ファイル] を選びます。
[既存の YAML ファイルを選択する] ペインで、次のパラメーターを指定します。
- パス: .ado/eshoponweb-cd-windows-cm.yml
[続行] をクリックして、これらの設定を保存します。
変数セクションで、リソースグループの名前を選び、目的の場所を設定し、サービス接続の値を先ほど作成した既存のサービス接続のいずれかに置き換えます。
右上隅のコーダーから [保存して実行] ボタンをクリックし、コミットダイアログが表示されたら、もう一度 [保存して実行] をクリックします。
デプロイが完了するまで待ってから、結果を確認します。

注:前に作成したサービス接続を使用するためのアクセス許可をパイプラインに付与することを忘れないでください。

[!IMPORTANT] 不要な料金が発生しないように、Azure portal で作成されたリソースを必ず削除してください。

確認

このラボでは、Azure Bicep テンプレートを作成し、テンプレートモジュールを使ってこれをモジュラー化し、メインデプロイテンプレートを変更してモジュールと更新済みの依存関係を呼び出し、最後に YAML パイプラインを使ってテンプレートを Azure にデプロイする方法を学びました。