diff --git a/README.md b/README.md index e6fae44..db91154 100644 --- a/README.md +++ b/README.md @@ -7,15 +7,15 @@ - [pi-servers](#pi-servers) - [Principe](#principe) - [Process](#process) - - [Flash Debian 12 Headless on SD card with Balena etcher](#flash-debian-12-headless-on-sd-card-with-balena-etcher) - - [Boot the raspberry](#boot-the-raspberry) - - [Clone rpi-clone on SD card](#clone-rpi-clone-on-sd-card) - - [Launch the clone process to Nvme](#launch-the-clone-process-to-nvme) - - [Config the raspberry pi to boot from Nvme :warning: IMPORTANT**](#config-the-raspberry-pi-to-boot-from-nvme-warning-important) - - [Overclock the raspberry](#overclock-the-raspberry) - - [Reboot the raspberry](#reboot-the-raspberry) - - [Config the Ansible playbook inventory.yaml](#config-the-ansible-playbook-inventoryyaml) - - [Provision the raspberry pis to create the cluster](#provision-the-raspberry-pis-to-create-the-cluster) + - [Flasher Debian 12 Headless sur carte SD avec Balena etcher](#flasher-debian-12-headless-sur-carte-sd-avec-balena-etcher) + - [Démarrer le Raspberry Pi](#d%C3%A9marrer-le-raspberry-pi) + - [Cloner rpi-clone sur la carte SD](#cloner-rpi-clone-sur-la-carte-sd) + - [Lancer le processus de clonage vers le NVMe](#lancer-le-processus-de-clonage-vers-le-nvme) + - [Configurer le Raspberry Pi pour démarrer depuis le NVMe :warning: IMPORTANT](#configurer-le-raspberry-pi-pour-d%C3%A9marrer-depuis-le-nvme-warning-important) + - [Overclocker le Raspberry Pi](#overclocker-le-raspberry-pi) + - [Redémarrer le Raspberry Pi](#red%C3%A9marrer-le-raspberry-pi) + - [Configurer le playbook Ansible inventory.yaml](#configurer-le-playbook-ansible-inventoryyaml) + - [Provisionner les Raspberry Pis pour créer le cluster](#provisionner-les-raspberry-pis-pour-cr%C3%A9er-le-cluster) - [Documentation](#documentation) - [TODO](#todo) @@ -23,70 +23,60 @@ ## Principe -Installer un cluster K3S sur des raspberry pi 5 avec l'os sur Nvme. +Installer un cluster K3S sur des raspberry pi 5 avec l'os sur NVMe. ## Process Pour chaque Raspberry pi du cluster, répéter ce process: -### Flash Debian 12 Headless on SD card with [Balena etcher](https://etcher.balena.io/) +### Flasher Debian 12 Headless sur carte SD avec [Balena etcher](https://etcher.balena.io/) -- Download PI-OS image for [Bookworm Lite](https://downloads.raspberrypi.com/raspios_lite_arm64/images/raspios_lite_arm64-2024-11-19/2024-11-19-raspios-bookworm-arm64-lite.img.xz) +- Télécharger l’image PI-OS de [Bookworm Lite](https://downloads.raspberrypi.com/raspios_lite_arm64/images/raspios_lite_arm64-2024-11-19/2024-11-19-raspios-bookworm-arm64-lite.img.xz) -- Flash the OS to the SD card +- Flasher l’OS sur la carte SD -### Boot the raspberry +### Démarrer le Raspberry Pi +### Cloner rpi-clone sur la carte SD -### Clone rpi-clone on SD card - -Git clone this repo: https://github.com/geerlingguy/rpi-clone.git: +Cloner ce dépôt Git : https://github.com/geerlingguy/rpi-clone.git: ```bash git clone https://github.com/geerlingguy/rpi-clone.git cd rpi-clone sudo cp rpi-clone rpi-clone-setup /usr/local/sbin ``` -### Launch the clone process to Nvme +### Lancer le processus de clonage vers le NVMe -Clone to the NVMe drive (usually nvme0n1, but check with `lsblk`): +Cloner vers le disque NVMe (généralement `nvme0n1`, mais vérifier avec `lsblk`) : ```bash sudo rpi-clone nvme0n1 ``` -> Validate and choose `ext4` as file system +> Valider et choisir ext4 comme système de fichiers -### Config the raspberry pi to boot from Nvme :warning: IMPORTANT** +### Configurer le Raspberry Pi pour démarrer depuis le NVMe :warning: **IMPORTANT** -- Edit the `/boot/firmware/config.txt` file: +- Modifier le fichier `/boot/firmware/config.txt`: ```bash dtparam=pciex1 - -# Note: You could also just add the following (it is an alias to the above line) -# dtparam=nvme - -# Optionally, you can control the PCIe lane speed using this parameter -# dtparam=pciex1_gen=3 ``` -- Change the boot order: +- Changer l’ordre de démarrage: ```bash sudo rpi-eeprom-config --edit ``` -- Change the BOOT_ORDER as follow: +- Modifier la ligne `BOOT_ORDER` comme suit: ```bash - -# Change the BOOT_ORDER line to the following: BOOT_ORDER=0xf416 ``` -### Overclock the raspberry +### Overclocker le Raspberry Pi -- Edit the `/boot/firmware/config.txt` file: +- Modifier le fichier `/boot/firmware/config.txt`: ```bash # Tell the DVFS algorithm to increase voltage by this amount (in µV; default 0). -# IMPORTANT: See note below over_voltage_delta=50000 # Set the Arm A76 core frequency (in MHz; default 2400). @@ -96,27 +86,27 @@ arm_freq=3000 gpu_freq=1000 ``` -### Reboot the raspberry +### Redémarrer le Raspberry Pi ```bash sudo reboot ``` -### Config the Ansible playbook (inventory.yaml) +### Configurer le playbook Ansible (inventory.yaml) -- Git clone this repo: https://git.legaragenumerique.fr/GARAGENUM/ansible-garage-kluster +- Cloner ce dépôt Git: https://git.legaragenumerique.fr/GARAGENUM/ansible-garage-kluster -- Edit the `inventory.yaml` file: +- Modifier le fichier `inventory.yaml`: ```bash cd ansible-garage-kluster/ nano inventory.yaml ``` -- Configure the Master and Workers IPs +- Configurer les adresses IP du Master et des Workers -### Provision the raspberry pis to create the cluster +### Provisionner les Raspberry Pis pour créer le cluster -- Launch the playbook: +- Lancer le playbook: ```bash ansible-playbook -i inventory.yaml install-k3s-playbook.yaml ``` @@ -129,4 +119,6 @@ ansible-playbook -i inventory.yaml install-k3s-playbook.yaml ## TODO -- [ ] Script bash automate the config \ No newline at end of file +- [ ] Etendre la partition sur tout l'espaxe disponible du NVMe +- [ ] Process pour créer carte SD template avec clé SSH (pour Ansible) via PIimager +- [ ] Script bash pour automatiser le process \ No newline at end of file