Versiebeheer.

Learn DXPR BuilderManage the siteNaar productie

Instellingen, sjablonen en profielen van DXPR Builder zijn Drupal-configuratie en horen dus met de rest van je configuratie in git thuis. Pagina's zijn inhoud en blijven in de database. Deze pagina somt op wat wat is en hoe je elk onderdeel tussen omgevingen verplaatst.

Wat in versiebeheer gaat

Type In versiebeheer Hoe
Instellingen Ja, zodra de productsleutel in een Key-entiteit staat Configuratie-export; zie hieronder
Paginasjablonen Ja Configuratie-entiteiten
Gebruikerssjablonen Ja Configuratie-entiteiten
Gebruikersprofielen Ja Configuratie-entiteiten
Productsleutel Alleen zonder de waarde Key-entiteit; zie hieronder
Paginainhoud Meestal niet Opgeslagen in de database
Geüploade bestanden Meestal niet Opgeslagen in de files-map

Configuratiebeheer

Exporteer de configuratie:

drush config:export

Dit schrijft deze DXPR Builder-bestanden naar je syncmap, vaak 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, of de Key-entiteit die je voor de productsleutel hebt geselecteerd

Belangrijk: onder de standaard Configuration storage bevat dxpr_builder.settings.yml je productsleutel als leesbare tekst, als json_web_token. Voordat je dat bestand commit, zet je Storage method op Key module bij DXPR Studio > DXPR Builder > General Settings (/admin/dxpr_studio/dxpr_builder/settings). Kies een key waarvan de provider een omgevingsvariabele of een bestand leest; door het formulier op te slaan wis je daarna json_web_token. Een key met de provider Configuration bewaart de waarde nog steeds in zijn eigen geëxporteerde bestand, dus wijzig eerst zijn provider bij Configuration > System > Keys (/admin/config/system/keys). Exporteer daarna opnieuw en commit deze bestanden naar je repository.

Configuratie deployen

Op de doelomgeving:

drush config:import
drush cache:rebuild

Dit past instellingen, sjablonen en profielen uit versiebeheer toe.

Inhoud tussen omgevingen

Paginainhoud (de HTML in tekstvelden) is database-inhoud, geen configuratie. Om die te verplaatsen:

  • Gebruik de module Default Content om inhoud als YAML te exporteren en importeren.
  • Gebruik Content Synchronization voor doorlopende synchronisatie van inhoud tussen omgevingen.
  • Verplaats de markup van één pagina met Drush: drush dxb:page:get 42 print die onder markup in YAML, en drush dxb:page:update 42 --markup=@page.html schrijft die als een nieuwe revisie naar een pagina op het doel.

Workflow voor teams

  1. Ontwikkelaars maken lokaal paginasjablonen.
  2. Exporteer de configuratie en commit.
  3. Push naar de repository.
  4. Deploy naar staging voor review.
  5. Deploy naar productie na goedkeuring.

Wat nu?

CI/CD-pipelines voor geautomatiseerde deployment om DXPR Builder verder te verkennen.