• Configuration
• 백업 구성
• 지속성 구성
  • 백업 고려 사항
  • 복원 고려 사항
• Toolbox 포함된 도구들
  • affinity

Toolbox

Toolbox Pod는 GitLab 애플리케이션 내에서 주기적인 가사 정리 작업을 실행하는 데 사용됩니다. 이러한 작업에는 백업, Sidekiq 유지 관리 및 Rake 작업이 포함됩니다.

Configuration

다음 구성 설정은 Toolbox 차트에서 제공하는 기본 설정입니다.

gitlab:
  ## doc/charts/gitlab/toolbox
  toolbox:
    enabled: true
    replicas: 1
    backups:
      cron:
        enabled: false
        concurrencyPolicy: Replace
        failedJobsHistoryLimit: 1
        schedule: "0 1 * * *"
        successfulJobsHistoryLimit: 3
        suspend: false
        backoffLimit: 6
        safeToEvict: false
        restartPolicy: "OnFailure"
        resources:
          requests:
            cpu: 50m
            memory: 350M
        persistence:
          enabled: false
          accessMode: ReadWriteOnce
          useGenericEphemeralVolume: false
          size: 10Gi
      objectStorage:
        backend: s3
        config: {}
    persistence:
      enabled: false
      accessMode: 'ReadWriteOnce'
      size: '10Gi'
    resources:
      requests:
        cpu: '50m'
        memory: '350M'
    securityContext:
      fsGroup: '1000'
      runAsUser: '1000'
      runAsGroup: '1000'
    containerSecurityContext:
      runAsUser: '1000'
    affinity: {}

백업 구성

백업 및 복원 설명서에서 백업 구성에 관한 정보를 찾을 수 있습니다. 또한, 백업이 수행되는 기술적인 구현에 대한 추가 정보는 백업 및 복원 아키텍처 설명서에서 찾을 수 있습니다.

지속성 구성

백업 및 복원을 위해 지속 스토어는 별도로 구성됩니다. GitLab을 백업 및 복원 작업을 구성할 때 다음을 고려하세요.

백업은 backups.cron.persistence.* 속성을 사용하고, 복원은 persistence.* 속성을 사용합니다. 지속성 스토어를 구성하는 데 사용되는 설명은 최종 속성 키만 사용하며(예: .enabled 또는 .size), 적절한 접두사가 추가되어야 합니다.

지속성 스토어는 기본적으로 사용되지 않으므로 .enabled를 사용하여 중요한 크기의 백업 또는 복원을 위해 true로 설정해야 합니다. 또한, Kubernetes에서 PersistentVolume을 생성하려면 .storageClass를 지정해야 하거나 수동으로 PersistentVolume을 생성해야 합니다. .storageClass가 '-'로 지정된 경우, PersistentVolume은 Kubernetes 클러스터에서 지정된 기본 StorageClass를 사용하여 생성됩니다.

수동으로 PersistentVolume를 생성하는 경우 .volumeName 속성을 사용하거나 .matchLables / .matchExpressions 속성을 사용하여 볼륨을 지정할 수 있습니다.

대부분의 경우 .accessMode의 기본값은 Toolbox만 PersistentVolumes에 액세스하는 데 충분한 컨트롤을 제공합니다. 올바른 설정인지 확인하려면 Kubernetes 클러스터에 설치된 CSI 드라이버에 대한 설명서를 참조하세요.

백업 고려 사항

백업 작업에는 백업 대상인 개별 구성 요소를 보관하기 위한 디스크 공간이 필요하며, 이후에 백업 개체 스토어에 기록됩니다. 디스크 공간의 양은 다음과 같은 요소에 따라 달라집니다:

• 각 프로젝트 및 각 프로젝트에 저장된 데이터 양
• PostgresSQL 데이터베이스의 크기 (이슈, MR 등)
• 각 개체 스토어 백엔드의 크기

대략적인 크기를 결정한 후, backups.cron.persistence.size 속성을 설정하여 백업을 시작할 수 있습니다.

복원 고려 사항

백업을 복원하는 동안, 파일을 실행 중인 인스턴스에서 교체하기 전에 백업을 디스크에 추출해야 합니다. 이 복원 디스크 공간의 크기는 persistence.size 속성에 의해 제어됩니다. GitLab 설치가 커질수록 복원 디스크 공간의 크기도 그에 따라 증가해야 한다는 점을 유념해야 합니다. 대부분의 경우 복원 디스크 공간의 크기는 백업 디스크 공간과 동일해야 합니다.

Toolbox 포함된 도구들

Toolbox 컨테이너에는 Rails 콘솔, Rake 작업 등과 같은 유용한 GitLab 도구가 포함되어 있습니다. 이러한 명령은 데이터베이스 마이그레이션 상태를 확인하거나, 관리 작업을 위해 Rake 작업을 실행하거나, Rails 콘솔과 상호 작용하기 위해 사용됩니다:

# Toolbox pod 찾기
kubectl get pods -lapp=toolbox

# pod 내에서 셸 실행
kubectl exec -it <Toolbox pod 이름> -- bash

# Rails 콘솔 열기
gitlab-rails console -e production

# Rake 작업 실행
gitlab-rake gitlab:env:info

affinity

더 많은 정보는 affinity를 참조하세요.