miroir de
https://github.com/PAPAMICA/Wiki-Tech.io.git
synchronisé 2025-01-05 22:50:54 +01:00
228 lignes
8 Kio
Markdown
228 lignes
8 Kio
Markdown
---
|
|
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
|
|
---
|
|
|
|
|
|
|
|
# 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 :
|
|
|
|
|
|
|
|
[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)"
|
|
```
|
|
|
|
|
|
|
|
## 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` :
|
|
|
|
|
|
> 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é :
|
|
|
|
|
|
|
|
Et on lui ajoute les bonnes permissions :
|
|
|
|
|
|
|
|
## 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://<IP_DU_PROXMOX>:8006/api2/json"
|
|
pm_user = "terraform@pve"
|
|
pm_password = "<MOT_DE_PASSE>"
|
|
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 = "<NOM_DU_SERVER_PROXMOX>"
|
|
node_qemuga = 1
|
|
node_pool = ""
|
|
node_size_disk = "32G"
|
|
node_bootauto = true
|
|
node_template = "<NOM_DU_TEMPLATE>"
|
|
node_storage_disk = "<NOM_DE_VOTRE_STORAGE>"
|
|
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 :
|
|
|
|
|
|
## Préparer les serveurs
|
|
### Changer le hostname
|
|
```bash
|
|
hostnamectl set-hostname <NOM_DU_SERVER>
|
|
```
|
|
|
|
### 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}
|
|
|
|
|
|
|
|
# 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://<IP_DU_MASTER>:6443 K3S_TOKEN=<TOKEN_DE_CONNEXION> 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 <none> 3m23s v1.26.5+k3s1
|
|
master01 Ready control-plane,master 18m v1.26.5+k3s1
|
|
node02 NotReady <none> 2m34s v1.26.5+k3s1
|
|
|
|
```
|
|
|
|
> Le cluster K3S est prêt pour nos premiers tests !
|
|
{.is-success}
|
|
|