Skip to content

Définitions et instances

Déclarer une fois dans l'architecture, provisionner dans chaque environnement : valeurs par défaut, surcharges et propagation des changements.

ConceptDeveloper

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

L'hébergement Wakastart repose sur une règle unique : ce que votre application est se déclare une fois, au niveau de l'application ; ce qui tourne existe une fois par environnement. La déclaration s'appelle une définition, la ressource réelle une instance.

Définition

Une définition décrit une ressource et ses valeurs par défaut, sans la créer. Une instance est sa matérialisation dans un environnement : elle hérite des valeurs par défaut et peut surcharger chacune d'elles.

Loading diagram…
Définition (architecture)Instance (par environnement)Où la créer dans la console
Serviceservice déployéonglet Services > Déployer un service
Base de donnéesbase de l'environnementonglet Databases > Nouvelle instance
Bucketbucket de l'environnementonglet Storage > Provisionner
URL et routeroute en ligneonglet URLs & IAM > Instancier
Variable attendueliaison à une valeurservice déployé > Configuration du service

Les définitions se gèrent dans Architecture : Services, Dépendances (bases et buckets), URLs. Les instances se gèrent dans chaque environnement.

Pourquoi ça existe

Sans cette séparation, chaque environnement serait une copie de la description de l'application, et les copies dériveraient : un port changé en production mais oublié en staging, une base ajoutée d'un côté seulement. Avec elle, l'architecture fait foi. Les environnements ne portent que leurs écarts assumés : plus de réplicas en production, une base managée plutôt que dans le cluster, des secrets différents.

Comment ça marche

Héritage et surcharges

Chaque champ d'une instance est soit vide, et la valeur de la définition s'applique, soit renseigné, et il l'emporte. Si la définition ne fixe pas non plus la valeur, Wakastart applique un défaut.

Valeur effective d'un service déployéOrdre de résolution
CPU demandé / limiteinstance, puis définition, puis 100m / 500m
Mémoire demandée / limiteinstance, puis définition, puis 128Mi / 512Mi
Portdéfinition, puis port par défaut de la technologie (3000 pour nestjs et nextjs), puis 8080
Imagele tag choisi au déploiement
Valeur effective d'une baseOrdre de résolution
Mode (dans le cluster ou managée), plan, région, taille disqueinstance, puis définition
Versioninstance, puis définition, puis 16
Réplicasinstance, puis définition, puis 1

Pour revenir à la valeur par défaut, videz le champ de l'instance.

Propagation des changements

Modifier une définition incrémente sa génération, puis Wakastart met à jour les instances concernées :

  • une ressource ou une sonde par défaut modifiée redéploie les instances qui ne la surchargent pas ; les autres gardent leur valeur ;
  • un réglage réseau modifié (port, protocole) redéploie toutes les instances du service ;
  • chaque redéploiement laisse une ligne dans l'historique des déploiements de l'environnement.

Création des instances

RessourceCréation de l'instance
Servicetoujours explicite : il faut choisir l'image et le nombre de réplicas
Base de donnéesexplicite, environnement par environnement
Bucketexplicite ; ou automatique dans chaque environnement existant si vous cochez Créer automatiquement les instances en déclarant le bucket
Routeexplicite, par Instancier
Liaison de variableexplicite ; sans liaison, la variable prend sa valeur par défaut, ou elle est absente si elle n'en a pas

Repérer ce qui manque

L'encart Ce qu'il reste à configurer, dans le Résumé de chaque environnement, compare l'architecture à ce qui existe : services déclarés mais pas déployés, variables obligatoires sans valeur, bases et buckets non provisionnés, routes non instanciées, services sans build réussi. En production, il signale aussi les ressources sans sauvegarde et les services à un seul réplica. Il informe sans rien bloquer.

Exemples

Augmenter la mémoire partout. Vous passez la mémoire par défaut du service api de 512Mi à 1Gi dans l'architecture. Les environnements dev et staging, qui n'ont pas de surcharge, sont redéployés avec 1Gi. La production, qui surcharge à 2Gi, ne bouge pas.

Ajouter une base. Vous déclarez une base PostgreSQL main dans Dépendances. Rien ne se crée encore. Dans chaque environnement, Databases > Nouvelle instance la provisionne, dans le cluster en dev, managée en prod. L'encart Ce qu'il reste à configurer signale les environnements qui n'en ont pas.

Pour aller plus loin