Foire Aux Questions (FAQ)

Cette FAQ répond aux questions fréquemment posées sur la plateforme Atlas.

Questions générales

Qu'est-ce que la plateforme Atlas ?

Atlas est une plateforme cloud native qui permet aux équipes de développement de déployer et gérer facilement leurs applications et ressources associées (bases de données, stockage, etc.) en utilisant une approche GitOps. Elle est conçue pour simplifier le déploiement et la gestion des applications dans un environnement Kubernetes.

Quels sont les avantages d'utiliser Atlas ?

Approche GitOps : Toute la configuration est stockée dans Git, ce qui permet un suivi des modifications et une collaboration efficace
Isolation des ressources : Les ressources sont isolées par workspace et par environnement
Automatisation : Les déploiements sont automatisés via ArgoCD
Gestion simplifiée des ressources : Création et gestion simplifiées des bases de données, buckets S3, etc.
Sécurité intégrée : Gestion des secrets via Vault, authentification via Keycloak

Qui peut utiliser Atlas ?

Atlas est destiné aux équipes de développement qui souhaitent déployer et gérer leurs applications dans un environnement Kubernetes sans avoir à gérer la complexité de l'infrastructure sous-jacente. Les utilisateurs peuvent avoir différents rôles, tels qu'administrateur de plateforme, administrateur d'organisation, administrateur de workspace ou utilisateur standard.

Comment puis-je commencer à utiliser Atlas ?

Pour commencer à utiliser Atlas, vous devez : 1. Obtenir un compte sur la plateforme 2. Être ajouté à une organisation et un workspace par un administrateur 3. Suivre les tutoriels de démarrage pour créer votre premier workspace et déployer votre première application

Architecture et concepts

Quelle est la différence entre une Organisation et un Workspace ?

Organisation : Entité administrative correspondant typiquement à un département ou une direction ayant la responsabilité de plusieurs projets.
Workspace : Espace de travail dédié à un projet spécifique, géré par les administrateurs d'organisation. Un workspace encapsule l'ensemble des ressources et environnements nécessaires à un projet particulier.

Qu'est-ce qu'un DeploymentTarget ?

Un DeploymentTarget représente un environnement de déploiement spécifique (branche de fonctionnalité, développement, préproduction, production) configuré par les administrateurs de workspace. Chaque DeploymentTarget se matérialise par un namespace Kubernetes dédié dans le cluster de la zone spécifiée.

Comment fonctionne l'approche GitOps dans Atlas ?

Dans Atlas, l'approche GitOps signifie que toute la configuration est stockée dans des dépôts Git : - Un dépôt par organisation pour la gestion des workspaces - Un dépôt par workspace pour la définition des ressources et des environnements

Les changements sont automatiquement appliqués lorsqu'ils sont poussés vers le dépôt, grâce à ArgoCD qui surveille les dépôts et synchronise l'état du cluster avec l'état souhaité défini dans les dépôts.

Gestion des ressources

Quels types de ressources puis-je créer dans Atlas ?

Vous pouvez créer plusieurs types de ressources dans Atlas : - DeploymentTargets (environnements de déploiement) - Buckets S3 (stockage d'objets) - DatabaseClusters (bases de données PostgreSQL) - Secrets (informations sensibles) - Et toutes les ressources Kubernetes standard (Deployments, Services, Ingress, etc.)

Comment puis-je créer une base de données ?

Pour créer une base de données, vous devez : 1. Créer un fichier YAML définissant un DatabaseCluster dans le dossier resources de votre dépôt workspace 2. Spécifier le type d'implémentation (CNPG pour développement/test, Managed pour production) 3. Configurer les paramètres (version, taille du disque, réplicas, etc.) 4. Spécifier les DeploymentTargets auxquels livrer les secrets 5. Pousser les changements vers le dépôt

Pour plus de détails, consultez le tutoriel Configurer une base de données.

Comment puis-je créer un bucket S3 ?

Pour créer un bucket S3, vous devez : 1. Créer un fichier YAML définissant un Bucket dans le dossier resources de votre dépôt workspace 2. Configurer les paramètres (nom, ACL, versioning, etc.) 3. Spécifier les DeploymentTargets auxquels livrer les secrets 4. Pousser les changements vers le dépôt

Pour plus de détails, consultez le tutoriel Utiliser un bucket S3.

Comment puis-je accéder aux secrets de mes ressources ?

Les secrets des ressources (bases de données, buckets S3) sont automatiquement livrés aux DeploymentTargets spécifiés dans la configuration. Vous pouvez y accéder de deux façons : 1. Via Vault, en naviguant vers le chemin correspondant à votre DeploymentTarget 2. Via les secrets Kubernetes, en montant le secret dans votre application ou en utilisant les variables d'environnement

Déploiement d'applications

Comment puis-je déployer une application ?

Pour déployer une application, vous devez : 1. Créer un DeploymentTarget dans le dossier resources de votre dépôt workspace 2. Créer les manifestes Kubernetes de votre application dans le dossier deployment-targets/<nom-du-deployment-target>/ 3. Pousser les changements vers le dépôt

Pour plus de détails, consultez le tutoriel Déployer votre première application.

Puis-je utiliser Helm pour déployer mes applications ?

Oui, vous pouvez utiliser Helm de deux façons : 1. En spécifiant des charts dans la définition du DeploymentTarget (fonctionnalité expérimentale) 2. En utilisant helm template pour générer des manifestes Kubernetes et en les poussant dans le dépôt GitOps (méthode recommandée)

Comment puis-je mettre à jour mon application ?

Pour mettre à jour votre application, vous devez : 1. Modifier les manifestes Kubernetes dans le dossier deployment-targets/<nom-du-deployment-target>/ 2. Pousser les changements vers le dépôt 3. ArgoCD détectera automatiquement les changements et mettra à jour votre application

Comment puis-je déployer plusieurs environnements (dev, staging, prod) ?

Pour déployer plusieurs environnements, vous devez : 1. Créer un DeploymentTarget pour chaque environnement, en spécifiant la zone appropriée 2. Créer les manifestes Kubernetes pour chaque environnement dans les dossiers deployment-targets/<nom-du-deployment-target>/ correspondants 3. Adapter la configuration de chaque environnement selon vos besoins (réplicas, ressources, etc.)

Sécurité et accès

Comment puis-je gérer les secrets dans Atlas ?

Les secrets dans Atlas sont gérés via Vault. Les secrets des ressources (bases de données, buckets S3) sont automatiquement livrés aux DeploymentTargets spécifiés dans la configuration. Pour les autres secrets, vous pouvez utiliser External Secrets Operator pour récupérer des secrets depuis Vault et les injecter dans votre application.

Comment puis-je donner accès à mon workspace à un nouveau membre de l'équipe ?

Pour donner accès à votre workspace à un nouveau membre de l'équipe, vous devez : 1. Demander à l'administrateur de la plateforme de créer un compte pour le nouveau membre 2. Demander à l'administrateur de l'organisation d'attribuer le rôle approprié au nouveau membre 3. Si vous êtes administrateur de workspace, vous pouvez attribuer des rôles spécifiques au nouveau membre pour les différents DeploymentTargets

Surveillance et débogage

Comment puis-je surveiller mes applications ?

Vous pouvez surveiller vos applications de plusieurs façons : 1. Via ArgoCD, pour vérifier l'état de déploiement 2. Via Grafana, pour consulter les métriques des ressources déployées 3. Via les logs des pods, accessibles via Kubernetes Dashboard ou via la ligne de commande

Comment puis-je accéder aux logs de mes applications ?

Vous pouvez accéder aux logs de vos applications de plusieurs façons : 1. Via Kubernetes Dashboard, en naviguant vers les pods de votre application 2. Via la ligne de commande, en utilisant kubectl logs 3. Via un système de gestion de logs centralisé, si disponible sur la plateforme

Comment puis-je déboguer une application qui ne démarre pas ?

Pour déboguer une application qui ne démarre pas, vous pouvez : 1. Vérifier l'état des pods dans Kubernetes Dashboard ou via kubectl get pods 2. Consulter les logs des pods pour identifier les erreurs 3. Vérifier les événements Kubernetes pour détecter des problèmes de ressources ou de configuration 4. Vérifier que les secrets nécessaires sont correctement montés 5. Utiliser un pod de débogage pour tester la connectivité et l'accès aux ressources

Maintenance et support

Comment puis-je mettre à jour les ressources de mon workspace ?

Pour mettre à jour les ressources de votre workspace, vous devez : 1. Modifier les fichiers YAML correspondants dans le dossier resources de votre dépôt workspace 2. Pousser les changements vers le dépôt 3. ArgoCD détectera automatiquement les changements et mettra à jour les ressources

Comment puis-je supprimer une ressource ?

Pour supprimer une ressource, vous devez : 1. Supprimer le fichier YAML correspondant du dossier resources de votre dépôt workspace 2. Pousser les changements vers le dépôt 3. ArgoCD détectera automatiquement les changements et supprimera la ressource

Attention : La suppression de certaines ressources (comme les DatabaseClusters ou les Buckets) peut entraîner la perte de données. Assurez-vous de sauvegarder vos données importantes avant de supprimer ces ressources.

Comment puis-je obtenir de l'aide en cas de problème ?

Si vous rencontrez un problème avec la plateforme Atlas, vous pouvez : 1. Consulter la documentation, notamment la section Résolution des problèmes 2. Contacter l'administrateur de votre organisation ou de votre workspace 3. Ouvrir un ticket de support via le portail Atlas 4. Contacter l'équipe de support par email ou via le canal de communication dédié

La plateforme Atlas est-elle disponible 24/7 ?

Oui, la plateforme Atlas est conçue pour être disponible 24/7. Cependant, des maintenances planifiées peuvent être nécessaires occasionnellement. Ces maintenances sont généralement annoncées à l'avance et planifiées pour minimiser l'impact sur les utilisateurs.