Added comments
This commit is contained in:
81
README.md
81
README.md
@@ -1,76 +1,75 @@
|
||||
[](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.
|
||||
|
||||
[](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)
|
||||
Reference in New Issue
Block a user