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.
Quand l’utiliser
Section intitulée « Quand l’utiliser »- 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.
Avant de commencer
Section intitulée « Avant de commencer »- Un domaine publié. Un brouillon ne peut pas être exporté.
- L’outil en ligne de commande
facetsur 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.
1. Exporter le domaine
Section intitulée « 1. Exporter le domaine »facet domain:export crm --output crm.facet-domainLa 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.
2. Importer sur la cible
Section intitulée « 2. Importer sur la cible »facet domain:import crm.facet-domainSans 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à :
facet domain:import crm.facet-domain --into crm-prod --mergeTout l’import s’exécute dans une seule transaction : un refus laisse la cible exactement comme elle était.
3. Lire les règles de fusion
Section intitulée « 3. Lire les règles de fusion »--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. |
4. Accepter les tickets inter-domaines
Section intitulée « 4. Accepter les tickets inter-domaines »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 :
facet domain:export crm --output crm.facet-domaintar -czf crm.facet-domain.tgz crm.facet-domainscp crm.facet-domain.tgz ops@prod.example.com:Sur l’hôte de production :
facet domain:import crm.facet-domain.tgz --mergeLe 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.
Dépannage
Section intitulée « Dépannage »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.
Voir aussi
Section intitulée « Voir aussi »- portable-domains doc on GitHub — le format des bundles et chaque barrière.
- Domaines et isolation — ce que porte un bundle.
- Le watcher du domaine de développement — appliquer les mêmes fichiers automatiquement pendant le développement.