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 からターゲット環境の選択が求められます。

関連項目

• Teams ツールキットの概要
• Teams のアプリ マニフェストのスキーマ
• クラウド リソースをさらに追加する
• Teams プロジェクトで他の開発者と協力する
• 異なる環境でアプリの動作をテストする