Azure Developer CLI (azd
) には、Azure でのアプリの開発、プロビジョニング、デプロイを効率化するための一連のコマンドが用意されています。
azd init
コマンドを使用すると、azd
を操作するために必要なファイルと構成を生成することで、新規または既存のプロジェクトを設定できます。 この記事では、使用できるさまざまな初期化ワークフローと、開発シナリオに最適なオプションを選択する方法について説明します。
初期化ワークフロー
azd init
コマンドでは、アプリがazd
で動作するように準備するためのいくつかのワークフローがサポートされています。
-
現在のディレクトリ内のコードを使用する: 既存のアプリ コードベースを分析して、適切な
azd
構成ファイルとリソースを生成します。 -
テンプレートの選択: テンプレートを複製し、
azd
テンプレート ギャラリーから初期化します。 -
最小限のプロジェクトを作成する: 独自の
azure.yaml
テンプレートを最初から作成するための開始点として、基本的なazd
ファイルを初期化します。
プロジェクトに最適なアプローチを選択します。 これらのフローはすべて、 テンプレートの作成の概要 と関連記事で詳しく説明されています。 次のセクションでは、各フローの概念的な概要について説明します。
現在のディレクトリでコードを使用する
このワークフローは、既存のアプリ コードベースがあり、 azd
を使用して Azure へのデプロイ用に準備する場合に使用します。
プロジェクトのルート ディレクトリに移動します。
azd init
コマンドを実行します。azd init
[現在のディレクトリでコードを使用する] を選択します。
azd
遺言:- ディレクトリをスキャンして、アプリで使用する言語またはフレームワークを特定します。
- Azure Container Apps などの適切なホスティング プラットフォームを選択します。
- 必要に応じて、検出されたサービスを追加または削除するように求められます。
? How do you want to initialize your app? Use code in the current directory (✓) Done: Scanning app code in current directory Detected services: .NET Detected in: src azd will generate the files necessary to host your app on Azure using Azure Container Apps. ? Select an option [Use arrows to move, type to filter] > Confirm and continue initializing my app Remove a detected service Add an undetected service
[ 確認] を選択し、アプリの初期化を続行 してワークフローを完了します。
azd
では、アプリ ディレクトリに次のものが作成されます。- アプリ サービスを定義し、それらをホスティング リソースにマップする
azure.yaml
ファイル。 - 環境名などの構成設定を保持する
.azure
フォルダー。 - アプリの言語とホスティング プラットフォーム用に構成された
.gitignore
ファイル。
- アプリ サービスを定義し、それらをホスティング リソースにマップする
必要に応じて、
azd up
を実行して Azure Container Apps リソースを作成し、アプリをデプロイします。
アプリは、より多くの Azure リソースとサービスを使用して引き続き開発および拡張できる azd
テンプレートとして構成されました。
テンプレートを選択する
このワークフローでは、通常、アプリケーション コードと必要な Azure インフラストラクチャ定義の両方を含む事前構築済みの azd
テンプレートから始めることができます。
azd init
コマンドを実行します。azd init
注
azd init
パラメーターを使用して--template
を実行して、テンプレートを名前で直接初期化し、ワークフローの選択をスキップすることもできます。[ テンプレートの選択] を選択します。
azd
には、構成済みのテンプレート ソースから使用可能なテンプレートの一覧が表示されます。? How do you want to initialize your app? Select a template ? Select a project template: [Use arrows to move, type to filter] > Deploy Phoenix to Azure (Arize-ai/phoenix-on-azure) API Center Reference Sample (Azure-Samples/APICenter-Reference) Event Driven Java Application with Azure Service Bus on Azure Spring Apps (Azure-Samples/ASA-Samples-Event-Driven-Application) Static React Web App with Java API and PostgreSQL (Azure-Samples/ASA-Samples-Web-Application)
結果をフィルター処理し、
Hello AZD
テンプレートを検索する場合に入力します。 Enter キーを押して、テンプレートを複製して初期化します。必要に応じて、
azd up
を実行してテンプレート リソースをプロビジョニングし、Azure にデプロイします。
初期化されたテンプレートを、さらなる開発の出発点として使用することもできます。
最小限のプロジェクトを作成する
最小限のセットアップから始め、すべてを手動でカスタマイズする上級ユーザー向けに、このオプションは必須の構成のみを提供します。
azd init
コマンドを実行します。azd init
注
azd init
パラメーターを使用して--minimal
を実行して、ワークフローの選択をスキップすることもできます。メッセージが表示されたら、
azd
テンプレートの名前を入力し、Enter キーを押します。? How do you want to initialize your app? Create a minimal project ? What is the name of your project? (empty) hello-azd ? What is the name of your project? hello-azd SUCCESS: Generated azure.yaml project file. Run azd add to add new Azure components to your project.
必須の
azure.yaml
構成ファイルのみが作成されます。 アプリケーション コードや包括的なインフラストラクチャ テンプレートは追加されないため、要件に基づいてインフラストラクチャ ファイルを手動で作成またはカスタマイズする必要があります。必要に応じて、
azd add
コンポーネント機能 を使用して、アプリへの Azure リソースの追加を開始します。
次のステップ
azd init
を使用してプロジェクトを初期化した後、次のことができます。
- 生成されたインフラストラクチャ ファイルを変更して、Azure リソースをカスタマイズします。
-
azd provision
を使用して、Azure に必要なリソースを作成します。 -
azd deploy
を使用して、プロビジョニングされたリソースにアプリケーション コードをデプロイします。 - プロビジョニングとデプロイを 1 つのコマンドで組み合わせる Azure Developer CLI のアップ ワークフロー について説明します。