UI에서 업그레이드

1. 업그레이드 과정을 테스트하기 위해 새로운 Databases for MongoDB 를 생성합니다.
   동일한 버전의 기존 배포 환경에서 백업을 복원하여 배포 환경을 생성하십시오.

2. 스테이징 애플리케이션을 테스트 배포 환경으로 연결하십시오.
   스테이징 애플리케이션을 테스트 배포 환경으로 가리키도록 업데이트하십시오. 테스트 애플리케이션이 스테이징 배포 환경에 성공적으로 연결되는지, 그리고 애플리케이션이 예상대로 작동하는지 확인하십시오. 스테이징 환경에 대해 필요한 모든 성능 및 운영 테스트를 수행하십시오.

3. ‘개요’ 페이지에서 ‘메인 버전 업그레이드’ 버튼을 클릭하여 테스트 배포 환경의 메인 버전을 업그레이드하세요.
   이렇게 하면 업그레이드 과정이 완료될 때까지 데이터베이스가 읽기 전용 모드로 전환됩니다. 업그레이드가 완료되는 데 걸리는 시간을 확인하여, 업그레이드 만료 설정을 통해 업그레이드를 유지보수 시간 내에 완료할 수 있도록 하십시오.

4. 스테이징 애플리케이션이 새로운 데이터베이스 버전에서 정상적으로 작동하는지 확인하십시오.
   애플리케이션이 정상적으로 작동한다면, 이 단계를 통해 프로덕션 데이터베이스를 안전하게 업그레이드할 수 있음을 확인할 수 있습니다.

5. 프로덕션 데이터베이스 배포 환경을 새 버전으로 업그레이드하십시오.
   새로운 버전의 데이터베이스를 사용하여 애플리케이션이 정상적으로 작동하는지 확인한 후에는 관리 콘솔로 돌아가 프로덕션 환경의 업그레이드 절차를 시작할 수 있습니다. ‘개요’ 페이지의 ‘배포 세부 정보’ 섹션에서 ‘메인 버전 업그레이드’ 버튼을 클릭한 다음 안내에 따라 진행하십시오.

   현장 업그레이드 프로세스가 시작되면 중지하거나 롤백할 수 없습니다. 따라서, 설령 오류가 발생할 가능성이 희박하더라도 데이터베이스 배포가 복구 불가능한 상태가 될 수 있습니다. 따라서, 나중에 새로운 배포 환경으로 복원하는 데 사용할 수 있는 백업을 생성하십시오. '백업과 함께 현장에서 주요 버전 업그레이드'를 선택하면, 생성된 백업을 사용하여 새로운 배포 환경에서 시스템을 복원할 수 있습니다.

expiration for starting upgrade 를 사용하면 업그레이드 작업이 자동으로 취소되기 전에 시작되어야 하는 ‘타임아웃’ 기간을 설정할 수 있습니다. 또한, 업그레이드가 원하는 시간 내에 완료되는지 확인하기 위해 사전에 스테이징 환경에서 업그레이드를 테스트하십시오. 예를 들어, 1시간 이내에 업그레이드를 완료하고자 하고, 테스트 결과 업그레이드에 30분이 소요된다는 것을 알고 있다면, 업그레이드를 진행하겠다고 확인한 시점부터 30분 이내에 업그레이드 작업이 시작되어야 합니다. 따라서 만료 시간을 30분으로 설정하세요. 그래야 해당 시간 내에 시작되지 않더라도 처리 시간 범위를 초과하지 않게 됩니다.

API를 통한 업그레이드

다음 명령을 사용하여 현장에서 업그레이드하십시오:

curl -X PATCH https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/version -H 'Authorization: Bearer <>' -H 'Content-Type: application/json' -d '{"version": "7.0"}'

expiration for starting upgrade 를 사용하면 업그레이드 작업이 자동으로 취소되기 전에 시작되어야 하는 ‘타임아웃’ 기간을 설정할 수 있습니다. 또한, 업그레이드가 원하는 시간 내에 완료되는지 확인하기 위해 사전에 스테이징 환경에서 업그레이드를 테스트하십시오. 예를 들어, 1시간 이내에 업그레이드를 완료하고자 하고, 테스트 결과 업그레이드에 30분이 소요된다는 것을 알고 있다면, 업그레이드를 진행하겠다고 확인한 시점부터 30분 이내에 업그레이드 작업이 시작되어야 합니다. 따라서 만료 시간을 지금부터 30분 후의 타임스탬프로 설정하십시오. 그래야 해당 시간 내에 시작되지 않더라도 처리 시간대를 초과하는 일이 없습니다. 만료 시간은 현재 시점으로부터 5분(기본값)에서 24시간 사이여야 합니다. 자세한 내용은 ‘ Cloud Databases ’ API 를 참조하십시오.

CLI를 통한 업그레이드

CDB 플러그인 버전 0.20.0 이상에서 사용할 수 있습니다.

배포에 대해 허용된 업그레이드 및 복원 전환 목록을 보려면:

ibmcloud cdb deployment-capability-show <NAME|CRN> versions

명령어를 필요한 매개변수와 함께 업그레이드하려면:

ibmcloud cdb deployment-version-upgrade <NAME|CRN> <TARGET_VERSION>

명령어 매개변수의 전체 세부 정보를 보려면:

ibmcloud cdb deployment-version-upgrade --help

expiration for starting upgrade 를 사용하면 업그레이드 작업이 자동으로 취소되기 전에 시작되어야 하는 ‘타임아웃’ 기간을 설정할 수 있습니다. 또한, 업그레이드가 원하는 시간 내에 완료되는지 확인하기 위해 사전에 스테이징 환경에서 업그레이드를 테스트하십시오. 예를 들어, 1시간 이내에 업그레이드를 완료하고자 하고, 테스트 결과 업그레이드에 30분이 소요된다는 것을 알고 있다면, 업그레이드를 진행하겠다고 확인한 시점부터 30분 이내에 업그레이드 작업이 시작되어야 합니다. 따라서 만료 시간을 30분으로 설정하세요. 그래야 해당 시간 내에 시작되지 않더라도 처리 시간 범위를 초과하지 않게 됩니다. 만료 시간은 현재 시점으로부터 5분(기본값)에서 24시간 사이여야 합니다. CLI를 사용하여 만료 기간을 설정하는 방법에는 두 가지가 있습니다. --expire-in 또는 --expire-at. 자세한 내용은 해당 명령어의 도움말에서 확인하십시오.

Terraform을 통한 업그레이드

Terraform 프로바이더 버전 1.79.2 이상에서 사용할 수 있습니다.

업그레이드하려면 구성 파일에서 version 값을 추가하거나 변경하기만 하면 됩니다. 또한 백업을 건너뛰도록 설정할 수 있는 선택적 bool 플래그인 version_upgrade_skip_backup``도 있습니다.

백업을 건너뛰는 것은 권장하지 않습니다. 버전 업그레이드 전에 백업을 생략하는 것은 위험하며, 업그레이드 과정 중 어느 단계에서든 실패할 경우 데이터 손실로 이어질 수 있습니다. 복구할 수 있는 최신 백업이 없기 때문입니다.

업그레이드 중에는 데이터베이스가 읽기 전용 모드로 전환됩니다. 업그레이드하기 전에 테스트를 진행하는 것을 적극 권장합니다.

업그레이드에는 기본 시간 제한보다 더 많은 시간이 소요될 수 있습니다. timeouts 속성을 사용하면 더 긴 타임아웃 값을 설정할 수 있습니다.

Terraform에는 만료 타임스탬프 대신 타임아웃이 있습니다. 따라서, 타임아웃 업데이트 값이 만료 시점으로 사용되므로 타임아웃 시간을 늘리십시오. 예를 들어, 타임아웃을 20분으로 설정하면 만료 시간이 20분으로 설정되며, 해당 시간 내에 업그레이드가 시작되지 않으면 만료되어 업그레이드가 시작되지 않습니다. 최대 유효 기간은 24시간이라는 점에 유의하십시오. 따라서 타임아웃을 36시간으로 설정하더라도, 처음 24시간 이내에 업그레이드가 시작되지 않으면 유효 기간이 만료됩니다.

업그레이드가 진행 중인 경우, 일부 작업이 대기열에 등록되어 버전 업그레이드가 완료될 때까지 진행되지 않을 수 있으니 유의하시기 바랍니다.

UI에서 업그레이드

새로운 호스팅 모델(독립형 컴퓨팅 및 공유형 컴퓨팅)의 경우, CLI 및 API를 통해 새로운 주요 버전으로 업그레이드할 수 있습니다.

IBM Cloud 콘솔의 배포 항목에 있는 ‘백업 및 복원’ 페이지에서 백업을 복원하여 새 버전으로 업그레이드할 수 있습니다. 백업 항목에서 ‘백업 복원’을 클릭하면 새 탭에 페이지가 열리며, 여기서 새로운 배포에 대한 몇 가지 옵션을 변경할 수 있습니다. 옵션 중 하나는 데이터베이스 버전으로 업그레이드할 수 있는 버전으로 자동으로 채워집니다. 버전을 선택한 후 ‘백업 복원’을 클릭하여 프로비저닝 및 복원 절차를 시작하십시오.

CLI를 통한 업그레이드

IBM Cloud CLI를 통해 백업에서 업그레이드 및 복원하는 경우에는 리소스 제어기에서 프로비저닝 명령을 사용하십시오.

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

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

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

API를 통한 업그레이드

API를 통한 프로비저닝과 마찬가지로, 백업 파일을 사용하여 업그레이드하려면 먼저 리소스 컨트롤러 API를 사용하기 위해 필요한 단계 를 완료해야 합니다. 그런 다음, API를 POST 요청으로 전송하십시오. name, target, resource_group 및 resource_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": "us-south",
    "resource_group": "5g9f447903254bb58972a2f3f5a4c711",
    "resource_plan_id": "databases-for-mongodb-standard",
    "backup_id": "crn:v1:bluemix:public:databases-for-mongodb:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
    "version":"7.0"
  }'

Terraform을 통한 업그레이드

Terraform을 사용하여 이전 버전의 백업에서 새 버전으로 복원합니다.

1. backup_id 를 설정하세요. 자세한 정보는 backup_id의 내용을 참조하십시오.
2. version 속성에 version 를 설정하세요. 자세한 정보는 version의 내용을 참조하십시오.

코드는 다음과 같습니다:

resource "ibm_database" "<your-instance>" {
  name                                 = "<your_database_name>"
  service                              = "<service>"
  plan                                 = "<plan>"
  location                             = "<region>"
  version                              = "<version>"
  backup_id                            = "<backup_id>"
}

자세한 내용은 Cloud Databases Terraform 레지스트리를 참조하십시오.