Versões comparadas

Chave

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

...

  • 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.

...

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

...

Deck of Cards
idInstalações
Card
labelHost
Expandir
titleInstalando o IIS

Instalando o IIS

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

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

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.

Expandir
titleConfiguração do arquivo appsettings.json

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

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:

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.

4) Após restaurar a base de dados Aceleradora do TF3 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 RemovedImage 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
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) No Pool novo gerado, clique nele e vá em Advanced Settings.

4) Na aba aberta, configure o campo Identity para o valor ApplicationPoolIdentity.

45) Vá em sites e clique em Add Website.

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

67) 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.

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

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

910) Abra o IIS e clique no 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.

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 x64 conforme  conforme a imagem abaixo.

 Image RemovedImage 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, reinicie o computador e na sequência, dê um start no IIS. Com isso, já é será 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.



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 clicar em "Desbloquear".

image-2023-11-10_11-48-4.pngImage Removed

Faça a inspeção dos seguintes arquivos contidos na pasta Testflow contida no diretório , verificando se os mesmos estão bloqueados:

  • Verifique as dlls contidas na pasta AutomationPlugins
  • rodar o seguinte comando no diretório do Agent, usando o cmd:

    Bloco de código
    dir -Recurse | Unblock-File
    Verifique o arquivo TestFlow.App.Lib.dll

    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

    ...