🔥🔥🔥🔥
Nuestra aplicación es un servidor web que expone una serie de endpoints:
- Alta de usuarios, que recibe un email y una contraseña y crea un nuevo usuario en el sistema (Si no existe)
- Login de usuarios, que para un par de email/contraseña válido devuelve un token válido durante 30 minutos.
- Los siguientes endpoints necesitan recibir un token válido en la cabecera HTTP "X-Service-Token"
- /almacena, que guarda las frases que recibe en una base de datos.
- /query, que devuelve el número de veces que una palabra aparece en frases del almacenamiento.
- /logout - expira el token
- /delete - elimina el usuario y expira el token
El servicio se apoya en una base de datos SQL [SQLite] para almacenar la información operativa: cadenas de búsqueda y usuarios.
El servicio almacena métricas de uso para cada endpoint en una base de datos NoSQL como Redis:
- número total de invocaciones
- tiempo medio de respuesta
Dado el caso de estudio, se debe elaborar los siguientes entregables:
Elaborar un documento formal en el que se describa la arquitectura de la solución. Se valorará positivamente una redacción clara y correcta y el uso de diagramas y topologías allá donde una imagen valga más que mil palabras.
Software que puede ayudar a que el resultado sea genial:
- Flowchart Maker & Online Diagram Software (Enlaces a un sitio externo.)
- Cloudcraft-Draw AWS diagrams (Enlaces a un sitio externo.)
- https://aws.amazon.com/es/architecture/icons/ (Enlaces a un sitio externo.)
En concreto, se pide elaborar con detalle los siguientes puntos:
Es necesario desarrollar estos dos temas para que esta parte cuente como apta:
Definir qué servicios, métodos y tecnologías se necesitan para poder ofrecer una solución:
- balanceadores de carga
- SSL
- Bases de datos
- Sobre qué software correrá el servicio en esas máquinas (por ejemplo, si la solución usa Java, definir si se usará Tomcat, Catalina u otra alternativa)
- Kubernetes
Se ha decidido desplegar nuestra infraestructura sobre una nube pública, al carecer de recursos físicos.
- Selección de proveedor
- Definición de servicios a usar
- Cantidad y tipo de instancias
- Aproximación de costes mensuales de la parte fija (no incluyendo costes variables en función del tráfico o la cantidad de datos almacenados)
Explicar en detalle cómo se llevará a cabo el despliegue de nuevas versiones de software:
- Elección de repositorio de artefactos, según su tipo
- Modelo de versionado
- Estrategia de despliegue sin indisponibilidad
- Plan de marcha atrás
Se pide buscar al menos un SLA (Service Level Agreement) para nuestro servicio, detallar cómo se conseguiría medir el indicador asociado (SLI) y cómo podríamos saber qué podemos incumplirlo, con un plan de acción para remediarlo.
Para facilitar el onboarding en el proyecto de nuevos desarrolladores, nada mejor que tener un entorno local de desarrollo potente, fiable y que se asemeje lo más posible al entorno final.
Se pide la definición de un entorno exportable de desarrollo.
-
Por exportable entendemos que se debe poder subir a control de versiones, descargar y ejecutar sin más. En caso de que se necesite alguna dependencia (software concreto, credenciales, variables de entorno) ésta deberá estar debidamente documentada.
-
Debe estar basado en alguna tecnología de virtualización (contenedores, máquinas virtuales…) que consiga, mediante la ejecución de un comando / script o similar levantar los servicios requeridos para poder probar localmente, de la forma más rápida posible, los cambios que hagamos a nuestro servicio web.
Se puede usar cualquier tecnología que tenga sentido, mientras el resultado sea el pedido: Se recomienda reutilizar algunos de los creados durante del bootcamp con Docker Compose , Vagrant o Kubernetes
Algo que sabemos que es imprescindible es que toda nuestra infraestructura, así como su configuración, esté declarada como código fuente en control de versiones.
Se pide declarar la infraestructura como código, usando cualquiera de las herramientas vistas durante el bootcamp (Terraform, Vagrant, AWS Cloudformation o equivalente si se elige otro proveedor) de los sistemas mínimos necesarios para poder ofrecer el servicio descrito de forma óptima desde un punto de vista Devops.
Aquí nos podríamos estar durante días y semanas y no terminar así que. para centrar un poco el fuego, se pide entregar al menos uno de los tres ambientes identificados:
Los servidores sobre los que se instalará y arrancará el servicio web. Debe existir un esquema de alta disponibilidad para evitar caídas de servicio y posibilitar despliegues sin downtime. Cualquier otra máquina que se considere necesaria debe ser instalada y configurada también).
Se debe instalar el software necesario para poder instalar, arrancar y actualizar el servidor web en cualquier momento.
Idéntico a producción pero con un único nodo en lugar de los N elegidos para dar mayor estabilidad.
Instalar y configurar los siguientes servicios
- CICD (Jenkins)
- Alternativas [github actions, gitlab]
- Almacenamiento: (Artifactory, Docker Registry, …)
- Colector de datos de telemetría (ElasticSearch, Prometheus…)
- [Opcional] Si se elige levantar algún servicio en lugar de usar un SaaS del proveedor de cloud elegido, debemos añadir su configuración (por ejemplo, si elegimos usar nuestra propia base de datos en lugar de contratar Amazon RDS)
OJO: Aquí hay que tener muy en cuenta que los entornos de producción y preproducción pueden estar en redes diferentes (eso es elección nuestra como operadores, aunque ciertamente una buena práctica). Si esto es así, hay que conseguir que la conectividad desde las máquinas del ciclo de vida hacia los entornos productivos sea posible:
- Es un error generar una infraestructura que dependa de una conectividad inexistente para funcionar.
Diseñar un Pipeline CI/CD en algunas de estas opciones Jenkins GithubActions Gitlab con las siguientes características obligatorias:
- Ejecución de tests unitarios
- Construcción de artefacto
- Almacenamiento artefacto
- Scan Sast Codigo y artefactos
- Despliegue a entorno de pre-producción
Opcionalmente, se pueden añadir los pasos necesarios para llegar a producción de forma apropiada:
- Tests integración sobre pre-producción (puede ser un smoke-test sobre la infra de preprod)
- Despliegue a producción con zero-downtime
Se debe entregar el archivo de configuración que implemente el flujo pedido y que funcione, de modo que se podría añadir al repositorio y cargarlo como un Multibranch Job.
Se ha optado por realizar una implementación del servicio usando Python y Flask mediante peticiones POST y GET al servidor.
Se ha considerado que cuando se usa el endpoint "almacena" se está modificando el estado del servidor y por tanto el verbo HTTP correcto es POST.
Sin embargo, cuando se hace uso del endpoint "consulta", se envían datos al servidor pero no se modifica su estado, así que se ha optado por emplear GET.
Del mismo modo cuando se da de alta un Usuario se ha de emplear el método POST. Para hacer login o logout se empleará GET.
Para probar el funcionamiento se recomienda emplear un programa como Curl o Postman.
Se ha eliminado el archivo de almacenamiento de cadenas de las versiones anteriores y se ha sustituido por una tabla dentro de la base de datos del programa.
Se pretendía implementar el frontend de la aplicación mediante plantillas html, para facilitar el testing y la presentación, pero ha sido posible.
Las dependencias están declaradas en el archivo requirements.txt
Para iniciar la aplicación ejecute el comando:
python server.py [-h] [-p <puerto>]
Si no se indica ningún parámetro se levantará el servicio con las opciones por defecto que es empleando el puerto 8080.
Para terminar la aplicación pulsar Ctrl+C
Los endpoints son:
- /
- /signup
- /login
- /logout
- /users
- /almacena
- /consulta
- /ready
- /health
- /metrics
Si se accede al endpoint / se muestra el mensaje HTML "Servicio Web para Cadenas"
Permite el registro de un nuevo usuario en la base de datos.
Se debe indicar en el cuerpo del mensaje un JSON con un nombre (name) y una contraseña (password):
{
"name":"Fulanito",
"password":"contraseña"
}
El servidor devuelve un mensaje JSON en la respuesta indicando el resultado de la operación.
El nuevo usuario y la contraseña se almacenan en la base de datos (no se almacena la contraseña en claro, si no un hash)
Permite al usuario autenticarse indicando su nombre y su contraseña mediante la cabecera de Autorización de HTML.
Si el usuario existe y la contraseña es correcta (se hace el hash y se comprueba con la que se tiene guardada en la base de datos) el servidor devuelve un token que será válido durante 60 minutos. Este token deberá ser incluido en la cabecera de las peticiones a los endpoints protegidos en un campo llamado X-Service-Token para que nos permita usarlos.
Si se accede al endpoint con un token válido, se incluye dicho token en una tabla de tokens expirados. A partir de ese momento no podrá acceder a ningún endpoint protegido hasta que consiga un nuevo token válido mediante el endpoint /login
Se necesita un token válido para poder llevar a cabo el almacenamiento.
Para llevar a cabo el almacenamiento de una cadena en el archivo se debe realizar un POST e incluir el parámetro string con la cadena que queremos almacenar en el archivo:
- ej: POST 127.0.0.1/almacena?string=Cadena+a+almacenar
Si se emplea un verbo distinto de POST devolverá un error 405 Method Not Allowed.
Si no se incluye el parámetro "string" devolverá una respuesta 400 BAD REQUEST con un json en el cuerpo con información sobre el error (debe incluir el parámetro string).
Se necesita un token válido para llevar a cabo la consulta.
Para llevar a cabo la consulta de una palabra en el archivo se debe realizar un GET e incluir el parámetro string con la palabra que queremos almacenar en el archivo:
- ej: POST 127.0.0.1/consulta?string=Cadena
Si se emplea un verbo distinto de GET devolverá un error 405 Method Not Allowed.
Si no se incluye el parámetro "string" devolverá una respuesta 400 BAD REQUEST con un json en el cuerpo con información sobre el error (debe incluir el parámetro string).
Si se envía más de una palabra devolvera una respuesta 400 BAD REQUEST con un json en el cuerpo con información sobre el error (debe enviar una única palabra).
Endpoint que comprueba la conexión con la base de datos y el correcto funcionamiento de los logs Si todo funciona correctamente devuelve un 200 OK. Si alguno de los dos falla devuelve un 503 NO DISPONIBLE.
Endpoint que devuelve 200 OK si el funciona correctamente, 503 si no está disponible.
Este endpoint devuelve un JSON con las métricas de los endpoints CONSULTA y ALMACENA y del numero de cadenas almacenadas actualmente en la base de datos.
En concreto devuelve el número de peticiones en cada endpoint y el tiempo medio de respuesta de cada endpoint.
El formato de salida es el siguiente:
{
"metrics": [
{
"Endpoint_CONSULTA": [
{
"name": "consulta_avg_response_time",
"value": averageConsulta
},
{
"name": "consulta_hits",
"value": consultaHits
}
]
},
{
"Endpoint_ALMACENA": [
{
"name": "almacena_avg_response_time",
"value": averageAlmacena
},
{
"name": "almacena_hits",
"value": almacenaHits
}
]
},
{
"Resource_DB": [
{
"name": "db_entries",
"value": resultsEntries
}
]
}
]
}
Si no estuviera disponible enviará un mensaje 503.
En la carpeta tests se han incluído los test unitarios para probar el funcionamiento del servicio.
IMPLEMENTADOS:
- test_almacena.py -- prueba el funcionamiento del endpoint "almacena"
- test_consulta.py -- prueba el funcionamiento del endpoint "consulta"
- test_health.py -- prueba el funcionamiento del endpoint "health"
- test_ready.py -- prueba el funcionamiento del endpoint "ready"
- test_others.py -- prueba el funcionamiento del resto de funciones de server.py
Para poder ejecutar los test y ver su cobertura es necesario instalar pytest y coverage
Para evaluar la covertura:
coverage run -m pytest
Para visualizar el resultado:
coverage report
Para generar un reporte detallado en HTML:
coverage html
El resultado de éste último cuando se ejecutó en nuestra máquina se ha incluido en el repositorio (Una cobertura del 84%).
Se recomienda el uso de Postman para comprobar el funcionamiento de la aplicación.
A tal efecto se ha incluído el archivo bootcampdevops.postman_collection.json que contiene una colección que con todos los casos de prueba.\
Se recomienda un visor de SQLite para revisar los datos en contenedor la base de datos se encuentra en data una posible solución es migrar a RDS Aurora o una alternativa de AWS Dynamodb, esto ultimo es adicional busquen la mejor manera de que funcione =)
Se recomienda el uso de postman la documentacion se encuentra en Doc
Si estás planeando usar este repositorio para aprender, por favor dale una estrella. ¡Gracias!
Recuerda documentar los pasos y decisiones tomadas durante la configuraciónde este proyecto ¡Buena suerte!