Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

 OrigemDestinoProtocolo

Porta

Motivo

HostAgentTCP

5010, 5011, 5012, 445

Compartilhamento de arquivo e Conexão do Host com Agent.

AgentHostTCP

6060, 445

Compartilhamento de arquivo e Conexão do Agent com Host.

AgentServidor de Banco SQLTCP

1433

Conexão do Agent com o Banco.

AgentServidor de Banco SQLUDP

1434

Conexão do Agent com o Banco.

Máquina local do usuário (Opcional caso tenha)HostTCP

6060

Conexão do computador local com o Host do TestFlow. 

Máquina local do usuário (Opcional caso tenha)Host, AgentTCP

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:

  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
idInstalações
Card
labelHost
Expandir
titleInstalaçã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

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
titleConfiguração do arquivo appsettings.json

1) Entre no diretório C:\inetpub\tf3 e procure pelo arquivo appsettings.json.

Image Added

2)

Expandir
titleConfiguraçã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
titleInstalando 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 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 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
titleConfiguraçã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.) 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.

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
titleConfiguraçã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 → Add.

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.

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
titleInstalaçã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ção

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

Informações
Validação

Após esse passo, já é possível acessar o TestFlow pela URL configurada.

Card
labelAgent
Expandir
titleInstalação do Agent

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
titleGarantir 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".

Alterar o appsettings do Agent

1) 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 Removed

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ço

A 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
labelValidações

Validações após instalações

Após a instalação e configuração dos ambientes é interessante validar se os cadastros e execuções estão funcionando conforme esperado.


Expandir
titleAutenticação com o Fluig Identity

Expandir
titleCadastro de grupos

Expandir
titleInclusão de atividade

Expandir
titleCadastro de ambientes

Expandir
titleCadastro de projetos

Expandir
titleCadastro de conexão com servidor do Agent

Expandir
titleExecução de projetos

Expandir
titleCadastro de agendamentos

Expandir
titleExecução de agendamentos

...