O Apidog Runner é uma ferramenta de linha de comandos que executa testes de API agendados e tarefas de automatização em ambientes de servidor. Este guia de referência descreve os requisitos de hardware, runtime e rede para implementar o Runner em ambientes de produção ou CI/CD.Compreender estes requisitos garante um desempenho e uma fiabilidade ideais ao executar testes de API automatizados 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 em simultâneo, exigindo capacidade de processamento adequada |
| Memória | 4GB RAM | 8GB+ RAM | O Runner carrega e gera grandes quantidades de dados durante tarefas agendadas; equipas maiores precisam de mais memória |
| Espaço em Disco | 30GB | 50GB+ | Acomoda o armazenamento de logs e artefactos de teste |
Para equipas maiores ou execução de testes de alta frequência, aumente a memória para 8GB ou mais para evitar degradação do desempenho.
Parâmetros de Runtime#
Configure as seguintes variáveis de ambiente ao implementar 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 a hora definidos. Consulte identificador TZ para a configuração. | America/Los_Angeles |
Utilizador de Runtime do Contentor e runAsNonRoot#
A partir da versão 2.2.5 do Runner, a imagem inclui um utilizador não root runner com um UID/GID fixo de 10001:10001 para suportar um modo de runtime não root mais seguro.Com o método de arranque predefinido, o contentor executa primeiro o script de entrypoint como root, prepara as permissões para o diretório /opt/runner e, em seguida, reduz os privilégios para executar o processo principal como o utilizador runner. Isto é compatível com permissões de volume históricas e impede que dados de runtime, como logs e ficheiros de variáveis, falhem ao ser escritos.Se a plataforma de implementação impuser runAsNonRoot, configure o contexto de segurança do contentor da seguinte forma:Depois de isto estar ativado, o script de entrypoint já não pode executar mkdir ou chown. Por conseguinte, qualquer hostPath, PVC ou outro volume montado em /opt/runner deve receber antecipadamente permissões de escrita para o UID/GID 10001. O Runner escreve dados de runtime em diretórios como /opt/runner/logs e /opt/runner/variables. Se as permissões forem insuficientes, a execução de tarefas poderá falhar ou os logs poderão não ser escritos.Ao utilizar hostPath, pode executar antecipadamente o seguinte comando no anfitrião:Se não existir um requisito obrigatório para ativar runAsNonRoot, recomendamos que mantenha o método de arranque predefinido.Ambiente de Rede#
Requisitos de Comunicação do Servidor#
O Runner precisa de comunicar com o servidor Apidog. Certifique-se de que o ambiente de rede do servidor que executa o Runner consegue aceder ao servidor Apidog e suporta o protocolo WebSocket.Certifique-se de que a sua firewall permite ligações de saída para os servidores Apidog nas portas 443 (HTTPS) e ligaçõ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 aceder a todos os URLs pedidos para iniciar pedidos normalmente. Depois de executar testes automatizados, os relatórios de teste serão carregados — certifique-se de que o ambiente de rede do servidor consegue aceder aos 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 consegue aceder ao URL da fonte de dados a importar. 