Merge pull request #211 from Lemoncode/feature/cicd-exercises-2023

Update after CI/CD lab class

Author: JTrillo

03-cd/03-github-actions/README.md

@@ -88,7 +88,7 @@ There are some limits whe using GitHub-hosted runners.
 | Team             | 60                        | 5                                 |
 | Enterprise Cloud | 1000                      | 50                                |
 
-## Refernces
+## References
 
 - [Understanding Github Actions](https://docs.github.com/en/actions/learn-github-actions/understanding-github-actions)
 - [Workflow syntax](https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions)

03-cd/exercises/README.md

@@ -6,21 +6,21 @@ Para superar el módulo debéis entregar como mínimo:
 * La parte obligatoria de los ejercicios de GitHub Actions.
 * Uno de los dos ejercicios opcionales de la parte de GitHub Actions
 
-## Ejercios Jenkins
+## Ejercicios Jenkins
 
 ### 1. CI/CD de una Java + Gradle - OBLIGATORIO
 
-En el directorio raíz de este [código fuente](./jenkins-resources), crea un `Jenkinsfile` que contenga un pipeline declarativa con los siguientes stages:
+En el directorio raíz de este [código fuente](./jenkins-resources), crea un `Jenkinsfile` que contenga una pipeline declarativa con los siguientes stages:
 
-* **Checkout** descarga de código desde un repositorio remoto, preferentemente utiliza GitHub.
-* **Compile** compilar el código fuente, para ello utilizar `gradlew compileJava`
-* **Unit Tests** ejecutar los test unitarios, para ello utilizar `gradlew test`
+* **Checkout**. Descarga de código desde un repositorio remoto, preferentemente utiliza GitHub
+* **Compile**. Compilar el código fuente utilizando `gradlew compileJava`
+* **Unit Tests**. Ejecutar los test unitarios utilizando `gradlew test`
 
 Para ejecutar Jenkins en local y tener las dependencias necesarias disponibles podemos contruir una imagen a partir de [este Dockerfile](./jenkins-resources/gradle.Dockerfile)
 
 ### 2. Modificar la pipeline para que utilice la imagen Docker de Gradle como build runner - OBLIGATORIO
 
-* Utilizar Docker in Docker a la hora de levantar Jenkins para realizar este ejercicio.
+* Utilizar Docker in Docker a la hora de levantar Jenkins para realizar este ejercicio
 * Como plugins deben estar instalados `Docker` y `Docker Pipeline`
 * Usar la imagen de Docker `gradle:6.6.1-jre14-openj9`
 
@@ -34,7 +34,7 @@ Para ejecutar Jenkins en local y tener las dependencias necesarias disponibles p
   * `maven:build` - En este `stage` el código de la aplicación se compila con [maven](https://maven.apache.org/).
   * `maven:test` - En este `stage` ejecutamos los tests utilizando [maven](https://maven.apache.org/).
   * `docker:build` - En este `stage` generamos una nueva imagen de Docker a partir del Dockerfile suministrado en el raíz del proyecto.
-  * `deploy` - En este `stage` utilizamos la imagen anteriormente creada, y la hacemos correr en nuestro local
+  * `deploy` - En este `stage` utilizamos la imagen anteriormente creada, y la hacemos correr en nuestro local.
 
 * **Pistas**:
   * Utiliza la versión de maven 3.6.3
@@ -63,20 +63,20 @@ Acciones a probar:
 
 Relizar de las siguientes maneras:
 
-* **Con el método de CI job permissions model**
+* **Con el método de CI job token**
   * ¿Qué ocurre si el repo que estoy clonando no estoy cómo miembro?
 
-> Pista: https://docs.gitlab.com/ee/user/project/new_ci_build_permissions_model.html (Dependent Repositories)
+> Pista: https://docs.gitlab.com/ee/ci/jobs/ci_job_token.html
 
 * **Con el método deploy keys**
   * Crear deploy key en el repo springapp y poner solo lectura
-  * Crear pipeline que usando la deploy key
+  * Crear pipeline que use la deploy key para clonar el repo
 
  > Pista: https://docs.gitlab.com/ee/ci/ssh_keys/
 
 ## Ejercicios GitHub Actions
 
-### Ejercicio 1. Crea un workflow CI para el proyecto de frontend - OBLIGATORIO
+### 1. Crea un workflow CI para el proyecto de frontend - OBLIGATORIO
 
 Copia el directorio [.start-code/hangman-front](../03-github-actions/.start-code/hangman-front) en el directorio raíz del mismo repositorio que usaste para las clases de GitHub Actions. Si no lo creaste, crea un repositorio nuevo.
 
@@ -85,18 +85,34 @@ Después crea un nuevo workflow que se dispare cuando haya cambios en el proyect
 * Build del proyecto de front
 * Ejecutar los unit tests
 
-### Ejercicio 2. Crea un workflow CD para el proyecto de frontend - OBLIGATORIO
+### 2. Crea un workflow CD para el proyecto de frontend - OBLIGATORIO
 
 Crea un nuevo workflow que se dispare manualmente y haga lo siguiente:
 
 * Crear una nueva imagen de Docker
 * Publicar dicha imagen en el [container registry de GitHub](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry)
 
-### Ejercicio 3. Crea un workflow que ejecute tests e2e - OPCIONAL
+### 3. Crea un workflow que ejecute tests e2e - OPCIONAL
 
-Crea un workflow que se ejecute de la manera que elijas y que ejecute los tests usando [Docker Compose](https://docs.docker.com/compose/gettingstarted/) o [Cypress action](https://github.com/cypress-io/github-action).
+Crea un workflow que se lance de la manera que elijas y ejecute los tests e2e que encontrarás en [este enlance](../03-github-actions/.start-code/hangman-e2e/e2e/). Puedes usar [Docker Compose](https://docs.docker.com/compose/gettingstarted/) o [Cypress action](https://github.com/cypress-io/github-action) para ejecutar los tests.
 
-### Ejercicio 4. Crea una custom JavaScript Action - OPCIONAL
+#### Como ejecutar los tests e2e
+
+* Tanto el front como la api se deben estar corriendo
+
+```bash
+docker run -d -p 3001:3000 hangman-api
+docker run -d -p 8080:8080 -e API_URL=http://localhost:3001 hangman-front
+```
+
+* Los tests se ejecutan desde el directorio `hangman-e2e/e2e` haciendo uso del comando `npm run open`
+
+```bash
+cd hangman-e2e/e2e
+npm run open
+```
+
+### 4. Crea una custom JavaScript Action - OPCIONAL
 
 Crea una custom JavaScript Action que se ejecute cada vez que una `issue` tenga la etiqueta `motivate`. La acción deberá pintar por consola un mensaje motivacional. Puedes usar [esta API](https://type.fit) gratuita. Puedes encontrar más información de como crear una custom JS action en [este enlace](https://docs.github.com/es/actions/creating-actions/creating-a-javascript-action).