Azure Developer CLI を使用して環境を作成する

  • [アーティクル]

この記事では、Azure Developer CLI (AZD) をインストールし、アプリ インフラストラクチャを Azure Deployment Environments にプロビジョニングして新しいデプロイ環境を作成し、プロビジョニングされたデプロイ環境にアプリ コードをデプロイします。

Azure Developer CLI (AZD) は、ローカルの開発環境から Azure にアプリケーションを移すために要する時間を短縮するオープンソース ツールです。 AZD では、ワークフロー (ターミナル、エディター、統合開発環境 (IDE) のどれで作業しているかに関わらず) または CI/CD (継続的インテグレーションと継続的デプロイ) の主要なステージに適用できる、ベスト プラクティスで開発者にとって使いやすいコマンドが提供されています。

Azure Deployment Environments で動作するように AZD を設定する方法については、「Azure Deployment Environments で Azure Developer CLI を使用する」を参照してください。

前提条件

次のことを行う必要があります。

AZD を使用する準備をする

AZD を初めて使用する場合は、1 回限りのセットアップ タスクをいくつか完了する必要があります。 これらのタスクには、Azure Developer CLI のインストール、Azure アカウントへのサインイン、Azure Deployment Environments に対する AZD サポートの有効化が含まれます。

Azure Developer CLI をインストールするには、次の手順に従います。

Visual Studio Code の Azure Developer CLI 拡張機能のインストール

azd をインストールすると、azd ツールはグローバルではなく azd スコープ内にインストールされ、azd がアンインストールされると削除されます。 Visual Studio Code で azd ツールを使用するには、拡張機能をインストールします。

Visual Studio Code で Azure Developer CLI 機能を有効にするには、Azure Developer CLI 拡張機能バージョン v0.8.3 をインストールします。 [アクティビティ] バーで [拡張機能] アイコンを選択し、Azure Developer CLI を検索して、[インストール] を選択します。

Visual Studio Code のスクリーンショット。コマンド パレットの [サインイン] コマンドを確認できます。

Azure Developer CLI を使用してサインインする

ログインして Azure リソースにアクセスします。 ログインを開始すると、ブラウザー ウィンドウが開き、Azure へのログインを求められます。 サインインすると、Azure にサインインしていることを示すメッセージがターミナルに表示されます。

コマンド パレットを使用して AZD にサインインします。

Visual Studio Code のスクリーンショット。[拡張機能] ウィンドウ内で Azure Developer CLI とインストールが強調表示されています。

コマンド パレットから発行されたコマンドの出力は、次の例のように azd dev ターミナルに表示されます。

azd dev ターミナルのスクリーンショット。任意のキーを押すとメッセージが閉じられます。

ADE の AZD サポートを有効にする

azd up や azd provision などの標準コマンドを使用してデプロイ環境にリソースをプロビジョニングしデプロイするように AZD を構成できます。 platform.type が devcenter に設定されている場合、すべての AZD リモート環境の状態とプロビジョニングでデベロッパー センターのコンポーネントが使用されます。 AZD は、リソース プロビジョニングのためにデベロッパー センター カタログで定義されているインフラストラクチャ テンプレートの 1 つを使用します。 この構成では、ローカル テンプレート内の infra フォルダーは使用されません。

Visual Studio Code のスクリーンショット。コマンド パレットの [サポートの有効化] コマンドを確認できます。

既存のコードから環境を作成する

これで、作業する環境を作成する準備ができました。 ローカル フォルダー内のコードから始めることもできますし、既存のリポジトリを複製することもできます。 この例では、ローカル フォルダー内のコードを使用して環境を作成します。

新しいアプリケーションを初期化する

新しいアプリケーションを初期化すると、AZD がアプリケーションを操作するために必要なファイルとフォルダーが作成されます。

AZD は azure.yaml ファイルを使用して環境を定義します。 azure.yaml ファイルは、アプリケーションが使用する Azure リソースのアプリと種類を定義し記述します。 azure.yaml の詳細については、「Azure Developer CLI の azure.yaml スキーマ」を参照してください。

  1. Visual Studio Code で、アプリケーション コードが含まれるフォルダーを開きます。

  2. コマンド パレットを開き、「Azure Developer CLI init」と入力し、一覧から Azure Developer CLI (azd): init を選択します。

    Visual Studio Code コマンド パレットのスクリーンショット。[Azure Developer CLI (azd): init] が強調表示されています。

  3. テンプレートの一覧で、テンプレートを選択せずに続行するには、Enter キーを 2 回押します。

  4. AZD ターミナルで、[現在のディレクトリのコードを使用する] を選択します。

    Visual Studio Code の AZD ターミナルのスクリーンショット。[現在のディレクトリでコードを使用する] プロンプトが表示されています。

  5. azd init により、アプリ コードに定義されているサービスが特定され、確認して続行するか、サービスを削除するか、サービスを追加することを求められます。 [Confirm and continue initializing my app] を選びます。

    AZD init プロンプトのスクリーンショット。確認して続行するか、サービスを削除するか、サービスを追加します。

  6. azd init はアプリを構成する情報を引き続き収集します。 このサンプル アプリケーションでは、MongoDB データベース インスタンスの名前と、サービスがリッスンするポートの入力を求められます。

    azd init プロンプトのスクリーンショット。データベース名を求めています。

  7. ローカル AZD 環境の名前を入力します。

    azd init プロンプトのスクリーンショット。新しい環境名を入力します。

  8. azd init により、アクセスできるプロジェクトの一覧が表示されます。 環境のプロジェクトを選びます

    azd init プロンプトのスクリーンショット。プロジェクトを選択します。

  9. azd init により、プロジェクト内の環境定義の一覧が表示されます。 環境定義を選びます。

    azd init プロンプトのスクリーンショット。環境の定義を選択します。

    AZD により、プロジェクトのルートに azure.yaml ファイルなどのプロジェクト リソースが作成されます。

Azure Deployment Environments へのインフラストラクチャのプロビジョニング

準備ができたら、ローカル環境を Azure のリモート Azure Deployment Environments 環境にプロビジョニングできます。 このプロセスでは、デベロッパー センター カタログの環境定義で定義されているインフラストラクチャとリソースがプロビジョニングされます。

  1. エクスプローラーで azure.yaml を右クリックし、[Azure Developer CLI (azd)]>[Azure リソースのプロビジョニング (provision)]を選択します。

    Visual Studio Code のスクリーンショット。azure.yaml、AZD コンテキスト メニュー、Azure Developer CLI、環境のプロビジョニングを確認できます。

  2. AZD は、アクセス権を持つプロジェクトについて Azure Deployment Environments をスキャンします。 AZD ターミナルで、次の情報を選ぶか入力します。

    1. Project
    2. 環境定義
    3. 環境の種類
    4. 場所

  3. AZD は、前の手順で指定した情報に基づいて新しい環境を作成するよう ADE に指示します。

  4. 作成されたリソースは、Azure portal または開発者ポータルで表示できます。

既存の環境を一覧表示する (省略可能)

既存の環境を一覧表示して、環境が作成されたことを確認します。

  1. エクスプローラーで azure.yaml を右クリックし、[Azure Developer CLI (azd)]>[ローカル環境とリモート環境の表示 (env list)] を選択します。

    Visual Studio Code のスクリーンショット。azure.yaml、AZD コンテキスト メニュー、Azure Developer CLI、ローカルおよびリモート環境の表示を確認できます。

    プロジェクトと環境定義を選択するように求められます。

Azure Deployment Environments にコードをデプロイする

環境がプロビジョニングされたら、コードを環境にデプロイできます。

  1. エクスプローラーで azure.yaml を右クリックし、[Azure Developer CLI (azd)]>[Azure リソースのデプロイ (deploy)]を選択します。

    Visual Studio Code のスクリーンショット。azure.yaml、AZD コンテキスト メニュー、Azure Developer CLI、Azure へのデプロイを確認できます。

  2. AZD ターミナルに一覧表示されているエンドポイント URL を選択して、コードがデプロイされていることを確認できます。

リソースをクリーンアップする

環境での作業を終えたら、Azure リソースを削除できます。

エクスプローラーで azure.yaml を右クリックし、[Azure Developer CLI (azd)]>[デプロイとリソースの削除 (down)]を選択します。

Visual Studio Code のスクリーンショット。azure.yaml、AZD コンテキスト メニュー、Azure Developer CLI、デプロイとリソースの削除 (下) を確認できます。

プロンプトが表示されたら、y を入力して環境を削除することを確認します。

関連するコンテンツ