Microsoft Visual Studio でクラウド リソースをプロビジョニングする
TeamsFx は Azure と Microsoft 365 クラウドと統合されており、1 つのコマンドでアプリを Azure に配置できます。 TeamsFx は Azure Resource Manager (ARM) と統合され、アプリケーションでコード アプローチに必要な Azure リソースをプロビジョニングできます。
Visual Studio を開きます。
Microsoft Teams App プロジェクトを開きます。
クラウドで [Project>Teams Toolkit>Provision] を選択します。
[ サインイン...] を選択します。
注意
既にサインインしている場合は、ユーザー名が表示されるか、[ アカウントの追加] オプションが表示されます。
資格情報を使用して Azure アカウントにサインインすると、ブラウザーは自動的に閉じます。
Visual Studio でプロジェクトを開いた後、クラウド リソースをプロビジョニングするには、次の手順に従います。
Cloud...で [Project>Teams Toolkit>Provision] を選択します。
[ プロビジョニング] ウィンドウが表示されます。
リソースをプロビジョニングするには、次の詳細を入力します。
- ドロップダウン メニューから サブスクリプション名 を選択します。
- ドロップダウン メニューからリソース グループを選択するか、[新規作成]を選択して新しいリソース グループを作成できます。
- ドロップダウン メニューから [リージョン ] を選択します。
- [プロビジョニング] を選択します。
表示されるポップアップ ウィンドウで、[プロビジョニング] を選択 します。
プロビジョニング プロセスでは、Azure クラウドにリソースが作成されます。 [ツールキットの出力] ウィンドウMicrosoft Teams監視することで、進行状況を監視できます。
表示されるポップアップ ウィンドウで、プロビジョニングされているすべてのリソースを表示するには、[ プロビジョニングされたリソースの表示] を選択します。
次のアクションは、プロビジョニング用に設計されています。
- teamsApp/create
- teamsApp/update
- teamsApp/validateManifest
- teamsApp/validateAppPackage
- teamsApp/zipAppPackage
- teamsApp/publishAppPackage
- aadApp/create
- aadApp/update
- botAadApp/create
- arm/deploy
- azureStorage/enableStaticWebsite
- スクリプト
Teams アプリ ID を格納する環境変数が空であるか、アプリ ID が Teams 開発者ポータルから見つからない場合、 teamsApp/create
アクションによって新しい Teams アプリが作成されます。 これは、Teams 開発者ポータルの Teams アプリで動作します。
- uses: teamsApp/create
with:
# #required. Name of Teams app
name: <your-preferred-app-name>
# Write the information of created resources into environment file for the specified environment variable(s).
writeToEnvironmentFile:
# The id for Teams app
teamsAppId: <your-preferred-env-var-name>
Teams 開発者ポータルで Teams アプリ マニフェストを既存の Teams アプリに適用する場合。
teamsApp/update
action は、manifest.json ファイル内のアプリ ID を使用して、更新する Teams アプリを決定します。 これは、Teams 開発者ポータルの Teams アプリで動作します。
- uses: teamsApp/update
with:
# Required. Relative path to the yaml file. This is the path for built zip file.
appPackagePath: <path-to-teams-app-package-file>
teamsApp/validateManifest
アクションは、環境変数を使用して Teams アプリ マニフェスト テンプレートをレンダリングし、そのスキーマを使用して Teams アプリ マニフェスト ファイルを検証します。
- uses: teamsApp/validateManifest
with:
# Required. Relative path to the yaml file. Path to Teams app manifest file
manifestPath: <path-to-manifest-file>
teamsApp/validateAppPackage
アクションは、検証ルールを使用して Teams アプリ パッケージを検証します。
- uses: teamsApp/validateAppPackage
with:
# Required. Relative path to the yaml file. This is the path for built zip file.
appPackagePath: <path-to-teams-app-package-file>
teamsApp/zipAppPackage
アクションは、環境変数を含む Teams アプリ マニフェスト テンプレートをレンダリングし、2 つのアイコンを含むマニフェスト ファイルを zip ファイルに圧縮します。
- uses: teamsApp/zipAppPackage
with:
# Required. Relative path to the yaml file. This is the path for Teams app manifest file. Environment variables in manifest will be replaced before apply to Microsoft Entra app.
manifestPath: <path-to-manifest-file>
# Required. Relative path to the yaml file. This is the path for built zip file.
outputZipPath: <path-to-generated-zip-file>
# Required. Relative path to the yaml file. This is the path for built manifest json file.
outputJsonPath: <path-to-generated-json-file>
teamsApp/publishAppPackage
アクションは、ビルドされた Teams アプリ zip ファイルをテナント アプリ カタログに発行します。 Microsoft 365 テナント アプリ カタログで動作します。
- uses: teamsApp/publishAppPackage
with:
# Required. Relative path to this file. This is the path for built zip file.
appPackagePath: <path-to-teams-app-package>
# Write the information of created resources into environment file for the specified environment variable(s).
writeToEnvironmentFile:
# The Teams app id in tenant app catalog.
publishedAppId: <your-preferred-env-var-name>
aadApp/create
アクションは、clientId
を格納する環境変数が空の場合にユーザーを認証する新しい Microsoft Entra アプリケーションを作成します。 Microsoft 365 テナントの Microsoft Entra ID で動作します。
- uses: aadApp/create
with:
# Required. The Microsoft Entra app's display name. When you run aadApp/update, the Microsoft Entra app name will be updated based on the definition in manifest. If you don't want to change the name, make sure the name in Microsoft Entra app manifest is the same with the name defined here.
name: <your-application-name>
# Required. If the value is false, the action will not generate client secret for you
generateClientSecret: true
# Required. Specifies what Microsoft accounts are supported for the current application. Supported values are: `AzureADMyOrg`, `AzureADMultipleOrgs`, `AzureADandPersonalMicrosoftAccount`, `PersonalMicrosoftAccount`.
signInAudience: "AzureADMyOrg"
# Write the information of created resources into environment file for the specified environment variable(s).
writeToEnvironmentFile:
# Required. The client (application) ID of Microsoft Entra application. The action will refer the environment variable defined here to determine whether to create a new Microsoft Entra app.
clientId: <your-preferred-env-var-name>
# Required when `generateClientSecret` is `true`. The action will refer the environment variable defined here to determine whether to create a new client secret. It's recommended to add `SECRET_` prefix to the environment variable name so it will be stored to the .env.{envName}.user environment file.
clientSecret: <your-preferred-env-var-name>
# Required. The object ID of Microsoft Entra application
objectId: <your-preferred-env-var-name>
# Optional. The tenant ID of Microsoft Entra tenant
tenantId: <your-preferred-env-var-name>
# Optional. The Microsoft Entra authority
authority: <your-preferred-env-var-name>
# Optional. The host name of Microsoft Entra authority
authorityHost: <your-preferred-env-var-name>
aadApp/update
action は、Microsoft Entra アプリ マニフェストに基づいて Microsoft Entra アプリケーションを更新します。 これは、Microsoft Entra アプリ マニフェストの ID プロパティを参照して、更新する Microsoft Entra アプリを決定します。 aadApp/update は、Microsoft 365 テナントの Microsoft Entra ID で動作します。
- uses: aadApp/update
with:
# Required. Relative path to the yaml file. Path to the Microsoft Entra app manifest. Environment variables in manifest will be replaced before apply to Microsoft Entra app.
manifestPath: <path-to-manifest-file>
# Required. Relative path to the yaml folder. This action will output the final Microsoft Entra app manifest used to update Microsoft Entra app to this path.
outputFilePath : <path-to-output-file>
botAadApp/create
アクションは、ボット用に新しい Microsoft Entra アプリケーションを作成するか、既存の Microsoft Entra アプリケーションを再利用します。 Microsoft 365 テナントの Microsoft Entra ID で動作します。
- uses: botAadApp/create
with:
# Required. The Microsoft Entra app's display name
name: <your-app-name>
writeToEnvironmentFile:
# The The Microsoft Entra app's client id created for bot.
botId: <your-preferred-env-var-name>
# The The Microsoft Entra app's client secret created for bot.
botPassword: <your-preferred-env-var-name>
arm/deploy
アクションは、指定された ARM テンプレートを並列にデプロイします。 Azure サブスクリプションで動作します。
- uses: arm/deploy
with:
# Required. You can use built-in environment variable `AZURE_SUBSCRIPTION_ID` here. TeamsFx will ask you select one subscription if its value is empty. You're free to reference other environment variable here, but TeamsFx will not ask you to select subscription if it's empty in this case.
subscriptionId: ${{AZURE_SUBSCRIPTION_ID}}
# Required. You can use built-in environment variable `AZURE_RESOURCE_GROUP_NAME` here. TeamsFx will ask you to select or create one resource group if its value is empty. You're free to reference other environment variable here, but TeamsFx will not ask you to select or create resource group if it's empty in this case.
resourceGroupName: ${{AZURE_RESOURCE_GROUP_NAME}}
# Required. The ARM templates to be deployed.
templates:
# Required. Relative path to the yaml file.
- path: <path-to-arm-template>
# Optional. Relative path to the yaml file. TeamsFx will replace the environment variable reference with real value before deploy ARM template.
parameters: <path-to-arm-template-parameter>
# Required. Name of the ARM template deployment.
deploymentName: <arm-deployment-name>
# Optional. Teams Toolkit will download this bicep CLI version from github for you, will use bicep CLI in PATH if you remove this config.
bicepCliVersion: v0.9.1
azureStorage/enableStaticWebsite
アクションを使用すると、Azure Storage で静的 Web サイト設定が有効になります。 Azure Storage で動作します。
- uses: azureStorage/enableStaticWebsite
with:
# Required. The resource id of Azure Storage
storageResourceId: ${{<env-name-of-azure-storage-resource-id>}}
# Required. The path to index page.
indexPage: <path-to-index-page>
# Required. The path to error page.
errorPage: <path-to-error-page>
script
アクションは、ユーザー定義スクリプトを実行します。
- uses: script
with:
# Required. Command to run or path to the script. Succeeds if exit code is 0. '::set-teamsfx-env key=value' is a special command to generate output variables into .env file, in this case, "mykey=abc" will be added the output in the corresponding .env file.
run: $my_key="abc"; echo "::set-teamsfx-env mykey=${my_key}"
# Optional. Available values are: bash, sh, powershell(Powershell Desktop), pwsh(powershell core), cmd. If omitted, it defaults to bash on Linux/MacOS, defaults to pwsh on windows.
shell: <shell-name>
# Optional. Current working directory. Defaults to the directory of this file.
workingDirectory: <working-directory>
# Optional. Timeout in ms.
timeout: <timeout-in-ms>
# Optional. Redirect stdout and stderr to a file.
redirectTo: <path-to-output-file>
プロビジョニング手順は、provision
プロパティのteamsapp.yml
ファイルで定義されます。
provision
プロパティにアクションを追加、削除、または更新して、プロビジョニング中に実行する必要があるアクションを定義できます。
Teams Toolkit では、 teamsapp.yml
ファイル、Teams アプリ マニフェスト、Microsoft Entra アプリ マニフェスト、Azure パラメーター ファイル内の環境変数からの値の参照がサポートされています。 構文 ${{ENV_VARIABLE_NAME}}
を使用して環境変数を参照できます。
次の例では、環境変数 MY_AZURE_SUBSCRIPTION_ID
の値を subscriptionId
に設定します。
subscriptionId: ${{MY_AZURE_SUBSCRIPTION_ID}}
定義済みのテンプレートがアプリの要件を満たしていない場合は、独自の ARM テンプレートを作成するか、既存の ARM テンプレートを更新し、 arm/deploy
アクションへのパスを次のように指定します。
- uses: arm/deploy
with:
subscriptionId: ${{AZURE_SUBSCRIPTION_ID}}
resourceGroupName: ${{AZURE_RESOURCE_GROUP_NAME}}
templates:
- path: <path-to-your-arm-template>
parameters: <path-to-your-parameter-file>
deploymentName: <arm-deployment-name>
bicepCliVersion: <bicep-cli-version>
arm/deploy
アクションでは、bicep 形式と json 形式で記述された ARM テンプレートがサポートされています。 json 形式を使用する場合は、 bicepCliVersion
パラメーターを省略できます。 Azure Resource Manager に関する基本的な知識が必要です。 詳細については、 Azure Resource Manager のドキュメントを参照してください。
Azure portal にサインインし、Teams Toolkit を使用して作成されたすべてのリソースを管理できます。
- 既存の一覧または作成した新しいリソース グループからリソース グループを選択できます。
- 選択したリソース グループの詳細は、目次の概要セクションで確認できます。
作成した Microsoft Entra アプリを使用するように環境変数を追加することで、ボットまたは Teams アプリをカスタマイズできます。 Teams アプリは、次の方法でカスタマイズできます。
Teams アプリ用に作成された Microsoft Entra アプリを使用し、環境変数を .env ファイルに追加するには、次の手順に従います。
teamsapp.yml
ファイルを開き、aadApp/create
アクションを見つけます。microsoft Entra アプリの情報を格納する環境変数名を
writeToEnvironmentFile
プロパティで見つけます。 Teams Toolkit を使用してプロジェクトを作成する場合、既定のwriteToenvironmentFile
プロパティ定義は次のようになります。writeToEnvironmentFile: clientId: AAD_APP_CLIENT_ID clientSecret: SECRET_AAD_APP_CLIENT_SECRET objectId: AAD_APP_OBJECT_ID tenantId: AAD_APP_TENANT_ID authority: AAD_APP_OAUTH_AUTHORITY authorityHost: AAD_APP_OAUTH_AUTHORITY_HOST
手順 2. から各環境変数の値を追加します。
ファイルに次の環境変数とその値
env\.env.{env}
追加します。 例:AAD_APP_CLIENT_ID=<value of Microsoft Entra application's client id (application id)> # example: 00000000-0000-0000-0000-000000000000 AAD_APP_OBJECT_ID=<value of Microsoft Entra application's object id> # example: 00000000-0000-0000-0000-000000000000 AAD_APP_TENANT_ID=<value of Microsoft Entra's (tenant) id>> # example: 00000000-0000-0000-0000-000000000000 AAD_APP_OAUTH_AUTHORITY=<value of Microsoft Entra's authority> # example: https://login.microsoftonline.com/<Directory (tenant) ID> AAD_APP_OAUTH_AUTHORITY_HOST=<host of Microsoft Entra's authority> # example: https://login.microsoftonline.com AAD_APP_ACCESS_AS_USER_PERMISSION_ID=<id of access_as_user permission> # example: 00000000-0000-0000-0000-000000000000
アプリケーションで Microsoft Entra アプリ クライアント シークレットが必要な場合は、次の環境変数とその値をファイル
env\.env.{env}.user
追加します。 例:SECRET_AAD_APP_CLIENT_SECRET=<value of Microsoft Entra application's client secret>
Microsoft Entra アプリがまだない場合、または Microsoft Entra アプリを持っていても、正しい値を見つける場所がわからない場合は、「 TeamsFx プロジェクトで既存の Microsoft Entra アプリを使用する」を参照してください。
注意
-
writeToEnvironmentFile
で異なる名前を使用する場合は、例の環境変数の名前を必ず更新してください。 -
aadApp/create
アクションを使用して Microsoft Entra アプリケーションを作成しない場合は、上記の手順に従わずに、任意の名前で必要な環境変数を追加できます。 - 複数の環境で同じ Microsoft Entra アプリを共有しないようにします。
次の手順に従って、環境変数を .env ファイルに追加して、Teams アプリ用に作成された Microsoft Entra アプリを使用できます。
teamsapp.yml
ファイルを開き、botAadApp/create
アクションを見つけます。microsoft Entra アプリの情報を格納する環境変数名を
writeToEnvironmentFile
プロパティで見つけます。 Teams Toolkit を使用してプロジェクトを作成する場合の既定のwriteToEnvironmentFile
定義は次のとおりです。writeToEnvironmentFile: botId: BOT_ID botPassword: SECRET_BOT_PASSWORD
手順 2. から各環境変数の値を追加します。
環境変数とその値をファイルに追加
env\.env.{env}
。 例:BOT_ID=<value of Microsoft Entra application's client id (application id)> # example: 00000000-0000-0000-0000-000000000000
環境変数とその値をファイルに追加
env\.env.{env}.user
。 例:SECRET_BOT_PASSWORD=<value of Microsoft Entra application's client secret>
ボット用の Microsoft Entra アプリがまだない場合や、適切な値を見つける場所がわからない場合は、「 TeamsFx プロジェクトで既存の Microsoft Entra アプリを使用する」を参照してください。
注意
-
writeToEnvironmentFile
で異なる名前を使用する場合は、例の環境変数の名前を必ず更新してください。 -
botAadApp/create
アクションを使用して Microsoft Entra アプリケーションを作成しない場合は、上記の手順に従わずに、任意の名前で必要な環境変数を追加できます。 - 複数の環境で同じ Microsoft Entra アプリを共有しないようにします。
Platform Docs に関するフィードバック
Platform Docs はオープンソース プロジェクトです。 フィードバックを提供するにはリンクを選択します。