Microsoft Teams Toolkit の環境

Teams Toolkit では、開発、ステージング、運用環境、またはコンピューター上のローカルなど、さまざまなターゲットでアプリを実行してテストする方法が提供されます。 これを行うために、Teams Toolkit には、環境ファイル内の情報を使用して、これらの異なるターゲットの構成を調整するオプションの機能セットが含まれています。 環境ファイルは、デプロイ ターゲットのすべてのリソースのコレクションを表します。 Teams Toolkit プロジェクト テンプレートには、2 つの既定の環境グループが含まれています。1 つは、"local" という名前のコンピューターでアプリを実行するためのグループと、"dev" という名前の別の場所をホストするためのグループです。 "dev" 環境の名前を変更し、[環境] ウィンドウを使用して別の環境を追加するか、新しい .env.{environment-name} ファイルで手動で追加できます。 ローカル環境の名前を変更することはできません。

Teams Toolkit は、さまざまな環境ファイルを追加することで、アプリを実行し、それらのリソースにコードをデプロイするために必要なリソースのプロビジョニングを自動化するのに役立ちます。 これらの機能を使用して、環境の数に対して 1 つのデプロイ 規則のセットを作成できます。

Teams Toolkit での環境ファイルの使用

Teams Toolkit では、 .env.{environment-name}などの環境ファイルの名前付け規則が使用されます。 ツールキットのライフサイクル コマンド (プロビジョニング、デプロイ、または発行) を使用して、環境名を指定する必要があります。 環境の名前は、環境ファイルの作成時に {environment-name} に選択した値と同じである必要があります。

注:

現在のシェル環境で Teams Toolkit の環境変数を定義できます。これは、名前付けの競合中に .env ファイル内の値をオーバーライドします。

環境ファイルの場所

既定では、Teams Toolkit では env 変数は読み込まれません。アクションの実行と ./env/.env.devへの出力の書き込みを続行するだけです。 environmentFolderPathが定義されていない場合、Teams Toolkit は.env ファイルから環境変数を読み込まず、env が dev であると仮定してアクションを実行します。 出力は、 ./env/.env.devに書き込まれます。

ローカル環境

Microsoft Teams アプリを構築するには、アプリの登録や Teams クライアントなどの特定のリソースがクラウドでホストされます。 ただし、アプリケーション ロジックなどの他のリソースをローカルでホストして、アプリ開発中のテストの変更を簡略化できます。 Teams Toolkit のすべてのプロジェクト テンプレートとサンプルは、 local 環境で構成されます。 ローカル環境には ./env/.env.local./env/.env.local.user ファイルがあり、ローカルでホストされている Web サーバーでアプリを実行するのに役立ちます。 Visual Studio Code (VS Code) と Visual Studio (VS) を使用する場合、ブレークポイントでのデバッグをサポートするようにプロジェクト テンプレートとサンプルが設定されます。

ローカル環境とその他のすべての環境を区別するために、teamsapp.ymlと同じディレクトリに teamsapp.local.yml という名前の別のプロジェクト ファイルを作成できます。

Visual Studio Code で新しい環境を手動で作成する

各プロジェクトには、1 つのローカル環境を使用できますが、複数のリモート環境を使用できます。 プロジェクトを作成すると、Teams Toolkit によって次の既定の環境が構成されます。

  • ローカル コンピューター環境の構成を表すローカル環境。
  • リモート またはクラウド環境の構成を表す開発環境。

新しい環境を作成するには:

  1. Visual Studio Code で Teams アプリ プロジェクトを開きます。

  2. Visual Studio Code アクティビティ バーから Teams Toolkit アイコンを選択します。

  3. [環境] セクションで+ アイコンを選択します。

    [環境] セクションで強調表示されているプラスアイコンを示すスクリーンショット。

  4. 環境の名前を入力し、[Enter] を選択 します

    環境名を入力する場所を示すスクリーンショット。

環境のターゲット設定

複数の環境があり、[運用]、[開発]、または [ローカル] メニュー項目を選択すると、Teams Toolkit からターゲット環境の選択が求められます。

[運用環境] が選択されていることを示すスクリーンショット。

関連項目