Implantar o aplicativo teams na nuvem usando o Visual Studio

O Teams Toolkit ajuda a implantar ou carregar o código de front-end e back-end em seu aplicativo para seus recursos de nuvem provisionados no Azure.

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

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

Observação

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

Para implantar o aplicativo Teams usando o Teams Toolkit, siga estas etapas:

  1. Abra o Visual Studio.

  2. Selecione Criar um projeto ou abra um projeto existente na lista.

  3. Selecione Implantarkit >de ferramentasdo Project > Teamsna nuvem.

    A captura de tela mostra as etapas para implantar 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 teamsapp.yml arquivo:

cli/runNpmCommand

Essa ação executa comandos npm em 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 em que você deseja executar o comando. Se o valor de entrada for um caminho relativo, ele será relativo ao workingDirectory. Não Raiz do projeto
args argumentos de comando Sim NA

cli/runDotnetCommand

Essa ação executa comandos dotnet em 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 em que você deseja executar o comando. Se o valor de entrada for um caminho relativo, ele será relativo ao workingDirectory. Não Raiz do projeto
args Argumentos de comando npm Sim NA
execPath caminho executor Não Path do Sistema

cli/runNpxCommand

Essa ação executa comandos npx em diretório especificado com parâmetros. Você pode usá-lo para executar gulp comandos para agrupar 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 em que você deseja executar o comando. Se o valor de entrada for um caminho relativo, ele será relativo ao workingDirectory. Não Raiz do projeto
args argumentos de comando Sim NA

azureAppService/zipDeploy

Essa ação carrega e implanta o projeto para Serviço de Aplicativo do Azure usando o recurso de implantação 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 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 valor de entrada for um caminho relativo, ele será relativo ao workingDirectory. Sim NA
ignoreFile Especifica o caminho do arquivo de ignorar usado durante o upload. Você pode utilizar esse arquivo para excluir determinados arquivos ou pastas do artefatoFolder. Sua sintaxe é semelhante à ignorar 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 provisionamento. 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, confira 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 você a verificar se o arquivo zip de empacotamento está correto. Não falso
outputZipFile Indica o caminho do arquivo zip para a pasta artefato empacotado. É relativo ao workingDirectory. Durante a implantação, ele reconstrói esse arquivo reflete todas as pastas e arquivos em seu artifactFoldere remove todos os arquivos ou pastas inexistentes. Não ./.deployment/deployment.zip

azureFunctions/zipDeploy

Essa ação carrega e implanta o projeto para Azure Functions usando. Para obter mais informações, confira o recurso de implantação 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 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 valor de entrada for um caminho relativo, ele será relativo ao workingDirectory. Sim NA
ignoreFile Especifica o caminho do arquivo de ignorar usado durante o upload. Você pode utilizar esse arquivo para excluir determinados arquivos ou pastas do artefatoFolder. Sua sintaxe é semelhante à ignorar do Git. Não null
resourceId Indica a ID do recurso de um Azure Functions. Ele é gerado automaticamente depois de executar o comando provisionamento. Se você já tiver uma Azure Functions, poderá encontrar sua ID de recurso no portal do Azure. Para obter mais informações, confira 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 você a verificar se o arquivo zip de empacotamento está correto. Não falso
outputZipFile Indica o caminho do arquivo zip para a pasta artefato empacotado. É relativo ao workingDirectory. Durante a implantação, ele reconstrói esse arquivo, refletindo todas as pastas e arquivos em seu artifactFoldere 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 valor de entrada for um caminho relativo, ele será relativo ao workingDirectory. Sim NA
ignoreFile Especifica o caminho do arquivo de ignorar usado durante o upload. Você pode utilizar esse arquivo para excluir determinados arquivos ou pastas do artifactFolder. Sua sintaxe é semelhante à ignorar do Git. Não null
resourceId Indica a ID do recurso de um Armazenamento do Azure. Ele é gerado automaticamente depois de executar o comando provisionamento. Se você já tiver um Armazenamento do Azure, poderá encontrar sua ID de recurso no portal do Azure (consulte este link para obter mais informações). Sim NA

Confira também

Implantar o aplicativo teams na nuvem usando o Visual Studio

Você pode implantar o seguinte na nuvem:

  • O aplicativo de guia, como aplicativos front-end, é implantado no Armazenamento do Azure, configurado para hospedagem da Web estática.
  • O aplicativo bot de notificação com gatilhos Azure Functions pode ser implantado para Azure Functions.
  • O aplicativo bot ou a extensão de mensagem é implantado no Azure App Services.

Após a implantação, você pode visualizar o aplicativo no cliente do Teams ou no navegador da Web antes de começar a usá-lo.

Implantar o aplicativo Teams usando o Teams Toolkit

  1. Abra o Visual Studio.

  2. Selecione Criar um projeto ou abra um projeto existente na lista.

  3. Clique com o botão direito do mouse em seu projeto MyTeamsApp4>Teams Toolkit>Deploy na nuvem....

    implantar na nuvem

    Observação

    Nesse cenário, o nome do projeto é MyTeamsApp4.

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

    Implantar na caixa de diálogo confirmação de nuvem

    Depois que o processo de implantação for concluído, você poderá ver um pop-up com a confirmação de que ele foi implantado com êxito. Você também pode marcar o status na janela de saída.

    implantar no pop-up de nuvem

Visualizar seu aplicativo

Para visualizar seu aplicativo, você precisa criar um Pacote de Aplicativo Zip e um sideload no cliente do Teams.

  1. SelecionePacote zip appdo KitdeFerramentas> do Project > Teams.

  2. Selecione Para Local ou Para Azure para gerar o pacote de aplicativos do Teams.

    implantar no pop-up de nuvem.

Para visualizar seu aplicativo no cliente do Teams

  1. Selecione Visualização do Kitde Ferramentas> do Project > Teamsno Teams.

    Visualizar o aplicativo teams no cliente do teams

    Agora seu aplicativo está sideload no Teams.

    Aplicativo Sideload Teams no cliente do Teams

A outra maneira de visualizar seu aplicativo:

  1. Clique com o botão direito do mouse no projeto MyTeamsApp4em Gerenciador de Soluções.

  2. Selecione Visualização do >Kit de Ferramentas do Teamsno Teams para iniciar o aplicativo Teams no navegador da Web.

    Visualizar o aplicativo teams no navegador da Web

    Observação

    As mesmas opções de menu estão disponíveis no menu Project.

    Agora seu aplicativo está sideload no Teams.

    Aplicativo Sideload Teams no cliente do Teams

Confira também