Docs

Composants

À quoi sert cette page

Les pièces qui composent Fenwave, et laquelle soupçonner quand quelque chose déraille. C’est la page qui transforme « Fenwave est cassé » en une question précise.

Avant de commencer

Rien. Il s’agit de matériel de référence.

Les pièces

Pièce Ce qu’elle fait Symptômes quand elle est en cause
Interface web La barre latérale et tous les écrans de cette documentation Entrées de menu absentes (permissions), données périmées après un changement (cache de session)
Backend Fenwave Sert les APIs derrière chaque écran, et porte les registres Réponses 401 / 403 / 503 ; listes vides là où il devrait y avoir des données
Catalogue Le registre des composants, systèmes, APIs et propriétaires Quelque chose d’enregistré n’apparaît pas ; propriétaire vide
TechDocs Construit et sert la documentation depuis les dépôts L’onglet Docs d’un composant est vide ; un changement de langue renvoie une 404
Argo CD Exécute les déploiements Les déploiements n’avancent pas
Argo Workflows Exécute pipelines et exécutions de tests Pipelines et tests soumis mais jamais démarrés
Clusters Kubernetes Là où tout tourne réellement Workloads en boucle de crash, OOM kills, pods non planifiés
Comptes cloud Les identifiants via lesquels les clusters s’authentifient Des clusters deviennent invalides ensemble après une rotation
Stockage objet Buckets S3 / GCS Synchronisations en échec ; objets manquants à un préfixe
Fenwave Agent / DevApp Outillage de développement local sur votre machine Problèmes de configuration locale uniquement — sans lien avec la plateforme hébergée

Quelle pièce soupçonner

Ce que vous constatez Soupçonnez Allez à
Une entrée de menu manque Les permissions Access Explorer
Un 403 avec un nom de permission Les permissions Comment fonctionnent les permissions
Un 503 Une intégration non configurée La zone Settings concernée
Déploiements bloqués Argo CD Settings › Development › CI/CD
Pipelines ou tests qui ne démarrent pas Argo Workflows CI/CD — intégration distincte d’Argo CD
Plusieurs clusters invalides d’un coup L’identifiant cloud partagé Cloud
Un seul workload qui déraille Le cluster Cluster Console
Documentation absente ou 404 au changement de langue TechDocs Docs

Scénario

« Fenwave est down » — cerner le problème en cinq minutes.

Il est très rare que toute la plateforme soit hors service. Le travail consiste à trouver quelle pièce.

  1. La barre latérale se charge-t-elle ? Si oui, l’interface web et le backend sont vivants : ce n’est pas une panne globale — passez à l’étape 2.
  2. Le problème est-il confiné à une zone du menu ? Une seule zone en échec désigne l’intégration de cette zone, pas la plateforme.
  3. Déploiements bloqués mais pipelines corrects → Argo CD. Pipelines bloqués mais déploiements corrects → Argo Workflows. Les deux corrects mais un cluster qui déraille → le cluster.
  4. Plusieurs clusters invalides d’un coup → un identifiant cloud partagé a tourné. Un seul cluster invalide → ce cluster.
  5. Une seule personne affectée → permissions, pas infrastructure. Confirmez avec Access Explorer avant de chercher ailleurs.
  6. Signalez ce que vous avez cerné, pas « Fenwave est down ». La distinction entre les deux branches de l’étape 3 détermine généralement qui doit être réveillé.

En cas de problème

Symptôme Cause Comment vérifier Solution
Tout renvoie 503 Une intégration sous-jacente n’est pas configurée La zone Settings concernée Configurez-la et testez-la
Une personne affectée, les autres non Les permissions Access Explorer Accordez le bon rôle
Tout le monde affecté sur une zone L’intégration de cette zone Sa page Settings, « Last Tested » Testez-la et réparez-la
Données périmées après un changement Cache de session, ou rafraîchissement périodique — Rechargez ; attendez le rafraîchissement

Pour aller plus loin