Gestion des versions.

Apprendre DXPR BuilderGérer le sitePasser en production

Les réglages, modèles et profils DXPR Builder sont de la configuration Drupal, donc ils entrent dans git avec le reste de votre configuration. Les pages sont du contenu et restent dans la base de données. Cette page liste lesquels vont où et comment déplacer chacun entre environnements.

Ce qui entre dans la gestion de versions

Type Sous gestion de versions Comment
Réglages Oui, une fois la clé de produit dans une Key Export de configuration ; voir ci-dessous
Modèles de page Oui Entités de configuration
Modèles d’utilisateur Oui Entités de configuration
Profils d’utilisateur Oui Entités de configuration
Clé de produit Seulement sans sa valeur Entité Key ; voir ci-dessous
Contenu des pages En général non Stocké dans la base de données
Fichiers téléversés En général non Stockés dans le répertoire des fichiers

Gestion de la configuration

Exportez la configuration :

drush config:export

Cela écrit ces fichiers DXPR Builder dans votre répertoire de synchronisation, souvent config/sync/ :

  • dxpr_builder.settings.yml
  • dxpr_builder.page_template.*.yml
  • dxpr_builder.user_template.*.yml
  • dxpr_builder.dxpr_builder_profile.*.yml
  • key.key.dxpr_builder_jwt.yml, ou l’entité Key que vous avez choisie pour la clé de produit

Important : sous le Configuration storage par défaut, dxpr_builder.settings.yml contient votre clé de produit en clair, comme json_web_token. Avant de commiter ce fichier, réglez Storage method sur Key module sous DXPR Studio > DXPR Builder > General Settings (/admin/dxpr_studio/dxpr_builder/settings). Choisissez une clé dont le fournisseur lit une variable d’environnement ou un fichier ; enregistrer le formulaire efface alors json_web_token. Une clé avec le fournisseur Configuration stocke toujours la valeur dans son propre fichier exporté, donc changez d’abord son fournisseur sous Configuration > System > Keys (/admin/config/system/keys). Puis exportez de nouveau et commitez ces fichiers dans votre dépôt.

Déployer la configuration

Sur l’environnement cible :

drush config:import
drush cache:rebuild

Cela applique réglages, modèles et profils depuis la gestion de versions.

Contenu entre environnements

Le contenu des pages (le HTML dans les champs de texte) est du contenu de base de données, pas de la configuration. Pour le déplacer :

  • Utilisez le module Default Content pour exporter et importer le contenu comme YAML.
  • Utilisez Content Synchronization pour une synchronisation de contenu continue entre environnements.
  • Déplacez le balisage d’une page avec Drush : drush dxb:page:get 42 l’affiche sous markup en YAML, et drush dxb:page:update 42 --markup=@page.html l’écrit vers une page sur la cible, comme une nouvelle révision.

Flux de travail en équipe

  1. Les développeurs créent des modèles de page en local.
  2. Exportez la configuration et commitez.
  3. Poussez vers le dépôt.
  4. Déployez en staging pour relecture.
  5. Déployez en production après approbation.

Et ensuite ?

Pipelines CI/CD pour le déploiement automatisé pour continuer à explorer DXPR Builder.