외부 데이터베이스를 사용하여 GitLab 차트 구성

프로덕션에 준비된 GitLab 차트 배포를 위해 외부 데이터베이스를 사용하세요.

전제 조건:

  • PostgreSQL 12 이상의 배포. 없는 경우 AWS RDS PostgreSQLGCP Cloud SQL과 같은 클라우드 제공 솔루션을 고려해보세요. Self-Managed형 솔루션을 사용하는 경우 Linux 패키지를 고려해보세요.
  • 기본적으로 gitlabhq_production이라는 빈 데이터베이스.
  • 전체 데이터베이스 액세스 권한을 가진 사용자. 자세한 내용은 외부 데이터베이스 문서를 참조하세요.
  • 데이터베이스 사용자의 비밀번호가 포함된 Kubernetes Secret가 있어야 합니다.
  • pg_trgmbtree_gist 익스텐션. GitLab에 슈퍼유저 플래그를 제공하지 않는 경우, 데이터베이스 설치 전에 이러한 익스텐션이 로드되어 있는지 확인하세요.

네트워킹 전제 조건:

  • 클러스터에서 데이터베이스에 연결할 수 있도록 보장하세요. 방화벽 정책이 트래픽을 허용하는지 확인하세요.
  • PostgreSQL을 로드 밸런싱 클러스터 및 Kubernetes DNS를 사용할 계획인 경우, bitnami/postgresql 차트를 설치할 때 --set slave.service.clusterIP=None을 사용하세요. 이 설정은 PostgreSQL 보조 서비스를 헤드리스 서비스로 구성하여 각 보조 인스턴스에 대해 DNS A 레코드가 생성되도록 합니다.

    서비스 검색에 Kubernetes DNS를 사용하는 예제는 examples/database/values-loadbalancing-discover.yaml에서 확인할 수 있습니다.

GitLab 차트를 외부 데이터베이스를 사용하도록 구성하려면:

  1. 다음 매개변수를 설정하세요:

    • postgresql.install: 내장 데이터베이스를 비활성화하려면 false로 설정하세요.
    • global.psql.host: 외부 데이터베이스의 호스트명을 설정하세요. 도메인 또는 IP 주소일 수 있습니다.
    • global.psql.password.secret: gitlab 사용자의 데이터베이스 비밀번호가 포함된 시크릿의 이름을 설정하세요.
    • global.psql.password.key: 시크릿 내 비밀번호가 포함된 키를 설정하세요.
  2. 선택 사항. 다음 항목은 기본값을 사용하지 않는 경우 추가로 사용자 정의할 수 있습니다:

    • global.psql.port: 데이터베이스가 사용 가능한 포트. 기본값은 5432입니다.
    • global.psql.database: 데이터베이스의 이름입니다.
    • global.psql.username: 데이터베이스에 액세스할 사용자입니다.
  3. 선택 사항. 데이터베이스에 상호 TLS 연결을 사용하는 경우 다음을 설정하세요:

    • global.psql.ssl.secret: 클라이언트 인증서, 키 및 인증 기관이 포함된 시크릿.
    • global.psql.ssl.serverCA: 시크릿의 인증 기관(CA)을 참조하는 키.
    • global.psql.ssl.clientCertificate: 시크릿의 클라이언트 인증서를 참조하는 키.
    • global.psql.ssl.clientKey: 시크릿의 클라이언트 키.
  4. GitLab 차트를 배포할 때 --set 플래그를 사용하여 값들을 추가하세요. 예:

    helm install gitlab gitlab/gitlab
      --set postgresql.install=false
      --set global.psql.host=psql.example
      --set global.psql.password.secret=gitlab-postgresql-password
      --set global.psql.password.key=postgres-password