Este documento visa fornecer um guia passo a passo para o processo de implantação do ambiente do TestFlow. 

Ambiente recomendado

Para uso, segue especificações recomendadas das máquinas para hospedar o Host e o Agent do TestFlow.

• VM Host: Neste Neste ambiente serão hospedados será hospedado o host do TestFlow, a base de dados original do TestFlow e o Backup do cliente. Especificações:VM Host: Neste ambiente será hospedado o host do TF3.
  • SO: Windows Server 2012+
  • 2VCPU;
  • 8GB de ram;
  • 60GB de espaço em disco + 2 vezes o tamanho da base a ser utilizada nos testes.
• Agent: Nesse ambiente será hospedado o Agent do TestFlow. Especificações:
  • 2VCPU;
  • 4GB de ram;
  • 80GB de espaço em disco.
  • Ambiente do RM
• •  
  • 2VCPU
  • 4GB RAM
  • 60GB Disco.
    
• VM Banco de Dados: Base de dados do TF3 TestFlow e as bases de testes do cliente
  • SQL Server 2019 ou 2022
  • 2VCPU
  • 4GB RAM
  • 60GB de disco (Windows + Base TF3TestFlow) + disco suficiente para 2x tamanho da base de testes do cliente.
• VM de Agent: Nesse ambiente será hospedado o Agent do TF3TestFlow.
  • 2VCPU
  • 4GB de ram
  • 60GB de disco.
  • Ambiente do RM

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 na versão nas versões 2019 e 2022 do SQL Server 2019 e 2022.

Após a solicitação, a base deve ser instalada em uma instância SQL Server conforme a versão selecionada.

...

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

  • Descubra qual o IPV4 dos servidores

    • Abra o prompt de comando (cmd) em ambas as máquinas.

    • Digite o comando 'ipconfig' e pressione Enter.

    • Verifique no seu adaptador de internet o seu endereço de IPV4
      • 

...

Para testar a conexão entre duas máquinas (por exemplo, entre a máquina do Agent e o servidor de banco de dados), abra o PowerShell como Administrador e execute o seguinte comando:

Test-NetConnection -ComputerName <hostname> -Port <porta>

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

O que será disponibilizado antes da implantação

Duas pastas serão fornecidas: uma contendo os arquivos do Agent e outra com os arquivos do Host.

Image Added

Na pasta AgentFiles, você encontrará três arquivos:

1. TestFlow.Agent.Instance.zip: Este arquivo ZIP contém a pasta com o executável do Agent. 
2. TestFlow.AutoUpdate.exe: Este executável realiza a atualização automática do Agent. 
3. TestFlow: Esta pasta inclui os plugins necessários para automações com WinForms. 

Image Added

Instalações

Deck of Cards
id Instalações
Card label Host Expandir title Instalando o IIS
Deck of Cards
id Instalações
cardlabel Card label Host Instalação de frameworks É necessário fazer a instalação de alguns frameworks para a utilização do TestFlow. .Net Core 2.2 Hosting Bundle 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 Removed Como instalar? Siga o passo a passo do executável até o final. Instalando o IIS 1) Abra o Dashboard do Server Manager e clique em “Add roles and features” Image Modified 2) Next -> Next -> Next. 3) Em Server Roles, selecione a opção “Web Server (IIS)” -> Add FeaturesImage Removed Next. Image Added Image Added 4) Em Features, selecione a opção "IIS Hostable Web Core". Image Added 4) Next -> Next -> Next -> Install. Install. Aviso Após instalar o IIS, copie os arquivos da pasta Host (fornecidos anteriormente) para o diretório C:\inetpub\tf3.  Além disso, extraia a pasta AgentFiles (fornecidos anteriormente) também nesse diretório em questão. Image Added Expandir title Configuração do arquivo appsettings.json 1) Entre no diretório C:\inetpub\tf3 e procure pelo arquivo appsettings.json. Image Added 2) 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 3) Em seguida, preencha o campo Endpoint com a URL no formato exibido na imagem abaixo. Essa URL será utilizada para acessar o TestFlow na máquina. Image Added 4) Após restaurar a base de dados Aceleradora do TestFlow no servidor de banco de dados, atualize o parâmetro Connection String nesse mesmo arquivo com as informações do seu servidor. Veja abaixo um exemplo de formato para a Connection String: Data Source=server\\SQL<Instancia-SQL>;User ID=user;Password=senha;Initial Catalog=TF3; Image Added OBS: Restaure a Base e modifique seu nome para TF3; 5) As demais informações já estarão previamente preenchidas por nossa equipe. Expandir title Configuração do WebSite Configuração do Website no IIS 1) Entre no IIS, vá em “Application Pools” e depois em “Add Application Pool”. Image Removed Image Added 2) Entre com o nome “tf3” e clique em OK. Image Modified 3) Salve a pasta do tf3 no diretório inetpub.4) Clique em  No Pool novo gerado, clique nele e vá em Advanced Settings. Image Added 4) Na aba aberta, configure o campo Identity para o valor ApplicationPoolIdentity. Image Added 5) Vá em sites e clique em Add Website. Image Added 6) No campo Site name, entre com o diretório C:\inetpub\tf3 e no campo Application pool selecione tf3 Image Added 7) 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 Removed Image Added 5 8) Faça o bind para a porta 6060. Image Modified 6 9) Faça a instalação do IIS URL Rewrite:   https://www.iis.net/downloads/microsoft/url-rewrite.  7 10) Abra o IIS e clique no site  site “tf3" e verifique se foi instalado o URL Rewrite. Image Modified 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 Removed Image Added 2) Clique Security → Advanced → Add. Image Removed Image Added 3) Clique em Select a principal. Image Added 4) Adicione o seguinte usuário: IIS_IUSRS e clique em Ok e depois em Apply. Image Modified 4) Dê todas as permissões (FUUL CONTROL) para o usuário em questão. Image Removed Image Added 5) Repita o mesmo processo para o usuário Administrador do servidor. 6) Após isso, entre na pasta C:\inetpub\tf3. 7) Clique em Propriedades. 8) Na Aba Geral, desabilite o Atributo "Somente leitura". Image Added 9) Vá na aba Segurança e clique em Editar. Image Added 10) Clique em Adicionar e adicione o usuário: IIS_IUSRS. Image Added 11) Dê todas as permissões (FUUL CONTROL) para o usuário em questão. Image Added 12) Dê todas as permissões (FUUL CONTROL) para todos os usuários da máquina. 13) Para finalizar o processo e salvar todas as operações, dê um restart no IIS. Expandir title Agent 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

FAQ

...

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.

dir -Recurse | Unblock-File

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

...

.