CI/CD 통합.

Learn DXPR BuilderManage the siteNaar productie

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

콘텐츠 저장소

DXPR Builder는 데이터를 데이터베이스와 설정에 저장합니다:

데이터 유형 저장소 배포 방법
페이지 콘텐츠 텍스트 필드 값(데이터베이스) 콘텐츠 동기화 또는 마이그레이션
페이지 템플릿 설정 엔터티 설정 내보내기/가져오기
사용자 템플릿 설정 엔터티 설정 내보내기/가져오기
설정 설정. 제품 키 보관 위치: 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(에)에 키가 더 이상 없는지 확인하세요.

공급자가 Configuration인 Key는 값을 자체 내보내기 파일에 보관하므로, 이 파일도 커밋하면 안전하지 않습니다.

다음 단계

Content staging between environments 문서에서 DXPR Builder 탐색을 계속하세요.