Développeur atlas — le point d'entrée

Page récapitulative pour le développeur data qui travaille dans le dépôt applicatif atlas et consomme la plateforme. Tout ce qui est utile, en un endroit.

Frontière (ADR 0022 / 0023). Vous écrivez le code métier (assets, pipelines, requêtes) dans atlas ; l’infrastructure (générique) vit dans ce dépôt. Vous poussez du contenu ; le socle fournit le contenant vide. Vous ne faites jamais de kubectl apply de vos workflows — Argo CD les réconcilie depuis Gitea.

Démarrer en deux commandes (banc local)

# 1. Monter le banc (topologie multi-node-3, chemin atlas, profil léger)
bench/lima/run-phases.sh atlas

# 2. Tout brancher : URLs cliquables + secrets regroupés + ../atlas/.env.cluster.local
bench/lima/access.sh

Puis travaillez dans atlas et git push (le webhook Gitea → Argo CD réconcilie). Détail pas à pas : guide du développeur data.

Comprendre la plateforme

Page	Pour quoi
Composants — la pile technologique	Ce que fait chaque brique (PostgreSQL/CNPG, Dagster, Marquez, MLflow, Argo CD, Gitea, Ceph, Cilium…) et pourquoi elle est là
Guide du développeur data	Comment se brancher : endpoints, secrets, paramétrage, boucle GitOps, accès local
Glossaire	Définitions courtes des termes techniques
Chaîne DataOps (accès & vérifs)	Vue d’ensemble Dagster → CNPG → Marquez + suivi de modèles MLflow

Se brancher — le contrat d’interface

Source machine-lisible de ce que le socle expose (ADR 0043) :

Artefact	Contenu
`contract/`	Vue d’ensemble du contrat
`contract/endpoints.example.yaml`	Services : FQDN, port, auth, UI
`contract/storage-classes.example.yaml`	StorageClasses par profil
`contract/namespaces-secrets.example.yaml`	Namespaces de destination + conventions de secrets
`contract/atlas.env.cluster.example`	Patron du `.env` consommé par atlas (généré par `access.sh`)

Commandes utiles (banc Lima)

bench/lima/run-phases.sh atlas      # monter le socle complet (GitOps + DataOps)
bench/lima/run-phases.sh status     # état du banc (VMs, nœuds, phases, UIs)
bench/lima/access.sh                # URLs + secrets + .env atlas
bench/lima/access.sh --stop         # arrêter les tunnels + retirer le bloc /etc/hosts
bench/lima/run-phases.sh down       # détruire le banc

Harnais du banc : bench/lima/ · validations : bench/lima/RESULTS.md
Init du dépôt Gitea (org/repo + webhook) : bench/lima/gitea-init.sh

Décisions qui vous concernent (ADR)

ADR	Sujet
0022	Frontière infra (Ansible) / applicatif (Argo CD)
0043	Contrat d’interface cluster → atlas
0044	Topologie du banc atlas (Gitea intra-banc, webhook)
0045	Chemins d’installation nommés (`atlas`, `atlas-ceph`…)
0048	Accès local développeur (`access.sh`)
0023	Valeurs génériques, config locale non versionnée

Index complet : décisions (ADR).

Où vit quoi

Code métier, images, workflows → dépôt atlas (assets Dagster, services, PWA).
Infra, manifestes, socle → ce dépôt (platform/, storage/, bootstrap/).
Secrets / valeurs réelles → config locale non versionnée (le .env généré par access.sh, gitignoré) — jamais commitées (ADR 0023).