Auto DevOps를 위한 PostgreSQL 업그레이드
POSTGRES_ENABLED
가 true
일 때, Auto DevOps는 애플리케이션을 위해 클러스터 내 PostgreSQL 데이터베이스를 제공합니다.
프로비저닝에 사용된 차트의 버전:
- 0.7.1부터 8.2.1로 설정할 수 있습니다.
GitLab은 사용자들에게 데이터베이스를 더 최신의 PostgreSQL 차트로 마이그레이션할 것을 권장합니다.
이 가이드에서는 데이터베이스를 마이그레이션하는 방법에 대한 지침을 제공합니다. 이 과정에는 다음이 포함됩니다:
- 데이터베이스 덤프 뜨기
- 더 최신 버전 8.2.1의 차트를 사용하여 새로운 PostgreSQL 데이터베이스 설치 및 이전 PostgreSQL 설치 제거
- 새 PostgreSQL에 데이터베이스 덤프 복원
전제 조건
-
kubectl
을 설치합니다. -
kubectl
을 사용하여 Kubernetes 클러스터에 액세스할 수 있는지 확인합니다. 이는 Kubernetes 공급업체에 따라 다릅니다. - 다운타임을 준비합니다. 아래 단계에는 애플리케이션을 오프라인으로 전환하여 데이터베이스 덤프가 생성된 후 클러스터 내 데이터베이스가 수정되지 않도록합니다.
-
POSTGRES_ENABLED
를false
로 설정하지 않도록 합니다. 이 설정은 기존 채널 1 데이터베이스를 삭제합니다. 자세한 정보는 기존 PostgreSQL 데이터베이스 감지됨을 참조하세요.
애플리케이션 오프라인으로 전환하기
필요한 경우, 데이터베이스 덤프가 생성된 후 데이터베이스가 수정되는 것을 방지하기 위해 애플리케이션을 오프라인으로 전환합니다.
-
환경을 위한 쿠버네티스 네임스페이스를 가져옵니다. 일반적으로
<프로젝트 이름>-<프로젝트 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의 pod 이름을 가져옵니다. 이 예에서 pod 이름은
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
-
다음 명령어로 pod에 연결합니다:
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
-
-
백업 덤프가 완료되면, Kubernetes exec 프로세스를
Control-D
또는exit
로 종료합니다. -
다음 명령어로 덤프 파일을 다운로드합니다:
kubectl cp --namespace "$APP_NAMESPACE" production-postgres-5db86568d7-qxlxv:/tmp/backup.sql backup.sql
지속적인 볼륨 유지
기본적으로 PostgreSQL의 기본 데이터를 저장하는 지속적인 볼륨은 볼륨을 사용하는 pod 및 pod 클레임이 삭제될 때 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 설치
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 파이프라인을 실행합니다. 파이프라인이 성공한 후, 애플리케이션이 이전과 같이 트래픽을 제공해야 합니다.