KEPLIN Docs

El entorno de prueba

Dónde escriben las pruebas cada base de datos, el datasource de prueba de las bases externas con escritura, los usuarios de prueba, las respuestas HTTP simuladas, el control del merge, la ejecución programada y los límites.

El entorno de prueba dice dónde escriben las pruebas, con qué cuentas entran en la app y qué pasa con los efectos fuera de la app. Se abre en el minitab Pruebas, con el botón Entorno de prueba.

El entorno de prueba, en un modal de tamaño fijo
El entorno de prueba, en un modal de tamaño fijo

Nota

Solo un administrador cambia el entorno de prueba. Un developer lo ve.

Bases de datos

Cada datasource de la app aparece con el tipo, el acceso y lo que pasa en las pruebas:

Datasource En las pruebas
Base interna de la app Una copia nueva con el esquema de la base, en cada prueba.
PostgreSQL interno Una base temporal en el servidor gestionado, con el esquema de la real, en cada prueba.
Base externa con escritura (Lectura y escritura o Estructura protegida) El datasource de prueba elegido, obligatorio. Las tablas de los datos de prueba se vacían antes de cada prueba.
Base externa en Solo lectura La base real, solo para leer. Las pruebas la leen y nunca escriben en ella.

El datasource de prueba de las bases externas

Una base externa con escritura no se puede copiar en cada prueba. Las pruebas usan otro datasource de la app, conectado a una base de prueba con la misma estructura. Las conexiones se crean siempre en los datasources, en la sección Datos, y el entorno de prueba solo elige cuál usar.

  1. En la sección Datos, cree un datasource del mismo tipo, con escritura, conectado a la base de prueba. También puede ser un datasource interno.
  2. Abra el Entorno de prueba.
  3. En la fila de la base externa, haga clic en Elegir el datasource de prueba y elíjalo de la lista.
  4. Haga clic en Guardar.

El estado pasa a lista. En la fila del datasource elegido, el entorno dice de qué base es el datasource de prueba, y las pruebas lo usan tal como está.

Atención

Mientras una base externa con escritura no tenga el datasource de prueba elegido, ninguna prueba de la app se ejecuta, ni siquiera las que parecen no usar esa base. Una prueba llega a cualquier base de la app a través de una pantalla, de una API o de un script, y no hay forma segura de saber de antemano a qué bases llega. La ejecución queda Bloqueada y dice qué base falta.

Una base externa en Solo lectura no necesita datasource de prueba: las pruebas leen la base real, y la plataforma rechaza cualquier escritura en ella, como ya hace fuera de las pruebas. La garantía total es conectar esa base con un usuario que solo tenga permisos de lectura.

Usuarios de prueba

Una prueba que empieza como un rol entra en la app con la cuenta elegida aquí para ese rol, con todos los roles de esa cuenta.

  1. En Usuarios de prueba, en la fila del rol, haga clic en Elegir el usuario.
  2. Busque y elija una cuenta activa que tenga ese rol. Sin usuario deshace la elección.
  3. Haga clic en Guardar.

Solo se eligen cuentas que ya existen: las cuentas y los roles se dan en Ajustes de la app › Usuarios de la app. La fila Visitante no tiene cuenta: una prueba sin rol no tiene sesión y ve solo las pantallas y las APIs públicas, como quien abre la app sin entrar.

Cada fila dice cuántas pruebas usan ese rol. Una prueba con un rol sin cuenta elegida falla con «El rol … no tiene usuario de prueba».

Respuestas HTTP simuladas

En las pruebas, una petición HTTP de una API o de un workflow nunca sale a la red: recibe la respuesta simulada cuya dirección sea el inicio de la dirección de la petición (y el método, si lo indica). Una petición sin respuesta simulada hace fallar el paso con la dirección, para que se sepa qué falta simular.

Para añadir una, haga clic en Añadir respuesta y rellene el método, la dirección (por ejemplo https://api.exemplo.pt/v1/), el código y el cuerpo.

Nota

Los scripts hacen las peticiones en su propio proceso y no pasan por las respuestas simuladas.

Cuándo se ejecutan solas

  • Antes de fusionar en el main: con el control activado, fusionar una versión en el main ejecuta primero las pruebas con las etiquetas indicadas (o todas, sin etiquetas) en la versión de origen. Si no se superan, no se fusiona nada. Ver Ejecutar y leer los resultados.
  • Ejecutar todas las pruebas a la hora de esta expresión cron: la ejecución programada, por ejemplo 0 2 * * * (todas las noches a las 02:00). Necesita que el planificador de la plataforma esté activado.

Límites

  • Segundos por paso: cuánto puede tardar un paso (y cuánto espera una verificación de pantalla). Por defecto, 30.
  • Minutos por ejecución: cuánto puede tardar una ejecución. Por defecto,