Added comments

This commit is contained in:
2026-04-17 11:09:46 +02:00
parent f3f4d30071
commit 39d5344d82
11 changed files with 272 additions and 99 deletions

View File

@@ -1,76 +1,75 @@
[![Agile611](https://www.agile611.com/wp-content/uploads/2020/09/cropped-logo-header.png)](http://www.agile611.com/)
# Agile611 Jenkins CI/CD Training
# Formació Jenkins CI/CD d'Agile611
Este repositorio ofrece scripts y una configuración mínima para levantar un entorno de Jenkins de prueba local usando Vagrant.
Aquest repositori ofereix scripts i una configuració mínima per aixecar un entorn de Jenkins de prova local usant Vagrant.
**Objetivo:** Proporcionar un punto de partida sencillo para probar Jenkins (y opcionalmente SonarQube) en entornos locales y educativos de CI.
**Objectiu:** Proporcionar un punt de partida senzill per provar Jenkins (i opcionalment SonarQube) en entorns locals i educatius de CI.
**Requisitos:**
- macOS, Linux o Windows con compatibilidad para Docker o Vagrant
- Permisos de ejecución para los scripts (`chmod +x *.sh`)
- **git**: Necesario para clonar el repositorio
- **Vagrant**: Este repositorio utiliza una caja Vagrant basada en Ubuntu y se utilizará APT.
- **Virtualbox**: Es el motor para virtualizar el entorno.
**Requisits:**
- macOS, Linux o Windows amb compatibilitat per a Docker o Vagrant
- Permisos d'execució per als scripts (`chmod +x *.sh`)
- **git**: Necessari per clonar el repositori
- **Vagrant**: Aquest repositori utilitza una caixa Vagrant basada en Ubuntu i es farà servir APT.
- **Virtualbox**: És el motor per virtualitzar l'entorn.
**Estructura del repositorio:**
- `docker.sh` — script para arrancar servicios con Docker
- `jenkins.sh` — script de ayuda para gestionar Jenkins (arrancar, detener, acceder)
- `sonarqube.sh` — script para arrancar SonarQube (opcional)
- `Vagrantfile` — definición para crear una VM con Vagrant que instala Jenkins
**Estructura del repositori:**
- `docker.sh` — script per arrancar serveis amb Docker
- `jenkins.sh` — script d'ajuda per gestionar Jenkins (arrancar, aturar, accedir)
- `sonarqube.sh` — script per arrancar SonarQube (opcional)
- `Vagrantfile` — definició per crear una VM amb Vagrant que instal·la Jenkins
**Inicio rápido (Vagrant)**
**Inici ràpid (Vagrant)**
1) Instala Vagrant y VirtualBox.
2) Inicia la VM definida en el `Vagrantfile`:
1) Instal·la Vagrant i VirtualBox.
2) Inicia la VM definida al `Vagrantfile`:
```bash
vagrant up
vagrant ssh jenkins
# dentro de la VM, sigue las instrucciones del Vagrantfile o de los scripts
# dins de la VM, segueix les instruccions del Vagrantfile o dels scripts
```
**Descripción breve de los scripts:**
- `docker.sh`: crea y gestiona contenedores (Jenkins, posiblemente SonarQube u otros servicios). Revisa su contenido para ajustar puertos y volúmenes.
- `jenkins.sh`: utilidades para obtener la URL de acceso, el usuario inicial y los secrets.
- `sonarqube.sh`: arranca SonarQube en modo desarrollo para escaneos locales.
- `Vagrantfile`: configura una máquina virtual con una instalación mínima para ejecutar Jenkins sin Docker.
**Descripció breu dels scripts:**
- `docker.sh`: crea i gestiona contenidors (Jenkins, possiblement SonarQube u altres serveis). Revisa el seu contingut per ajustar ports i volums.
- `jenkins.sh`: utilitats per obtenir la URL d'accés, l'usuari inicial i els secrets.
- `sonarqube.sh`: arranca SonarQube en mode desenvolupament per a escanejats locals.
- `Vagrantfile`: configura una màquina virtual amb una instal·lació mínima per executar Jenkins sense Docker.
**Puertos por defecto (configurables):**
**Ports per defecte (configurables):**
- Jenkins: 8080
- SonarQube: 9000
## Resolución de problemas
- Si un puerto está ocupado, modifica la configuración del script o libera el puerto.
- Comprueba permisos: `chmod +x *.sh`.
- Revisa logs de los contenedores con `docker logs <container>` o entra con `vagrant ssh` y consulta los logs dentro de la VM.
## Resolució de problemes
- Si un port està ocupat, modifica la configuració del script o allibera el port.
- Comprova permisos: `chmod +x *.sh`.
- Revisa registres dels contenidors amb `docker logs <container>` o entra amb `vagrant ssh` i consulta els registres dins de la VM.
## Contribuir
- Abre un issue para proponer mejoras o reportar bugs.
- Haz fork y envía pull requests con cambios pequeños y bien documentados.
- Obri un issue per proposar millores o reportar bugs.
- Fes fork i envia pull requests amb canvis petits i ben documentats.
## Solución de problemas
## Solució de problemes
Si encuentras problemas al aprovisionar la caja, puedes descargarla directamente y añadirla a Vagrant.
Si trobes problemes en aprovisionar la caixa, pots descarregar-la directament i afegir-la a Vagrant.
## Problemas comunes de red
## Problemes comuns de xarxa
Si tienes proxies o VPNs activos en tu equipo, es posible que Vagrant no pueda aprovisionar el entorno.
Si tens proxies o VPNs actius al teu equip, és possible que Vagrant no pugui aprovisionar l'entorn.
Comprueba tu conectividad previamente.
Comprova la teva connectivitat prèviament.
## Licencia
## Llicència
Este proyecto está publicado bajo la licencia MIT. Modifica según tus necesidades.
Aquest projecte està publicat sota la llicència MIT. Modifica segons les teves necessitats.
Este tutorial ha sido publicado por [Agile611](http://www.agile611.com/) bajo la licencia Creative Commons Atribución-NoComercial 4.0 Internacional.
Aquest tutorial ha estat publicat per [Agile611](http://www.agile611.com/) sota la llicència Creative Commons Atribució-NoComercial 4.0 Internacional.
[![License: CC BY-NC 4.0](https://img.shields.io/badge/License-CC_BY--NC_4.0-lightgrey.svg)](https://creativecommons.org/licenses/by-nc/4.0/)
Aquest `README` va ser originalment escrit per [Guillem Hernández Sola](https://www.linkedin.com/in/guillemhs/) i també es publica en el domini públic.
Este `README` fue originalmente escrito por [Guillem Hernández Sola](https://www.linkedin.com/in/guillemhs/) y también se publica en el dominio público.
Contacta con Agile611 para más detalles.
Contacta amb Agile611 per més detalls.
- [Agile611](http://www.agile611.com/)
- Laureà Miró 309
- 08950 Esplugues de Llobregat (Barcelona)