Partilhar via

Ambientes no Microsoft Teams Toolkit

  • Artigo

O Teams Toolkit fornece uma maneira de executar e testar seu aplicativo em diferentes destinos para implantação, como desenvolvimento, preparo, produção ou localmente em seu computador. Para fazer isso, o Teams Toolkit inclui um conjunto opcional de recursos que orquestram a configuração desses diferentes destinos usando informações em arquivos de ambiente. Os arquivos de ambiente representam uma coleção de todos os recursos de um destino de implantação. Os modelos de projeto do Teams Toolkit incluem dois agrupamentos de ambiente padrão: um para executar o aplicativo em seu computador chamado 'local' e outro para hospedagem em outro lugar chamado 'dev'. Você pode renomear o ambiente 'dev' e adicionar outros ambientes usando a janela Ambientes ou manualmente com um novo .env.{environment-name} arquivo. Você não pode renomear o ambiente local.

Ao adicionar arquivos de ambiente diferentes, o Teams Toolkit pode ajudar a automatizar o provisionamento de recursos necessários para executar o aplicativo e implantar seu código nesses recursos. Você pode ter um único conjunto de regras de implantação para o número de ambientes usando esses recursos.

Usando arquivos de ambiente com o Teams Toolkit

O Teams Toolkit usa uma convenção de nomenclatura para os arquivos de ambiente, como: .env.{environment-name}. Usando os comandos de ciclo de vida do kit de ferramentas (Provisionar, Implantar ou Publicar) você precisa fornecer um nome de ambiente. O nome do ambiente deve ser o mesmo que o valor escolhido para {environment-name} ao criar o arquivo de ambiente.

Observação

Você pode definir variáveis de ambiente para o Teams Toolkit em seu ambiente de shell atual que substituem quaisquer valores no .env arquivo durante um conflito de nomenclatura.

Localização do arquivo de ambiente

Por padrão, o Teams Toolkit não carrega nenhuma variável env e apenas prossegue com a execução de ações e saídas de gravação para ./env/.env.dev. Se environmentFolderPath não estiver definido, o Teams Toolkit não carregará nenhuma variável de ambiente do .env arquivo e executará ações supondo que o env seja dev. As saídas são gravadas em ./env/.env.dev.

Ambientes locais

Para criar um aplicativo do Microsoft Teams, determinados recursos, como registros de aplicativo e o cliente do Teams, estão hospedados na nuvem. No entanto, os outros recursos, como incluir a lógica do aplicativo, podem ser hospedados localmente para simplificar as alterações de teste durante o desenvolvimento do aplicativo. Todos os modelos e exemplos de projeto do Teams Toolkit são configurados com um local ambiente. O ambiente local tem ./env/.env.local e arquivos e ./env/.env.local.user ajuda você a executar seu aplicativo com um servidor Web hospedado localmente. Ao usar Visual Studio Code (VS Code) e Visual Studio (VS), os modelos e exemplos de projeto são configurados para dar suporte à depuração com pontos de interrupção.

Para diferenciar entre um ambiente local e todos os outros ambientes, você pode criar um arquivo de projeto separado chamado teamsapp.local.yml no mesmo diretório que teamsapp.yml.

Criar um novo ambiente manualmente no Visual Studio Code

Cada projeto pode ter um ambiente local, mas vários ambientes remotos. Depois de criar um projeto, o Teams Toolkit configura os seguintes ambientes padrão:

  • ambiente local para representar a configuração do ambiente de máquina local.
  • ambiente de desenvolvimento para representar a configuração de ambiente remoto ou de nuvem.

Para criar um novo ambiente:

  1. Abra seu projeto de aplicativo do Teams em Visual Studio Code.

  2. Selecione o ícone Kit de Ferramentas do Teams na barra de atividades Visual Studio Code.

  3. Selecione o + ícone na seção ENVIRONMENT .

    A captura de tela mostra o ícone de adição realçado na seção Ambiente.

  4. Insira um nome para o ambiente e selecione Inserir.

    A captura de tela mostra onde inserir o nome do ambiente.

Direcionando um ambiente

Quando você tem vários ambientes e seleciona os itens de menu Produção, desenvolvimento ou local, o Teams Toolkit solicita que você selecione um ambiente de destino.

A captura de tela mostra o ambiente de produção selecionado.

Confira também