Aller au contenu principal

Problèmes courants avec les Déploiements

Sur un composant, ou sur la page Déploiements​

Ce que tu voisQuoi faire
Pas d'onglet Déploiements, pas de carte Déploiements, pas de clé Déploiements dans Ajouter une carteAllume Déploiements dans Administration › Plugins.
shop-web n'affiche aucun déploiement Argo CD : son annotation argocd/app-selector (« env=prod ») ne contient pas son nom. Supprimez cette annotation pour utiliser le label backstage.io/component (les applications qui portent backstage.io/component=shop-web), ou écrivez : argocd/app-selector: backstage.io/component=shop-web. dans la carte Déploiements de la Vue d'ensembleSupprime l'annotation argocd/app-selector du catalog-info.yaml du composant. Le composant est alors relié aux applications qui portent le label du composant avec son nom.
L'application Argo CD shop-pay-recette appartient à shop-pay mais n'apparaît dans aucun environnement. Dans Argo CD, ajoutez à cette application le label environment, avec le nom de son environnement pour valeur (par exemple environment=prod). Le label recherché est le réglage « Environment label » de Administration › Deployments. dans la carte Déploiements de la Vue d'ensembleDans Argo CD, ajoute à l'application nommée dans le message le label d'environnement que le message indique, avec le nom de son environnement pour valeur, par exemple environment: prod.
Aucune application Argo CD de admin-api n'a été trouvée. Dans Argo CD, ajoutez à chacune de ses applications le label backstage.io/component avec la valeur admin-api. Le label recherché est le réglage « Component label » de Administration › Deployments. dans la carte Déploiements de la Vue d'ensembleDans Argo CD, ajoute à chaque application du composant le label que le message indique, avec le nom du composant pour valeur, par exemple backstage.io/component: admin-api. Vérifie que le label du message est bien celui que portent tes applications : c'est le réglage Component label de Administration › Plugins › Déploiements.
Argo CD (argocd-prod) refuse la connexion.Vérifie l'hôte et le port de cet Argo CD dans Administration › Connexions de l'entreprise, et qu'il tourne. Les autres Argo CD continuent d'afficher leurs versions.
Argo CD n'est pas encore relié à Astrolabe.Ajoute ton Argo CD dans Administration › Connexions de l'entreprise : clique sur Ouvrir l'intégration Argo CD.
Rien à afficher et Aucun déploiement n'est encore enregistré pour un composant du catalogue. dans la carte Déploiements du Tableau de bordAucun pipeline n'a encore déclaré de déploiement. Déclares-en un : voir Déclarer les déploiements depuis tes pipelines.
Aucun déploiementAvec Argo CD : lis le message au-dessus de la carte, il nomme le label à ajouter. Avec un pipeline : aucun déploiement n'a été déclaré sous le nom du composant.
Le serveur d'Astrolabe n'a pas su répondre (503).Réessaie dans un instant. Si ça dure, dis à l'administrateur d'Astrolabe de ton entreprise ce que tu faisais.
Aucun déploiement n'a encore été déclaré. sur la page DéploiementsAucun pipeline n'a déclaré de déploiement. En administrateur, clique sur Déclarer des déploiements depuis vos pipelines sous la phrase et suis Déclarer les déploiements depuis tes pipelines. Toute autre personne le demande à un administrateur : la page dit Un administrateur génère le jeton avec lequel vos pipelines déclarent leurs déploiements.
Aucun résultat avec ces filtres sur la page DéploiementsVide Rechercher un composant, ou clique sur Effacer les filtres.

Dans les réglages des Déploiements​

Ce que tu voisQuoi faire
« mon env » n'est pas accepté. sous Environment label ou Component labelUn label s'écrit sans espace ni accent, par exemple env ou app.kubernetes.io/environment.
Still waiting for: integrations.argocdAucun Argo CD n'est encore connecté : ajoutes-en un dans Administration › Connexions de l'entreprise.

Quand un pipeline déclare un déploiement​

L'appel du pipeline répond par l'un de ces messages, en anglais ; lis-les dans le journal du job.

Ce que tu voisQuoi faire
A pipeline token is required: generate one in Administration › Plugins › Deployments › Configure › Pipeline token and send it as « Authorization: Bearer <token> ».L'appel ne porte aucun jeton. Vérifie que le job voit le secret ASTROLABE_PIPELINE_TOKEN (branches protégées, environnements de ta CI), et que l'appel envoie la ligne Authorization.
This pipeline token is not valid: it was replaced or revoked. Generate a new one in Administration › Plugins › Deployments › Configure › Pipeline token.Le jeton a été remplacé ou révoqué. Génères-en un nouveau et mets-le dans le secret ASTROLABE_PIPELINE_TOKEN : voir Déclarer les déploiements depuis tes pipelines.
No component named shop-api in the catalog: COMPONENT must be the name of a component of the catalog.COMPONENT contient un nom que le catalogue ne connaît pas. Mets le nom du composant, celui de metadata.name dans son catalog-info.yaml.
version is requiredVERSION est vide dans le job : donne-lui la version déployée.
L'appel réussit mais le composant affiche Aucun déploiementVérifie que COMPONENT est le nom du composant, celui de metadata.name dans son catalog-info.yaml, et l'environnement que tu regardes.

Quand tu ajoutes un Argo CD​

Ce que tu voisQuoi faire
argocd.example.com a refusé les identifiants (401). Vérifie le jeton, et qu'il n'a pas expiré.Crée un nouveau jeton d'API Argo CD : voir Créer un jeton d'API Argo CD.
Toujours bloqué ?

Écris à support@forgeit.fr avec le nom du composant.