--- title: Installation d'un POC K3S sous Proxmox description: published: true date: 2023-06-14T20:33:21.832Z tags: k8s, proxmox editor: markdown dateCreated: 2023-06-14T17:52:35.877Z --- ![proxmox](https://gplexpert.com/wp-content/uploads/2019/07/PROXMOX-768x269.png) # Prérequis ## Un serveur hyperviseur Plusieurs solutions sont disponibles, le plus simple reste le petit NUC boosté aux stéroïde. C'est vers cette solution que je me suis tourné ! Voici donc la bête que j'ai acheté spécialement pour ce POC : ![poc_server.jpg](/Conteneurisation/poc_server.jpg) [Disponible sur Amazon](https://amzn.to/3P9ySPp) {.amazon} 16 Threads et 32Go de RAM seront parfait pour faire un POC K8S, voir même de la prod dans un futur proche. J'ai cependant profité du port SATA pour ajouter un SSD de 1To au NVME de 500Go déjà disponible. ## Installer Proxmox Je ne vous guiderai pas dans ce tutoriel dans l'installation de Proxmox, mais vous pouvez retrouver toutes la documentation necessaire directement sur internet ou peut être dans un avenir proche dans cette catégorie Wiki-Tech : https://wiki-tech.io/Virtualisation#proxmox A la fin de l'installation de Proxmox, j'ai pour habitude d'utiliser un petit script post installation pour changer quelques configurations : ```bash bash -c "$(wget -qLO - https://github.com/tteck/Proxmox/raw/main/misc/post-pve-install.sh)" ``` ![pve2_-_proxmox_console_2023-06-14_20.45.08@2x.png](/Conteneurisation/pve2_-_proxmox_console_2023-06-14_20.45.08@2x.png) ## Configurer le SSD de 1To Afin de bénéficier de la place disponible dans ce SSD SATA nouvellement ajouté à la machine, il fait le configurer dans Proxmox pour permettre son utilisation. Pour cela, rendez vous dans la catégorie `Disk` de votre hyperviseur, et cliquer sur `Create Volume Group` : ![pve2_-_proxmox_virtual_environment_2023-06-14_19.56.48@2x.png](/Conteneurisation/pve2_-_proxmox_virtual_environment_2023-06-14_19.56.48@2x.png) > Pensez à retenir le nom de votre volume, on va en avoir besoin par la suite. {.is-warning} > Votre disque est prêt à être utilisé ! {.is-success} ## Créer un utilisateur Par la suite je vais utiliser Packer et Terraform pour déployer l'infra rapidement, pour cela, je vais créer un utilisateur dédié : ![pve2_-_proxmox_virtual_environment_2023-06-14_20.09.41@2x.png](/Conteneurisation/pve2_-_proxmox_virtual_environment_2023-06-14_20.09.41@2x.png) ![pve2_-_proxmox_virtual_environment_2023-06-14_20.11.16@2x.png](/Conteneurisation/pve2_-_proxmox_virtual_environment_2023-06-14_20.11.16@2x.png) Et on lui ajoute les bonnes permissions : ![pve2_-_proxmox_virtual_environment_2023-06-14_20.12.57@2x.png](/Conteneurisation/pve2_-_proxmox_virtual_environment_2023-06-14_20.12.57@2x.png) ![pve2_-_proxmox_virtual_environment_2023-06-14_20.14.46@2x.png](/Conteneurisation/pve2_-_proxmox_virtual_environment_2023-06-14_20.14.46@2x.png) ## Créer un template Debian 12 Là aussi vous êtes libre de créer ce template par les moyens que vous souhaitez, dans mon cas je vais en profiter pour utiliser Packer avec l'aide de l'excellent projet de QJoly : [QJoly/Debian-Template-Proxmox](https://github.com/QJoly/Debian-Template-Proxmox) {.github} # Déployer l'infra du POC Dans ce POC je vais avoir besoin de 3 VM. Pour leur création, je vais utiliser Terraform. ## Préparer Terraform Il faut installer le client Terraform sur sa machine, dans mon cas j'utilise MacOS donc je l'installe avec : ```bash brew install terraform ``` Ensuite nous avons besoin d'un fichier pour permettre à Terraform de se connecter à notre cluster Proxmox : `provider.tf` ```json terraform { required_providers { proxmox = { source = "Telmate/proxmox" version = "2.9.14" } } } provider "proxmox" { pm_api_url = "https://:8006/api2/json" pm_user = "terraform@pve" pm_password = "" pm_tls_insecure = "true" pm_parallel = 3 } ``` Et d'un autre fichier pour décrire l'infrastructure que nous voulons : `main.tf` ```json module "machinetest" { count = 3 source = "QJoly/proxmox/module" version = "0.0.1" node_name = "master-${count.index}-tf" node_target = "" node_qemuga = 1 node_pool = "" node_size_disk = "32G" node_bootauto = true node_template = "" node_storage_disk = "" node_network_host = "vmbr0" node_notes = "Super-VM for the customer No 01" node_cpu = 4 node_memory = 4092 } ``` Ce qui nous donnes ces deux fichiers : ``` . ├── main.tf └── provider.tf ``` ## Déployer les serveurs Rien de plus simple : ```bash # On initialise Terraform terraform init # On vérifie ce que va faire Terraform terraform plan # Et on lance les joyeusetés ! terraform apply ``` Et 4 min 20 après, voici les 3 machines virtuelles qui ont bien été créées : ![pve2_-_proxmox_virtual_environment_2023-06-14_21.28.55@2x.png](/Conteneurisation/pve2_-_proxmox_virtual_environment_2023-06-14_21.28.55@2x.png) ## Préparer les serveurs ### Changer le hostname ```bash hostnamectl set-hostname ``` ### Configurer le terminal Pour ça, j'utilise directement un petit script qui m'automatise toute la configuration : https://github.com/PAPAMICA/terminal {.github} ```bash apt update && apt install -y curl && curl -Ls https://raw.githubusercontent.com/PAPAMICA/terminal/main/server_utils.sh | bash -s -- --motd --all-users ``` ## Changer l'adresse IP J'édite le fichier `/etc/network/interfaces` avec ces lignes : ```bash # The primary network interface allow-hotplug ens18 iface ens18 inet static address 10.10.0.250 netmask 255.255.255.0 gateway 10.10.0.1 dns-nameservers 10.10.0.1 1.1.1.1 ``` ## Redémarrer le serveur Et on applique toutes nos modifications avec un petit reboot : ``` reboot ``` > Il faut bien évidemment faire pareil sur les 3 serveurs en changeant les hostnames et les IP {.is-info} ![k3s](https://cncf-branding.netlify.app/img/projects/k3s/horizontal/color/k3s-horizontal-color.png) # Installer de K3S ## Installation du Master J'installe K3S sur le master avec commande : ```bash curl -sfL https://get.k3s.io | sh - ``` ## Récupération du Token On peux récupérer le token de connexion au cluster sur le master : ```bash cat /var/lib/rancher/k3s/server/node-token ``` ## Installation des Nodes On installe K3S et on rejoins le cluster avec cette commande sur les nodes : ```bash curl -sfL https://get.k3s.io | K3S_URL=https://:6443 K3S_TOKEN= sh - ``` ## Vérification Deux petites commandes pour vérifier l'état du cluster à faire sur le master : ```bash # Vérification des services essentiels : kubectl get pods -A # Résultat attendu : NAMESPACE NAME READY STATUS RESTARTS AGE kube-system local-path-provisioner-76d776f6f9-zfvl2 1/1 Running 0 16m kube-system coredns-59b4f5bbd5-pq9tc 1/1 Running 0 16m kube-system helm-install-traefik-crd-2zcts 0/1 Completed 0 16m kube-system helm-install-traefik-fp9r2 0/1 Completed 1 16m kube-system svclb-traefik-9b862d50-55xl9 2/2 Running 0 6m15s kube-system traefik-57c84cf78d-xz84t 1/1 Running 0 6m15s kube-system metrics-server-7b67f64457-7tvs2 1/1 Running 0 16m kube-system svclb-traefik-9b862d50-hmmgj 2/2 Running 0 63s kube-system svclb-traefik-9b862d50-w92rm 0/2 Pending 0 13s # Vérification des noeuds : kubectl get nodes # Résultat attendu : NAME STATUS ROLES AGE VERSION node01 Ready 3m23s v1.26.5+k3s1 master01 Ready control-plane,master 18m v1.26.5+k3s1 node02 NotReady 2m34s v1.26.5+k3s1 ``` > Le cluster K3S est prêt pour nos premiers tests ! {.is-success}