Apidog Runner es una herramienta de línea de comandos que ejecuta pruebas de API programadas y tareas de automatización en entornos de servidor. Esta guía de referencia describe los requisitos de hardware, runtime y red para implementar Runner en entornos de producción o CI/CD.Comprender estos requisitos garantiza un rendimiento y una fiabilidad óptimos al ejecutar pruebas de API automatizadas a escala.
Configure las siguientes variables de entorno al implementar Runner:
Nombre del parámetro
Descripción
Valor de ejemplo
TZ
Configure la zona horaria para la ejecución de Runner. Las tareas programadas se ejecutarán de acuerdo con la zona horaria y la hora establecidas. Consulte TZ identifier para la configuración.
A partir de la versión 2.2.5 de Runner, la imagen incluye un usuario no root runner con un UID/GID fijo de 10001:10001 para admitir un modo de runtime no root más seguro.Con el método de inicio predeterminado, el contenedor primero ejecuta el script de entrypoint como root, prepara los permisos para el directorio /opt/runner y luego reduce los privilegios para ejecutar el proceso principal como el usuario runner. Esto es compatible con los permisos de volumen históricos y evita que los datos de runtime, como los logs y los archivos de variables, no puedan escribirse.Si la plataforma de implementación exige runAsNonRoot, configure el contexto de seguridad del contenedor de la siguiente manera:
Después de habilitar esto, el script de entrypoint ya no puede ejecutar mkdir ni chown. Por lo tanto, cualquier hostPath, PVC u otro volumen montado en /opt/runner debe recibir permisos de escritura para UID/GID 10001 de antemano. Runner escribe datos de runtime en directorios como /opt/runner/logs y /opt/runner/variables. Si los permisos son insuficientes, la ejecución de tareas puede fallar o los logs pueden no escribirse.Al utilizar hostPath, puede ejecutar el siguiente comando en el host de antemano:
Si no existe un requisito obligatorio para habilitar runAsNonRoot, recomendamos mantener el método de inicio predeterminado.
Runner necesita comunicarse con el servidor de Apidog. Asegúrese de que el entorno de red del servidor que ejecuta Runner pueda acceder al servidor de Apidog y admita el protocolo WebSocket.Protocolos requeridos:
HTTPS (puerto 443)
WebSocket (WSS)
Configuración del firewall
Asegúrese de que su firewall permita conexiones salientes a los servidores de Apidog en los puertos 443 (HTTPS) y conexiones WebSocket para la comunicación en tiempo real.
Para las tareas programadas de pruebas automatizadas, el entorno de red del servidor debe poder acceder a todas las URL solicitadas para iniciar peticiones con normalidad. Después de ejecutar las pruebas automatizadas, se cargarán los informes de prueba; asegúrese de que el entorno de red del servidor pueda acceder a los nombres de dominio de AWS.
Para las tareas programadas que importan datos, asegúrese de que el entorno de red del servidor pueda acceder a la URL de la fuente de datos que se va a importar.
