> ## Documentation Index
> Fetch the complete documentation index at: https://infra-docs.kaeyros.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart : vos premiers pas sur la plateforme

> Les accès à demander, les outils à installer et les premières commandes à passer pour prendre en main la plateforme 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.

**1. Accès organisationnels**

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

**2. Selon votre rôle**

* Console Hetzner, Cloudflare, AWS
* Odoo, Taiga

**3. 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

```bash macOS theme={null}
# 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
```

```bash Linux theme={null}
# 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
```

> [!TIP]
>
> `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.

```bash Reconnaissance theme={null}
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 :

```bash Suivre un produit theme={null}
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é :

```bash Rendre un chart theme={null}
# 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
```

> [!NOTE]
>
> 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](https://infra-docs.kaeyros.org/deploiement/nom-de-pod.md))
* [ ] 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](https://infra-docs.kaeyros.org/comprendre/kaeyros-et-sa-plateforme.md)**
>
> Ce que fait Kaeyros, son modèle technique, ses ordres de grandeur.

> **[Modèle GitOps](https://infra-docs.kaeyros.org/deploiement/gitops-principe.md)**
>
> Le mécanisme central de la plateforme.

> **[Tâches courantes](https://infra-docs.kaeyros.org/operations/deployer-version.md)**
>
> Déployer, revenir en arrière, ajouter un secret.

> **[Pièges à connaître](https://infra-docs.kaeyros.org/operations/pieges.md)**
>
> À lire avant de les rencontrer.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.