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.
...
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
- 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
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 |
---|
|
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. | | 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)” -> 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: ![](/download/attachments/848818879/image-2024-6-13_11-8-25.png?version=1&modificationDate=1718287705273&api=v2)
| Expandir |
---|
| 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 TF3 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 IIS1) 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 Removed Image Added
2) Entre com o nome “tf3” e clique em OK. ![](/download/thumbnails/848818879/image-2024-4-12_11-38-40.png?version=1&modificationDate=1718103272407&api=v2)
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 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 Removed Image Added
58) Faça o bind para a porta 6060. ![](/download/attachments/848818879/image-2024-4-12_11-39-24.png?version=1&modificationDate=1718103343177&api=v2)
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. ![](/download/attachments/848818879/image-2024-4-12_11-40-53.png?version=1&modificationDate=1718103366177&api=v2)
|
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. ![](/download/attachments/848818879/image-2024-4-12_11-57-16.png?version=1&modificationDate=1718103471580&api=v2)
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 | 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 Removed
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 |
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".rodar 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 |
---|
| Image Modified
|
Expandir |
---|
| Image Modified
|
Expandir |
---|
title | Inclusão de atividade |
---|
| Image Modified
|
Expandir |
---|
title | Cadastro de ambientes |
---|
| Image Modified
|
Expandir |
---|
title | Cadastro de projetos |
---|
| Image Modified
| e o | Image Modified
|
Expandir |
---|
title | Execução de projetos |
---|
| Image Modified
|
Expandir |
---|
title | Cadastro de agendamentos |
---|
| Image Modified
|
Expandir |
---|
title | Execução de agendamentos |
---|
| Image Modified
|
|
|
Uso do sistema somente após a vínculo do usuário em um grupo
...