Ejecutar suites de prueba mediante CLI

Seleccionar un método de ejecución adecuado

Apidog proporciona varias formas de ejecutar suites de prueba, adecuadas para diferentes requisitos de prueba.

Ejecución visual local:

Este método se inicia desde una máquina local y es adecuado para pruebas rápidas y de pequeña escala.

Es especialmente eficaz cuando el desarrollo y las pruebas ocurren simultáneamente, ya que permite la supervisión en tiempo real y ajustes inmediatos.

Ejecución local con Apidog CLI:

Ideal para gestionar datos a gran escala o escenarios iterativos, este método ofrece una mayor velocidad de ejecución.

Puede ejecutarse sin conexión, lo cual es adecuado para entornos con recursos restringidos o para aquellos que no requieren una interfaz gráfica de usuario.

Ejecución de CI/CD:

Este estilo de ejecución se integra dentro del pipeline de CI/CD, lo que lo convierte en una excelente opción para procesos de integración automatizada y despliegue continuo.

Es especialmente útil en entornos donde las pruebas se ejecutan con frecuencia para confirmar la estabilidad de las API después de cada actualización de código.

Ejecución con Runner autoalojado:

Los equipos pueden configurar Apidog Runner en sus propios servidores, aprovechando recursos informáticos más robustos para las pruebas.

Este método incluye compatibilidad con tareas programadas, lo que lo hace ideal para escenarios que necesitan pruebas periódicas o para aquellos con demandas de prueba significativas.

TIP

En las suites de prueba, si se utilizan variables de entorno/globales, los valores reales de estas variables pueden diferir según el método de ejecución elegido, lo que podría provocar resultados de prueba incoherentes. Más información.

Ejecutar Apidog CLI

Para ejecutar suites de prueba mediante Apidog CLI, primero debe crear y orquestar una suite de prueba. Luego, puede ejecutar la suite de prueba desde la línea de comandos utilizando Apidog CLI y obtener los resultados de la prueba y el informe de prueba.

En una suite de prueba, cambie a la pestaña CI/CD.

Configure parámetros como el entorno de ejecución y el método de notificación. Cada configuración de la interfaz se reflejará en tiempo real en el comando CLI generado a continuación.

En la sección de proveedor de CI/CD, seleccione la línea de comandos CLI u otras plataformas.

Haga clic en el botón "Add access token" y luego en "Generate token" para la autenticación de la llamada CLI. Más información.

Haga clic para copiar el comando, péguelo en la línea de comandos y ejecútelo para ver el proceso de ejecución de la prueba y el informe de prueba.

Nota: Para que el comando se ejecute correctamente, primero debe instalar Apidog CLI. Si ya está instalado, debe actualizarlo a la versión más reciente.

Acerca de las variables y los archivos de configuración locales (opcional)

En algunos escenarios, la ejecución de CLI requiere archivos de configuración locales:

Variables de entorno/globales

Si elige "Export current values for use", debe colocar el archivo de variables exportado en la máquina de ejecución de CLI y especificar la ruta del archivo mediante --variables <path>.

Para conocer la diferencia entre "Use initial Values" y "Export current values for use", consulte: Reglas para usar variables de entorno/globales en diferentes métodos de ejecución.

Conexión de base de datos

Si la prueba utiliza "conexiones de base de datos" guardadas localmente, la interfaz le guiará para exportar el archivo de configuración y usarlo en CLI mediante --database-connection <path>.

Se recomienda guardar los detalles de la "conexión de base de datos" en forma de variable, de modo que no sea necesario ningún --database-connection <path> adicional al ejecutar CLI, y también resulte más cómodo para la colaboración y el mantenimiento. Más información.

Informe de prueba de CLI

Después de ejecutar CLI, obtendrá un informe de prueba en la línea de comandos que contiene las estadísticas de ejecución de la suite de prueba, así como información de validación y aserción para las peticiones fallidas.

En la carpeta donde se ejecuta CLI, también puede encontrar la carpeta /apidog-reports/, que contiene informes de prueba de CLI en formato HTML.

Opciones de comando

Apidog CLI proporciona amplias opciones de configuración para personalizar la ejecución de suites de prueba. Para obtener detalles, consulte Opciones de comando CLI.

Uso de Apidog CLI en CI/CD

Apidog CLI admite la integración con diversas herramientas de pipeline, como Jenkins, GitLab, GitHub Actions, etc. Para obtener más información, consulte Integración de CI/CD.

Ejecutar suites de prueba mediante CLI

Seleccionar un método de ejecución adecuado#

Ejecutar Apidog CLI#

Acerca de las variables y los archivos de configuración locales (opcional)#

Informe de prueba de CLI#

Opciones de comando#

Uso de Apidog CLI en CI/CD#

Seleccionar un método de ejecución adecuado

Ejecutar Apidog CLI

Acerca de las variables y los archivos de configuración locales (opcional)

Informe de prueba de CLI

Opciones de comando

Uso de Apidog CLI en CI/CD