O Apidog Runner é uma ferramenta de linha de comando que executa testes de API agendados e tarefas de automação em ambientes de servidor. Este guia de referência descreve os requisitos de hardware, runtime e rede para implantar o Runner em ambientes de produção ou CI/CD.Compreender esses requisitos garante desempenho e confiabilidade ideais ao executar testes automatizados de API em escala.Requisitos de Hardware#
Configuração de Servidor Recomendada#
| Componente | Requisito Mínimo | Recomendado | Finalidade |
|---|
| CPU | 2 núcleos | 4+ núcleos | O Runner executa tarefas agendadas simultaneamente, exigindo poder de processamento adequado |
| Memória | 4 GB de RAM | 8 GB+ de RAM | O Runner carrega e gera grandes quantidades de dados durante tarefas agendadas; equipes maiores precisam de mais memória |
| Espaço em Disco | 30 GB | 50 GB+ | Acomoda o armazenamento de logs e artefatos de teste |
Para equipes maiores ou execução de testes em alta frequência, aumente a memória para 8 GB ou mais a fim de evitar degradação de desempenho.
Parâmetros de Runtime#
Configure as seguintes variáveis de ambiente ao implantar o Runner:| Nome do Parâmetro | Descrição | Valor de Exemplo |
|---|
TZ | Configure o fuso horário para a execução do Runner. As tarefas agendadas serão executadas de acordo com o fuso horário e o horário definidos. Consulte TZ identifier para configuração. | America/Los_Angeles |
Usuário de Runtime do Contêiner e runAsNonRoot#
A partir da versão 2.2.5 do Runner, a imagem inclui um usuário não root runner com UID/GID fixos de 10001:10001 para oferecer suporte a um modo de runtime não root mais seguro.Com o método de inicialização padrão, o contêiner primeiro executa o script de entrypoint como root, prepara as permissões para o diretório /opt/runner e, em seguida, reduz privilégios para executar o processo principal como o usuário runner. Isso é compatível com permissões históricas de volume e evita que dados de runtime, como logs e arquivos de variáveis, falhem ao serem gravados.Se a plataforma de implantação impuser runAsNonRoot, configure o contexto de segurança do contêiner da seguinte forma:Depois que isso for habilitado, o script de entrypoint não poderá mais executar mkdir ou chown. Portanto, qualquer hostPath, PVC ou outro volume montado em /opt/runner deve receber permissões de gravação para UID/GID 10001 com antecedência. O Runner grava dados de runtime em diretórios como /opt/runner/logs e /opt/runner/variables. Se as permissões forem insuficientes, a execução da tarefa poderá falhar ou os logs poderão não ser gravados.Ao usar hostPath, você pode executar o seguinte comando no host com antecedência:Se não houver um requisito obrigatório para habilitar runAsNonRoot, recomendamos manter o método de inicialização padrão.Ambiente de Rede#
Requisitos de Comunicação do Servidor#
O Runner precisa se comunicar com o servidor Apidog. Certifique-se de que o ambiente de rede do servidor que executa o Runner possa acessar o servidor Apidog e ofereça suporte ao protocolo WebSocket.Certifique-se de que seu firewall permita conexões de saída para os servidores Apidog nas portas 443 (HTTPS) e conexões WebSocket para comunicação em tempo real.
Requisitos de Testes Automatizados#
Para tarefas agendadas de testes automatizados, o ambiente de rede do servidor deve conseguir acessar todas as URLs solicitadas para iniciar requisições normalmente. Após a execução dos testes automatizados, os relatórios de teste serão enviados; certifique-se de que o ambiente de rede do servidor possa acessar nomes de domínio da AWS.Requisitos de Importação de Dados#
Para tarefas agendadas que importam dados, certifique-se de que o ambiente de rede do servidor possa acessar a URL da fonte de dados a ser importada. 