新しい Azure Developer CLI (azd) テンプレートから始める

さまざまな作成方法を使用して、新しい Azure Developer CLI (azd) テンプレートで標準ファイルをビルドできます。

  • azd initでGitHub Copilot統合を使用します。 組み込みのワークフローは、既存のプロジェクト ファイルを分析したり、新しいプロジェクトを計画したり、テンプレート資産を作成したり、展開前の検証を実行したりするのに役立ちます。
  • 別の AI コーディング アシスタントを使用します。 azd initと直接統合することなく、同じazure.yaml、コードとしてのインフラストラクチャ、アプリケーション、およびサポート ファイルを作成するようにアシスタントに依頼します。
  • ファイルを直接作成します。 完全な制御が必要な場合、または AI コーディング アシスタントを使用しない場合は、テンプレート資産を自分で作成して編集します。

この記事では、azdと統合されたガイド付きエクスペリエンスを提供するため、主に組み込みのGitHub Copilot ワークフローに焦点を当てます。 作成方法に関係なく、デプロイの前にすべてのファイルを確認して検証します。

Important

azd initでのGitHub Copilot統合はプレビュー段階です。 プレビュー機能は、一般公開前に変更される可能性があります。 詳細については、 azd 機能のバージョン管理とリリース戦略に関する記事を参照してください。

生成されるアセットは、標準の編集可能な azd テンプレート ファイルです。 初期化後、それらを直接、または任意の AI コーディング アシスタントで更新できます。

GitHub Copilotの前提条件

組み込みのCopilot ワークフローを使用するには、次のものが必要です。

  • Azure Developer CLI 1.23.11 以降。
  • アクティブなGitHub Copilot サブスクリプション。
  • ファイルを変更する前に作業ツリーを調査する際に azd init が使用する Git
  • 対話型ターミナル セッション。

GitHub Copilotでまだ認証されていない場合は、azdサインインするように求められます。

azd versionを実行して、インストールされている Azure Developer CLI のバージョンを確認します。

Note

azd init ワークフローは、ターミナルで専用の GitHub Copilot エージェント セッションを開始します。 Visual Studio Codeでアクティブな GitHub Copilot Chat セッションを使用したり、続行したりすることはありません。

GitHub Copilotを使用してビルドする

  1. テンプレートをビルドするディレクトリでターミナルを開きます。

    Note

    ディレクトリには、既存のアプリケーション、インフラストラクチャ プロジェクト、または新しいソリューションの初期ファイルを含めることができます。 ディレクトリにコミットされていない変更が含まれている場合は、 azd 続行する前に確認を求められます。 重要な変更はまずコミットするか、スタッシュしてください。

  2. azd initを実行します。

    azd init

  3. [Set up with GitHub Copilot (プレビュー)] を選択します。

    初期化プロンプトは次の例のようになります。

    ? How do you want to initialize your app?
   Scan current directory
   Select a template
> Set up with GitHub Copilot (Preview)

  4. 要求されたツール アクセスを確認し、ワークフローに必要なツールへのアクセス権を付与します。 Copilotでは、azdとAzureの開発機能を使用して、プロジェクトの検査、ファイルの作成、結果の検証を行います。

  5. モデルと推論レベルを選択 azd 、モデルの構成を求めるメッセージが表示されたら選択します。

    最初の実行時に、プロンプトでは次のラベルが使用されます。 使用可能なモデルと推論の選択肢は、GitHub Copilot アカウントと選択したモデルによって異なります。

    ? Select AI model
? Select reasoning effort level

  6. 構築する内容について説明します。 次のような関連する要件を含めます。

    • テンプレートにアプリケーション コード、インフラストラクチャのみ、またはその両方が含まれているかどうか。
    • アプリケーションの言語とフレームワーク (既知の場合)。
    • 使用するAzure サービスとホスティング プラットフォーム。
    • Bicepまたは Terraform のどちらを使用するか。
    • セキュリティ、ネットワーク、スケーリング、リージョンの要件。

    例えば次が挙げられます。

    Build an infrastructure-only azd template that provisions an Azure Container Apps
environment, Azure Container Registry, and Log Analytics workspace with Bicep.
Use managed identity and least-privilege role assignments. Parameterize the location
and environment name so the template can be reused.

  7. Copilotからアーキテクチャまたは構成に関する質問に回答します。 エージェントは、プロジェクトをAzure用に準備し、テンプレート資産を生成して、デプロイ前検証を実行します。

  8. Copilot が作成または変更したファイルの全体構成を確認します。 テンプレートに、予想されるプロジェクト構成、インフラストラクチャ ディレクトリ、アプリケーション ソース、およびソリューションのサポート資産が含まれていることを確認します。

    たとえば、生成されたインフラストラクチャ専用テンプレートには、次のキー ファイルが含まれている場合があります。

    azure.yaml
infra/
├── main.bicep
├── main.parameters.json
└── modules/
   ├── container-apps-environment.bicep
   └── container-registry.bicep

    構成とインフラストラクチャの内容の確認に関する詳細なガイダンスについては、「 テンプレート ファイルの探索と編集」を参照してください。

テンプレートをプロビジョニングしてデプロイする

生成されたファイルを承認したら、次のコマンドを実行します。

azd up

このコマンドは、azd環境を作成または選択し、Azure リソースをプロビジョニングし、アプリケーション サービスをパッケージ化してデプロイします。 コマンドの詳細な内訳については、「azd up ワークフローを調べる」を参照してください。

別の作成方法を使用する

他の AI コーディング アシスタントは、 azd init ワークフローに直接接続されていませんが、同じ標準テンプレート資産を作成できます。 また、すべての資産を直接作成することもできます。

これらの資産を自分で作成するか、別のコーディング アシスタントに要件を分析して作成するよう依頼します。

  • プロジェクトと配置可能なサービスを定義する azure.yaml ファイル。
  • 必要なAzure リソースをプロビジョニングするBicepまたは Terraform ファイル。
  • リソース出力とアプリケーション環境変数。
  • 必要に応じて、Dockerfile、デプロイ構成、および補助スクリプト。

別のエージェントを使用する前に最小限の開始点を指定するには、次を実行します。

azd init --minimal

別のコーディング アシスタントを使用する場合は、azure.yaml スキーマ、Azure インフラストラクチャのセキュリティ プラクティス、および開発者 CLI テンプレートで説明されているテンプレート規則Azure従うように指示します。 ファイルを直接作成する場合は、実装ガイドと同じ参照を使用します。 azd upを実行する前に、すべてのファイルを確認して検証します。

関連するコンテンツ

ヘルプを要求する

Azure Developer CLI のバグの報告、ヘルプの要求、または新機能の提案の方法については、トラブルシューティングとサポートページを参照してください。

  • Last updated on