startusingkubernetes/exemples/README.md

Exemples — Resum i ús ràpid

Aquest directori conté manifests Kubernetes d'exemple agrupats en subcarpetes. Són fitxers pensats per aprendre i desplegar recursos bàsics (Pods, Deployments, Services, StatefulSets, PVCs, Ingress, Secrets, etc.) en un clúster local o d'estudi.

Prerequisits

• Clúster: Un clúster Kubernetes (k3s, minikube, kind, etc.).
• kubectl: Configurat per apuntar al clúster.

Com aplicar els exemples

Per aplicar una carpeta sencera:

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

Aplica fitxers individuals amb kubectl apply -f <ruta/al/fitxer>.

Estructura i descripció dels fitxers

exemples-inicials/

• File: exemples/exemples-inicials/app-configurada.yaml — Exemple de desplegament amb configuració (ConfigMap/variables) aplicada.
• File: exemples/exemples-inicials/deploy.yaml — Manifest d'un Deployment bàsic amb rèpliques.
• File: exemples/exemples-inicials/nginx-clusterip.yaml — Service de tipus ClusterIP per Nginx.
• File: exemples/exemples-inicials/nginx-deployment.yaml — Deployment de Nginx.
• File: exemples/exemples-inicials/nginx-ingress.yaml — Regles d'Ingress per exposar Nginx (requereix controlador d'ingress).
• File: exemples/exemples-inicials/pod.yaml — Manifest d'un Pod senzill per provar execució bàsica.
• File: exemples/exemples-inicials/redis-deployment.yaml — Deployment de Redis (stateless, per proves).
• File: exemples/exemples-inicials/redis-pod.yaml — Pod de Redis (ús demostratiu).
• File: exemples/exemples-inicials/redis-pvc.yaml — PersistentVolumeClaim per a Redis.
• File: exemples/exemples-inicials/redis-stateful-replica.yaml — Exemple de rèplica/escala en StatefulSet per Redis.
• File: exemples/exemples-inicials/redis-stateful.yaml — StatefulSet per desplegament de Redis amb PVCs.
• File: exemples/exemples-inicials/service.yaml — Exemple genèric de Service (ClusterIP/NodePort segons configuració).

maria-db/

• File: exemples/maria-db/mariadb-deployment.yaml — Deployment (o StatefulSet) per MariaDB.
• File: exemples/maria-db/mariadb-pvc.yaml — PersistentVolumeClaim per l'emmagatzematge de la base de dades.

mariadb-replication/

• File: exemples/mariadb-replication/mariadb-replication.yaml — Manifests per muntar un entorn de replicació de MariaDB (master/replica) amb secrets i configuració.

practica-final/

• File: exemples/practica-final/01-secret.yaml — Secret amb credencials per la pràctica final.
• File: exemples/practica-final/02-pvcs.yaml — PVCs requerits per MariaDB/WordPress.
• File: exemples/practica-final/03-mariadb.yaml — Desplegament de MariaDB per la pràctica final.
• File: exemples/practica-final/04-wordpress.yaml — Deployment/Service de WordPress configurat per connectar amb MariaDB.
• File: exemples/practica-final/05-ingress.yaml — Ingress per exposar WordPress públicament (requereix controlador d'ingress i DNS/hosts si s'usa hostname).
• File: exemples/practica-final/install.yaml — Fitxer compost per aplicar l'ordre correcta (secrets → PVCs → DB → app → ingress).

Suggeriments i consideracions

• Ordre d'aplicació: Normalment Secret → PVCs → Deployments/StatefulSets → Services → Ingress.
• Ingress: Comprova que tens un controlador d'ingress actiu (traefik, nginx-ingress, etc.).
• Persistència: Si treballes en un entorn local, revisa la provisió de StorageClass per assegurar que els PVCs es vinculen.
• Neteja: Per eliminar recursos després de provar:

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

---

Si vols, puc: generar un README per cada subcarpeta individual, afegir descripcions més detallades per cada manifest o crear scripts d'aplicació/neteja automatitzats.