Aller au contenu

Déplacer des domaines avec des bundles

Un bundle est un fichier qui porte la définition d’un domaineà : le domaine lui-même, ses doctypes, ses scripts et ses vues partagées. Vous l’exportez depuis une instance et l’importez sur une autre — de la préproduction vers la production, ou un domaine vendu à un client.

  • Vous avez construit un domaine en préproduction et vous l’expédiez en production.
  • Vous gardez les définitions de domaines dans un dépôt et les chargez sur les serveurs.
  • Vous livrez un domaine prêt à l’emploi à une autre organisation.
  • Un domaine publié. Un brouillon ne peut pas être exporté.
  • L’outil en ligne de commande facet sur la machine cible, avec accès à sa base de données.
  • Une décision sur les documents. Les définitions sont toujours emportéesà ; les données seulement avec --with-documents.
Fenêtre de terminal
facet domain:export crm --output crm.facet-domain

La sortie est une arborescence de répertoires. Terminez le chemin par .tgz pour obtenir une seule archive tar à la place. Le bundle contientà :

Contenu Toujoursà?
Le document du domaine, avec ses hooks en fichiers de script Oui
Chaque définition de doctype, avec son script Lua à côté Oui
Chaque modèle de vue de document de chaque doctype Oui
Chaque vue de liste partagée (générale) Oui
Chaque document Seulement avec --with-documents

Les vues de liste personnelles ne partent jamaisà ; elles appartiennent à

leurs propriétaires.

Fenêtre de terminal
facet domain:import crm.facet-domain

Sans option, l’import crée un domaine neuf et refuse une cible existante. Passez --merge pour mettre à jour un domaine existant, ou --into newname pour l’installer sous un autre nom. Les deux se combinentà :

Fenêtre de terminal
facet domain:import crm.facet-domain --into crm-prod --merge

Tout l’import s’exécute dans une seule transaction : un refus laisse la cible exactement comme elle était.

--merge compare chaque doctype du bundle avec celui du domaine réelà :

Situation Résultat
Doctype absent sur la cible Créé.
Même structure Laissé inchangé.
Structure différente La version du bundle doit être exactement supérieure d’un cran à celle du domaine réel, avec la migration correspondante.
Vue de liste partagée Mise à jour par nom. Une vue qui n’existe que sur la cible n’est jamais supprimée.

Si le domaine lit des données dans d’autres domaines, l’import dépose des tickets de consentement auprès de ces producteurs. Ils démarrent inactifs à l’import ; un administrateur du domaine producteur les active. La commande affiche une ligne par ticket.

Une construction de crm en préproduction part en production :

Fenêtre de terminal
facet domain:export crm --output crm.facet-domain
tar -czf crm.facet-domain.tgz crm.facet-domain
scp crm.facet-domain.tgz ops@prod.example.com:

Sur l’hôte de production :

Fenêtre de terminal
facet domain:import crm.facet-domain.tgz --merge

Le résumé détaille ce qui s’est appliqué, par exemple [crm] Imported domain 'crm' avec doctypes: 4 created, 1 updated, 0 unchanged. Un doctype mis à jour a franchi la barrière de version en préproduction avant l’exportà ; la production l’accepte donc en une étape.

L’export refuse avec une erreur de brouillon.

Publiez d’abord le brouillon. Les bundles ne portent jamais de brouillons.

L’import répondà : le domaine existe déjà.

La cible existe et vous n’avez pas passé --merge. Ajoutez l’option, ou renommez avec --into.

L’import renvoie une erreur de barrière de version.

Le doctype du bundle est en retard ou en avance sur celui du domaine réel. Reconstruisez le bundle depuis une source à la version correspondante, ou fusionnez de nouveau après avoir corrigé les versions sur la source.

Les références vers d’autres domaines semblent cassées.

Un bundle ne déplace pas les autres domaines. Importez aussi les domaines référencésà ; les références se résolvent quand leurs cibles existent.