Aquest repositori mostra com desplegar un clúster lleuger de Kubernetes (k3s) amb Vagrant i exemples pràctics per aprendre a executar aplicacions en un entorn local.

Contingut del repositori

Vagrantfile: configuració principal per crear un clúster k3s amb Vagrant.
libvirtVagrantfile: configuració alternativa per a entorns amb libvirt en lloc de VirtualBox.
boxes/: imatges de VM i arxius de suport per a Vagrant.
shared/: fitxers compartits i configuració comuna entre màquines.
debian/, ubuntu/: catàlegs amb exemples específics per a cada distribució i scripts d'instal·lació.
exemples/: manifests Kubernetes i pràctiques d'exemple per desplegar aplicacions.

Exemple principal

El directori exemples/practica-final conté una pràctica completa de WordPress + MariaDB amb:

01-secret.yaml: credencials de base de dades.
02-pvcs.yaml: volum persistent per a WordPress.
03-mariadb.yaml: MariaDB replicada com a StatefulSet de 3 rèpliques.
04-wordpress.yaml: desplegament de WordPress connectat al primari de MariaDB.
05-ingress.yaml: Ingress per exposar l'aplicació a elmeublog.local.
install.yaml: manifest combinat per aplicar tota la pràctica amb un sol comandament.

Com executar la pràctica final

Arrenca el clúster amb Vagrant:

vagrant up

Comprova l'estat del node i la connectivitat:

vagrant ssh -c "sudo kubectl get nodes"

Aplica la pràctica completa:

kubectl apply -f exemples/practica-final/install.yaml

Accedeix a WordPress des del navegador amb:

http://elmeublog.local

Assegura't d'afegir 127.0.0.1 elmeublog.local al teu /etc/hosts si estàs treballant en local.

Altres exemples

exemples/exemples-inicials: manifestos bàsics de Kubernetes per a desplegar pods, serveis, ingress, Redis i Nginx.
exemples/maria-db: exemple de MariaDB amb Deployment i PVC.
exemples/mariadb-replication: configuració de replicació de MariaDB amb StatefulSet i ConfigMap.

Requisits

Vagrant instal·lat
Proveïdor de VM compatible (per exemple, VirtualBox o libvirt)
curl i ssh disponibles
kubectl accessible dins de la VM o des de l'amfitrió si tens accés a la configuració del cluster

Personalització

Modifica el Vagrantfile per canviar la mida de la VM, el nombre de nodes o la xarxa.
Utilitza libvirtVagrantfile si prefereixes treballar amb libvirt.
Revisa els fitxers dins dels directoris debian/ i ubuntu/ per veure scripts específics d'instal·lació.

Neteja

Per aturar i eliminar les màquines virtuals:

vagrant halt
vagrant destroy -f

Per eliminar la pràctica final de Kubernetes:

kubectl delete -f exemples/practica-final/install.yaml

Contribucions

Si trobes un error o vols millorar aquesta guia, obre un issue o envia un PR.

Suport i llicència

Aquest repositori es publica per Agile611 amb llicència Creative Commons Attribution-NonCommercial 4.0 International.

Aquest README s'ha creat per facilitar l'ús del repositori i ajudar a desplegar Kubernetes local amb exemples pràctics.