Version control.

Learn DXPR BuilderManage the siteNaar productie

Le impostazioni, i modelli e i profili di DXPR Builder sono configurazione di Drupal, quindi finiscono in git con il resto della configurazione. Le pagine sono contenuto e restano nel database. Questa pagina elenca cosa è cosa e come spostare ciascuna voce tra gli ambienti.

Cosa finisce nel version control

Tipo Sotto version control Come
Impostazioni Sì, una volta che la chiave prodotto è in una chiave Esportazione della configurazione; vedi sotto
Modelli di pagina Sì Entità di configurazione
Modelli utente Sì Entità di configurazione
Profili utente Sì Entità di configurazione
Chiave prodotto Solo senza il suo valore Entità chiave; vedi sotto
Contenuto delle pagine In genere no Memorizzato nel database
File caricati In genere no Memorizzati nella directory dei file

Gestione della configurazione

Esporta la configurazione:

drush config:export

Questo scrive questi file di DXPR Builder nella tua directory di sincronizzazione, spesso 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, oppure l’entità chiave che hai scelto per la chiave prodotto

Importante: con il valore predefinito di Configuration storage, dxpr_builder.settings.yml contiene la tua chiave prodotto in chiaro, come json_web_token. Prima di fare il commit di quel file, imposta Storage method su Key module in DXPR Studio > DXPR Builder > General Settings (/admin/dxpr_studio/dxpr_builder/settings). Scegli una chiave il cui provider legga una variabile d’ambiente o un file; salvare il form azzera json_web_token. Una chiave con il provider Configuration memorizza comunque il valore nel suo file esportato, quindi cambia prima il suo provider in Configuration > System > Keys (/admin/config/system/keys). Poi esporta di nuovo e fai il commit di questi file nel tuo repository.

Distribuzione della configurazione

Nell’ambiente di destinazione:

drush config:import
drush cache:rebuild

Questo applica impostazioni, modelli e profili dal version control.

Contenuti tra gli ambienti

Il contenuto delle pagine (l’HTML nei campi di testo) è contenuto del database, non configurazione. Per spostarlo:

  • Usa il modulo Default Content per esportare e importare i contenuti come YAML.
  • Usa Content Synchronization per la sincronizzazione continua dei contenuti tra gli ambienti.
  • Sposta il markup di una pagina con Drush: drush dxb:page:get 42 lo stampa sotto markup in YAML, e drush dxb:page:update 42 --markup=@page.html lo scrive in una pagina di destinazione, come nuova revisione.

Flusso di lavoro per i team

  1. Gli sviluppatori creano modelli di pagina in locale.
  2. Esporta la configurazione e fai il commit.
  3. Fai il push nel repository.
  4. Distribuisci in staging per la revisione.
  5. Distribuisci in produzione dopo l’approvazione.

Prossimi passi

Pipeline CI/CD per la distribuzione automatizzata e continua a esplorare DXPR Builder.