Este documento visa fornecer um guia passo a passo para o processo de criação implantação do ambiente do TestFlow.
Índice |
---|
maxLevel | 1 |
---|
exclude | Onde baixar?;Como instalar? |
---|
|
Ambiente recomendado
Para uso, segue especificações recomendadas das máquinas para hospedar o Host e o Agent do TestFlow.
...
...
...
- TF3.
- SO: Windows Server 2012+
- 2VCPU
- 4GB RAM
- 60GB Disco.
- VM Banco de Dados: Base de dados do TF3 e as bases de testes do cliente
- SQL Server 2019 ou 2022
- 2VCPU
- 4GB RAM
- 60GB de disco (Windows + Base TF3) + disco suficiente para 2x tamanho da base de testes do cliente.
- VM de Agent: Nesse
- 2VCPU;
- 8GB de ram;
- 60GB de espaço em disco + 2 vezes o tamanho da base a ser utilizada nos testes.
...
- ambiente será hospedado o Agent do
...
...
...
...
...
...
Base de dados do TestFlow
É necessário solicitar uma base aceleradora do TestFlow para o time de automação da TOTVS. Há bases de dados disponíveis nas versões 2019 e 2022 do SQL Server.
Após a solicitação, a base deve ser instalada em uma instância SQL Server conforme a versão selecionada.
Liberações de rede
Para a utilização do TestFlow é necessário fazer algumas liberações de rede entre os ambientes e localmente no firewall dos servidores.
Entre os ambientes
- Verificar a conectividade entre as redes da máquina Host e da máquina Agent
Para determinar se dois endereços IP estão na mesma rede, utiliza-se a máscara de sub-rede. Esta máscara é utilizada para distinguir a parte de rede da parte de host em um endereço IP.
...
Caso não estejam na mesma rede ou ainda não seja possível fazer a conexão, é necessário garantir as seguintes liberações de rede:
Origem | Destino | Protocolo | Porta | Motivo |
---|
Host | Agent | TCP | 5010, 5011, 5012, 445 | Compartilhamento de arquivo e Conexão do Host com Agent. |
---|
Agent | Host | TCP | 6060, 445 | Compartilhamento de arquivo e Conexão do Agent com Host. |
---|
Agent | Servidor de Banco SQL | TCP | 1433 | Conexão do Agent com o Banco. |
---|
Agent | Servidor de Banco SQL | UDP | 1434 | Conexão do Agent com o Banco. |
---|
Máquina local do usuário (Opcional caso tenha) | Host | TCP | 6060 | Conexão do computador local com o Host do TestFlow. |
---|
Máquina local do usuário (Opcional caso tenha) | Host, Agent | TCP | 3389 | Conexão remota com a VM do Host e do Agent. |
---|
Firewall
Localmente nos servidores do Agent e do Host é necessário fazer as mesmas liberações de rede ou desabilitar o firewall para a utilização do TestFlow.
...
- Solicitação da configuração do Fluig Identity feito pelo time de automação da TOTVS
- Servidores do Agent e Host disponíveis para a implantação
- Solicitação para configuração do arquivo de ambiente (appsettings) para o time de automação da TOTVS, informando os ambientes que foram criados para a utilização do TestFlow
- Liberações de rede entre os servidores do Agent e Host já feitas
- Zip com o TestFlow na versão mais atual disponível no ambiente
...
Instalações
Deck of Cards |
---|
id | Criação de um grupoInstalações |
---|
|
Card |
---|
| 1. Criação de um Grupo: Após o login, um usuário administrador deve adicionar você a um grupo específico para que você possa acessar as atividades criadas pelos membros desse grupo. Se o grupo não existir, basta navegar até a seção "Grupos" na barra de menu do TestFlow e clicar no ícone de pasta verde para criá-lo. Image Removed
|
Card |
---|
label | Definir Nome e Descrição |
---|
| 2. Definir Nome e Descrição do Grupo: Descreva o nome e a descrição desse Grupo. O nome do grupo deve representar para qual finalidade esse grupo está sendo criado, seja por produto ou para um projeto específico. Image Removed
|
Card |
---|
label | Definição do Nível de Acesso. |
---|
| 3. Adição de novos membros e definição do seu nível de acesso: Para adicionar um novo membro ao grupo, basta digitar o nome desse novo integrante na seção "Membros" e selecioná-lo dentre as sugestões apresentadas Image Removed
Após esse passo, selecione a permissão do usuário. - Administrador: Tem acesso total às atividades criadas pelo grupo. - Membro: Tem acesso somente de leitura às atividades criadas pelo grupo. Image Removed
|
Card |
---|
label | Configuração de Notificações |
---|
| 4. Configuração de Notificações Caso queira receber notificações sobre o grupo em questão via e-mail, você pode adicioná-lo clicando no seguinte ícone em questão. Image Removed
|
Card |
---|
label | Uso do sistema após a adição do usuário a um grupo |
---|
| 5. Uso do sistema após a adição do usuário a um grupo Após o usuário ser adicionado em um grupo, será possível para o mesmo criar, editar e executar atividades no TestFlow. Image Removed
|
|
Saiba mais
Dica |
---|
Os Grupos são definidos de acordo com a necessidade das equipes. Aconselha-se a definição de grupos por produto. |
Dica |
---|
Grupos podem ser alterados ou excluídos pelos administradores. No entanto, a exclusão de um grupo resultará na exclusão de todas as atividades pertencentes a esse grupo. |
Dica |
---|
A exclusão de usuários é permitida apenas para membros administradores. |
Dica |
---|
Cada grupo deve ter pelo menos um usuário administrador para garantir a transferência de atividades quando necessário. |
FAQ
...
| Expandir |
---|
title | Configuração de envio de Email |
---|
| O TestFlow permite o envio de email após a execução de agendamentos em algumas condições selecionadas pelo usuário. Para a sua configuração, é necessário alterar o arquivo appsettings.json do Host com as informações abaixo: Image Added
|
Expandir |
---|
| Instalando o IIS1) Abra o Dashboard do Server Manager e clique em “Add roles and features” Image Added
2) Next -> Next -> Next. 3) Em Server Roles, selecione a opção “Web Server (IIS)” -> Add Features Image Added
4) Next -> Next -> Next -> Install. |
Expandir |
---|
title | Configuração do WebSite no IIS |
---|
| 1) Entre no IIS, vá em “Application Pools” e depois em “Add Application Pool”. Image Added
2) Entre com o nome “tf3” e clique em OK. Image Added
3) Salve a pasta do tf3 no diretório inetpub. 4) Clique em “connect as” e selecione a opção “specific user”. Entre com o usuário administrador do servidor e sua respectiva senha (a mesma utilizada para realizar login nas demais funcionalidades com esse usuário). Por fim, clique em Ok. Image Added
5) Faça o bind para a porta 6060. Image Added
6) Faça a instalação do IIS URL Rewrite: https://www.iis.net/downloads/microsoft/url-rewrite. 7) Abra o IIS e clique no site “tf3" e verifique se foi instalado o URL Rewrite. Image Added
|
Expandir |
---|
title | Configuração das permissões dos usuários no Website |
---|
| 1) Vá em sites, clique em "tf3" e selecione a opção "Edit Permissions". Image Added
2) Clique Advanced → Add. Image Added
3) Adicione o seguinte usuário e clique em Ok e depois em Apply. Image Added
4) Dê todas as permissões para o usuário em questão. Image Added
5) Repita o mesmo processo para o usuário Administrador do servidor. 6) Para finalizar o processo e salvar todas as operações, dê um restart no IIS. |
Expandir |
---|
title | Instalação de frameworks |
---|
| É necessário fazer a instalação do framework .NET Core 2.2.x na versão Hosting Bundle para a utilização do TestFlow. Onde baixar?Acesse o site https://dotnet.microsoft.com/en-us/download/dotnet/2.2 e selecione a opção de Hosting Bundle x64 conforme a imagem abaixo. Image Added Como instalar?Siga o passo a passo do executável até o final. ValidaçãoApós a instalação, é possível executar o comando "dotnet --version" no CMD e obter a versão instalada. |
Informações |
---|
ValidaçãoApós esse passo, já é possível acessar o TestFlow pela URL configurada. |
|
Card |
---|
| Instalação do AgentAcesse a URL correspondente ao host do TestFlow configurado anteriormente em um navegador da web. Em seguida, proceda com o download do Agent:
Image Added
Isso fará com que seja baixado um arquivo zip. Descompacte-o no disco C: OBS: A sugestão é descompactar em uma pasta C:\Agent Garantir que nenhum arquivo está bloqueado após o download de arquivos do AgentÉ importante garantir o desbloqueio dos arquivos do Agent e os plugins do WinForms, usando a opção Unblock do Windows. Nesse caso, é necessário clicar com o botão direito em um arquivo bloqueado e desabilitar a opção "Bloqueado". Utilização de um usuário de serviçoA recomendação é que seja utilizado um usuário de serviço para iniciar o Agent. Assim, é possível garantir que ele nunca estará offline, mesmo quando um usuário seja desconectado do servidor. |
Card |
---|
| Validações após instalaçõesApós a instalação e configuração dos ambientes é interessante validar se os cadastros e execuções estão funcionando conforme esperado.
Expandir |
---|
title | Autenticação com o Fluig Identity |
---|
| Image Added
|
Expandir |
---|
| Image Added
|
Expandir |
---|
title | Inclusão de atividade |
---|
| Image Added
|
Expandir |
---|
title | Cadastro de ambientes |
---|
| Image Added
|
Expandir |
---|
title | Cadastro de projetos |
---|
| Image Added
|
Expandir |
---|
title | Cadastro de conexão com servidor do Agent |
---|
| Image Added
|
Expandir |
---|
title | Execução de projetos |
---|
| Image Added
|
Expandir |
---|
title | Cadastro de agendamentos |
---|
| Image Added
|
Expandir |
---|
title | Execução de agendamentos |
---|
| Image Added
|
|
|
Uso do sistema somente após a vínculo do usuário em um grupo
Após o usuário ser adicionado em um grupo, será possível para o mesmo criar, editar, visualizar e executar atividades no TestFlow
P: O que acontece quando um grupo é excluído?
R: Todas as atividades pertencentes ao grupo serão automaticamente excluídas.
P: É possível excluir todos os usuários de um grupo?
R: Não. Pelo menos um usuário administrador deve permanecer no grupo. Quando um usuário é excluído, as atividades pertencentes a ele são transferidas automaticamente para o primeiro usuário administrador.
P: Quem pode excluir ou alterar grupos?
R: Apenas os administradores podem excluir ou alterar grupos.
...
.