Implantar o aplicativo Microsoft Teams na nuvem usando o Microsoft Visual Studio

O Microsoft 365 Agents Toolkit (anteriormente conhecido como Teams Toolkit) ajuda a implantar ou carregar o código de front-end e back-end do seu aplicativo para seus recursos de nuvem provisionados no Azure.

Você pode implantar seu aplicativo do Teams nos seguintes recursos de nuvem:

  • Serviços de Aplicativo do Azure App
  • Azure Functions
  • Armazenamento do Azure (como site estático)
  • SharePoint

Observação

Antes de implantar o código do aplicativo na nuvem do Azure, você precisa concluir o provisionamento dos recursos de nuvem.

Para implantar o aplicativo Teams usando o Kit de Ferramentas de Agentes, siga estas etapas:

  1. Abra o Visual Studio.

  2. Selecione Criar um novo projeto ou abrir um projeto existente na lista.

  3. Selecione Projeto> Kit de ferramentas > deagentes do Microsoft 365Implantar na nuvem.

    A captura de tela mostra as etapas a serem implantadas na nuvem.

  4. Na janela pop-up exibida, selecione Implantar.

    A captura de tela mostra a janela de aviso de implantação.

    O aplicativo é implantado na nuvem do Azure.

Personalizar o ciclo de vida de implantação no Teams usando o Visual Studio

Para personalizar o processo de implantação, você pode editar as seguintes deploy seções no m365agents.yml arquivo:

cli/runNpmCommand

Essa ação executa npm comandos no diretório especificado com parâmetros.

Amostra

  - uses: cli/runNpmCommand
    with:
      workingDirectory: ./src
      args: install

Parâmetros

Parâmetro Descrição Obrigatório Valor padrão
workingDirectory Representa a pasta na qual você deseja executar o comando. Se o workingDirectoryvalor de entrada for um caminho relativo, ele será relativo ao . Não Raiz do projeto
args argumentos do comando Sim NA

cli/runDotnetCommand

Essa ação executa dotnet comandos no diretório especificado com parâmetros.

Amostra

  - uses: cli/runDotnetCommand
    with:
      workingDirectory: ./src
      execPath: /YOU_DOTNET_INSTALL_PATH
      args: publish --configuration Release --runtime win-x86 --self-contained

Parâmetros

Parâmetro Descrição Obrigatório Valor padrão
workingDirectory Representa a pasta na qual você deseja executar o comando. Se o workingDirectoryvalor de entrada for um caminho relativo, ele será relativo ao . Não Raiz do projeto
args Argumentos do comando npm Sim NA
execPath caminho do executor Não CAMINHO do sistema

cli/runNpxCommand

Essa ação executa npx comandos no diretório especificado com parâmetros. Você pode usá-lo para executar gulp comandos para empacotar e empacotar sppkg.

Amostra

  - uses: cli/runNpxCommand
    with:
      workingDirectory: ./src
      args: gulp package-solution --ship --no-color

Parâmetros

Parâmetro Descrição Obrigatório Valor padrão
workingDirectory Representa a pasta na qual você deseja executar o comando. Se o workingDirectoryvalor de entrada for um caminho relativo, ele será relativo ao . Não Raiz do projeto
args argumentos do comando Sim NA

azureAppService/zipDeploy

Essa ação carrega e implanta o projeto no Serviço de Aplicativo do Azure usando o recurso de implantação de zip.

Amostra

  - uses: azureAppService/zipDeploy
    with:
      workingDirectory: ./src
      artifactFolder: .
      ignoreFile: ./.webappignore
      resourceId: ${{BOT_AZURE_APP_SERVICE_RESOURCE_ID}}
      dryRun: false
      outputZipFile: ./.deployment/deployment.zip

Parâmetros

Parâmetro Descrição Obrigatório Valor padrão
workingDirectory Representa a pasta em que você deseja carregar o artefato. Se o workingDirectoryvalor de entrada for um caminho relativo, ele será relativo ao . Não Raiz do projeto
artifactFolder Representa a pasta em que você deseja carregar o artefato. Se o workingDirectoryvalor de entrada for um caminho relativo, ele será relativo ao . Sim NA
ignoreFile Especifica o caminho do arquivo ignorado usado durante o upload. Você pode utilizar esse arquivo para excluir determinados arquivos ou pastas da artifactFolder. Sua sintaxe é semelhante à ignorância do Git. Não null
resourceId Indica a ID do recurso de um Serviço de Aplicativo do Azure. Ele é gerado automaticamente depois de executar o comando provisionar. Se você já tiver um Serviço de Aplicativo do Azure, poderá encontrar sua ID de recurso no portal do Azure. Para obter mais informações, consulte como encontrar a ID do recurso. Sim NA
dryRun Você pode definir o parâmetro dryRun como true se quiser apenas testar a preparação do upload e não pretende implantá-lo. Isso ajuda a verificar se o arquivo zip de empacotamento está correto. Não falso
outputZipFile Indica o caminho do arquivo zip para a pasta de artefato empacotada. É relativo ao workingDirectory. Durante a implantação, ele reconstrói esse arquivo, reflete todas as pastas e arquivos em seu artifactFolder, e remove todos os arquivos ou pastas inexistentes. Não ./.deployment/deployment.zip

azureFunctions/zipDeploy

Essa ação carrega e implanta o projeto no Azure Functions usando. Para obter mais informações, consulte o recurso de implantação de zip.

Amostra

  - uses: azureFunctions/zipDeploy
    with:
      workingDirectory: ./src
      artifactFolder: .
      ignoreFile: ./.webappignore
      resourceId: ${{BOT_AZURE_APP_SERVICE_RESOURCE_ID}}
      dryRun: false
      outputZipFile: ./.deployment/deployment.zip

Parâmetros

Parâmetro Descrição Obrigatório Valor padrão
workingDirectory Representa a pasta em que você deseja carregar o artefato. Se o workingDirectoryvalor de entrada for um caminho relativo, ele será relativo ao . Não Raiz do projeto
artifactFolder Representa a pasta em que você deseja carregar o artefato. Se o workingDirectoryvalor de entrada for um caminho relativo, ele será relativo ao . Sim NA
ignoreFile Especifica o caminho do arquivo ignorado usado durante o upload. Você pode utilizar esse arquivo para excluir determinados arquivos ou pastas da artifactFolder. Sua sintaxe é semelhante à ignorância do Git. Não null
resourceId Indica a ID do recurso de um dispositivo do Azure Functions. Ele é gerado automaticamente depois de executar o comando provisionar. Se você já tiver um Azure Functions, poderá encontrar sua ID de recurso no portal do Azure. Para obter mais informações, consulte como encontrar a ID do recurso. Sim NA
dryRun Você pode definir o parâmetro dryRun como true se quiser apenas testar a preparação do upload e não pretende implantá-lo. Isso ajuda a verificar se o arquivo zip de empacotamento está correto. Não falso
outputZipFile Indica o caminho do arquivo zip para a pasta de artefato empacotada. É relativo ao workingDirectory. Durante a implantação, ele reconstrói esse arquivo, refletindo todas as pastas e arquivos em seu artifactFolder, e remove todos os arquivos ou pastas inexistentes. Não ./.deployment/deployment.zip

azureStorage/deploy

Essa ação carrega e implanta o projeto no Armazenamento do Azure.

Amostra

  - uses: azureStorage/deploy
    with:
      workingDirectory: ./src
      artifactFolder: .
      ignoreFile: ./.webappignore
      resourceId: ${{BOT_AZURE_APP_SERVICE_RESOURCE_ID}} 

Parâmetros

Parâmetro Descrição Obrigatório Valor padrão
workingDirectory Representa a pasta em que você deseja carregar o artefato. Se o valor de entrada for um caminho relativo, ele será relativo ao workingDirectory. Não Raiz do projeto
artifactFolder Representa a pasta em que você deseja carregar o artefato. Se o workingDirectoryvalor de entrada for um caminho relativo, ele será relativo ao . Sim NA
ignoreFile Especifica o caminho do arquivo ignorado usado durante o upload. Você pode utilizar esse arquivo para excluir determinados arquivos ou pastas do artifactFolder. Sua sintaxe é semelhante à ignorância do Git. Não null
resourceId Indica a ID do recurso de um Armazenamento do Azure. Ele é gerado automaticamente depois de executar o comando provisionar. Se você já tiver um Armazenamento do Azure, poderá encontrar a ID do recurso no portal do Azure (confira este link para obter mais informações). Sim NA

Confira também