• 요구 사항
• 설계 선택 사항
• 구성
• 설치 명령줄 옵션
• 차트 구성 예시
  • extraEnv
  • extraEnvFrom
  • image.pullSecrets
  • serviceAccount
  • affinity
• 이 차트의 Community Edition 사용하기
• 외부 서비스
  • Redis
    • host
    • serviceName
    • port
    • password
    • sentinels
  • PostgreSQL
    • host
    • serviceName
    • port
    • database
    • preparedStatements
    • username
    • password

GitLab-Migrations 차트 사용하기

migrations 서브 차트는 GitLab 데이터베이스의 시드/마이그레이션을 처리하는 단일 마이그레이션 Job를 제공합니다. 이 차트는 GitLab Rails 코드베이스를 사용하여 실행됩니다.

마이그레이션을 완료한 후, 이 Job은 또한 데이터베이스에서 인증 키 파일 쓰기를 해제하기 위해 응용 프로그램 설정을 편집합니다. 차트에서는 SSH AuthorizedKeysCommand를 사용하여 GitLab 인증 키 API를 지원하기 때문에 인증된 키 파일에 쓰기를 지원하지 않습니다.

요구 사항

이 차트는 Redis 및 PostgreSQL에 의존하며, 완전한 GitLab 차트의 일부로서 또는 이 차트가 배포된 Kubernetes 클러스터에서 도달 가능한 외부 서비스로 제공됩니다.

설계 선택 사항

migrations는 차트가 배포될 때마다 새로운 마이그레이션 Job을 작성합니다. Job 이름 충돌을 방지하기 위해 차트 수정본과 임의의 알파벳-숫자 값을 Job 이름에 추가합니다. 무작위 텍스트의 목적은 이 섹션에서 자세히 설명되어 있습니다.

현재도 Job이 완료된 후에도 클러스터에 개체로 남아 있는 상태를 유지합니다. 이는 마이그레이션 로그를 볼 수 있도록 하는 것입니다. 현재 이러한 Job은 helm uninstall 후에도 지속됩니다. 이것이 동일한 릴리스 이름을 사용하여 미래 배포에서 충돌을 일으키지 않도록 Job 이름에 임의의 텍스트를 추가하는 이유 중 하나입니다. 미래에 로그 배송 형태가 갖추어지면 이러한 개체의 지속성을 재검토할 수 있습니다.

이 차트에 사용된 컨테이너에는 현재 차트에서 사용하지 않는 몇 가지 추가 최적화가 있습니다. 주로 이미 최신 상태인 경우 빠르게 마이그레이션을 건너뛸 수 있는 기능으로, 레일 응용 프로그램을 부팅하여 확인할 필요 없이 이미 마이그레이션이 완료된 경우를 빠르게 건너뛸 수 있습니다. 이 최적화에는 현재 차트에서 마이그레이션 상태를 계속 보존해야 한다는 것이 필요합니다. 현재 이 차트에서는 이 작업을 수행하지 않고 있습니다. 미래에는 이 차트에 마이그레이션 상태의 저장소 지원을 도입할 것입니다.

구성

migrations 차트는 외부 서비스와 차트 설정 두 부분으로 구성됩니다.

설치 명령줄 옵션

아래 표에는 --set 플래그를 사용하여 helm install 명령에 제공할 수 있는 모든 가능한 차트 구성이 포함되어 있습니다.

차트 구성 예시

extraEnv

extraEnv를 사용하면 팟의 모든 컨테이너에 추가적인 환경 변수를 노출할 수 있습니다.

아래에 extraEnv를 사용한 예시가 있습니다:

extraEnv:
  SOME_KEY: some_value
  SOME_OTHER_KEY: some_other_value

컨테이너가 시작되면 환경 변수가 노출되었는지 확인할 수 있습니다:

env | grep SOME
SOME_KEY=some_value
SOME_OTHER_KEY=some_other_value

extraEnvFrom

extraEnvFrom를 사용하면 팟의 모든 컨테이너에 다른 데이터 소스의 추가적인 환경 변수를 노출할 수 있습니다.

아래에 extraEnvFrom를 사용한 예시가 있습니다:

extraEnvFrom:
  MY_NODE_NAME:
    fieldRef:
      fieldPath: spec.nodeName
  MY_CPU_REQUEST:
    resourceFieldRef:
      containerName: test-container
      resource: requests.cpu
  SECRET_THING:
    secretKeyRef:
      name: special-secret
      key: special_token
      # optional: boolean
  CONFIG_STRING:
    configMapKeyRef:
      name: useful-config
      key: some-string
      # optional: boolean

image.pullSecrets

pullSecrets를 사용하면 팟에서 이미지를 가져오기 위해 프라이빗 레지스트리에 인증할 수 있습니다.

프라이빗 레지스트리 및 해당 인증 방법에 대한 자세한 내용은 쿠버네티스 문서에서 확인할 수 있습니다.

아래에 pullSecrets를 사용한 예시가 있습니다:

image:
  repository: my.migrations.repository
  pullPolicy: Always
  pullSecrets:
  - name: my-secret-name
  - name: my-secondary-secret-name

serviceAccount

이 섹션은 ServiceAccount가 생성되어야 하는지 여부와 기본 액세스 토큰이 팟에 마운트되어야 하는지를 제어합니다.

affinity

자세한 정보는 affinity를 참조하세요.

이 차트의 Community Edition 사용하기

기본적으로 Helm 차트는 GitLab의 Enterprise Edition을 사용합니다. 원하는 경우 Community Edition을 대신 사용할 수 있습니다. 두 가지 간의 차이점에 대해 자세히 알아보세요.

Community Edition을 사용하려면 image.repository를 registry.gitlab.com/gitlab-org/build/cng/gitlab-toolbox-ce로 설정하세요.

외부 서비스

Redis

redis:
  host: redis.example.com
  serviceName: redis
  port: 6379
  sentinels:
    - host: sentinel1.example.com
      port: 26379
  password:
    secret: gitlab-redis
    key: redis-password

host

사용할 데이터베이스가 있는 Redis 서버의 호스트 이름입니다. serviceName 대신에 이를 생략할 수 있습니다. Redis Sentinels를 사용하는 경우 host 속성은 sentinel.conf에서 지정된 클러스터 이름으로 설정되어야 합니다.

serviceName

Redis 데이터베이스를 운영하는 service의 이름입니다. 이 속성이 존재하고 host가 존재하지 않는 경우, 차트는 host 값 대신에 서비스의 호스트 이름을 (그리고 현재 .Release.Name) 템플릿화합니다. 전체적인 GitLab 차트의 일부로 Redis를 사용하는 경우 편리합니다. 기본값은 redis입니다.

port

Redis 서버에 연결할 포트입니다. 기본값은 6379입니다.

password

Redis의 password 속성에는 두 개의 하위 키가 있습니다:

• secret: 사용할 쿠버네티스 Secret의 이름을 정의합니다
• key: 위의 Secret에 포함된 비밀번호의 이름을 정의합니다.

sentinels

sentinels 속성을 사용하면 Redis HA 클러스터에 연결할 수 있습니다. 하위 키는 각각의 Sentinel 연결을 설명합니다.

• host: Sentinel 서비스의 호스트 이름을 정의합니다
• port: Sentinel 서비스에 도달하기 위한 포트 번호를 정의합니다. 기본값은 26379입니다.

참고: 현재 Redis Sentinel 지원은 GitLab 차트와 별도로 배포된 Sentinels만 지원합니다. 따라서 GitLab 차트를 통해 Redis 배포를 비활성화해야 합니다(redis.install=false). Redis 비밀번호를 포함하는 Secret는 GitLab 차트를 배포하기 전에 수동으로 생성되어야 합니다.

PostgreSQL

psql:
  host: psql.example.com
  serviceName: pgbouncer
  port: 5432
  database: gitlabhq_production
  username: gitlab
  preparedStatements: false
  password:
    secret: gitlab-postgres
    key: psql-password

host

사용할 데이터베이스가 있는 PostgreSQL 서버의 호스트 이름입니다. postgresql.install=true (기본값은 비 프로덕션)이면 이를 생략할 수 있습니다.

serviceName

PostgreSQL 데이터베이스를 운영하는 서비스의 이름입니다. 이 속성이 존재하고 host가 존재하지 않는 경우, 차트는 서비스의 호스트 이름을 host값 대신에 템플릿화합니다.

port

PostgreSQL 서버에 연결할 포트입니다. 기본값은 5432입니다.

database

PostgreSQL 서버에서 사용할 데이터베이스의 이름입니다. 기본값은 gitlabhq_production입니다.

preparedStatements

PostgreSQL 서버와 통신할 때 준비된 문을 사용해야 하는지 여부입니다. 기본값은 false입니다.

username

데이터베이스에 인증할 사용자 이름입니다. 기본값은 gitlab입니다.

password

PostgreSQL의 password 속성에는 두 개의 하위 키가 있습니다:

• secret: 사용할 쿠버네티스 Secret의 이름을 정의합니다
• key: 위의 Secret에 포함된 비밀번호의 이름을 정의합니다.