IBM Cloud Docs
새 주 버전으로 업그레이드

새 주 버전으로 업그레이드

데이터베이스의 주요 버전이 지원 종료(EOL) 상태인 경우 현재 주요 버전으로 업그레이드하는 것이 좋습니다.

Cloud Databases CLI 플러그인 명령 ibmcloud cdb deployables-show또는 Cloud Databases API /deployables 엔드포인트에서 IBM Cloud 카탈로그 페이지의 사용 가능한 Databases for PostgreSQL 버전을 찾으십시오.

새 인스턴스로 업그레이드할 때 애플리케이션의 연결 정보도 변경해야 합니다.

PostgreSQL v12 최신 PostgreSQL 메이저 버전으로 업그레이드하기 위한 요구 사항

pg_repack을(를) 설치한 경우 업그레이드를 수행하기 전에 제거해야 합니다. 이는 다음과 같은 명령을 사용하여 수행할 수 있습니다.

DROP EXTENSION pg_repack;

업그레이드 후 pg_repack 를 다시 설치하십시오. 다음 명령으로 이 작업을 수행할 수 있습니다:

CREATE EXTENSION pg_repack;

PostGIS, 를 사용 중인 경우 PostgresSQL 로 업그레이드하기 전에 먼저 PostGIS 로 업그레이드해야 합니다. PostGIS 이 설치된 데이터베이스에 대해 다음 명령을 실행하면 됩니다.

SELECT postgis_extensions_upgrade();

다음 쿼리를 사용하여 Postgis 확장 프로그램 업그레이드의 유효성을 검사합니다.

SELECT postgis_full_version();

읽기 전용 복제본에서 업그레이드

읽기 전용 복제본을 구성 하여 업그레이드하십시오. 배포와 동일한 데이터베이스 버전으로 읽기 전용 복제본을 프로비저닝하고 모든 데이터를 복제하는 동안 기다립니다. 배포와 복제본이 동기화되면 읽기 전용 복제본을 새 버전의 데이터베이스를 실행하는 전체 독립 실행형 배포로 승격 및 업그레이드합니다. 업그레이드 및 승격 단계를 수행하려면 요청 본문에 업그레이드할 버전을 포함한 POST 요청을 /deployments/{id}/remotes/promotion 엔드포인트에 요청 본문에 업그레이드하려는 버전을 포함시켜야 합니다.

이 요청은 다음과 같습니다.

curl -X POST \
  https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/remotes/promotion \
  -H 'Authorization: Bearer <>'  \
 -H 'Content-Type: application/json' \
 -d '{
    "promotion": {
        "version": "14",
        "skip_initial_backup": false
    }
}' \

skip_initial_backup은 선택사항입니다. true로 설정된 경우 새 배치가 승격을 완료한 후 초기 백업을 작성하지 않습니다. 더 짧은 시간 내에 새 배치를 사용할 수 있지만 대신 다음 자동 백업이 실행되거나 On-Demand 백업을 작성할 때까지 백업되지 않습니다.

승격 및 업그레이드 시범 실행

주요 버전 업그레이드의 효과를 평가하려면 드라이런을 트리거하세요. 건식 실행은 승격 및 업그레이드를 시뮬레이션하며 결과는 데이터베이스 로그에 인쇄됩니다. 로그 분석 통합 를 통해 데이터베이스 로그에 액세스하고 확인할 수 있습니다. 이렇게 하면 현재 확장 프로그램과 함께 실행 중인 버전이 원하는 버전으로 성공적으로 업그레이드될 수 있습니다.

시범 실행은 skip_initial_backupfalse로 설정되고 version이 정의된 상태에서만 실행해야 합니다.

명령은 다음과 같습니다.

curl -X POST \
  https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/remotes/promotion \
  -H 'Authorization: Bearer <>'  \
 -H 'Content-Type: application/json' \
 -d '{
    "promotion": {
        "version": "14",
        "skip_initial_backup": false,
        "dry_run": true
    }
}' \

업그레이드 백업 및 복원

새 데이터베이스 버전을 실행 중인 새 배치로 데이터의 백업을 복원 하여 데이터베이스 버전을 업그레이드할 수 있습니다.

UI에서 업그레이드

_배치 대시보드_의 백업 메뉴에서 백업을 복원 할 때 새 버전으로 업그레이드하십시오. 새 탭의 프로비저닝 페이지로 이동하는 백업에서 복원을 클릭하면 새 배포에 대한 몇 가지 옵션을 변경할 수 있습니다. 옵션 중 하나는 데이터베이스 버전으로, 업그레이드할 수 있는 버전이 자동으로 채워집니다. 버전을 선택하고 만들기를 클릭하여 프로비저닝 및 복원 프로세스를 시작합니다.

CLI를 통한 업그레이드

IBM Cloud CLI를 통해 백업에서 업그레이드 및 복원하려면 리소스 컨트롤러에서 프로비저닝 명령을 사용하세요.

ibmcloud resource service-instance-create <DEPLOYMENT_NAME_OR_CRN> <SERVICE_ID> <SERVICE_PLAN_ID> <REGION>

매개변수 service-name, service-id, service-plan-idregion이 모두 필요합니다. 또한 JSON 오브젝트에 버전 및 백업 ID 매개변수와 함께 -p를 제공합니다. 새 배치는 백업 시 소스 배치와 동일한 디스크 및 메모리로 자동으로 크기가 조정됩니다.

이 명령은 다음과 같습니다.

ibmcloud resource service-instance-create example-upgrade databases-for-postgresql standard us-south \
-p \ '{
  "backup_id": "crn:v1:bluemix:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
  "version":14
}'

API를 통한 업그레이드

리소스 컨트롤러 API 을 백업에서 업그레이드하는 데 사용하기 전에 필요한 단계를 완료하세요. 그런 다음 API에 POST 요청을 보냅니다. name, target, resource_groupresource_plan_id 매개변수는 모두 필수입니다. 또한 버전 및 백업 ID를 제공합니다. 새 배치는 백업 시 소스 배치와 동일한 메모리 및 디스크 할당을 가집니다.

이 명령은 다음과 같습니다.

curl -X POST \
  https://resource-controller.cloud.ibm.com/v2/resource_instances \
  -H 'Authorization: Bearer <>' \
  -H 'Content-Type: application/json' \
    -d '{
    "name": "my-instance",
    "target": "bluemix-us-south",
    "resource_group": "5g9f447903254bb58972a2f3f5a4c711",
    "resource_plan_id": "databases-for-postgresql-standard",
    "backup_id": "crn:v1:bluemix:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
    "version":14
  }'

강제 업그레이드

사용 종료 날짜가 지나면 더 이상 사용되지 않는 버전의 모든 활성 Databases for PostgreSQL 배포가 다음 지원 버전으로 강제로 업그레이드됩니다. 예를 들어 PostgreSQL 버전 12(더 이상 사용되지 않음)는 버전 13으로 업그레이드합니다.

다음과 같은 위험을 피하려면 사용 기간 종료일 전에 업그레이드하세요:

  • 이러한 유형의 강제 업그레이드에는 SLA가 제공되지 않습니다.
  • 일부 데이터 손실이 발생할 수 있습니다.
  • 애플리케이션의 다운타임이 길어질 수 있습니다.
  • 애플리케이션이 새 버전과 호환되지 않는 경우 작동이 중지될 수 있습니다.
  • 이 업그레이드가 배포에 적용되는 시기를 제어할 수는 없습니다.
  • 이 강제 업그레이드에는 롤백 프로세스가 없습니다.

사용 종료 날짜는 버전 정책 페이지를 참조하세요.

주 PostgreSQL 버전에 대한 변경 로그