GitLab Pages 병렬 배포
GitLab Pages 사이트의 여러 버전을 각자의 URL로 동시에 게시하는 방법을 설명합니다.
히스토리 GitLab 16.7에서 pages_multiple_versions_setting 이라는 기능 플래그와 함께 실험 기능으로 도입되었습니다 . 기본적으로 비활성화되어 있습니다. GitLab 17.4에서 이름이 "multiple deployments" 에서 "parallel deployments" 로 변경되었습니다 . GitLab 17.4에서 GitLab.com, GitLab Self-Managed, GitLab Dedicated에 활성화되었습니다 . GitLab 17.7에서 프로젝트 설정을 제거하도록 변경되었습니다 . GitLab 17.8에서 path_prefix 에 마침표를 허용하도록 변경되었습니다 . GitLab 17.9에서 publish 속성에 전달할 때 변수를 허용하도록 변경되었습니다 . GitLab 17.9에서 일반 제공됩니다 . 기능 플래그 pages_multiple_versions_setting 은 제거되었습니다. pages.publish 경로를 artifacts:paths 에 자동으로 추가하는 기능이 GitLab 17.10에서 Pages job에 한해 도입되었습니다 . 병렬 배포를 사용하면 GitLab Pages 사이트의 여러 버전을 동시에 게시할 수 있습니다. 각 버전은 지정한 경로 접두사를 기준으로 고유한 URL을 가집니다. 병렬 배포는 다음 용도로 사용합니다. 프로덕션에 병합하기 전에 개발 브랜치의 변경 사항을 테스트하는 워크플로를 개선합니다. 이해관계자와 작업 중인 미리 보기를 공유해 피드백을 받습니다. 여러 소프트웨어 버전의 문서를 동시에 유지합니다. 대상 독자별로 현지화된 콘텐츠를 게시합니다. 최종 게시 전에 검토할 스테이징 환경을 만듭니다. 사이트의 각 버전은 지정한 경로 접두사를 기준으로 고유한 URL을 가집니다. 병렬 배포가 유지되는 기간은 직접 제어합니다. 기본적으로 24시간 후에 만료되지만, 검토 일정에 맞게 이 기간을 조정할 수 있습니다. 병렬 배포 만들기 # 사전 요건: 최상위 네임스페이스에 사용 가능한 병렬 배포 슬롯 이 있어야 합니다. 병렬 배포를 만들려면 다음 단계를 따릅니다. .gitlab-ci.yml 파일에 path_prefix 를 지정한 Pages job을 추가합니다. pages: stage: deploy script: - echo "Pages accessible through ${CI_PAGES_URL}" pages: # specifies that this is a Pages job and publishes the default public directory path_prefix: "$CI_COMMIT_BRANCH" path_prefix 값은 다음 규칙을 따릅니다. 소문자로 변환됩니다. 숫자( 0-9 ), 문자( a-z ), 마침표( . )를 포함할 수 있습니다. 그 밖의 문자는 하이픈( - )으로 대체됩니다. 하이픈( - )이나 마침표( . )로 시작하거나 끝날 수 없으며, 해당 문자는 제거됩니다. 63바이트 이하여야 합니다. 이를 초과하는 부분은 잘립니다. 선택 사항. 동적 접