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