Versionskontrolle.

Learn DXPR BuilderManage the siteNaar productie

DXPR-Builder-Einstellungen, -Vorlagen und -Profile sind Drupal-Konfiguration, daher wandern sie mit dem Rest Ihrer Konfiguration in Git. Seiten sind Inhalte und bleiben in der Datenbank. Diese Seite listet auf, was wozu gehört und wie Sie jedes zwischen Umgebungen bewegen.

Was in die Versionskontrolle wandert

Typ Versionskontrolliert Wie
Einstellungen Ja, sobald der Produktschlüssel in einem Key liegt Konfigurationsexport; siehe unten
Seitenvorlagen Ja Konfigurationsentitäten
Benutzervorlagen Ja Konfigurationsentitäten
Benutzerprofile Ja Konfigurationsentitäten
Produktschlüssel Nur ohne seinen Wert Key-Entität; siehe unten
Seiteninhalte Üblicherweise nein In der Datenbank gespeichert
Hochgeladene Dateien Üblicherweise nein Im Dateiverzeichnis gespeichert

Konfigurationsverwaltung

Exportieren Sie die Konfiguration:

drush config:export

Dies schreibt diese DXPR-Builder-Dateien in Ihr Sync-Verzeichnis, oft 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, oder die für den Produktschlüssel gewählte Key-Entität

Wichtig: Unter der Standardoption Configuration storage hält dxpr_builder.settings.yml Ihren Produktschlüssel im Klartext, als json_web_token. Bevor Sie diese Datei committen, setzen Sie Storage method auf Key module unter DXPR Studio > DXPR Builder > General Settings (/admin/dxpr_studio/dxpr_builder/settings). Wählen Sie einen Key, dessen Anbieter eine Umgebungsvariable oder eine Datei liest; das Speichern des Formulars leert dann json_web_token. Ein Key mit dem Anbieter Configuration speichert den Wert weiterhin in eigener exportierter Datei, ändern Sie daher zuerst seinen Anbieter unter Configuration > System > Keys (/admin/config/system/keys). Exportieren Sie dann erneut und committen Sie diese Dateien in Ihr Repository.

Konfiguration ausrollen

Auf der Zielumgebung:

drush config:import
drush cache:rebuild

Dies wendet Einstellungen, Vorlagen und Profile aus der Versionskontrolle an.

Inhalte zwischen Umgebungen

Seiteninhalte (das HTML in Textfeldern) sind Datenbankinhalte, keine Konfiguration. Um sie zu bewegen:

  • Nutzen Sie das Modul Default Content, um Inhalte als YAML zu exportieren und zu importieren.
  • Nutzen Sie Content Synchronization für laufenden Inhalts-Sync zwischen Umgebungen.
  • Bewegen Sie das Markup einer Seite mit Drush: drush dxb:page:get 42 gibt es unter markup in YAML aus, und drush dxb:page:update 42 --markup=@page.html schreibt es auf eine Seite im Ziel, als neue Revision.

Workflow für Teams

  1. Entwicklung erstellt Seitenvorlagen lokal.
  2. Konfiguration exportieren und committen.
  3. In das Repository pushen.
  4. Auf Staging zum Prüfen ausrollen.
  5. Nach Freigabe in die Produktion ausrollen.

Wie geht es weiter?

CI/CD-Pipelines für automatisiertes Deployment, um DXPR Builder weiter zu erkunden.