버전 관리.

Learn DXPR BuilderBuild pagesVolg een tutorial

DXPR Builder 설정, 템플릿, 프로필은 Drupal 구성이므로 나머지 구성과 함께 git에 들어갑니다. 페이지는 콘텐츠이므로 데이터베이스에 남습니다. 이 페이지에서는 무엇이 무엇인지, 환경 간 이동법을 나열합니다.

버전 관리 대상

Type Version controlled How
설정 예. 제품 키가 키에 있으면 구성 내보내기. 아래 참조
페이지 템플릿 예 구성 엔터티
사용자 템플릿 예 구성 엔터티
사용자 프로필 예 구성 엔터티
제품 키 값 없이만 Key 엔터티. 아래 참조
페이지 콘텐츠 보통 아니요 데이터베이스에 저장
업로드된 파일 보통 아니요 파일 디렉터리에 저장

구성 관리

구성을 내보냅니다.

drush config:export

다음 DXPR Builder 파일이 동기화 디렉터리(보통 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 또는 제품 키용으로 선택한 Key 엔터티

Important: 기본 Configuration storage에서는 dxpr_builder.settings.yml이 제품 키를 json_web_token으로 평문 보관합니다. 해당 파일을 커밋하기 전에 Storage method를 Key module로 설정합니다. DXPR Studio > DXPR Builder > General Settings (/admin/dxpr_studio/dxpr_builder/settings)에서 설정합니다. 환경 변수나 파일을 읽는 프로바이더의 키를 고릅니다. 양식을 저장하면 json_web_token이 지워집니다. 다음 프로바이더의 키는 값을 자체 내보낸 파일에 저장하므로 먼저 변경합니다. Configuration 프로바이더의 키는 값을 자체 내보낸 파일에 저장하므로 먼저 Configuration > System > Keys (/admin/config/system/keys)에서 프로바이더를 변경합니다. 그런 뒤 다시 내보내고 해당 파일을 저장소에 커밋합니다.

구성 배포하기

대상 환경에서:

drush config:import
drush cache:rebuild

버전 관리에서 설정, 템플릿, 프로필이 적용됩니다.

환경 간 콘텐츠

페이지 콘텐츠(텍스트 필드의 HTML)는 구성이 아니라 데이터베이스 콘텐츠입니다. 옮기려면:

  • 다음 모듈을 사용하여 콘텐츠를 YAML로 내보내고 가져옵니다. Default Content 모듈을 사용하여 콘텐츠를 YAML로 내보내고 가져옵니다.
  • 환경 간 지속적인 콘텐츠 동기화에는 Content Synchronization을 사용합니다.
  • 한 페이지의 마크업은 Drush로 옮깁니다. drush dxb:page:get 42는 YAML의 markup 아래에 출력하고, drush dxb:page:update 42 --markup=@page.html은 새 리비전으로 대상 페이지에 씁니다.

팀 워크플로

  1. 개발자가 로컬에서 페이지 템플릿을 만듭니다.
  2. 구성을 내보내고 커밋합니다.
  3. 저장소에 푸시합니다.
  4. 검토용으로 스테이징에 배포합니다.
  5. 승인 후 프로덕션에 배포합니다.

다음 단계

CI/CD pipelines for automated deployment에서 DXPR Builder 탐색을 계속합니다.