Premiers pas avec Atlas

Ce tutoriel vous guidera à travers les premières étapes pour commencer à utiliser la plateforme Atlas.

Prérequis

Avoir un compte sur la plateforme Atlas
Avoir les droits appropriés (administrateur d'organisation, administrateur de workspace, ou autre rôle selon votre cas d'utilisation)

Accès à la plateforme

Accédez à la plateforme Atlas via l'URL https://atlas.fabrique.social.gouv.fr/
Connectez-vous en utilisant vos identifiants (l'authentification se fait via OIDC)
Si vous n'avez pas de compte, contactez les administrateurs de la plateforme

Interface principale

Une fois connecté, vous aurez accès aux différents outils de la plateforme :

ArgoCD : Pour visualiser les ressources déployées
Grafana : Pour consulter les métriques des ressources
Vault : Pour gérer les secrets
Keycloak : Pour gérer votre compte utilisateur

Comprendre votre rôle

Selon votre rôle, vous aurez différentes permissions :

Administrateur de la plateforme : Vous pouvez créer des zones, des organisations et des workspaces
Administrateur d'organisation : Vous pouvez créer des workspaces dans votre organisation
Administrateur de workspace : Vous pouvez créer des ressources (buckets, databaseclusters, deploymenttargets) dans votre workspace
Autres rôles : Vous pouvez avoir des permissions spécifiques sur certains DeploymentTargets

Workflow actuel et évolution future

Note importante sur l'évolution future : Le mode de fonctionnement actuel basé sur GitOps sera dans un futur proche remplacé par un portail complet où les utilisateurs pourront commander leurs ressources via un formulaire web. À terme, le dépôt GitOps ne sera qu'un détail d'implémentation. Cette documentation reflète le fonctionnement présent de la plateforme.

Actuellement, Atlas utilise une approche GitOps pour la gestion des ressources :

Les ressources sont définies dans des fichiers YAML
Ces fichiers sont stockés dans des dépôts Git
Les changements sont automatiquement appliqués lorsqu'ils sont poussés vers le dépôt

Structure des dépôts

Dépôt d'organisation : Pour créer des workspaces
Dépôt de workspace : Pour créer des ressources (buckets, databaseclusters, deploymenttargets) et déployer des applications

Prochaines étapes

Maintenant que vous êtes familiarisé avec les bases de la plateforme Atlas, vous pouvez passer aux tutoriels suivants :