Azure Developer CLI (azd) では、templates を使用して、アプリ リソースをプロビジョニングし、クラウドにデプロイします。 開発者は、アプリケーションをテンプレートに変換することで、 azd コマンドと機能のサポートを追加できます。 この記事では、 azd テンプレートを構築するためのさまざまなオプションのコンテキストの概要について説明します。 この記事の概念を理解したら、より詳細な実装ガイドについては、次のリソースを参照してください。
注
この記事では、 azd テンプレートの一般的な理解を前提としています。 テンプレートの詳細については、 テンプレートの概要 に関するドキュメントを参照してください。
テンプレート作成の概念
azd テンプレートを作成するには、既存のコード ベースに特定の構成資産とインフラストラクチャ資産を追加するか、既存のテンプレートから新しいアプリを開始する必要があります。 どちらのワークフローも、後のセクションで説明します。 すべての azd テンプレートは、 azd 規則に基づいて同様のファイル構造を共有します。 次の図は、 azd テンプレートを作成するプロセスの概要を示しています。
すべての azd テンプレートには、次の最小リソースが必要です。
- インフラストラクチャコード（Bicep または Terraform ファイル）を含む
infraフォルダー。 - プロビジョニングされたインフラストラクチャ リソースにアプリケーション サービスをマップする
azure.yaml構成ファイル。
多くの場合、CI/CD パイプラインを作成するためのアセットを含む .github フォルダーなど、その他の省略可能なディレクトリも含まれます。 テンプレートの詳細については、 テンプレートの概要 に関するドキュメントを参照してください。
次のサンプル アプリ リポジトリについて考えてみましょう。
このサンプル アプリを azd テンプレートに変換した後、同じアプリ リポジトリに次のものが含まれます。
元のアプリ リソースは変更されていませんが、azd が azd up に依存しているようなコマンドに対応する新しいアセットが追加されました。
- Azure リソースを作成するBicep ファイルを含む
infraフォルダーが追加されました。 -
azure.yaml構成ファイルが追加され、srcディレクトリ内のアプリ コードがプロビジョニング Azure リソースにマップされました。 - 環境変数を保持する
.azureフォルダーazd作成されました。 -
.githubフォルダー (省略可能) が追加され、GitHub アクションを通じて CI/CD パイプラインがサポートされました。
テンプレート作成ワークフロー
azd init コマンドは、アプリ リソースをプロビジョニングして Azure にデプロイするために、azd テンプレートを初期化するために使用されます。 次のセクションで説明するテンプレートを初期化するには、次の 2 つの異なるワークフローから選択するように求められます。 現在のディレクトリのコードを使用 し、 既存のテンプレートを使用します。
azd initに変換するディレクトリのルートで、azd template コマンドを実行します。
azd init
現在のディレクトリでコードを使用する
このオプションは、ディレクトリ内のコードを分析して、プログラミング言語、フレームワーク、データベース システムなど、使用するテクノロジを識別するように azd に指示します。
azd では、 azure.yaml サービス定義ファイルや、コードとしてのインフラストラクチャ ファイルを含む infra フォルダーなど、テンプレート資産が自動的に生成されます。 生成された資産は、追加の変更の開始点です。
azd スキャフォールディング機能でサポートされている一般的なAzure サービスを使用する場合は、この方法を使用します。
テンプレートを作成するためのアプリ コードを使用して開始するチュートリアルで、このアプローチを実装する方法の詳細と、自動検出とスキャフォールディングをサポートするAzureリソースの詳細を確認してください。
テンプレートを選択する
Azureリソースとアーキテクチャの目標の多くを開始点として定義する既存のテンプレートを使用するには、このオプションを選択します。
azd は、 awesome-azd ギャラリーからスターター テンプレートまたは別のテンプレートを選択するように求められます。 テンプレートを選択すると、そのテンプレートのアセットが既存のプロジェクト ディレクトリに追加され、開始点として使用されます。 一部のテンプレートには、独自のテンプレートに置き換えることができるサンプル アプリ コードが含まれていますが、一部 ("スターター テンプレート" と呼ばれます) はインフラストラクチャのみです。
azd init コマンドを使用して、既存のテンプレートを空のディレクトリにプルダウンし、独自のアプリの開始点として使用します。 テンプレートにアプリのソース コードが含まれている場合は、そのコードからビルドするか、ソース コード ディレクトリを独自のディレクトリに置き換えることができます。
この方法を実装する方法の詳細については、 既存のテンプレート のチュートリアルを開始するを参照してください。
こちらも参照ください
ヘルプを要求する
Azure Developer CLI のバグの報告、ヘルプの要求、または新機能の提案の方法については、トラブルシューティングとサポートページを参照してください。