다중 외부 데이터베이스로 GitLab 차트 구성하기

Tier: Free, Premium, Ultimate
Offering: Self-Managed
Status: Beta

기본적으로 GitLab은 main 데이터베이스로 참조되는 단일 애플리케이션 데이터베이스를 사용합니다.

GitLab을 확장하기 위해 GitLab을 여러 애플리케이션 데이터베이스로 구성할 수 있습니다.

다중 외부 데이터베이스로 새 설치된 GitLab 차트 구성

caution
이 기능은 알려진 이슈로 인해 프로덕션 환경에서 사용 준비가 되지 않았을 수 있습니다.

기본적으로 GitLab은 main 데이터베이스로 참조되는 단일 애플리케이션 데이터베이스를 사용합니다.

GitLab을 확장하기 위해 main 및 ci 라고 하는 여러 외부 애플리케이션 데이터베이스를 구성할 수 있습니다. 다음 다이어그램은 파드가 다중 데이터베이스와 통신하는 방법을 보여줍니다:

graph LR subgraph 외부 데이터베이스 B[(Main Database)] C[(CI Database)] end subgraph 쿠버네티스 클러스터 A[GitLab Pod 1] --> B A --> C D[GitLab Pod 2] --> B D --> C end

사전 준비 사항:

  • 외부 데이터베이스 문서에 나열된 모든 사전 준비 사항.
  • gitlabhq_production 데이터베이스와 같은 PostgreSQL 서버에서 실행할 수 있는 추가적인 비어있는 gitlabhq_production_ci 데이터베이스.
  • kubectl 및 helm CLI 도구를 사용하여 Kubernetes 클러스터에 액세스할 수 있어야 합니다. 자세한 정보는 GitLab 차트 사전 준비 사항을 참조하십시오.

여러 외부 데이터베이스를 설정하려면:

  1. 데이터베이스 사용자 gitlab의 PostgreSQL 비밀번호를 보유하는 Kubernetes 시크릿을 생성합니다. 이 비밀번호는 두 개의 서로 다른 물리적 서버에 다른 비밀번호를 지원하기 위해 다를 수 있습니다.

    이 Kubernetes 시크릿에 gitlab-postgresql-password라는 이름을 선택해 보겠습니다: 

    kubectl create secret generic gitlab-postgresql-password \
    --from-literal=main-gitlab-password=<main-database-password> \
    --from-literal=ci-gitlab-password=<ci-database-password>

  2. GitLab 차트를 배포하는 데 사용하는 기존 YAML 파일(예: gitlab-values.yaml)에 다음을 추가하고 host 값을 사용자의 것으로 교체합니다: 

    global:
  psql:
    main:
      host: main.database.host # 외부 main 데이터베이스의 호스트를 여기에 설정
      database: gitlabhq_production
      password:
        secret: gitlab-postgresql-password
        key: main-gitlab-password
    ci:
      host: ci.database.host # 외부 ci 데이터베이스의 호스트를 여기에 설정. main 데이터베이스와 동일할 수 있습니다.
      database: gitlabhq_production_ci # CI 스키마를 포함하는 데이터베이스 차이는 `database_tasks: true`로 이어짐
      password:
        secret: gitlab-postgresql-password
        key: ci-gitlab-password
postgresql:
  install: false

    여기서:

    • postgresql.install: 내장 데이터베이스를 비활성화하고 외부 데이터베이스를 대신 사용하려면 false로 설정합니다.
    • global.psql.main.host: 외부 main 데이터베이스의 호스트명을 설정하십시오. 도메인 또는 IP 주소일 수 있습니다.
    • global.psql.main.password.secret: PostgreSQL 사용자를 보유하는 Kubernetes 시크릿의 이름입니다. 예시에서는 gitlab-postgresql-password입니다.
    • global.psql.main.password.key: 시크릿 내에서 비밀번호를 포함하는 키입니다. 예시에서는 main-gitlab-password입니다.
    • global.psql.ci.host: 외부 ci 데이터베이스의 호스트명을 설정하십시오. 도메인 또는 IP 주소일 수 있습니다. main과 ci 데이터베이스가 동일한 데이터베이스 서버에 있는 경우 global.psql.main.host와 동일한 값일 수 있습니다.
    • global.psql.ci.password.secret: PostgreSQL 사용자를 보유하는 Kubernetes 시크릿의 이름입니다. 예시에서는 gitlab-postgresql-password입니다.
    • global.psql.ci.password.key: 시크릿 내에서 비밀번호를 포함하는 키입니다. 예시에서는 ci-gitlab-password입니다.

  3. 마지막으로 gitlab-values.yaml을 사용하여 GitLab 차트를 배포합니다: 

    helm repo add gitlab https://charts.gitlab.io/
helm repo update
helm upgrade --install gitlab gitlab/gitlab --timeout=900s -f gitlab-values.yaml

기존 설치를 다중 데이터베이스로 마이그레이션하기

기존 설치를 다중 데이터베이스로 마이그레이션할 수 있습니다.

준비

기존 설치를 다중 데이터베이스로 마이그레이션하기 전에:

  1. 데이터베이스의 백업을 만듭니다.

  2. 툴박스 파드를 찾습니다: 

    kubectl get pods -lrelease=릴리스_이름,app=toolbox

  3. 데이터베이스 콘솔에 액세스하고 데이터베이스 암호를 제공합니다: 

    kubectl exec <툴박스_파드_이름> -it -c toolbox -- gitlab-rails dbconsole

    직접 데이터베이스 서버에 직접 액세스할 수 있는 호스트에서 적절한 psql 명령으로 이 명령을 대체할 수 있습니다.

  4. 충분한 디스크 공간이 있는지 확인하고 다운타임을 계획하며 다중 데이터베이스 문서에서 SQL 명령으로 gitlabhq_production_ci 데이터베이스를 만듭니다. 이미 데이터베이스 콘솔에 액세스했으므로 sudo gitlab-psql 명령은 생략할 수 있습니다.

  5. 데이터베이스 콘솔을 종료합니다: 

    \q

  6. 툴박스 파드를 종료합니다: 

    exit

GitLab 중지

GitLab이 현재 데이터베이스에 기록하지 못하도록하려면 현재 GitLab 데이터베이스에 쓰는 모든 서비스를 중지해야 합니다.

  1. 각 데이터베이스에 액세스하는 배포의 기존 복제본을 저장합니다: 

    rm -f /tmp/deployments.txt
deployments=$(kubectl get deployment --selector 'app in (webservice, sidekiq, kas, gitlab-exporter)'  --no-headers -o custom-columns=":metadata.name")
for deployment in ${deployments}
do
replicas=$(kubectl get deployment $deployment -o=jsonpath='{.status.replicas}')
echo "$deployment/$replicas" >> /tmp/deployments.txt
done

  2. 데이터베이스에 액세스하는 배포를 축소합니다: 

    kubectl scale deployment --replicas 0 --selector 'app in (webservice, sidekiq, kas, gitlab-exporter)'

데이터베이스 마이그레이션

데이터베이스를 마이그레이션하려면:

  1. 툴박스 파드에서 Bash 셸에 액세스합니다: 

    kubectl exec <툴박스_파드_이름> -it  -c toolbox -- bash

  2. 툴박스 파드에서 마이그레이션 명령을 실행합니다: 

    gitlab-rake gitlab:db:decomposition:migrate

    명령이 다음 메시지를 출력해야 합니다: Database migration finished!.

  3. 툴박스 파드를 종료합니다: 

    exit

GitLab에 두 개의 데이터베이스 사용 설정

GitLab을 main과 ci 2개의 데이터베이스를 사용하도록 전환합니다: 

helm upgrade gitlab gitlab/gitlab \
  --set global.psql.database=null \
  --set global.psql.main.database=gitlabhq_production \
  --set global.psql.ci.database=gitlabhq_production_ci \
  --set gitlab.migrations.enabled=false \
  --set global.extraEnv.GITLAB_ALLOW_SEPARATE_CI_DATABASE=1 \
  --reuse-values

마이그레이션이 완료되었는지 확인

  1. 새로운 toolbox pod을 찾습니다: 

    kubectl get pods -lrelease=RELEASE_NAME,app=toolbox

  2. toolbox pod의 bash 쉘에 액세스합니다: 

    kubectl exec <toolbox_pod_name> -it  -c toolbox -- bash

  3. cat /srv/gitlab/config/database.yml을 실행하여 GitLab 구성이 main과 ci 둘 다를 포인팅하고 있는 gitlabhq_production 및 gitlabhq_production_ci 두 가지 다른 데이터베이스를 포함하는지 확인합니다.

마이그레이션 후 정리

GitLab을 다시 시작하기 전에 레거시 테이블을 쓰기용으로 잠그고 정리해야 합니다.

toolbox pod 내부에서 다음을 실행합니다: 

gitlab-rake gitlab:db:lock_writes
gitlab-rake gitlab:db:truncate_legacy_tables:main
gitlab-rake gitlab:db:truncate_legacy_tables:ci

GitLab 시작

GitLab을 시작하려면 다음을 실행합니다: 

while read line; do
  deployment=$(echo $line|cut -d'/' -f 1)
  replicas=$(echo $line|cut -d'/' -f 2)
  kubectl patch deployment "${deployment}" -p "{\"spec\": {\"replicas\": ${replicas}}}"
done < /tmp/deployments.txt