Configuration en code
La configuration d'un projet peut tenir dans un seul fichier que vous versionnez et poussez. La production change quand vous publiez une publication, et le même fichier peut décrire à la fois staging et production.
Ce que le fichier déclare
foir.config.ts déclare les modèles, les clés API, les hooks et les fournisseurs de connexion. Il couvre aussi les opérations, les planifications, les placements, les segments, les rôles de vos utilisateurs, les installations d'apps, les tokens de design, les locales, les dimensions de contexte, le catalogue de variantes, les textes d'e-mails et les paramètres du projet. Pour une clé API, le fichier versionné contient la déclaration : son nom, son type, ses portées et la variable d'environnement à utiliser. La CLI provisionne la clé pendant un push et écrit sa valeur dans votre fichier d'environnement sous cette variable.
Un push prépare un brouillon
foir push commence par un essai à blanc sur le serveur, de sorte qu'un refus arrive avant que quoi que ce soit soit écrit. Il écrit ensuite des brouillons, et la production continue de servir la copie publiée jusqu'à une publication. Les nouveaux modèles, les nouvelles opérations et les champs facultatifs ajoutés sont publiés avec le push. Tout le reste attend que vous publiiez.
Un push est une fusion à trois voies entre le fichier, l'état actuel du projet et votre dernier push. Quand le même champ a changé dans le fichier et dans la console, il s'arrête et signale le conflit.
Staging et production depuis une seule config
Une config peut déclarer plusieurs projets nommés dans un seul manifeste, ce qui permet de garder staging et production identiques. Seules les valeurs déclarées comme destinations peuvent différer : points d'accès, URI de redirection, origines, domaines et adresses d'expéditeur. Toute autre différence refuse le push et nomme le champ et les deux valeurs. Un push échoue aussi quand le projet contient un modèle, une opération, un hook, une planification ou une dimension de contexte que la config ne déclare pas.
Retirer un champ
Retirer un champ de la config ne supprime pas ses données immédiatement. Le champ est conservé comme obsolète pendant 30 jours, et le push écrit un fichier de décision qui demande quoi faire des valeurs stockées : renommer, convertir ou supprimer.
Lire le détail
La documentation de la config couvre le format du fichier, chaque famille qu'il peut déclarer, le push, la publication et les projets nommés.