GitLab 데이터베이스를 다른 PostgreSQL 인스턴스로 이동하기

Tier: Free, Premium, Ultimate Offering: Self-managed

때때로 데이터베이스를 한 PostgreSQL 인스턴스에서 다른 인스턴스로 이동해야 할 필요가 있습니다. 예를 들어, AWS Aurora를 사용하고 있고 데이터베이스 로드 밸런싱을 활성화할 준비를 하고 있다면, 데이터를 RDS for PostgreSQL로 이동해야 합니다.

데이터베이스를 한 인스턴스에서 다른 인스턴스로 이동하려면:

  1. 소스 및 대상 PostgreSQL 엔드포인트 정보를 수집합니다:

    SRC_PGHOST=<source postgresql host>
SRC_PGUSER=<source postgresql user>

DST_PGHOST=<destination postgresql host>
DST_PGUSER=<destination postgresql user>

  2. GitLab을 중지합니다:

    sudo gitlab-ctl stop

  3. 소스에서 데이터베이스를 덤프합니다:

    /opt/gitlab/embedded/bin/pg_dump -h $SRC_PGHOST -U $SRC_PGUSER -c -C -f gitlabhq_production.sql gitlabhq_production
/opt/gitlab/embedded/bin/pg_dump -h $SRC_PGHOST -U $SRC_PGUSER -c -C -f praefect_production.sql praefect_production

    주의:
    드문 경우에 pg_dump 후 복원한 후 데이터베이스 성능 문제가 발생할 수 있습니다. 이는 pg_dump가 쿼리 계획 결정을 내리는 데 사용되는 통계를 포함하지 않기 때문입니다.
    복원 후 성능 저하가 발생하면 문제를 일으키는 쿼리를 찾아, 해당 쿼리에서 사용하는 테이블에 대해 ANALYZE를 실행하여 문제를 해결합니다.

  4. 대상에 데이터베이스를 복원합니다 (이는 동일한 이름을 가진 기존 데이터베이스를 덮어씁니다):

    /opt/gitlab/embedded/bin/psql -h $DST_PGHOST -U $DST_PGUSER -f praefect_production.sql postgres
/opt/gitlab/embedded/bin/psql -h $DST_PGHOST -U $DST_PGUSER -f gitlabhq_production.sql postgres

  5. 선택 사항. PgBouncer를 사용하지 않는 데이터베이스에서 사용하는 데이터베이스로 마이그레이션하는 경우, 애플리케이션 데이터베이스(일반적으로 gitlabhq_production)에 pg_shadow_lookup 함수를 수동으로 추가해야 합니다.

  6. /etc/gitlab/gitlab.rb 파일에서 대상 PostgreSQL 인스턴스에 대한 적절한 연결 세부정보로 GitLab 애플리케이션 서버를 구성합니다:

    gitlab_rails['db_host'] = '<destination postgresql host>'

    GitLab 다중 노드 설정에 대한 자세한 내용은 참조 아키텍처를 참조하십시오.

  7. 변경 사항을 적용하기 위해 재구성합니다:

    sudo gitlab-ctl reconfigure

  8. GitLab을 재시작합니다:

    sudo gitlab-ctl start