O que são?
O Agent é um Client que facilita a comunicação entre o TestFlow e a máquina onde as Atividades ou Projetos serão executados. É obrigatório instalá-lo na máquina onde o usuário realizará essas tarefas. Sem o Agent, não será possível executar nenhuma atividade no servidor em questão.
Para que servem?
O Agent serve para:
- Execução de Testes: Realiza a execução dos testes automatizados nas aplicações, garantindo que as funcionalidades sejam validadas conforme definido pelos scripts de teste.
- Comunicação: Facilita a comunicação entre o servidor do TestFlow e a máquina de teste, permitindo o envio e recebimento de comandos e resultados de testes.
- Atualização Automática: O Agent possui uma funcionalidade de auto-update, que garante que ele esteja sempre na versão mais recente compatível com o servidor do TestFlow.
Exemplo de Uso
- Navegue no menu TestFlow e clique em Downloads → Agent e o Download do arquivo .zip contendo o Agent será instalado automaticamente.
- Após o download, descomprima o arquivo para um diretório na sua máquina. Recomenda-se realizar essa ação no diretório C:\ para facilitar à procura dessa pasta.
O Agent é um executável que gera um processo no sistema operacional, permanecendo em execução contínua enquanto uma sessão de usuário estiver ativa. Para que ele funcione de forma constante em um servidor, é essencial que seja iniciado por um usuário cuja sessão permaneça sempre ativa na máquina. Isso garante que o Agent esteja sempre disponível para executar projetos, sempre que necessário.
2.1 - Ações Antes de Executar o Agent:
Verifique se todos os arquivos na pasta do Agent estão desbloqueados. Para automatizar essa verificação, execute o seguinte comando no diretório usando o cmd:
dir -Recurse | Unblock-File
- Certifique-se de que o arquivo appsettings está configurado corretamente, apontando para a URL completa do Host do seu TestFlow na tag HostAddress. Abaixo, segue um exemplo de configuração correta desse arquivo:
{
"HostAddress": "http://hostname.dominio:6060",
"AgentUpdateCron": "0 0 * * *"
}
2.2 - Realizando a Execução:
- Após descomprimir a pasta em questão, entre nela e procure pelo executável TestFlow.Agent.Instance.
- Execute o aplicativo em questão como Administrador.
3. Com isso, será aberto um console que registrará a execução da inicialização do Agent naquele servidor. Se tudo correr bem, a última linha do log aparecerá conforme mostrado abaixo, sem registrar nenhum erro. Você poderá então verificar na tabela de Servidores se o servidor em questão está Online. Clique aqui para saber como visualizar o Status do seu Servidor.
Dica: Para executar este programa sempre como Administrador, sem precisar solicitar permissão a cada vez, siga este passo a passo:
- Clique com o botão direito no executável e selecione "Propriedades".
- Na aba "Compatibilidade", marque a opção "Executar este programa como administrador".
- Clique em "Aplicar" e depois em "OK".
Após realizar essas configurações, o aplicativo será executado em modo administrador com apenas dois cliques.
Sempre que precisar atualizar o Agent, você pode baixá-lo novamente e repetir o processo de instalação original. No entanto, o Agent também conta com um recurso de autoatualização que automatiza esse procedimento.
O recurso de auto-update verifica se a versão do Agent instalada no seu ambiente corresponde à versão disponível no host do TestFlow. Caso as versões sejam diferentes, o Agent será atualizado automaticamente.
Esse processo de autoatualização só ocorre quando o Agent está ocioso e funciona da seguinte maneira:
Verificação de Versão: O Agent compara sua versão com a versão disponível no host do TestFlow.
- Se as versões forem idênticas, nenhuma ação é tomada.
- Se as versões forem diferentes, o processo de atualização é iniciado.
Finalização e Preparação: O Agent é finalizado para garantir que a atualização ocorra de maneira segura e sem conflitos.
Download dos Arquivos: Os arquivos necessários para a atualização são baixados automaticamente.
Atualização: Os arquivos são substituídos no diretório onde o Agent está instalado.
Reinício do Agent: Após a conclusão da atualização, o Agent é reiniciado automaticamente, garantindo que a nova versão esteja em execução.
Este processo garante que o Agent esteja sempre atualizado, sem a necessidade de intervenção manual, mantendo a compatibilidade com o host do TestFlow.
Saiba mais
Sem o Agent, o TestFlow não poderá se comunicar com a máquina de teste, impossibilitando a execução de testes automatizados.
O Agent possui uma funcionalidade de auto-update. Ele verifica automaticamente a versão do Agent em relação ao host do TestFlow. Se houver uma discrepância, o Agent baixa e instala a atualização quando estiver ocioso.
Para garantir acesso total às funcionalidades do sistema e evitar problemas de permissão, o Agent deve ser configurado para sempre executar como administrador.
Utilize uma conta de serviço que nunca faça logout no servidor onde o Agent está hospedado. Isso garante que o processo do Agent permaneça sempre em execução.
FAQ
P: Como posso garantir que o Agent esteja funcionando corretamente após a instalação?
R: Após instalar o Agent, você pode realizar um teste de conexão com o servidor do TestFlow para garantir que ele esteja funcionando corretamente.
P: O que devo fazer se não conseguir baixar o agent?
R: Verifique se o navegador bloqueou o download do Agent. Em caso positivo, configure o navegador para não bloquear esse download.
P: O que devo fazer se não conseguir iniciar a execução do Agent?
R: Certifique-se de que o usuário responsável por iniciar o Agent possua controle total sobre a pasta do Agent e permissões para executá-lo como Administrador. Além disso, verifique se o arquivo appsettings está configurado corretamente e se os arquivos da pasta Agent não estão bloqueados.
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas