DevOps en tu Alexa Skill. Integration Tests.
Simulando diálogos usando texto como input
Las pruebas de integración aseguran que los componentes de una aplicación se estén ejecutando correctamente a un nivel que incluye toda la infraestructura de la aplicación, como la interfaz de usuario de voz, el backend y la integración con sistemas externos.
DevOps en tu Alexa Skill: Integration Tests
Las pruebas de integración evalúan los componentes de una aplicación a un nivel más alto que las pruebas unitarias. Las pruebas unitarias se utilizan para probar componentes de software aislados, como métodos de clases individuales. Las pruebas de integración verifican que dos o más componentes de una aplicación funcionen juntos y generan un resultado esperado, incluyendo todos los componentes necesarios para procesar completamente una request.
Estos tests están automatizadas en el sistema de integración continua (CircleCI) y se ejecutan en cada nueva versión del software.
Requisitos previos
Aquí tienes las tecnologías utilizadas en este proyecto:
- Amazon Developer Account - Cómo crear una cuenta
- AWS Account - Regístrate aquí gratis
- ASK CLI - Instalar y configurar ASK CLI
- CircleCI Account - Regístrate aquí gratis
- Visual Studio Code
ASK CLI (Alexa Skill Kit CLI)
La Alexa Skills Kit Command Line Interface (ASK CLI) es una herramienta para que puedas administrar tus Skills de Alexa y recursos relacionados, como las funciones de AWS Lambda. Con la ASK CLI, tienes acceso a la Skill Management API, que te permite administrar las Skills de Alexa mediante programación desde la línea de comandos. Usaremos esta poderosa herramienta para ejecutar los tests de integración. ¡Empecemos!
Instalación
La ASK CLI y la herramienta bash expect se incluyen en la Docker image que estamos usando, por lo que no es necesario instalar nada más.
Desarrollando integration tests
En este paso del pipeline vamos a desarrollar algunas pruebas escritas en bash usando ASK CLI.
Una vez que hayamos probado nuestra interfaz de usuario de voz y comprobado que todo está correcto. Es hora de probar todos los componentes de software interelacionados en una request de Alexa.
Estas pruebas de integración se pueden realizar con ASK CLI. utilizaremos el siguiente comando ASK CLI:
- Para ask cli v1 y v2:
ask dialog -s ${skill_id} -l ${locale}
Con este comando realizaremos una simulación de un diálogo con nuestra Alexa Skill usando texto plano como entrada. Con esto, podemos probar que todos los componentes software estén funcionando correctamente.
Esos comandos están integrados en el archivo de script bash test/integration-test/simple-dialog-checker.sh.
Aquí podemos encontrar el script bash completo:
#!/usr/bin/expect
set skill_id [lindex $argv 0];
spawn ask dialog -s ${skill_id} -l es-ES
expect "User"
send -- "abre hola mundo\r"
expect "Bienvenido, puedes decir Hola o Ayuda. Cual prefieres?"
send -- "hola\r"
expect "Hola Mundo!"
send -- "abre hola mundo\r"
expect "Bienvenido, puedes decir Hola o Ayuda. Cual prefieres?"
send -- "ayuda\r"
expect "Puedes decirme hola. Cómo te puedo ayudar?"
send -- "adios\r"
expect "Hasta luego!"
Informes
No hay informes definidos en este job.
Integración
No es necesario integrarlo en el archivo package.json.
Pipeline Jobs
Todo está listo para ejecutar y probar nuestro tests de integración, ¡agregémoslo a nuestro pipeline!
Este job ejecutará las siguientes tareas:
- Restaurar el código que hemos descargado en el paso anterior en la carpeta
/home/node/project - Ejecutar el script
simple-dialog-checker. - Conservar nuevamente el código que reutilizaremos en el próximo job
integration-test:
executor: ask-executor
steps:
- attach_workspace:
at: /home/node/
- run: cd test/integration-test/ && ./simple-dialog-checker.sh $SKILL_ID
- persist_to_workspace:
root: /home/node/
paths:
- project
NOTA: Para realizar estas pruebas en CircleCI, debemos configurar la variable de entorno SKILL_ID con el ID de nuestra Alexa Skill.
Recursos
- DevOps Wikipedia - Wikipedia reference
- Documentación Oficial Alexa Skill Management API - Documentación Oficial Alexa Skill Management API
- Documentación oficial de CircleCI - Documentación oficial de CircleCI
Conclusión
Comprobar que todos los componentes de nuestra aplicación se estén ejecutando correctamente es una de las cosas más importantes en cada ejecución del pipeline. Estas pruebas se utilizan para probar la infraestructura de la aplicación y sus componentes. Es por eso que estas pruebas son muy relevantes en nuestro pipeline. Gracias al ASK CLI podemos realizar estas complejas pruebas.
También podemos escribir pruebas de integración con Bespoken. Ver documentación aquí. Estabelciendo la prueba de tipo simulación en lugar de e2e
Puedes encontrar el código en mi Github
!Eso es todo!
¡Espero que te sea útil! Si tienes alguna duda o pregunta, no dudes en ponerte en contacto conmigo o poner un comentario a continuación.
Happy coding!
