Auto DevOps를 위한 PostgreSQL 업그레이드
세부 정보: Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
POSTGRES_ENABLED
가 true
일 때 Auto DevOps는 애플리케이션을 위해
in-cluster PostgreSQL database를 제공합니다.
프로비저닝에 사용된 차트 버전은 다음과 같습니다:
- GitLab 12.8 및 이전 버전에서는 0.7.1입니다.
- GitLab 12.9 이상에서는 0.7.1부터 8.2.1까지 설정할 수 있습니다.
GitLab은 사용자들에게 데이터베이스를 최신 PostgreSQL 차트로 마이그레이션하도록 권장합니다.
본 가이드는 PostgreSQL 데이터베이스를 마이그레이션하는 방법에 대한 지침을 제공하며, 다음을 포함합니다:
- 데이터베이스 덤프 가져오기.
- 차트의 새로운 버전 8.2.1을 사용하여 새로운 PostgreSQL 데이터베이스 설치 및 이전 PostgreSQL 설치 제거.
- 새 PostgreSQL로 데이터베이스 덤프 복원.
사전 요구 사항
-
kubectl
설치. -
kubectl
을 사용하여 Kubernetes 클러스터에 액세스할 수 있는지 확인하세요. 이는 Kubernetes 제공 업체에 따라 다릅니다. - 다운타임 준비. 아래 단계에는 적용 프로그램을 오프라인 상태로 전환하는 것이 포함되어 있으므로 데이터베이스 덤프가 생성된 후 클러스터 내 데이터베이스가 수정되지 않도록 합니다.
-
POSTGRES_ENABLED
를false
로 설정하지 않았는지 확인하세요. 이 설정은 채널 1의 기존 데이터베이스를 삭제합니다. 자세한 내용은 기존 PostgreSQL 데이터베이스를 찾았음을 참조하세요.
참고: 스테이징을 갖도록 Auto DevOps를 구성했다면, 먼저 스테이징에서 백업 및 복원 단계를 시도하거나 리뷰 앱에서 시도해보십시오.
애플리케이션 오프라인으로 전환
필요한 경우, 데이터베이스 덤프 생성 후 데이터베이스가 수정되는 것을 방지하기 위해 애플리케이션을 오프라인으로 전환하세요.
-
환경을 위한 Kubernetes 네임스페이스를 가져옵니다. 일반적으로
<프로젝트-이름>-<프로젝트-id>-<환경>
와 같습니다. 이 예에서 네임스페이스는minimal-ruby-app-4349298-production
으로 지정되었습니다.$ kubectl get ns NAME STATUS AGE minimal-ruby-app-4349298-production Active 7d14h
-
사용 편의를 위해 네임스페이스 이름을 내보냅니다:
export APP_NAMESPACE=minimal-ruby-app-4349298-production
-
애플리케이션의 배포 이름을 다음 명령어로 가져옵니다. 이 예에서 배포 이름은
production
입니다.$ kubectl get deployment --namespace "$APP_NAMESPACE" NAME READY UP-TO-DATE AVAILABLE AGE production 2/2 2 2 7d21h production-postgres 1/1 1 1 7d21h
-
데이터베이스가 수정되는 것을 방지하기 위해 다음 명령어로 배포의 레플리카를 0으로 설정합니다. 앞 단계에서 배포 이름을 사용하였습니다(
deployments/<DEPLOYMENT_NAME>
).$ kubectl scale --replicas=0 deployments/production --namespace "$APP_NAMESPACE" deployment.extensions/production scaled
-
작업자에 대해서도 레플리카를 0으로 설정해야 합니다.
백업
-
PostgreSQL의 서비스 이름을 가져옵니다. 서비스 이름은 일반적으로
-postgres
로 끝납니다. 이 예에서 서비스 이름은production-postgres
입니다.$ kubectl get svc --namespace "$APP_NAMESPACE" NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE production-auto-deploy ClusterIP 10.30.13.90 <none> 5000/TCP 7d14h production-postgres ClusterIP 10.30.4.57 <none> 5432/TCP 7d14h
-
다음 명령어로 PostgreSQL의 파드 이름을 가져옵니다. 이 예에서 파드 이름은
production-postgres-5db86568d7-qxlxv
입니다.$ kubectl get pod --namespace "$APP_NAMESPACE" -l app=production-postgres NAME READY STATUS RESTARTS AGE production-postgres-5db86568d7-qxlxv 1/1 Running 0 7d14h
-
다음 명령어로 파드에 연결합니다:
kubectl exec -it production-postgres-5db86568d7-qxlxv --namespace "$APP_NAMESPACE" -- bash
-
연결된 후, 다음 명령어로 덤프 파일을 생성합니다.
-
SERVICE_NAME
은 이전 단계에서 얻은 서비스 이름입니다. -
USERNAME
은 PostgreSQL에 구성한 사용자 이름입니다. 기본값은user
입니다. -
DATABASE_NAME
은 보통 환경 이름입니다. -
데이터베이스 암호를 요청받으면, 기본값은
testing-password
입니다.## 형식은 다음과 같습니다: # pg_dump -h SERVICE_NAME -U USERNAME DATABASE_NAME > /tmp/backup.sql pg_dump -h production-postgres -U user production > /tmp/backup.sql
-
-
백업 덤프를 완료하면,
Control-D
또는exit
를 사용하여 Kubernetes exec 프로세스를 종료합니다. -
다음 명령어로 덤프 파일을 다운로드합니다:
kubectl cp --namespace "$APP_NAMESPACE" production-postgres-5db86568d7-qxlxv:/tmp/backup.sql backup.sql
영속 볼륨 유지
기본적으로 영속 볼륨은 PostgreSQL의 기본 데이터를 저장할 때 사용되며, 해당 볼륨을 사용하는 파드 및 파드 클레임이 삭제될 때 Delete
로 표시됩니다.
이것은 최신 8.2.1 PostgreSQL로 전환할 때 중요한데, 이전 0.7.1 PostgreSQL이 삭제되면 영속 볼륨도 삭제된다는 것입니다.
다음 명령을 사용하여 확인할 수 있습니다.
$ kubectl get pv
NAME CAPACITY ACCESS MODES RECLAIM POLICY STATUS CLAIM STORAGECLASS REASON AGE
pvc-0da80c08-5239-11ea-9c8d-42010a8e0096 8Gi RWO Delete Bound minimal-ruby-app-4349298-staging/staging-postgres standard 7d22h
pvc-9085e3d3-5239-11ea-9c8d-42010a8e0096 8Gi RWO Delete Bound minimal-ruby-app-4349298-production/production-postgres standard 7d22h
이전 0.7.1 PostgreSQL이 삭제되더라도 영속 볼륨을 유지하려면 보관 정책을 Retain
으로 변경할 수 있습니다. 이 예에서는 클레임 이름을 통해 영속 볼륨 이름을 찾습니다. minimal-ruby-app-4349298
어플리케이션의 스테이징 및 프로덕션용 볼륨을 유지하는 것에 관심이 있기 때문에 여기서의 볼륨 이름은 pvc-0da80c08-5239-11ea-9c8d-42010a8e0096
및 pvc-9085e3d3-5239-11ea-9c8d-42010a8e0096
입니다.
$ kubectl patch pv pvc-0da80c08-5239-11ea-9c8d-42010a8e0096 -p '{"spec":{"persistentVolumeReclaimPolicy":"Retain"}}'
persistentvolume/pvc-0da80c08-5239-11ea-9c8d-42010a8e0096 patched
$ kubectl patch pv pvc-9085e3d3-5239-11ea-9c8d-42010a8e0096 -p '{"spec":{"persistentVolumeReclaimPolicy":"Retain"}}'
persistentvolume/pvc-9085e3d3-5239-11ea-9c8d-42010a8e0096 patched
$ kubectl get pv
NAME CAPACITY ACCESS MODES RECLAIM POLICY STATUS CLAIM STORAGECLASS REASON AGE
pvc-0da80c08-5239-11ea-9c8d-42010a8e0096 8Gi RWO Retain Bound minimal-ruby-app-4349298-staging/staging-postgres standard 7d22h
pvc-9085e3d3-5239-11ea-9c8d-42010a8e0096 8Gi RWO Retain Bound minimal-ruby-app-4349298-production/production-postgres standard 7d22h
새 PostgreSQL 설치
경고: 최신 버전의 PostgreSQL을 사용하면 이전 0.7.1 PostgreSQL이 삭제됩니다. 기본 데이터가 삭제되는 것을 방지하려면 영속 볼륨을 보관할 수 있습니다.
참고:
또한 AUTO_DEVOPS_POSTGRES_CHANNEL
, AUTO_DEVOPS_POSTGRES_DELETE_V1
및 POSTGRES_VERSION
변수를 특정 환경에 대해 배제할 수 있습니다. 예를 들어, staging
에 대해 설정할 수 있습니다.
-
AUTO_DEVOPS_POSTGRES_CHANNEL
을2
로 설정합니다. 이렇게하면 최신 8.2.1 기반 PostgreSQL을 사용하도록 변경되며, 이전 0.7.1 기반 PostgreSQL도 제거됩니다. -
AUTO_DEVOPS_POSTGRES_DELETE_V1
을 비어 있지 않은 값으로 설정합니다. 이 플래그는 데이터베이스의 실수로 삭제되는 것을 방지하는 보안 기능입니다. -
POSTGRES_VERSION
이 설정되어 있으면9.6.16
또는 그 이후 버전으로 설정됩니다. 이것은 Auto DevOps에서 지원하는 최소 PostgreSQL 버전입니다. 또한 사용 가능한 태그 목록도 참조하십시오. -
PRODUCTION_REPLICAS
를0
으로 설정합니다. 다른 환경에서는 환경 범위를 사용하여REPLICAS
를 설정합니다. -
DB_INITIALIZE
또는DB_MIGRATE
변수를 설정했을 경우, 변수를 제거하거나 일시적으로 변수 이름을XDB_INITIALIZE
나XDB_MIGRATE
로 변경하여 비활성화합니다. - 브랜치에 대해 새 CI 파이프라인을 실행합니다. 이 경우,
main
에 대해 새 CI 파이프라인을 실행합니다. - 파이프라인이 성공적으로 실행된 후에는 새 PostgreSQL이 설치된 애플리케이션이 업그레이드됩니다. 이 시점에서 0개의 레플리카가 존재하므로 애플리케이션에 대한 트래픽이 제공되지 않습니다 (새 데이터가 들어오는 것을 방지하기 위함).
복원
-
새로운 PostgreSQL의 pod 이름을 가져옵니다. 이 예에서는 pod 이름이
production-postgresql-0
입니다:$ kubectl get pod --namespace "$APP_NAMESPACE" -l app=postgresql NAME READY STATUS RESTARTS AGE production-postgresql-0 1/1 Running 0 19m
-
백업 단계에서 덤프 파일을 해당 pod로 복사합니다:
kubectl cp --namespace "$APP_NAMESPACE" backup.sql production-postgresql-0:/tmp/backup.sql
-
해당 pod에 연결합니다:
kubectl exec -it production-postgresql-0 --namespace "$APP_NAMESPACE" -- bash
-
pod에 연결된 후, 다음 명령어를 실행하여 데이터베이스를 복원합니다.
- 데이터베이스 암호를 요청받으면, 기본값은
testing-password
입니다. -
USERNAME
은 PostgreSQL을 위해 구성한 사용자 이름입니다. 기본값은user
입니다. -
DATABASE_NAME
은 일반적으로 환경 이름입니다.
## 형식은: # psql -U USERNAME -d DATABASE_NAME < /tmp/backup.sql psql -U user -d production < /tmp/backup.sql
- 데이터베이스 암호를 요청받으면, 기본값은
-
복원이 완료되면 데이터가 올바르게 복원되었는지 확인할 수 있습니다.
psql
을 사용하여 데이터의 일부를 확인할 수 있습니다.
애플리케이션 복구
데이터베이스가 복원되었음을 확인한 후, 다음 단계를 실행하여 애플리케이션을 복구합니다:
- 이전에 제거되었거나 비활성화된 경우
DB_INITIALIZE
및DB_MIGRATE
변수를 복원합니다. -
PRODUCTION_REPLICAS
또는REPLICAS
변수를 원래 값으로 복원합니다. - 브랜치에 대해 새 CI 파이프라인을 실행합니다. 이 경우
main
에 대해 새 CI 파이프라인을 실행합니다. 파이프라인이 성공적으로 완료되면, 애플리케이션이 이전과 같이 트래픽을 제공해야 합니다.