Skip to content

Référence des domaines et URLs

Écrans, champs, formats, statuts et limites des domaines, URLs, routes, domaines racines, préfixes et hôtes IAM.

ReferenceDeveloper

This page has not been translated yet and is shown in French.

Les domaines et les URLs se gèrent depuis la console Wakastart (https://app.wakastart.app). Il n'existe pas d'API publique pour ces opérations.

Écrans

ÉcranChemin dans la consoleAccès
DomainesApp > Architecture > URLs > DomainesDroit « Infra Client »
URLs publiquesApp > Architecture > URLsDroit « Infra Client »
URLs & IAMApp > Environnements > environnement > onglet URLs & IAMDroit « Voir les URLs/routage » pour l'afficher, « Gérer les URLs/routage » pour agir, « Modifier un environnement » pour le préfixe et la gateway ; « Accès infrastructure en production » en plus sur un environnement prod
Section Hôtes IAMOnglet URLs & IAMNiveau Administrateur réseau et droit « Gérer les URLs/routage »
Mapping IAMApp > Environnements > onglet Mapping IAMDroit « Infra Client »

Domaine

Champ à l'écranFormatNotes
Nom de domaine1 à 255 caractèresUnique sur toute la plateforme. Non modifiable
Provider DNSOVH, IONOS Cloud, IONOS HostingNon modifiable depuis la console
Zone DNSNom de la zone chez le fournisseurLa zone doit déjà exister chez le fournisseur
Credentials DNSChamps propres au fournisseurStockés dans le coffre, jamais réaffichés
FournisseurChamps d'identifiants
OVHOVH Endpoint (ovh-eu, ovh-ca, ovh-us), Application Key, Application Secret, Consumer Key
IONOS CloudAPI Token
IONOS HostingAPI Key
État affiché (colonne Credentials DNS)Signification
Aucun credential DNS configuréAucun identifiant enregistré
Configuration en cours...Identifiants enregistrés, mise à disposition en cours
Credentials actifsIdentifiants disponibles pour les écritures DNS
Échec de la configurationLa mise à disposition a échoué ; le motif s'affiche dessous

URL

ChampFormatNotes
Sous-domaine^[a-z][a-z0-9-]{0,61}[a-z0-9]$ ou une seule lettre, 63 caractères au plusUnique par domaine dans l'app
DomaineDomaine plateforme ou domaine personnalisé de l'app—

Statuts d'une URL dans l'architecture : Actif, Détachée (sans domaine), Suppression..., Supprimé.

Route

ChampValeursDéfaut
URL de rattachementUne URL active de l'app—
CheminCommence par /, sans / final sauf pour //
Type de cheminPathPrefix, Exact, RegularExpressionPathPrefix
ServiceUne définition de service de l'app—
Port (optionnel)À laisser videPort de la définition du service
URL front officielle de l'appCase à cocher, une seule route par app, service de rôle FRONTNon cochée

Un même chemin ne peut exister qu'une fois par URL.

Domaine racine

ChampValeursDéfaut
DomaineDomaine personnalisé sans domaine racine ni redirection depuis sa racine—
ServiceUne définition de service de l'app—
Chemin / Type de cheminComme une route/, PathPrefix

Un seul domaine racine par domaine. Enregistrement DNS toujours de type A ou AAAA.

Préfixe d'environnement

RègleValeur
Format^[a-z][a-z0-9-]{0,19}$ : commence par une lettre minuscule, puis minuscules, chiffres et tirets, 20 caractères au plus
VideNoms publiés sans préfixe ; un seul environnement par app
UnicitéUn préfixe par environnement au sein d'une app

Formule du nom d'hôte

CasNom d'hôte
URL sur un domaine personnalisé<sous-domaine>[.<préfixe>].<domaine>
URL sur un domaine plateforme<sous-domaine>[.<préfixe>].<identifiant court de l'app>.<domaine>
Domaine racine[<préfixe>.]<domaine>

Statuts d'une route, d'un domaine racine ou d'une redirection dans un environnement

StatutSignification
PENDINGInstanciation enregistrée, pas encore prise en charge
PROVISIONINGCréation du rattachement, du certificat et du DNS en cours
PROVISIONEDCertificat valide et DNS écrit, trafic servi
FAILEDÉchec durable
DESTROYINGRetrait en cours
DESTROYEDRetiré

Hôte IAM

ChampFormatNotes
Pattern d'hôteNom d'hôte complet, 255 caractères au plusUnique sur toute la plateforme pour une app
*Wildcard ( . )Case à cocherCouvre les sous-domaines du motif
App mobile (deep link)Case à cocherRemplace le motif par Schéma (^[a-z][a-z0-9+.-]*$, 100 caractères au plus) et Chemin callback (défaut callback)
ActifCase à cocherUn hôte inactif n'est plus résolu
Hôte local<identifiant de l'app>.localhost:<port>En dev uniquement

Valeurs fixées par la plateforme

ÉlémentValeur
CertificatLet's Encrypt, défi HTTP-01, un par nom d'hôte, sans wildcard
Relance d'un certificat en échecaprès 10 min, puis après 30 min ; FAILED au troisième échec
Redirection HTTP vers HTTPS301
TTL des enregistrements DNS300 s (3 600 s chez IONOS Hosting)
Délais du load balancer180 s d'inactivité côté client et côté service, 20 s pour établir la connexion
Prise en charge d'une instanciationdemandes explicites toutes les 10 s, nouvelles ressources toutes les 30 s, rattrapage toutes les 5 min