89 lines
2.8 KiB
Markdown
89 lines
2.8 KiB
Markdown
# Debian Vagrant — Descripció i ús
|
|
|
|
Aquest directori inclou una infraestructura Vagrant per muntar màquines Debian que suporten un petit clúster k3s d'estudi.
|
|
|
|
Contingut
|
|
- `Vagrantfile` — Fitxer principal per crear les màquines virtuals (controlador i agents).
|
|
- `.vagrant/` — Estat local de Vagrant (no versionar).
|
|
- `shared/` — Conté fitxers compartits entre host i les VM:
|
|
- `k3s.yaml` — Fitxer kubeconfig generat pel clúster k3s dins les VM.
|
|
- `token` — Token d'unió per a workers (k3s join token).
|
|
|
|
Prerequisits
|
|
- Instal·lar `Vagrant` i un provider (ex. VirtualBox). Si fas servir `libvirt` o un altre provider, configura'l prèviament.
|
|
- Xarxa i permisos per crear màquines virtuals.
|
|
|
|
Com arrencar el lab
|
|
1. Situa't a la carpeta `debian`:
|
|
|
|
```bash
|
|
cd debian
|
|
```
|
|
|
|
2. Inicia totes les màquines:
|
|
|
|
```bash
|
|
vagrant up
|
|
```
|
|
|
|
3. Opcional — iniciar només una màquina concreta (ex.: `server`):
|
|
|
|
```bash
|
|
vagrant up server
|
|
```
|
|
|
|
Accedir al kubeconfig
|
|
- Un cop el clúster està operatiu, trobaràs el `kubeconfig` generat a `shared/k3s.yaml`. Per usar-lo localment, pots fer:
|
|
|
|
```bash
|
|
export KUBECONFIG=$PWD/shared/k3s.yaml
|
|
kubectl get nodes
|
|
```
|
|
|
|
o copiar-lo al teu fitxer de kubeconfig:
|
|
|
|
```bash
|
|
cp shared/k3s.yaml ~/.kube/config
|
|
```
|
|
|
|
Ús del token
|
|
- El fitxer `shared/token` conté normalment el token per unir workers al clúster. No el comparteixis públicament.
|
|
|
|
Neteja i aturada
|
|
- Aturar màquines:
|
|
|
|
```bash
|
|
vagrant halt
|
|
```
|
|
|
|
- Destruir màquines i alliberar recursos:
|
|
|
|
```bash
|
|
vagrant destroy -f
|
|
```
|
|
|
|
Consells i consideracions
|
|
- No versionis la carpeta `.vagrant` ni fitxers sensibles (secrets, tokens) al repositori.
|
|
- Si utilitzes un provider diferent de VirtualBox (ex. libvirt), assegura't d'haver instal·lat i configurat el plugin de Vagrant corresponent.
|
|
- Si el `kubeconfig` mostra nodes en estat NotReady, comprova que les VM tenen connectivitat i que k3s està en execució (`vagrant ssh server` i `sudo systemctl status k3s`).
|
|
|
|
Vols que:
|
|
- faci un `git commit` d'aquest `README.md`?
|
|
- o que generi instruccions més detallades per personalitzar la topologia (nombre d'agents, recursos, etc.)?
|
|
|
|
# Suport
|
|
|
|
Aquest tutorial és publicat al domini públic per [Agile611](http://www.agile611.com/) sota la llicència Creative Commons Attribution-NonCommercial 4.0 International.
|
|
|
|
[](https://creativecommons.org/licenses/by-nc/4.0/)
|
|
|
|
Aquest fitxer README va ser escrit originalment per [Guillem Hernández Sola](https://www.linkedin.com/in/guillemhs/) i també és publicat al domini públic.
|
|
|
|
Si us plau, contacta amb Agile611 per a més detalls.
|
|
|
|
* [Agile611](http://www.agile611.com/)
|
|
* Laureà Miró 309
|
|
* 08950 Esplugues de Llobregat (Barcelona)
|
|
|
|
[](http://www.agile611.com/)
|