Aller au contenu

Résoudre les problèmes d'environnement

Messages d'erreur et blocages fréquents à la création, à la configuration, à l'import ou à la suppression d'un environnement.

DépannageDéveloppeur
Voir en Markdown

Cette page couvre l'architecture d'une application et ses environnements. Pour un service qui ne démarre pas, voir Résoudre les problèmes de services ; pour un build, voir Résoudre les problèmes de build et de déploiement.

Symptômes

Impossible de créer l'environnement

Message : « Impossible de créer l'environnement ».

Cause : le nom court ou le slug est déjà utilisé par un autre environnement de l'application, ou un autre environnement est déjà sans préfixe d'URL. Un nouvel environnement est toujours créé sans préfixe, et une application n'en accepte qu'un.

Solution :

  1. Dans Environnements, repérez l'environnement qui n'a pas de préfixe : son Résumé indique « Aucun (racine) » à côté de Préfixe URL.
  2. Donnez-lui un préfixe : voir Configurer un environnement.
  3. Recommencez la création, avec un nom court qui n'existe pas encore.

Pour vérifier : la carte du nouvel environnement apparaît dans Environnements avec l'état Actif.

Action non autorisée à la création

Message : « Action non autorisée » — « Vous n'avez pas le droit de créer un environnement. » ou « Vous n'avez pas le droit de créer un environnement de production. ».

Cause : il vous manque le droit Créer un environnement, ou, pour le type Production, le droit Accès infrastructure en production.

Solution : demandez à l'administrateur de votre organisation de vous attribuer le profil Infra, ou les droits manquants. Voir Droits et profils.

Les boutons Éditer n'apparaissent pas

Cause : la carte Informations n'affiche Éditer qu'avec le droit Modifier un environnement, et pour un environnement de production avec Accès infrastructure en production en plus.

Solution : demandez les droits manquants à l'administrateur de votre organisation.

Build automatique indisponible

Message : « Build automatique indisponible » — « Le build automatique nécessite un accès complet à ce repository. Vérifiez la configuration d'accès GitHub de ce repository. ».

Cause : un service de l'environnement utilise un dépôt importé auquel l'application GitHub de Wakastart n'a pas accès.

Solution : voir Donner accès à un dépôt importé.

Le bouton Importer est grisé

Info-bulle : « L'import nécessite une app vierge — supprimez d'abord l'architecture existante. »

Cause : l'application contient déjà au moins un dépôt, un service, une définition de base ou de bucket, une URL, une route, un domaine racine ou une redirection.

Solution : importez dans une application vierge, ou retirez ces éléments de l'architecture. Les environnements existants n'empêchent pas l'import.

Import bloqué — app non vierge

Cause : l'architecture de l'application a changé entre l'ouverture de la fenêtre et la simulation. L'encart liste les catégories qui contiennent déjà des éléments.

Solution : fermez la fenêtre et vérifiez l'architecture de l'application cible.

Erreurs de validation à l'import

Message : « N erreurs de validation », suivi de chemins et de messages.

Cause et solution :

MessageCauseCorrection
Unknown repo ref "…"Un service désigne par repoRef un dépôt absent de reposAjoutez le dépôt ou corrigez la référence
Unknown serviceDefinition ref "…"Une route ou une exposition sur domaine racine désigne un service absentCorrigez serviceRef
Unknown appUrl ref "…"Une route ou une redirection désigne une URL absente de appUrlsCorrigez urlRef ou targetUrlRef
Exactly one of targetUrlRef/targetApexRef must be providedUne redirection a zéro ou deux ciblesGardez une seule cible
must have required property '…'Un champ obligatoire manque à l'endroit indiqué par le cheminAjoutez le champ ; voir Format de l'architecture JSON
must NOT have additional propertiesUn champ inconnu du format est présentRetirez-le

L'export échoue

Message : Cannot export architecture: repo "…" (name: "…") has no htmlUrl.

Cause : un dépôt géré par Wakastart est encore en cours de création sur GitHub.

Solution : dans Architecture > Repositories, attendez que le dépôt passe à Provisionné, puis relancez l'export.

Impossible de supprimer l'environnement

Message : « Impossible de supprimer l'environnement ».

Cause : l'environnement contient encore une ressource vivante — instance de service, base, bucket, route, sonde de disponibilité, enregistrement DNS — ou publie une page légale publique.

Solution : retirez ces ressources une par une, puis recommencez. Voir Supprimer un environnement.

Une ressource reste en Provisionnement

Cause : la plateforme n'a pas encore terminé, ou elle réessaie après une erreur. Une base managée peut demander plusieurs minutes ; une instance de service attend que ses conteneurs soient démarrés et en bonne santé.

Solution :

  1. Attendez quelques minutes, puis cliquez sur Actualiser.
  2. Pour une instance de service, ouvrez-la et cliquez sur Réconcilier.
  3. Si l'instance ne démarre pas, consultez son onglet Logs : voir Résoudre les problèmes de services.

L'encart de préparation ne se calcule pas

Message : « Impossible de calculer l'état de la configuration pour le moment. Réessayez en rafraîchissant la page. »

Solution : rechargez la page. Si le message persiste, contactez le support.

Toujours bloqué ?

Contactez le support Wakastart avec :

  • le nom court de l'application et le slug de l'environnement ;
  • l'action tentée et l'heure à laquelle vous l'avez faite ;
  • le message exact affiché par la console.