...
- 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
- 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
...
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.
COLOCAR COMANDO PARA VERIFICAR A CONEXÃO UTILIZANDO O POWERSHELL das Máquinas
Test-NetConnection -ComputerName hostname -Port 6060
netstat -a -o → Veirifica o processo dos executáveis rodando em quais portar
Em resumo, se todos os números antes do último ponto resultantes do comando 'ipconfig' forem idênticos, isso indica que as máquinas estão conectadas na mesma rede. Por exemplo:
...
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.
...
- Solicitação da configuração do Fluig Identity feito pelo time de automação da TOTVS (Pedir os usuários, gmail, 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:
- 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 |
---|
|
|
Deck of Cards |
---|
|
Card |
---|
| 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çãoApós a instalação, é possível executar o comando "dotnet --version" no CMD e obter a versão instalada. DOTNET --list-runtimes | Expandir |
---|
| Instalando o IIS1) Abra o Dashboard do Server Manager e clique em “Add roles and features”
2) Next -> Next -> Next. 3) Em Server Roles, selecione a opção “Web Server (IIS)” -> Add Features Image Removed iis host webcore → selecionar Next. Image Added Image Added 4) Em Features, selecione a opção "IIS Hostable Web Core". Image AddedIIS MANAGENET TOOLS EM ROLE SERVICES 4) Next -> Next -> Next -> Install.- colocar o passo, depois da instalão do IIS: Copiar os arquivos do TestFlow.Host dentro da maquina do host na pasta inetpub (tf3) - Liberar a pasta para o usuário da pessoa conseguir copiar e colar os arquivos 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 | Copiar Arquivos do Host na pasta inetpub |
---|
| Expandir |
---|
title | Configuração de envio de Email |
---|
| Configuração do arquivo appsettings.json |
| 1) Entre no diretório C:\inetpub\tf3 e procure pelo arquivo appsettings.json. Image Added 2) (INVERTER A ORDEM - Colocar no Final) 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:
CRIAR UM CHECKLIST NOSSO PARA SABER O QUE JÁ PRECISA SER FORNECIDO NO CLIENTE NO APPSETTINGS, ANTES DE MANDAR A PASTA TESTFLOW PARA O USUÁRIO Image Removed Lembrar de colocar algumas informações que não foram colocadas no appsettings.json do cliente FluigIdentity → Tem que ser passado por nós. Return URL → FLUIG RedirectURL → Fluig Secret → A gente passa ELES PREENCHEM APENAS A PARTE DO SMTP E o Endpoint O resto a gente que coloca COLOCAR EXEMPLO DA CONNECTION STRING 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\\SQL2019SQL<Instancia-SQL>;User ID=user;Password=senha;Initial Catalog=TF3;Falar para o cliente restaurar a base e mudar a base para 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 no IIS |
---|
| 1) Entre no IIS, vá em “Application Pools” e depois em “Add Application Pool”.
2) Entre com o nome “tf3” e clique em OK.
3) Salve a pasta do tf3 no diretório inetpub. 4) Clicar em Advanced Settings → Application PoolIdentity → Criar um site novo, nesse passo consigurar o connect as e depois configurar o bind da porta 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 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.
5) Criar um site novo, fazer bind para a porta 6060 8) 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".
2) Clique Security → Advanced Advanced → Add.
3) Clique em Select a principal. Image Added 4) SELECT a Principal → Adicione o seguinte usuário: IIS_IUSRS e clique em em Ok e e depois em em Apply.
4) Dê todas as permissões (FUUL CONTROL) para o usuário em questão.
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 |
---|
| É 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 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 --list-runtimes" 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 |
---|
| Expandir |
---|
| Proceda da seguinte forma: - Acesse a URL correspondente ao host do TestFlow configurado anteriormente em um navegador da web.
- Em seguida, proceda com o download do Agent
| : Image Modified
Isso fará com que seja baixado um arquivo zip. Descompacte-o no disco C: OBS: A sugestão é descompactar em uma pasta C:\Agent |
Expandir |
---|
title | 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".Colocar quais arquivos devem ser desbloqueados (TestFlowAgent, AutomationPlugins → Olhar as dlls, TestFlow.App.Lib.dll). Colocar como desbloquear Alterar o appsettings do Agent1) Localize a pasta do Agent (Provavelmente estará no C:/Agent conforme o padrão) 2) Localize o arquivo "appsettings.json" 3) Altere ele da seguinte forma Image Removedrodar o seguinte comando no diretório do Agent, usando o cmd: Bloco de código |
---|
dir -Recurse | Unblock-File |
|
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 |
---|
|
|
Expandir |
---|
|
|
Expandir |
---|
title | Inclusão de atividade |
---|
|
|
Expandir |
---|
title | Cadastro de ambientes |
---|
|
|
Expandir |
---|
title | Cadastro de projetos |
---|
|
|
Expandir |
---|
title | Cadastro de conexão com servidor do Agent |
---|
|
|
Expandir |
---|
title | Execução de projetos |
---|
|
|
Expandir |
---|
title | Cadastro de agendamentos |
---|
|
|
Expandir |
---|
title | Execução de agendamentos |
---|
|
|
|
|
...