외부 PostgreSQL 서비스를 사용하여 GitLab 구성하기

Tier: Free, Premium, Ultimate

Offering: Self-managed

클라우드 제공업체에서 GitLab을 호스팅하는 경우, 선택적으로 관리형 서비스를 사용할 수 있습니다.

예를 들어, AWS는 PostgreSQL을 실행하는 관리형 관계형 데이터베이스 서비스(RDS)를 제공합니다.

또는 리눅스 패키지와 별도로 자신의 PostgreSQL 인스턴스나 클러스터를 관리할 수도 있습니다.

클라우드 관리형 서비스를 사용하거나 자신의 PostgreSQL 인스턴스를 제공하는 경우:

  1. 데이터베이스 요구 사항 문서에 따라 PostgreSQL을 설정하세요.

  2. 원하는 비밀번호로 gitlab 사용자 계정을 만들고, gitlabhq_production 데이터베이스를 생성한 후, 사용자를 데이터베이스 소유자로 지정하세요. 이 설정의 예는 자체 컴파일 설치 문서에서 확인할 수 있습니다.

  3. 클라우드 관리형 서비스를 사용하는 경우, gitlab 사용자에게 추가 역할을 부여해야 할 수 있습니다:

    이는 설치 및 업그레이드 중 확장을 설치하는 데 필요합니다. 대안으로, 확장을 수동으로 설치하고 이후 GitLab 업그레이드 중 발생할 수 있는 문제에 대해 읽어보세요.

  4. /etc/gitlab/gitlab.rb 파일에서 외부 PostgreSQL 서비스에 대한 적절한 연결 세부정보로 GitLab 애플리케이션 서버를 구성하세요:

    # 패키지로 제공되는 PostgreSQL 비활성화
postgresql['enable'] = false

# PostgreSQL 연결 세부정보
gitlab_rails['db_adapter'] = 'postgresql'
gitlab_rails['db_encoding'] = 'unicode'
gitlab_rails['db_host'] = '10.1.0.5' # 데이터베이스 서버의 IP/호스트명
gitlab_rails['db_password'] = 'DB password'

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

  5. 변경 사항을 적용하려면 재구성하세요:

    sudo gitlab-ctl reconfigure

  6. TCP 포트를 활성화하려면 PostgreSQL을 재시작하세요:

    sudo gitlab-ctl restart

문제 해결

SSL SYSCALL error: EOF detected 오류 해결

외부 PostgreSQL 인스턴스를 사용할 때 다음과 같은 오류가 발생할 수 있습니다:

pg_dump: error: Error message from server: SSL SYSCALL error: EOF detected

이 오류를 해결하려면 최소 PostgreSQL 요구 사항을 충족하고 있는지 확인하세요. RDS 인스턴스를 지원되는 버전으로 업그레이드한 후에는 이 오류 없이 백업을 수행할 수 있어야 합니다. 자세한 내용은 문제 64763를 참조하세요.