Résolution des problèmes

Ce document fournit des solutions aux problèmes courants que vous pourriez rencontrer lors de l'utilisation de la plateforme Atlas.

Problèmes de déploiement

Les ressources ne se déploient pas dans ArgoCD

Symptômes : Vous avez poussé des changements vers votre dépôt GitOps, mais les ressources n'apparaissent pas dans ArgoCD ou restent en état "OutOfSync".

Causes possibles : - Erreurs de syntaxe dans les fichiers YAML - Problèmes de permissions - Problèmes de connexion entre ArgoCD et le dépôt Git

Solutions : 1. Vérifiez la syntaxe de vos fichiers YAML avec un validateur YAML 2. Assurez-vous que les fichiers sont placés dans les bons dossiers (resources/ pour les ressources workspace, deployment-targets/<nom-du-deployment-target>/ pour les ressources de déploiement) 3. Vérifiez les logs dans ArgoCD pour identifier les erreurs spécifiques 4. Assurez-vous que vous avez les droits nécessaires pour créer les ressources 5. Vérifiez que ArgoCD a accès à votre dépôt Git

Erreur "Resource already exists" lors de la création d'une ressource

Symptômes : Vous essayez de créer une ressource, mais vous obtenez une erreur indiquant que la ressource existe déjà.

Causes possibles : - Une ressource avec le même nom existe déjà - La ressource a été supprimée mais n'a pas été complètement nettoyée

Solutions : 1. Utilisez un nom différent pour votre ressource 2. Vérifiez si la ressource existe déjà dans ArgoCD ou Kubernetes 3. Si la ressource a été supprimée mais persiste, contactez l'administrateur de la plateforme pour un nettoyage manuel

Problèmes d'accès

Impossible de se connecter à la plateforme

Symptômes : Vous ne pouvez pas vous connecter à l'interface Atlas ou à ArgoCD.

Causes possibles : - Problèmes d'authentification - Session expirée - Problèmes de réseau

Solutions : 1. Vérifiez vos identifiants de connexion 2. Essayez de vous déconnecter et de vous reconnecter 3. Vérifiez votre connexion réseau 4. Contactez l'administrateur de la plateforme si le problème persiste

Accès refusé aux ressources

Symptômes : Vous pouvez vous connecter à la plateforme, mais vous ne pouvez pas accéder à certaines ressources ou effectuer certaines actions.

Causes possibles : - Permissions insuffisantes - Rôle incorrect attribué à votre compte

Solutions : 1. Vérifiez vos rôles et permissions dans Keycloak 2. Demandez à l'administrateur de votre organisation ou de votre workspace de vous attribuer les rôles nécessaires 3. Assurez-vous que vous accédez aux ressources du bon workspace ou de la bonne organisation

Problèmes de bases de données

Impossible de se connecter à la base de données

Symptômes : Votre application ne peut pas se connecter à la base de données, ou vous obtenez des erreurs de connexion.

Causes possibles : - Secrets mal configurés - Problèmes de réseau - Base de données non disponible

Solutions : 1. Vérifiez que les secrets ont été correctement livrés au DeploymentTarget 2. Vérifiez que votre application utilise les bonnes informations de connexion 3. Pour les bases de données managées, vérifiez que l'adresse IP de votre application est autorisée 4. Vérifiez l'état de la base de données dans ArgoCD

Erreurs de performance de la base de données

Symptômes : La base de données est lente ou ne répond pas.

Causes possibles : - Ressources insuffisantes - Requêtes non optimisées - Trop de connexions simultanées

Solutions : 1. Augmentez les ressources allouées à la base de données (CPU, mémoire) 2. Optimisez vos requêtes et votre schéma de base de données 3. Utilisez un pool de connexions pour gérer les connexions à la base de données 4. Surveillez les métriques de la base de données dans Grafana

Problèmes de secrets

Les secrets ne sont pas livrés au DeploymentTarget

Symptômes : Les secrets d'une ressource (bucket, base de données) ne sont pas disponibles dans votre DeploymentTarget, ou votre application ne peut pas accéder aux secrets.

Causes possibles : - Le DeploymentTarget n'est pas correctement spécifié dans le champ secretDeliveryTargets - Problèmes de permissions - Problèmes avec External Secrets Operator - La ressource n'a pas été correctement créée

Solutions : 1. Vérifiez que le DeploymentTarget est correctement spécifié dans le champ secretDeliveryTargets de la ressource 2. Assurez-vous que vous avez les droits nécessaires sur le DeploymentTarget 3. Vérifiez l'état de l'ExternalSecret et du SecretStore : ```bash # Vérifier l'état de l'ExternalSecret kubectl get externalsecret -n

# Afficher les détails de l'ExternalSecret pour diagnostiquer les problèmes kubectl describe externalsecret -n

# Vérifier l'état du SecretStore kubectl get secretstore -n

# Afficher les détails du SecretStore pour diagnostiquer les problèmes kubectl describe secretstore -n ``` 4. Vérifiez que la ressource (bucket, base de données) a été correctement créée et que son statut est "Ready" 5. Si le problème persiste, contactez l'administrateur de la plateforme

Erreurs d'accès aux secrets dans Vault

Symptômes : Vous ne pouvez pas accéder aux secrets dans Vault, ou vous obtenez des erreurs d'autorisation.

Causes possibles : - Problèmes d'authentification - Permissions insuffisantes - Chemin incorrect

Solutions : 1. Vérifiez que vous êtes correctement authentifié dans Vault 2. Assurez-vous que vous avez les permissions nécessaires pour accéder aux secrets 3. Vérifiez que vous utilisez le bon chemin pour accéder aux secrets 4. Contactez l'administrateur de la plateforme si le problème persiste

Problèmes de stockage

Impossible d'accéder au bucket S3

Symptômes : Votre application ne peut pas accéder au bucket S3, ou vous obtenez des erreurs d'accès.

Causes possibles : - Secrets mal configurés - Problèmes de permissions - Bucket non disponible

Solutions : 1. Vérifiez que les secrets ont été correctement livrés au DeploymentTarget 2. Vérifiez que votre application utilise les bonnes informations de connexion 3. Vérifiez que l'ACL du bucket est correctement configurée 4. Vérifiez l'état du bucket dans ArgoCD

Erreurs lors du téléchargement ou du téléversement de fichiers

Symptômes : Vous ne pouvez pas télécharger ou téléverser des fichiers dans le bucket S3.

Causes possibles : - Problèmes de permissions - Fichiers trop volumineux - Problèmes de réseau

Solutions : 1. Vérifiez les permissions du bucket 2. Vérifiez la taille des fichiers que vous essayez de télécharger ou de téléverser 3. Essayez de diviser les fichiers volumineux en plusieurs parties 4. Vérifiez votre connexion réseau

Problèmes de GitOps

Les changements ne sont pas appliqués après un push

Symptômes : Vous avez poussé des changements vers votre dépôt GitOps, mais ils ne sont pas appliqués.

Causes possibles : - Problèmes de synchronisation avec ArgoCD - Erreurs dans les fichiers YAML - Problèmes de permissions

Solutions : 1. Vérifiez l'état de synchronisation dans ArgoCD 2. Vérifiez les logs dans ArgoCD pour identifier les erreurs 3. Assurez-vous que les fichiers sont placés dans les bons dossiers 4. Vérifiez que vous avez les droits nécessaires pour appliquer les changements

Conflits Git lors des pushes

Symptômes : Vous obtenez des erreurs de conflit lors des pushes vers le dépôt GitOps.

Causes possibles : - Plusieurs personnes modifient les mêmes fichiers - Branches non synchronisées

Solutions : 1. Tirez les derniers changements avant de pousser les vôtres 2. Résolvez les conflits manuellement 3. Utilisez des branches séparées pour les différentes fonctionnalités 4. Coordonnez les changements avec votre équipe

Problèmes de réseau

Impossible d'accéder aux services déployés

Symptômes : Vous ne pouvez pas accéder aux services déployés via leur URL.

Causes possibles : - Problèmes de configuration de l'Ingress - Services non déployés correctement - Problèmes de réseau

Solutions : 1. Vérifiez la configuration de l'Ingress 2. Assurez-vous que les services sont correctement déployés 3. Vérifiez que les pods sont en état "Running" 4. Vérifiez les logs des pods pour identifier les erreurs

Problèmes de communication entre les services

Symptômes : Les services déployés ne peuvent pas communiquer entre eux.

Causes possibles : - Problèmes de configuration du réseau - Problèmes de DNS - Problèmes de sécurité

Solutions : 1. Vérifiez que les services utilisent les bons noms de service pour la communication 2. Assurez-vous que les services sont dans le même namespace ou que la communication entre namespaces est autorisée 3. Vérifiez les politiques de sécurité réseau 4. Vérifiez les logs des services pour identifier les erreurs de communication

Contacter le support

Si vous ne parvenez pas à résoudre votre problème avec les solutions proposées ci-dessus, vous pouvez contacter le support de la plateforme Atlas :

Ouvrez un ticket de support via le portail Atlas
Fournissez une description détaillée du problème
Incluez les logs pertinents
Mentionnez les étapes que vous avez déjà essayées pour résoudre le problème

L'équipe de support vous aidera à diagnostiquer et à résoudre votre problème dans les plus brefs délais.