Azure Developer CLI (azd) は、 azd pipeline config コマンドを使用して CI/CD のセットアップを効率化します。 このコマンドでは、 azd テンプレートに含まれるパイプライン定義ファイルを使用して、Azure 上のアプリ リソースのプロビジョニングとデプロイ パイプラインを自動化します。 テンプレートとパイプラインを統合することで、 azd はシームレスな CI/CD エクスペリエンスを実現し、一貫性のある信頼性の高いデプロイを確保しながら開発に集中できます。
パイプライン機能
azd pipeline config コマンドを実行すると、azdは次の手順を実行して CI/CD パイプラインを設定します。
- Azure での認証: ログインしていて、必要なアクセス許可があることを確認します。
- CI/CD プラットフォームの選択: GitHub Actions または Azure Pipelines のいずれかを選択するように求められます。
- リポジトリの構成: リポジトリに接続するか、リポジトリを作成するためのガイドを示します。
- サービス プリンシパルの設定: セキュリティで保護されたデプロイ用のサービス プリンシパルを自動的に作成して構成します。
-
認証を構成します。
- GitHub の場合: OpenID Connect (OIDC) またはクライアント資格情報を設定します。
- Azure Pipelines の場合: クライアント資格情報を設定し、個人用アクセス トークン (PAT) を要求します。
-
パイプライン ファイルのプロビジョニング: テンプレートからリポジトリに適切なパイプライン定義ファイル (
azure-dev.yml) をコピーします。 - パイプライン変数とシークレットの設定: デプロイに必要な変数とシークレットを構成します。
- 変更をコミットしてプッシュする: パイプライン構成をコミットしてリポジトリにプッシュします。
- パイプラインの実行をトリガーする: Azure リソースを作成または更新し、アプリをデプロイします。
プラットフォーム固有の詳細
azd pipeline config コマンドでは、GitHub Actions と Azure Pipelines の両方がサポートされており、それぞれに固有の考慮事項があります。
GitHub Actions:
- GitHub でホストされているリポジトリで動作します。
-
.github/workflows構成ファイルにazure-dev.ymlディレクトリを使用します。 - 既定では、セキュリティで保護された認証のために OpenID Connect (OIDC) をサポートします。
- 別の認証方法としてクライアント資格情報を使用できます。
Azure Pipelines:
- Azure Pipelines でホストされているリポジトリを使用します。
-
.azuredevops/pipelines構成ファイルの.azdo/pipelinesまたはazure-dev.ymlディレクトリを使用します。 - 認証にクライアント資格情報を使用します (OIDC は現在サポートされていません)。
- 特定のスコープを持つ個人用アクセス トークン (PAT) が必要です。
- プル要求ワークフローを通じて保護されたメイン ブランチをサポートします。
テンプレートの統合
Azure Developer CLI テンプレートには、azure-dev.yml コマンドと互換性のある事前構成済みの CI/CD パイプライン定義ファイル (azd pipeline config) を含めることができます。 テンプレートを複製すると、構成ファイルを最初から作成することなく、 azd pipeline config をすぐに実行して CI/CD パイプラインを設定できます。
テンプレートには、 azure.yaml ファイルを使用して、より多くの変数、シークレット、および環境固有の設定を含むカスタマイズされたパイプライン構成を含めることもできます。これにより、パイプラインをさまざまなプロジェクト要件に簡単に適応させることができます。
サンプル ワークフロー
azd pipeline configを使用するための一般的なワークフローは次のとおりです。
- 目的の
azdテンプレート リポジトリをローカル コンピューターに複製します。 -
azd pipeline configコマンドを実行し、プロンプトに従ってパイプラインを設定します。 最初の実行では、必要な Azure リソースがプロビジョニングされ、アプリをデプロイするためのワークフローがトリガーされます。 - パイプラインが作成されたら、リポジトリに変更をコミットしてプッシュし、デプロイ パイプラインをトリガーし、アプリを更新します。
- CI/CD プラットフォームでパイプラインの実行を監視して、デプロイが成功したことを確認するか、問題のトラブルシューティングを行います。
各プラットフォームの詳細なワークフローを確認します。
独自のパイプライン定義ファイルを作成する方法、または高度な構成を調べる方法について説明します。