次の方法で共有


Azure Developer CLI 初期化ワークフローを調べる

Azure Developer CLI (azd) には、Azure でのアプリの開発、プロビジョニング、デプロイを効率化するための一連のコマンドが用意されています。 azd init コマンドを使用すると、azdを操作するために必要なファイルと構成を生成することで、新規または既存のプロジェクトを設定できます。 この記事では、使用できるさまざまな初期化ワークフローと、開発シナリオに最適なオプションを選択する方法について説明します。

初期化ワークフロー

azd init コマンドでは、アプリがazdで動作するように準備するためのいくつかのワークフローがサポートされています。

  • 現在のディレクトリ内のコードを使用する: 既存のアプリ コードベースを分析して、適切な azd 構成ファイルとリソースを生成します。
  • テンプレートの選択: テンプレートを複製し、 azdテンプレート ギャラリーから初期化します。
  • 最小限のプロジェクトを作成する: 独自のazure.yaml テンプレートを最初から作成するための開始点として、基本的なazd ファイルを初期化します。

プロジェクトに最適なアプローチを選択します。 これらのフローはすべて、 テンプレートの作成の概要 と関連記事で詳しく説明されています。 次のセクションでは、各フローの概念的な概要について説明します。

現在のディレクトリでコードを使用する

このワークフローは、既存のアプリ コードベースがあり、 azdを使用して Azure へのデプロイ用に準備する場合に使用します。

  1. プロジェクトのルート ディレクトリに移動します。

  2. azd init コマンドを実行します。

    azd init
    
  3. [現在のディレクトリでコードを使用する] を選択します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
    
  4. [ 確認] を選択し、アプリの初期化を続行 してワークフローを完了します。 azd では、アプリ ディレクトリに次のものが作成されます。

    • アプリ サービスを定義し、それらをホスティング リソースにマップする azure.yaml ファイル。
    • 環境名などの構成設定を保持する .azure フォルダー。
    • アプリの言語とホスティング プラットフォーム用に構成された .gitignore ファイル。
  5. 必要に応じて、 azd up を実行して Azure Container Apps リソースを作成し、アプリをデプロイします。

アプリは、より多くの Azure リソースとサービスを使用して引き続き開発および拡張できる azd テンプレートとして構成されました。

テンプレートを選択する

このワークフローでは、通常、アプリケーション コードと必要な Azure インフラストラクチャ定義の両方を含む事前構築済みの azd テンプレートから始めることができます。

  1. azd init コマンドを実行します。

    azd init
    

    azd init パラメーターを使用して--templateを実行して、テンプレートを名前で直接初期化し、ワークフローの選択をスキップすることもできます。

  2. [ テンプレートの選択] を選択します。 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)
    
  3. 結果をフィルター処理し、 Hello AZD テンプレートを検索する場合に入力します。 Enter キーを押して、テンプレートを複製して初期化します。

  4. 必要に応じて、 azd up を実行してテンプレート リソースをプロビジョニングし、Azure にデプロイします。

初期化されたテンプレートを、さらなる開発の出発点として使用することもできます。

最小限のプロジェクトを作成する

最小限のセットアップから始め、すべてを手動でカスタマイズする上級ユーザー向けに、このオプションは必須の構成のみを提供します。

  1. azd init コマンドを実行します。

    azd init
    

    azd init パラメーターを使用して--minimalを実行して、ワークフローの選択をスキップすることもできます。

  2. メッセージが表示されたら、 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 構成ファイルのみが作成されます。 アプリケーション コードや包括的なインフラストラクチャ テンプレートは追加されないため、要件に基づいてインフラストラクチャ ファイルを手動で作成またはカスタマイズする必要があります。

  3. 必要に応じて、 azd addコンポーネント機能 を使用して、アプリへの Azure リソースの追加を開始します。

次のステップ

azd initを使用してプロジェクトを初期化した後、次のことができます。

  • 生成されたインフラストラクチャ ファイルを変更して、Azure リソースをカスタマイズします。
  • azd provisionを使用して、Azure に必要なリソースを作成します。
  • azd deployを使用して、プロビジョニングされたリソースにアプリケーション コードをデプロイします。
  • プロビジョニングとデプロイを 1 つのコマンドで組み合わせる Azure Developer CLI のアップ ワークフロー について説明します。