Quickstart : vos premiers pas sur la plateforme - Documentation technique Kaeyros

Ce guide condense ce qu’il faut faire pendant votre première semaine pour être opérationnel sur la plateforme Kaeyros. Il regroupe les demandes d’accès, l’installation des outils et les commandes en lecture seule à passer avant toute modification.

1. Demandez vos accès dès le premier jour

Certains accès prennent du temps. Faites la demande auprès de l’équipe infrastructure dès votre arrivée.

Accès organisationnels

Organisation GitHub kaeyros-analytics-org
Passbolt (coffre d’équipe)
Kubeconfig nominatif pour le cluster
ArgoCD, Grafana, Alertmanager

Selon votre rôle

Console Hetzner, Cloudflare, AWS
Odoo, Taiga

Rangez votre kubeconfig

Votre kubeconfig est personnel. Il ne se partage pas, ne se colle pas dans un ticket ou une conversation, et se range dans Passbolt. Si vous pensez qu’il a fuité, signalez-le immédiatement : il est révocable en quelques minutes.

2. Installez les outils

# kubectl
brew install kubernetes-cli

# Plugin Argo Rollouts (indispensable pour suivre un déploiement)
kubectl krew install argo-rollouts

# CLI ArgoCD
brew install argocd

# Helm : pour rendre un chart localement avant de pousser
brew install helm

# Utile
brew install jq k9s

# kubectl
curl -LO "https://dl.k8s.io/release/$(curl -Ls https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl

# Plugin Argo Rollouts
kubectl krew install argo-rollouts

# CLI ArgoCD, Helm, jq, k9s : voir la documentation officielle de chaque outil

k9s n’est pas obligatoire, mais c’est le moyen le plus rapide de se promener dans un cluster de 600 pods quand on débute.

3. Passez vos premières commandes

Toutes en lecture seule. Prenez le temps de les passer avant de modifier quoi que ce soit.

Reconnaissance

kubectl get nodes -o wide                      # les 4 machines
kubectl get ns                                 # les 100 namespaces
kubectl get pods -A | wc -l                    # l'échelle
kubectl -n argocd get applications             # les ~326 applications

Choisissez un produit et suivez-le de bout en bout :

Suivre un produit

kubectl -n biolab get pods,svc,ingress
kubectl -n biolab get pods -o jsonpath='{.items[*].spec.containers[*].image}{"\n"}'
kubectl -n argocd get app biolab-prod-api -o yaml | head -40

Puis, dans le dépôt cloné :

Rendre un chart

# Rendre un chart localement : c'est exactement ce que fait ArgoCD
helm template test charts/rollout-v2 -f values/biolab/api-prod.yaml -n biolab | less

Cette dernière commande est votre meilleur outil d’apprentissage. Elle vous montre les manifestes Kubernetes réels produits par un fichier de valeurs.

4. Cochez votre checklist de la première semaine

Tous les accès obtenus, kubeconfig rangé dans Passbolt
Outils installés, kubectl get nodes fonctionne
Dépôt argo-production cloné, docs/ lu en entier
Un helm template passé sur une application existante
Un pod suivi de bout en bout : Ingress → Service → pod → base
Un nom de pod décodé sans aide (voir Lire un nom de pod)
Interface ArgoCD parcourue, une application observée en cours de synchronisation
Un tableau de bord Grafana ouvert
Première modification en dev : ajouter une variable d’environnement, la voir apparaître dans le pod

Et ensuite

Comprendre la plateforme

Ce que fait Kaeyros, son modèle technique, ses ordres de grandeur.

Modèle GitOps

Le mécanisme central de la plateforme.

Tâches courantes

Déployer, revenir en arrière, ajouter un secret.

Pièges à connaître

À lire avant de les rencontrer.

​1. Demandez vos accès dès le premier jour

​2. Installez les outils

​3. Passez vos premières commandes

​4. Cochez votre checklist de la première semaine

​Et ensuite

Comprendre la plateforme

Modèle GitOps

Tâches courantes

Pièges à connaître

1. Demandez vos accès dès le premier jour

2. Installez les outils

3. Passez vos premières commandes

4. Cochez votre checklist de la première semaine

Et ensuite