Este documento visa fornecer um guia passo a passo para o processo de 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.

VM Host: Neste ambiente será hospedado o host do TF3TestFlow.
- SO: Windows Server 2012+
- 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. Clique aqui, para acessar o guia de como Instalar o SQL Server no ambiente.
- 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

...

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

Configuração de Servidor de E-mail

É necessário configurar um servidor de e-mail ou, caso o servidor já exista, criar um usuário de serviço para que ele possa ser utilizado nas configurações posteriores.

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.

...

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.

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:

Bloco de código
Test-NetConnection -ComputerName <hostname> -Port <porta>

Firewall

Localmente nos servidores do Agent e do Host é necessário fazer as mesmas liberações de rede para a utilização do TestFlow. Para isso, dê acesso ao firewall às portas listadas na tabela acima, tanto para entrada, quanto para a saída das portas.

Pré-condições

Para uso, segue pré-condições 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
Configuração de um usuário de serviço para o servidor de e-mail
Zip com o TestFlow na versão mais atual disponível no ambiente

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:

TestFlow.Agent.Instance.zip: Este arquivo ZIP contém a pasta com o executável do Agent.
TestFlow.AutoUpdate.exe: Este executável realiza a atualização automática do Agent.
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	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 Removed

Como instalar?

Siga o passo a passo do executável até o final.

Validação

Após a instalação, é possível executar o comando "dotnet --version" no CMD e obter a versão instalada.

Instalando o IIS

1) 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)” -> Next.

Image Added Image Added

4) Em Features, selecione a opção "IIS Hostable Web Core".

Image Added

4) Next -> Next -> 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)

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:

Expandir

title	Instalando o IIS

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

Instalando o IIS

1) Abra o Dashboard do Server Manager e clique em “Add roles and features”

Image Removed

2) Next -> Next -> Next.

3) Em Server Roles, selecione a opção “Web Server (IIS)” -> Add Features

Image Removed

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 RemovedImage Added

2) Entre com o nome “tf3” e clique em OK.

3) Salve a pasta do tf3 no diretório inetpub.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 nome tf3, nocampo physical path entre com o diretório C:\inetpub\tf3 e no campo Application pool selecione tf3

Image Added

7) Clique em 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 RemovedImage Added

58) Faça o bind para a porta 6060.

69) Faça a instalação do IIS URL Rewrite: https://www.iis.net/downloads/microsoft/url-rewrite.

710) Abra o IIS e clique no site site “tf3" e verifique se foi instalado o URL Rewrite.

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 RemovedImage Added

2) Clique Security → Advanced → Add.

Image RemovedImage 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.

4) Dê todas as permissões (FUUL CONTROL) para o usuário em questão.

Image RemovedImage 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	Instalação de frameworks