문서 배포

GitLab 문서 사이트의 배포 환경, 릴리즈 프로세스, 안정 브랜치, Pages 배포 job, Docker 파일 구성 등을 설명합니다.

배포 환경 # GitLab 문서 사이트 는 GitLab Pages 로 호스팅되는 정적 사이트입니다. 배포는 Pages 배포 job 에서 처리됩니다. 이 웹사이트는 지원되는 GitLab 버전의 문서만 호스팅합니다. 이전 버전의 문서는 다음 위치에서 확인할 수 있습니다: 온라인: GitLab Docs Archives 오프라인 또는 Self-managed 사용: GitLab Docs Archives 에서 다운로드 가능한 Docker 패키지 형태로 제공 릴리즈 프로세스 구성 요소 # 문서 릴리즈 프로세스 는 다음 요소들로 구성됩니다: 머지 리퀘스트: main 및 관련 안정 브랜치에 변경 사항을 적용합니다. 파이프라인: 다음을 수행합니다. Hugo를 사용하여 문서를 빌드합니다. GitLab Pages에 배포합니다. 테스트 및 빌드에 사용되는 Docker 이미지를 빌드합니다. 빌드 환경에 사용되는 docs-gitlab-com 컨테이너 레지스트리 의 Docker 이미지 안정 브랜치 # 각 GitLab 릴리즈마다 문서 프로젝트에 안정 브랜치(예: 17.2 )가 생성됩니다. 이 브랜치는 포함된 프로젝트들의 해당 안정 브랜치에서 콘텐츠를 가져옵니다: gitlab 프로젝트의 안정 브랜치 (예: 17-2-stable-ee ) gitlab-runner 프로젝트의 안정 브랜치 (예: 17-2-stable ) omnibus-gitlab 프로젝트의 안정 브랜치 (예: 17-2-stable ) charts/gitlab 프로젝트의 안정 브랜치 (예: 7-2-stable ) charts/gitlab 버전은 GitLab 버전에 매핑 됩니다. gitlab-org/cloud-native/gitlab-operator 의 기본 브랜치 cli 프로젝트의 기본 브랜치 Technical Writing 팀이 docs-gitlab-com 프로젝트의 안정 브랜치를 생성 하며, 이는 다른 팀에서 생성한 안정 브랜치를 활용합니다. 안정 문서 # docs-gitlab-com 의 안정 브랜치를 타깃으로 하는 머지 리퀘스트가 병합되면, 파이프라인이 Hugo를 사용하여 문서를 빌드하고 병렬 배포 로 배포합니다. 문서는 다음 위치에서 호스팅됩니다: 현재 안정 버전과 이전 마이너 버전 2개는 docs.gitlab.com/VERSION/ 에서 제공 이전 버전은 archives.docs.gitlab.com/VERSION/ 에서 제공 새 마이너 버전이 릴리즈되면, docs.gitlab.com 에서 가장 오래된 버전이 archives.docs.gitlab.com 으로 이전됩니다. 각 파이프라인의 image:docs-single job이 자동으로 실행됩니다. 빌드된 결과물을 가져와 빌드 및 테스트 환경에서 사용할 수 있도록 아카이브 컨테이너 레지스트리 에 푸시합니다. 안정 문서 이미지 재빌드 # 안정 문서 이미지를 재빌드하려면, 재빌드할 안정 브랜치에 대해 새 파이프라인 을 생성합니다. 재빌드가 필요한 경우는 다음과 같습니다: 업스트림 안정 브랜치의 새로운 문서 변경 사항을 포함하기 위해. 예를 들어, gitla