direktil/docs
4
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update documentation for quickstart

Browse Source
This commit is contained in:
Guillaume
2025-11-02 18:32:45 +01:00
parent a0bc037be0
commit f45e65f4c3
1 changed files with 4 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
content/quick-start/_index.md
View File

@ -41,7 +41,7 @@ cp kubeconfig ~/.kube/config
## Récupération de la configuration de départ
Nous avons compilé une configuration suffisante à la plupart des cas de figure, disponible sur notre [repository git](https://novit.tech/direktil/config). Vous pouvez alors soit [télécharger l'archive complète](https://novit.tech/direktil/config/archive/main.tar.gz) comme base de travail, ou alors [cloner le repo directement](git@novit.tech:direktil/config.git).
Nous avons compilé une configuration suffisante à la plupart des cas de figure, disponible sur notre [repository git](https://novit.tech/direktil/config). Vous pouvez alors soit [télécharger l'archive complète](https://novit.tech/direktil/config/archive/main.tar.gz) comme base de travail, ou alors cloner le repo directement via ssh: git@novit.tech:direktil/config.git.
A noter que cette configuration de départ présente une installation de cluster mono-noeud (master/compute). Il est tout à fait possible de la modifier pour spécifier 3 noeuds et ainsi avoir un cluster redondant et déjà prod-ready.
@ -96,28 +96,16 @@ L'utilisateur local `root` n'a pas de mot de passe spécifié mais ne peut évid
Cette étape rapide demande de se connecter aux machines et d'activer le control plane pour démarrer le cluster. Cela ne peut se faire de façon automatisée seulement si vous avez ajouté votre clé SSH à la configuration avant l'installation (voir partie *Modification de la configuration*). La manuelle est disponible ci-dessous dans les autres cas.
{{< notice info >}}
Dans tous les cas, il n'est nécessaire de faire cette opération qu'une seule fois par cluster. Egalement, ces commandes doivent à partir de maintenance être lancées avec votre utilisateur système local et non *root*
Dans tous les cas, il n'est nécessaire de faire cette opération qu'une seule fois par cluster. Également, ces commandes doivent à partir de maintenant être lancées avec votre utilisateur système local et non *root*
{{< /notice >}}
{{< tabs >}}
{{% tab name="Automatisée" %}}
```bash
./scripts/2.first_start_k8s.sh
```
{{% /tab %}}
{{% tab name="Manuel" %}}
Sans connexion SSH, il est possible de d'activer le cluster Kubernetes en utilisant la console Qemu. Le compte à utiliser est "root", sans mot de passe. Y lancer alors les commandes suivantes:
```bash
loadkeys fr # Pour passer en clavier AZERTY, si besoin
mv /etc/kubernetes/manifests.static/* /var/lib/kubernetes/manifests/
```
{{% /tab %}}
{{< /tabs >}}
Cette étape sert également à la mise en place des addons. Dans les addons devant être installés dans le cluster, nous pouvons citer un fournisseur d'overlay réseau, kube-proxy, un contrôleur ingress, un dashboard, un coredns local, etc...
Enfin, un cluster kubernetes sécurisé et fonctionnel nécessite des certificats TLS pour toute communication intra-cluster. Ce rôle de les générer est à majorité celui du DLS, à l'exception de deux certificats, tous deux utilisés par le processus Kubelet de la machine nouvellement installés (voir [TLS Bootstraping](https://kubernetes.io/docs/reference/access-authn-authz/kubelet-tls-bootstrapping/)). Ceux-là sont générés automatiquement au sein de Kubernetes mais nécessitent une approbation manuelle, ce qui est géré par ce script par facilité.
Enfin, un cluster kubernetes sécurisé et fonctionnel nécessite des certificats TLS pour toute communication intra-cluster. Ce rôle de les générer est à majorité celui du DLS, à l'exception de deux certificats, tous deux utilisés par le processus Kubelet de la machine nouvellement installée (voir [TLS Bootstraping](https://kubernetes.io/docs/reference/access-authn-authz/kubelet-tls-bootstrapping/)). Ceux-là sont générés automatiquement au sein de Kubernetes mais nécessitent une approbation manuelle, ce qui est géré par ce script par facilité.
## Utilisation du cluster
@ -151,7 +139,7 @@ Les commandes ci-dessous vont supprimer toutes machines virtuelles et clusters k
{{% /notice %}}
{{< highlight bash >}}
# ATTENTION, CELA SUPPRIMERA TOUTES LES DONNEES
# ATTENTION, CELA SUPPRIMERA TOUTES LES DONNÉES
sudo ./scripts/.cleanup.sh
{{< /highlight >}}