GitLab 팀원을 위한 공식 빌드 인프라 사용 가이드

만약 GitLab 팀원이라면, 공식 빌드 인프라에 액세스하거나 해당 인프라에 액세스하는 동료를 이용할 수 있습니다. 해당 액세스를 사용하여 패키지를 빌드할 수 있습니다.

gitlab-org/gitlab 프로젝트의 병합 요청(MR) 테스트

gitlab-org/gitlab 프로젝트에 MR이 있다면, 해당 MR을 패키지 또는 Docker 이미지를 사용하여 테스트할 수 있습니다.

당신의 MR에 해당하는 CI 파이프라인에서 qa 단계에서 e2e:package-and-test 작업을 실행하여 다음을 트리거하세요:

  • QA 미러에 대한 하류 파이프라인입니다. 이는 테스트를 위한 Ubuntu 22.04 패키지 및 all-in-one Docker 이미지를 제공합니다.
  • 또한 이러한 아티팩트를 사용하여 gitlab-qa 실행합니다.

omnibus-gitlab 프로젝트의 MR 테스트

만약 omnibus-gitlab 프로젝트에 MR이 있다면, 해당 MR을 패키지 또는 Docker 이미지를 사용하여 테스트할 수 있습니다.

GitLab 프로젝트와 유사하게, omnibus-gitlab의 MR에 대해 실행되는 파이프라인에도 패키지 또는 Docker 이미지를 가져오기 위한 수동 작업이 있습니다. Trigger:ce-package 및 Trigger:ee-package 작업은 CE 및 EE 패키지 및 Docker 이미지를 빌드하고 QA 실행을 수행합니다.

GitLab 구성 요소의 특정 브랜치 또는 버전 사용

GitLab Rails 또는 Gitaly와 같은 주요 GitLab 구성 요소의 버전은 다음에 의해 제어됩니다:

  • omnibus-gitlab 리포지토리 내의 *_VERSION 파일.
  • 빌드 중에 존재하는 *_VERSION 환경 변수.

더 많은 정보를 위해 다음 표를 확인하세요:

파일 이름 환경 변수 설명
VERSION GITLAB_VERSION GitLab Rails 애플리케이션의 Git 참조를 제어합니다. 기본적으로, GitLab-FOSS 리포지토리의 master 브랜치를 가리킵니다. GitLab 리포지토리를 사용하려면, ee 환경 변수를 true로 설정하세요.
GITALY_SERVER_VERSION GITALY_SERVER_VERSION Gitaly 리포지토리의 Git 참조입니다.
GITLAB_PAGES_VERSION GITLAB_PAGES_VERSION GitLab Pages 리포지토리의 Git 참조입니다.
GITLAB_SHELL_VERSION GITLAB_SHELL_VERSION GitLab Shell 리포지토리의 Git 참조입니다.
GITLAB_ELASTICSEARCH_INDEXER_VERSION GITLAB_ELASTICSEARCH_INDEXER_VERSION GitLab Elasticsearch Indexer 리포지토리의 Git 참조입니다. EE 빌드에서만 사용됩니다.
GITLAB_KAS_VERSION GITLAB_KAS_VERSION GitLab Kubernetes Agent Server 리포지토리의 Git 참조입니다.

당신이 GitLab MR에서 e2e:package-and-test 작업을 실행 중이라면, GITLAB_VERSION 환경 변수는 해당 파이프라인에 해당하는 커밋 SHA로 설정됩니다. 다른 환경 변수는 명시되지 않은 경우, 해당 파일에서 추출되고 트리거된 파이프라인으로 전달됩니다.

참고: 환경 변수는 *_VERSION 파일보다 우선합니다.

임시로 구성 요소 버전 지정

다음 중 하나의 방법을 사용하여 임시로 구성 요소 버전을 지정하세요:

  • *_VERSION 파일을 편집하고, 이 변경 사항을 MR이 병합 준비 상태로 표시되기 전에 되돌릴 수 있도록 커밋 및 푸시합니다. 이 변경을 되돌리기 위해 MR에서 이 diff에 관련된 논의를 열 것을 권장합니다.

  • .gitlab-ci.yml 파일에서 환경 변수를 설정하고, 해당 변경 사항을 MR이 병합 준비 상태로 표시되기 전에 되돌릴 수 있도록 커밋 및 푸시합니다. 이 변경을 되돌리기 위해 MR에서 이 diff에 관련된 논의를 열 것을 권장합니다.

  • Git push 옵션으로 환경 변수를 전달합니다. 

    git push <REMOTE> -o ci.variable="<ENV_VAR>=<VALUE>"

# 다중 변수 전달
git push <REMOTE> -o ci.variable="<ENV_VAR_1>=<VALUE_1>" -o ci.variable="<ENV_VAR_2>=<VALUE_2>"

    참고: 이 작업은 변경 사항을 푸시할 경우에만 작동합니다. 원격 저장소가 로컬 브랜치로 이미 업데이트된 경우, 새로운 파이프라인이 생성되지 않습니다.

  • UI에서 환경 변수를 지정하여 파이프라인을 수동으로 실행합니다.

환경 변수는 QA 미러에서 트리거된 하류 파이프라인으로 전달되어 빌드 중에 사용됩니다.

추가적인 변경 사항을 되돌리는 추가 작업을 피하기 위해 *_VERSION 파일 대신 환경 변수를 사용해야 합니다. *_VERSION 파일은 omnibus-gitlab의 반복적인 패키지 빌드가 필요하고 변경 사항이 발생하는 것은 주로 GitLab 구성 요소일 때에 가장 효과적입니다. 이 경우, *_VERSION 파일을 변경한 후 파이프라인을 재시작하면 새로운 패키지를 빌드하여 상류 구성 요소 기능 브랜치의 변경 사항을 반영할 수 있습니다.

특정 GitLab 구성 요소의 미러 또는 포크 사용

Omnibus가 빌드하는 대부분의 소프트웨어의 저장소 소스는 omnibus-gitlab 저장소의 .custom_sources.yml 파일에 있습니다. 주요 GitLab 구성 요소를 환경 변수를 사용하여 재정의할 수 있습니다. 자세한 내용은 아래 표를 확인하세요:

환경 변수 설명
ALTERNATIVE_PRIVATE_TOKEN 개인 저장소에서 가져와야 할 경우 사용하는 액세스 토큰입니다.
GITLAB_ALTERNATIVE_REPO GitLab Rails 애플리케이션의 Git 저장소 위치입니다.
GITLAB_SHELL_ALTERNATIVE_REPO GitLab Shell의 Git 저장소 위치입니다.
GITLAB_PAGES_ALTERNATIVE_REPO GitLab Pages의 Git 저장소 위치입니다.
GITALY_SERVER_ALTERNATIVE_REPO Gitaly의 Git 저장소 위치입니다.
GITLAB_ELASTICSEARCH_INDEXER_ALTERNATIVE_REPO GitLab Elasticsearch Indexer의 Git 저장소 위치입니다.
GITLAB_KAS_ALTERNATIVE_REPO GitLab Kubernetes Agent Server의 Git 저장소 위치입니다.

다른 운영 체제용 패키지 빌드

전제 조건:

  • omnibus-gitlab 릴리스 미러에 브랜치를 푸시할 수 있는 권한이 있어야 합니다.

릴리스 미러를 사용하여 다음을 수행할 수 있습니다:

  • Ubuntu 22.04 이외의 운영 체제용 패키지 빌드합니다.
  • 변경된 패키지가 모든 운영 체제에서 빌드될 수 있도록 합니다.

다른 운영 체제용 패키지를 빌드하려면:

  1. 필요한 경우 이전 섹션에서 명시된대로 *_VERSION 파일이나 환경 변수를 수정합니다. CI 구성에서 ee 환경 변수를 true로 설정하여 GitLab 리포지토리의 커밋을 사용하도록 할 수 있습니다.

  2. 브랜치를 릴리스 미러에 푸시하고 파이프라인을 확인합니다.

  3. 파이프라인은 모든 지원되는 운영 체제용 패키지 및 Docker 이미지를 빌드합니다.