チュートリアル: ARM テンプレートと Azure Pipelines の継続的インテグレーション

2025-05-01

前のチュートリアルでは、リンクされたテンプレートをデプロイします。このチュートリアルでは、Azure Pipelines を使用して、Azure Resource Manager テンプレート (ARM テンプレート) プロジェクトを継続的にビルドしてデプロイする方法について説明します。

Azure DevOps は、チームをサポートするための開発者サービスを提供して、作業の計画、コード開発との共同作業、およびアプリケーションの構築と展開を行います。開発者は、Azure DevOps Services を使用してクラウドで作業できます。 Azure DevOps には、Web ブラウザーまたは IDE クライアントからアクセスできる統合された機能セットが用意されています。 Azure Pipelines は、これらの機能の 1 つです。 Azure Pipelines は、完全に機能する継続的インテグレーション (CI) および継続的デリバリー (CD) サービスです。お好みの Git プロバイダーで動作し、ほとんどの主要なクラウドサービスにデプロイできます。その後、Microsoft Azure、Google Cloud Platform、または Amazon Web Services へのコードのビルド、テスト、デプロイを自動化できます。

注

プロジェクト名を選択します。チュートリアルを実行するときは、 ARMPipelineProj のいずれかをプロジェクト名に置き換えます。このプロジェクト名は、リソース名を生成するために使用されます。リソースの 1 つはストレージアカウントです。ストレージアカウント名の長さは 3 ~ 24 文字で、数字と小文字のみを使用する必要があります。名前は一意である必要があります。テンプレートでは、ストレージアカウント名は ストア が追加されたプロジェクト名であり、プロジェクト名は 3 ~ 11 文字にする必要があります。そのため、プロジェクト名はストレージアカウント名の要件を満たし、11 文字未満である必要があります。

このチュートリアルに含まれるタスクは次のとおりです。

GitHub リポジトリを準備する
Azure DevOps プロジェクトの作成
Azure パイプラインを作成する
パイプラインのデプロイを確認する
テンプレートを更新して再デプロイする
リソースをクリーンアップする

Azure サブスクリプションをお持ちでない場合は、始める前に無料アカウントを作成してください。

[前提条件]

この記事を完了するには、以下が必要です。

GitHub アカウント。このアカウントを使用してテンプレートのリポジトリを作成します。持っていない場合は、無料で作成できます。 GitHub リポジトリの使用の詳細については、「 GitHub リポジトリのビルド」を参照してください。
Git をインストールします。このチュートリアルの手順では、 Git Bash または Git Shell を使用します。手順については、「 Git のインストール」を参照してください。
Azure DevOps 組織。アカウントをお持ちでない場合は、無料で作成することができます。「組織またはプロジェクトコレクションを作成する」を参照してください。
(省略可能) Visual Studio Code と Resource Manager ツール拡張機能。「クイックスタート:Visual Studio Code を使用して ARM テンプレートを作成する」を参照してください。

GitHub リポジトリを準備する

GitHub は、Resource Manager テンプレートを含むプロジェクトのソースコードを格納するために使用されます。サポートされているその他のリポジトリについては、 Azure DevOps でサポートされているリポジトリを参照してください。

GitHub リポジトリを作成する

GitHub アカウントをお持ちでない場合は、「前提条件」を参照してください。

GitHub にサインインします。
右上隅にあるアカウントイメージを選択し、[ リポジトリ] を選択します。
[ 新規] を選択し、緑色のボタンを選択します。
[ リポジトリ名] に、リポジトリ名を入力します。たとえば、 ARMPipeline-repo などです。 ARMPipeline は必ずプロジェクト名に置き換えてください。このチュートリアルでは、[ パブリック ] または [ プライベート ] を選択できます。次に、[ リポジトリの作成] を選択します。
URL を書き留めます。リポジトリの URL は、 https://github.com/[YourAccountName]/[YourRepositoryName]という形式です。

このリポジトリは、 リモートリポジトリと呼ばれます。同じプロジェクトの各開発者は、独自の ローカルリポジトリを複製し、変更をリモートリポジトリにマージできます。

リモートリポジトリを複製する

Git Shell または Git Bash を開きます。「前提条件」を参照してください。
現在のフォルダーが GitHub であることを確認します。
次のコマンドを実行します。
```
git clone https://github.com/[YourAccountName]/[YourGitHubRepositoryName]
cd [YourGitHubRepositoryName]
mkdir create_web_app
cd create_web_app
pwd
```
[YourAccountName]を GitHub アカウント名に置き換え、[YourGitHubRepositoryName]を前の手順で作成したリポジトリ名に置き換えます。

create_web_app フォルダーは、テンプレートが格納されているフォルダーです。 pwd コマンドは、フォルダーパスを表示します。パスは、次の手順でテンプレートを保存する場所です。

クイックスタートテンプレートをダウンロードする

テンプレートを作成する代わりに、テンプレートをダウンロードし、 create_web_app フォルダーに保存することができます。

メインテンプレート: https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/get-started-deployment/linked-template/azuredeploy.json
リンク済みテンプレート: https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/get-started-deployment/linked-template/linkedStorageAccount.json

フォルダー名とファイル名は、変更されずにそのままパイプラインで使用されます。これらの名前を変更する場合は、パイプラインで使用される名前を更新する必要があります。

テンプレートをリモートリポジトリにプッシュする

azuredeploy.json がローカルリポジトリに追加されました。次に、テンプレートをリモートリポジトリにアップロードします。

Git Shell または Git Bash が開かっていない場合は開きます。
ローカルリポジトリ内の create_web_app フォルダーにディレクトリを変更します。
azuredeploy.json ファイルがフォルダー内にあるかどうかを確認します。
次のコマンドを実行します。
```
git add .
git commit -m "Add web app templates."
git push origin main
```
LF に関する警告が表示される場合があります。警告は無視してかまいません。 main はメインブランチです。通常、各更新ごとにブランチを作成します。このチュートリアルを簡略化するには、メインブランチを直接使用します。
ブラウザーから GitHub リポジトリを参照します。 URL は https://github.com/[YourAccountName]/[YourGitHubRepository] です。 create_web_app フォルダーとフォルダー内の 2 つのファイルが表示されます。
azuredeploy.json を選択してテンプレートを開きます。
Raw ボタンを選択します。 URL は https://raw.githubusercontent.comで始まります。
URL のコピーを作成します。この値は、チュートリアルの後半でパイプラインを構成するときに指定する必要があります。

ここまで、GitHub リポジトリを作成し、テンプレートをリポジトリにアップロードしました。

DevOps プロジェクトを作成する

次の手順に進む前に、DevOps 組織が必要です。お持ちでない場合は、「前提条件」を参照してください。

Azure DevOps にサインインします。
左側から DevOps 組織を選択し、[ 新しいプロジェクト] を選択します。プロジェクトがない場合は、プロジェクトの作成ページが自動的に開きます。
次の値を入力します。
- プロジェクト名: プロジェクト名を入力します。チュートリアルの最初に選択したプロジェクト名を使用できます。
- 可視性: [プライベート] を選択します。
その他のプロパティには既定値を使用します。
を選択してを作成します。

プロジェクトを Azure にデプロイするために使用するサービス接続を作成します。

左側のメニューの下部にある [プロジェクトの設定 ] を選択します。
[パイプライン] の下にある [サービス接続] を選択します。
[ サービス接続の作成] を選択し、[ Azure Resource Manager] を選択して、[ 次へ] を選択します。
[ サービスプリンシパル (自動)] を選択し、[ 次へ] を選択します。
次の値を入力します。
- スコープレベル: [サブスクリプション] を選択します。
- サブスクリプション: サブスクリプションを選択します。
- リソースグループ: 空白のままにします。
- 接続名: 接続名を入力します。たとえば、 ARMPipeline-conn です。この名前を書き留めます。パイプラインの作成時に名前が必要です。
- すべてのパイプラインにアクセス許可を付与します。 (選択)
保存を選択します。

パイプラインを作成する

ここまでは、次のタスクを完了しました。 GitHub と DevOps に慣れているため、前のセクションをスキップする場合は、続行する前にタスクを完了する必要があります。

GitHub リポジトリを作成し、テンプレートをリポジトリ内の create_web_app フォルダーに保存します。
DevOps プロジェクトを作成し、Azure Resource Manager サービス接続を作成します。

テンプレートをデプロイするステップを含むパイプラインを作成するには:

左側のメニューから [パイプライン] を選択します。
[パイプラインを作成] を選択します。
[ 接続 ] タブで、 GitHub を選択します。求められたら、GitHub の資格情報を入力し、指示に従います。次の画面が表示される場合は、[ リポジトリの選択のみ] を選択し、[ 承認] と [インストール] を選択する前にリポジトリが一覧に表示されていることを確認します。
[ 選択 ] タブで、リポジトリを選択します。既定の名前は [YourAccountName]/[YourGitHubRepositoryName] です。
[ 構成 ] タブで、[ スターターパイプライン] を選択します。 2 つのスクリプトステップを含 むazure-pipelines.yml パイプラインファイルが表示されます。
.yml ファイルから 2 つのスクリプトステップを削除します。
カーソルをステップ：の後の行に移動します。
画面の右側にある [アシスタントの表示 ] を選択して 、[タスク ] ウィンドウを開きます。
ARM テンプレートのデプロイを選択します。
次の値を入力します。
- deploymentScope: リソースグループを選択します。スコープの詳細については、「デプロイスコープ」を参照してください。
- Azure Resource Manager 接続: 前に作成したサービス接続名を選択します。
- サブスクリプション: ターゲットサブスクリプション ID を指定します。
- アクション: [リソースグループの作成または更新 ] アクションを選択すると、2 つのアクション (1) が実行されます。新しいリソースグループ名が指定されている場合は、リソースグループを作成します。2. 指定したテンプレートをデプロイします。
- [リソースグループ] :新しいリソースグループの名前を入力します。たとえば、 ARMPipeline-rg です。
- 場所: リソースグループの場所 ( 米国中部など) を選択します。
- テンプレートの場所: ファイルの URL を選択します。つまり、タスクは URL を使用してテンプレートファイルを検索します。 relativePath はメインテンプレートで使用され、relativePath は URI ベースのデプロイでのみサポートされるため、ここでは URL を使用する必要があります。
- テンプレートリンク: [GitHub リポジトリの準備 ] セクションの最後に取得した URL を入力します。これは https://raw.githubusercontent.com で始まります。
- [テンプレートパラメーター] リンク: このフィールドは空白のままにします。パラメーター値は、テンプレートパラメーターのオーバーライドで指定 します。
- テンプレートパラメーターをオーバーライドする: -projectName [EnterAProjectName]を入力します。
- デプロイモード: [増分] を選択します。
- デプロイ名: DeployPipelineTemplate と入力します。 [デプロイ名] を表示する前に、[詳細設定] を選択します。
[] を選択し、[] を追加します。

タスクの詳細については、「Azure リソースグループのデプロイタスク」および「Azure Resource Manager テンプレートのデプロイタスク」を参照してください。

.yml ファイルは次のようになります。
[保存および実行] を選択します。
[保存して実行] ウィンドウで[保存して実行]を選択し、もう一度実行します。 YAML ファイルのコピーが接続されたリポジトリに保存されます。リポジトリを参照すると、YAML ファイルを確認できます。
パイプラインが正常に実行されたことを確認します。

デプロイメントを確認する

Azure portal にサインインします。
リソースグループを開きます。名前は、パイプライン YAML ファイルで指定した名前です。作成されたストレージアカウントが 1 つ表示されます。ストレージアカウント名は ストアで始まります。
ストレージアカウント名を選択して開きます。
[プロパティ] を選択します。 レプリケーションがローカル冗長ストレージ (LRS) であることに注意してください。

更新と再デプロイ

テンプレートを更新し、変更をリモートリポジトリにプッシュすると、パイプラインによってリソース (この場合はストレージアカウント) が自動的に更新されます。

Visual Studio Code または任意のテキストエディターでローカルリポジトリから linkedStorageAccount.json を開きます。
storageAccountType の defaultValue をStandard_GRSに更新します。次のスクリーンショットを参照してください。
変更を保存します。
Git Bash/Shell から次のコマンドを実行して、リモートリポジトリに変更をプッシュします。
```
git pull origin main
git add .
git commit -m "Update the storage account type."
git push origin main
```
最初のコマンド (pull) は、ローカルリポジトリをリモートリポジトリと同期します。パイプライン YAML ファイルは、リモートリポジトリにのみ追加されました。 pull コマンドを実行すると、YAML ファイルのコピーがローカルブランチにダウンロードされます。

4 番目のコマンド (push) は、変更した linkedStorageAccount.json ファイルをリモートリポジトリにアップロードします。リモートリポジトリのメインブランチが更新されると、パイプラインが再度起動されます。

変更を確認するには、ストレージアカウントの Replication プロパティを確認します。デプロイの確認を参照してください。

リソースをクリーンアップする

Azure リソースが不要になったら、リソースグループを削除して、デプロイしたリソースをクリーンアップします。

Azure portal で、左側のメニューから [リソースグループ ] を選択します。
[名前 でフィルター] フィールドにリソースグループ名を入力します。
リソースグループ名を選択します。
上部のメニューから [ リソースグループの削除 ] を選択します。

GitHub リポジトリと Azure DevOps プロジェクトを削除することもできます。

次のステップ

これで、この Resource Manager テンプレートのデプロイチュートリアルが完了しました。フィードバックセクションにコメントや提案がある場合は、お知らせください。よろしくお願いいたします。テンプレートに関するより高度な概念に進む準備ができました。次のチュートリアルでは、デプロイするリソースの定義に役立つテンプレートリファレンスドキュメントの使用について詳しく説明します。

テンプレートリファレンスを利用する