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.
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
- Action non autorisée à la création
- Les boutons Éditer n'apparaissent pas
- Build automatique indisponible
- Le bouton Importer est grisé
- Import bloqué — app non vierge
- Erreurs de validation à l'import
- L'export échoue
- Impossible de supprimer l'environnement
- Une ressource reste en Provisionnement
- L'encart de préparation ne se calcule pas
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 :
- 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.
- Donnez-lui un préfixe : voir Configurer un environnement.
- 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 :
| Message | Cause | Correction |
|---|---|---|
Unknown repo ref "…" | Un service désigne par repoRef un dépôt absent de repos | Ajoutez 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 absent | Corrigez serviceRef |
Unknown appUrl ref "…" | Une route ou une redirection désigne une URL absente de appUrls | Corrigez urlRef ou targetUrlRef |
Exactly one of targetUrlRef/targetApexRef must be provided | Une redirection a zéro ou deux cibles | Gardez une seule cible |
must have required property '…' | Un champ obligatoire manque à l'endroit indiqué par le chemin | Ajoutez le champ ; voir Format de l'architecture JSON |
must NOT have additional properties | Un champ inconnu du format est présent | Retirez-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 :
- Attendez quelques minutes, puis cliquez sur Actualiser.
- Pour une instance de service, ouvrez-la et cliquez sur Réconcilier.
- 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.