Azure Developer CLI を使用して Azure DevOps CI/CD パイプラインを作成する

2025-05-16

この記事では、Azure Developer CLI (azd) を使用して、 azd テンプレート用の Azure DevOps Pipelines (Azure Pipelines) を使用して CI/CD パイプラインを作成する方法について説明します。パイプラインを使用すると、コードリポジトリに更新をプッシュし、変更を自動的にプロビジョニングして Azure 環境にデプロイすることができます。

注

azd pipeline config コマンドはベータ版です。詳細については、機能のバージョン管理とリリース戦略を参照してください。

[前提条件]

Azure Developer CLI をインストールします。
Visual Studio Code がインストールされました。

テンプレートを初期化する

この例では Hello-AZD テンプレートを使用しますが、パイプライン定義ファイル ( .github フォルダーまたは .azdo フォルダーにある) を含む任意のテンプレートに対して、次の手順に従うことができます。

空のディレクトリで、 hello-azd テンプレートを初期化します。
```
azd init -t hello-azd
```
プロンプトが表示されたら、環境の名前 ( hello-azd など) を入力します。

Azure Pipelines を設定する

注

Windows で Java テンプレートに Azure Pipelines を使用している場合は、トラブルシューティングガイドを参照してください。

Azure Pipelines 組織を作成または使用する

Azure Pipelines を使用するには、組織が必要です。まだお持ちでない場合は、 https://dev.azure.com で作成します。

個人用アクセストークン (PAT) を作成する

Azure Developer CLI では、Azure Pipelines を構成するために個人用アクセストークン (PAT) が必要です。次のスコープで新しい PAT を作成します。

エージェントプール (読み取り、管理)
ビルド (データの読み取りと実行)
コード（完全）
プロジェクトとチーム (読み取り、書き込み、管理)
リリース (読み取り、書き込み、実行、管理)
サービス接続 (読み取り、クエリ、管理)

パイプラインを構成する

次のコマンドを実行して、デプロイパイプラインを使用して Azure Pipelines プロジェクトとリポジトリを構成します。
```
azd pipeline config --provider azdo
```
注

既定では、Azure Pipelines の azd pipeline config はクライアント資格情報を使用します。 OIDC/フェデレーション資格情報は現在サポートされていません。 azdでの OIDC サポートの詳細について説明します。
プロンプトに応答します。
- 個人用アクセストークン (PAT):
  - PAT を貼り付けてください。
  - 必要に応じて、PAT をシステム環境変数としてエクスポートして、プロンプトが繰り返されないようにします。
```
export AZURE_DEVOPS_EXT_PAT=<PAT>
```
- Azure Pipelines 組織名:
  - 組織名を入力します。この値は、現在の環境の .env ファイルに保存されます。
- "origin"という名前のリモートが見つかりませんでした。構成したいですか？
  - イエス
- プロジェクトをどのように構成しますか?
  - 新しい Azure Pipelines プロジェクトを作成する
- 新しい Azure Pipelines プロジェクトの名前を入力するか、Enter キーを押してこの名前を使用します( {default name} )
  - Enter キーを押すか、一意のプロジェクト名を作成します。
- 構成された CI パイプラインを開始するために、ローカルの変更をコミットしてプッシュしますか?
  - イエス
ビルドを確認するには、Azure Pipelines ポータル (https://dev.azure.com) でプロジェクトに移動します。

コード変更を行ってプッシュする

/src/components/pages ディレクトリで、Home.razorを開きます。
Hello AZD!ヘッダーテキストをHello, pipeline!に変更し、ファイルを保存します。
ブランチを作成し、変更をコミットします。 main ブランチは保護されているため、新しいブランチから変更をプッシュし、Azure Pipelines でプル要求を作成します。プル要求はパイプラインをトリガーし、パイプラインが失敗した場合はマージをブロックします。
pull request を承認してマージすると、パイプラインが再開されます。
ブラウザーでプロジェクトのリポジトリを開き、コミットと Azure Pipeline の実行を確認します。
Web フロントエンド URL にアクセスして、更新プログラムを検査します。

`azd`を Azure Pipelines タスクとして使用する

azdを Azure Pipelines タスクとして追加して、パイプラインにazdをインストールします。次を .azdo/pipelines/azure-dev.yml に追加します。

trigger:
  - main
  - branch

pool:
  vmImage: ubuntu-latest
  # vmImage: windows-latest

steps:
  - task: setup-azd@0
    displayName: Install azd

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

この記事で作成した Azure リソースが不要になったら、次のコマンドを実行します。

azd down

次のステップ

Azure Developer CLI (azd) を使用してアプリを監視する