Versionskontrolle.

Learn DXPR BuilderBuild pagesVolg een tutorial

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

Was in die Versionskontrolle geht

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
Seiteninhalt Meist nein In der Datenbank gespeichert
Hochgeladene Dateien Meist nein Im Dateiverzeichnis gespeichert

Konfigurationsverwaltung

Exportieren Sie die Konfiguration:

drush config:export

Das 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 von Ihnen für den Produktschlüssel gewählte Key-Entität

Wichtig: Unter dem Standard 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 Provider eine Umgebungsvariable oder eine Datei liest; das Speichern des Formulars leert dann json_web_token. Ein Key mit dem Configuration-Provider speichert den Wert weiter in seiner eigenen exportierten Datei, also ändern Sie zuerst dessen Provider unter Configuration > System > Keys (/admin/config/system/keys). Exportieren Sie dann erneut und committen Sie diese Dateien in Ihr Repository.

Konfiguration deployen

Auf der Zielumgebung:

drush config:import
drush cache:rebuild

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

Inhalte zwischen Umgebungen

Seiteninhalt (das HTML in Textfeldern) ist Datenbankinhalt, keine Konfiguration. Um ihn zu bewegen:

  • Nutzen Sie das Modul Default Content, um Inhalte als YAML zu exportieren und zu importieren.
  • Nutzen Sie Content Synchronization für laufenden Inhaltssync 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. Das Entwicklungsteam erstellt lokal Seitenvorlagen.
  2. Konfiguration exportieren und committen.
  3. In das Repository pushen.
  4. Auf Staging zum Review deployen.
  5. Nach Freigabe auf Produktion deployen.

Wie geht es weiter?

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