Controlo de versões.

Aprender DXPR BuilderGerir o siteOperar em produção

As definições, modelos e perfis do DXPR Builder são configuração do Drupal, por isso vão para o git com o resto da configuração. As páginas são conteúdo e ficam na base de dados. Esta página enumera o que é o quê e como mover cada um entre ambientes.

O que vai para o controlo de versões

Type Version controlled How
Definições Sim, quando a chave de produto está numa chave Exportação de configuração; ver abaixo
Modelos de página Sim Entidades de configuração
Modelos de utilizador Sim Entidades de configuração
Perfis de utilizador Sim Entidades de configuração
Chave de produto Apenas sem o valor Entidade Key; ver abaixo
Conteúdo de página Normalmente não Guardado na base de dados
Ficheiros carregados Normalmente não Guardados no diretório de ficheiros

Gestão de configuração

Exporte a configuração:

drush config:export

Isto escreve estes ficheiros do DXPR Builder no diretório de sincronização, muitas vezes 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 a entidade Key selecionada para a chave de produto

Important: com o Configuration storage predefinido, dxpr_builder.settings.yml guarda a chave de produto em texto claro, como json_web_token. Antes de registar esse ficheiro, defina Storage method como Key module em DXPR Studio > DXPR Builder > General Settings (/admin/dxpr_studio/dxpr_builder/settings). Escolha uma chave cujo fornecedor lê uma variável de ambiente ou um ficheiro; guardar o formulário limpa depois json_web_token. Uma chave com o fornecedor Configuration continua a guardar o valor no próprio ficheiro exportado, por isso mude primeiro o fornecedor em Configuration > System > Keys (/admin/config/system/keys). Depois exporte outra vez e registe estes ficheiros no repositório.

Implementar configuração

No ambiente de destino:

drush config:import
drush cache:rebuild

Isto aplica definições, modelos e perfis do controlo de versões.

Conteúdo entre ambientes

O conteúdo de página (o HTML em campos de texto) é conteúdo de base de dados, não configuração. Para o mover:

  • Use o módulo Default Content para exportar e importar conteúdo como YAML.
  • Use Content Synchronization para sincronização contínua de conteúdo entre ambientes.
  • Mova a marcação de uma página com Drush: drush dxb:page:get 42 imprime-a em markup em YAML, e drush dxb:page:update 42 --markup=@page.html escreve-a numa página no destino, como nova revisão.

Fluxo de trabalho para equipas

  1. Os programadores criam modelos de página localmente.
  2. Exporte a configuração e registe.
  3. Envie para o repositório.
  4. Implemente em encenação para revisão.
  5. Implemente em produção após aprovação.

O que se segue?

Pipelines de CI/CD para implementação automatizada para continuar a explorar o DXPR Builder.