CI/CD 통합.

Learn DXPR BuilderBuild pagesVolg een tutorial

DXPR Builder 콘텐츠는 Drupal 텍스트 필드와 구성 엔터티에 저장됩니다. 이 페이지에서는 DXPR Builder 콘텐츠를 CI/CD 파이프라인과 배포 워크플로에 포함하는 법을 설명합니다.

콘텐츠 저장소

DXPR Builder는 데이터를 데이터베이스와 구성에 저장합니다.

Data type Storage Deployment method
페이지 콘텐츠 텍스트 필드 값(데이터베이스) 콘텐츠 동기화 또는 마이그레이션
페이지 템플릿 구성 엔터티 구성 내보내기/가져오기
사용자 템플릿 구성 엔터티 구성 내보내기/가져오기
설정 구성. 제품 키 보관 위치: Configuration storage 키가 Key 엔터티에 있으면 구성 내보내기/가져오기. 아래 참조
사용자 프로필 구성 엔터티 구성 내보내기/가져오기
제품 키 설정, 또는 키를 보관하거나 가리키는 Key 엔터티 환경별. 아래 참조

구성 관리

DXPR Builder 설정과 템플릿은 Drupal 구성입니다. 표준 Drupal 구성 관리로 배포합니다.

내보내기

drush config:export

다음 DXPR Builder 구성 파일을 내보냅니다.

  • dxpr_builder.settings.yml
  • dxpr_builder.dxpr_builder_profile.*.yml
  • dxpr_builder.page_template.*.yml
  • dxpr_builder.user_template.*.yml
  • key.key.dxpr_builder_jwt.yml 또는 제품 키용으로 선택한 Key 엔터티

제품 키가 들어 있는 동안 dxpr_builder.settings.yml을 커밋하지 않습니다. 아래 Product keys를 참조합니다.

가져오기

drush config:import

CI 파이프라인 예제

drush deploy는 데이터베이스 업데이트를 실행하고 구성을 가져오며 올바른 순서로 캐시를 다시 빌드합니다. DXPR Builder 릴리스는 데이터베이스 업데이트에서 콘텐츠를 변환하므로 매 배포마다 실행합니다.

deploy:
  script:
    - drush deploy -y

콘텐츠 배포

페이지 콘텐츠(텍스트 필드의 HTML)는 구성이 아니라 데이터베이스 콘텐츠입니다. 환경 간 콘텐츠 배포 방법은 다음과 같습니다.

Default Content 모듈

콘텐츠를 YAML 파일로 내보내고 대상 환경에서 가져옵니다.

Content Synchronization

콘텐츠 엔터티를 내보내고 가져오려면 Content Synchronization 모듈(content_sync)을 사용합니다.

데이터베이스 동기화

데이터베이스를 한 환경에서 다른 환경으로 복사합니다.

drush sql:sync @source @target

환경별 고려 사항

파일 경로

DXPR Builder 콘텐츠는 업로드된 이미지를 파일 경로로 참조합니다. 환경 간에 파일 디렉터리를 동기화합니다.

제품 키

각 환경에는 유효한 제품 키가 필요합니다. 기본 Configuration storage에서는 dxpr_builder.settings.yml이 해당 키를 json_web_token으로 평문 보관합니다. 파일이 저장소에 들어가기 전에:

  1. 환경 변수나 파일을 읽는 프로바이더의 Key를 Configuration > System > Keys (/admin/config/system/keys)에서 만듭니다.
  2. 다음에서 설정하면 지워집니다. DXPR Studio > DXPR Builder > General Settings (/admin/dxpr_studio/dxpr_builder/settings)에서 Storage method를 Key module로 설정하고 Key 아래에서 해당 키를 고른 뒤 Save settings를 클릭합니다. 이렇게 하면 json_web_token이 지워집니다.
  3. 구성을 다시 내보내고 dxpr_builder.settings.yml에 더 이상 키가 없는지 확인합니다.

다음 프로바이더의 Key는 값을 자체 내보낸 파일에 저장하므로 커밋해도 안전하지 않습니다. Configuration 프로바이더의 Key는 값을 자체 내보낸 파일에 저장하므로 커밋해도 안전하지 않습니다.

다음 단계

Content staging between environments에서 DXPR Builder 탐색을 계속합니다.