Amazon DocumentDB 유지 관리 - Amazon DocumentDB

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon DocumentDB 유지 관리

Amazon DocumentDB는 Amazon DocumentDB 리소스를 정기적으로 유지 관리합니다. 이러한 유지 관리에는 대개 데이터베이스 엔진(클러스터 유지 관리) 또는 인스턴스의 기본 운영 체제(OS)(인스턴스 유지 관리)에 대한 업데이트가 포함됩니다. 데이터베이스 엔진 업데이트는 필수 패치이며 보안 수정, 버그 수정 및 데이터베이스 엔진 개선 사항을 포함합니다. 대부분의 운영 체제 패치는 선택 사항이지만 한동안 적용하지 않으면 보안 태세를 유지하기 위해 패치가 필요하며 자동으로 적용될 수 있습니다. 따라서 Amazon DocumentDB 인스턴스에 운영 체제 업데이트가 제공되는 즉시 적용하는 것이 좋습니다.

데이터베이스 엔진 패치를 사용하려면 Amazon DocumentDB 클러스터를 잠시 오프라인 상태로 전환해야 합니다. 패치를 사용할 수 있게 되면 Amazon DocumentDB 클러스터의 예정된 유지 관리 기간 중에 적용되도록 자동으로 예약됩니다.

클러스터 및 인스턴스 유지 관리 모두 해당 유지 관리 기간이 있습니다. 즉시 적용하지 않기로 선택한 클러스터 및 인스턴스 수정 사항도 유지 관리 기간 중에 적용됩니다. 기본적으로 클러스터를 생성할 때 Amazon DocumentDB가 클러스터 및 각 개별 인스턴스에 대해 유지 관리 기간을 지정합니다. 클러스터 또는 인스턴스를 생성할 때 유지 관리 기간을 선택할 수 있습니다. 또한 언제라도 비즈니스 일정 또는 절차에 맞춰 유지 관리 기간을 수정할 수 있습니다. 일반적으로 애플리케이션에 대 유지 관리의 영향을 최소화하는 유지 관리 기간을 서택하는 것이 좋습니다(예: 야간 또는 주말).

Amazon DocumentDB 엔진 패치에 대한 알림

AWS 콘솔의 AWS Health Dashboard (AHD) 상태 이벤트와 이메일을 통해 필수 데이터베이스 엔진 패치에 대한 유지 관리 알림을 받게 됩니다. AWS 특정 지역에서 Amazon DocumentDB 엔진 유지 관리 패치를 사용할 수 있게 되면 해당 지역의 영향을 받는 모든 Amazon DocumentDB 사용자 계정이 패치의 영향을 받는 각 Amazon DocumentDB 버전에 대한 AHD 및 이메일 알림을 받게 됩니다. 콘솔의 AHD의 예정된 변경 사항 섹션에서 이러한 알림을 확인할 수 있습니다. AWS 알림에는 패치 가용성 시기, 자동 적용 일정, 영향을 받는 클러스터 목록 및 릴리스 노트에 대한 세부 정보가 포함됩니다. 이 알림은 전자 메일을 통해 AWS 계정의 루트 사용자 전자 메일 주소로도 전달됩니다.

엔진 패치 업그레이드를 위한 예정된 변경 사항 탭을 보여주는 Amazon DocumentDB 콘솔.

이 알림을 받으면 예정된 자동 적용 날짜 이전에 Amazon DocumentDB 클러스터에 이러한 엔진 패치를 자체 적용하도록 선택할 수 있습니다. 또는 예정된 유지 관리 기간 동안 엔진 패치가 자동으로 적용될 때까지 기다릴 수 있습니다 (기본 옵션).

참고

AHD의 알림 상태는 새 엔진 패치 버전이 포함된 새 Amazon DocumentDB 엔진 패치가 릴리스될 때까지 '진행 중'으로 설정됩니다.

Amazon DocumentDB 클러스터에 엔진 패치를 적용하면 클러스터의 엔진 패치 버전이 업데이트되어 알림의 버전을 반영합니다. db.runCommand({getEngineVersion: 1})명령을 실행하여 이 업데이트를 확인할 수 있습니다.

AWS Health 또한 이벤트를 사용하여 확장 가능한 이벤트 기반 애플리케이션을 구축하는 Amazon과 EventBridge 통합되며 Amazon Simple Queue Service (SQS) 등을 비롯한 AWS Lambda 20개 이상의 대상과 통합됩니다. 엔진 패치가 EventBridge 제공되기 전에 AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_SCHEDULED 이벤트 코드를 사용하여 Amazon을 설정할 수 있습니다. 이벤트에 EventBridge 응답하도록 설정하고, Amazon DocumentDB 엔진 패치를 해당 지역에서 사용할 수 있게 되면 이벤트 정보 캡처, 추가 이벤트 시작, 추가 채널을 통한 알림 전송 (예: 푸시 알림) AWS Console Mobile Application, 수정 또는 기타 조치 취와 같은 작업을 자동으로 수행할 수 있습니다.

Amazon DocumentDB가 엔진 패치를 취소하는 드문 시나리오의 경우 AHD 알림과 취소 사실을 알리는 이메일을 받게 됩니다. 따라서 AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_CANCELLED 이벤트 코드를 사용하여 Amazon이 이 이벤트에 EventBridge 응답하도록 설정할 수 있습니다. Amazon EventBridge 규칙 사용에 대해 자세히 알아보려면 Amazon 사용 EventBridge 설명서를 참조하십시오.

보류 중인 Amazon DocumentDB 유지 관리 작업 보기

AWS Management Console 또는 를 사용하여 클러스터에 대한 유지 관리 업데이트가 제공되는지 여부를 확인할 수 AWS CLI있습니다.

업데이트가 있을 경우에는 다음 중 한 가지를 선택할 수 있습니다.

  • 다음 유지 관리 기간으로 현재 예정된 유지 관리 작업을 연기하십시오 (OS 패치에만 해당).

  • 유지 관리 작업을 즉시 적용합니다.

  • 다음 유지 관리 기간 중 시작할 유지 관리 작업을 예약합니다.

참고

아무 조치도 취하지 않으면 엔진 패치와 같은 필수 유지 관리 작업이 예정된 예정된 유지 관리 기간에 자동으로 적용됩니다.

유지 관리 기간에 따라 대기 중인 작업의 시작 시기가 결정되지만 이러한 작업의 전체 실행 시간이 제한되지는 않습니다.

Using the AWS Management Console
  1. 에 AWS Management Console로그인하고 https://console.aws.amazon.com/docdb 에서 Amazon DocumentDB 콘솔을 엽니다.

  2. 탐색 창에서 클러스터를 선택합니다.

  3. 업데이트가 있는 경우 다음과 같이 Amazon DocumentDB 콘솔의 클러스터에 대한 유지 관리 열에 이용 가능, 필수 또는 다음 창의 단어로 표시됩니다.

    클러스터에 대한 유지 관리 열을 보여주는 Amazon DocumentDB 콘솔
  4. 조치를 취하려면 클러스터를 선택하여 세부 정보를 표시한 후 유지 관리 및 백업을 선택하십시오. 그러면 대기 중인 유지 관리 항목이 표시됩니다.

    클러스터 유지 관리 창을 보여주는 Amazon DocumentDB 콘솔
Using the AWS CLI

다음 AWS CLI 작업을 사용하여 보류 중인 유지 관리 작업을 확인하십시오. 출력에는 대기 중인 유지 관리 작업이 없습니다.

aws docdb describe-pending-maintenance-actions

이 작업의 출력은 다음과 같습니다(JSON 형식).

{ "PendingMaintenanceActions": [] }

Amazon DocumentDB 엔진 업데이트

Amazon DocumentDB를 사용하여 유지 관리 작업을 적용하는 시기를 선택할 수 있습니다. 또는 를 사용하여 Amazon DocumentDB에서 업데이트를 적용하는 시기를 결정할 수 있습니다. AWS Management Console AWS CLI

이번 주제에서 설명하는 절차에 따라 클러스터를 즉시 업그레이드하거나, 업드레이드 일정을 예약합니다.

Using the AWS Management Console

콘솔을 사용하여 Amazon DocumentDB 클러스터에 대한 업데이트를 관리할 수 있습니다.

클러스터에 대한 업데이트를 관리하려면
  1. 에 AWS Management Console로그인하고 https://console.aws.amazon.com/docdb 에서 Amazon DocumentDB 콘솔을 엽니다.

  2. 탐색 창에서 클러스터를 선택합니다.

  3. 클러스터 목록에서 유지 관리 작업을 적용할 클러스터의 이름 옆에 있는 버튼을 선택합니다.

  4. 작업 메뉴에서 다음 중 하나를 선택합니다.

    • 지금 업그레이드: 대기 중인 유지 관리 작업을 즉시 수행합니다.

    • 다음에 업그레이드: 클러스터의 다음 유지 관리 기간 중에 대기 중인 유지 관리 작업을 수행합니다.

    또는 클러스터의 유지 관리 및 백업 탭의 대기 중인 유지 관리 섹션에서 지금 적용 또는 다음 유지 관리 창에 적용을 클릭할 수 있습니다(이전 섹션의 AWS Management Console 사용 참조).

    참고

    대기 중인 유지 관리 작업이 없는 경우 위의 두 옵션이 모두 비활성화됩니다.

Using the AWS CLI

보류 중인 업데이트를 클러스터에 적용하려면 작업을 사용하십시오. apply-pending-maintenance-action AWS CLI

파라미터
  • --resource-identifier - 대기 중인 유지 관리 작업이 적용되는 Amazon DocumentDB Amazon 리소스 이름(ARN)입니다.

  • --apply-action - 이 리소스에 적용할 대기 중인 유지 관리 작업입니다.

    유효한 값: system-updatedb-upgrade

  • --opt-in-type - 옵트인 요청의 유형을 지정하거나 옵트인 요청을 실행 취소하는 값입니다. immediate 유형의 옵트인 요청은 실행 취소할 수 없습니다.

    유효한 값:

    • immediate - 유지 관리 작업을 즉시 적용합니다.

    • next-maintenance - 리소스에 대한 다음 유지 관리 기간 중에 유지 관리 작업을 적용합니다.

    • undo-opt-in - 기존 next-maintenance 옵트인 요청을 취소합니다.

Linux, macOS, Unix의 경우:

aws docdb apply-pending-maintenance-action \ --resource-identifier arn:aws:rds:us-east-1:123456789012:db:docdb \ --apply-action system-update \ --opt-in-type immediate

Windows의 경우:

aws docdb apply-pending-maintenance-action ^ --resource-identifier arn:aws:rds:us-east-1:123456789012:db:docdb ^ --apply-action system-update ^ --opt-in-type immediate

하나 이상의 보류 중인 업데이트가 있는 리소스 목록을 반환하려면 describe-pending-maintenance-actions AWS CLI 작업을 사용하십시오.

Linux, macOS, Unix의 경우:

aws docdb describe-pending-maintenance-actions \ --resource-identifier arn:aws:rds:us-east-1:001234567890:db:docdb

Windows의 경우:

aws docdb describe-pending-maintenance-actions ^ --resource-identifier arn:aws:rds:us-east-1:001234567890:db:docdb

이 작업의 출력은 다음과 같습니다(JSON 형식).

{ "PendingMaintenanceActions": [ { "ResourceIdentifier": "arn:aws:rds:us-east-1:001234567890:cluster:sample-cluster", "PendingMaintenanceActionDetails": [ { "Action": "system-update", "CurrentApplyDate": "2019-01-11T03:01:00Z", "Description": "db-version-upgrade", "ForcedApplyDate": "2019-01-18T03:01:00Z", "AutoAppliedAfterDate": "2019-01-11T03:01:00Z" } ] } ] }

describe-pending-maintenance-actions AWS CLI 작업의 --filters 파라미터를 지정하여 클러스터의 리소스 목록을 반환할 수도 있습니다. --filters 작업의 형식은 Name=filter-name,Values=resource-id,...입니다.

필터의 Name 파라미터에 대해 허용되는 값은 db-cluster-id입니다. 이 값은 클러스터 식별자 또는 ARN 목록을 허용합니다. 반환되는 목록에는 이러한 식별자 또는 ARN으로 식별된 클러스터에 대해 보류 중인 유지 관리 작업만 포함됩니다.

다음 예에서는 sample-cluster1sample-cluster2 클러스터에 대해 보류 중인 유지 관리 작업을 반환합니다.

Linux, macOS, Unix의 경우:

aws docdb describe-pending-maintenance-actions \ --filters Name=db-cluster-id,Values=sample-cluster1,sample-cluster2

Windows의 경우:

aws docdb describe-pending-maintenance-actions ^ --filters Name=db-cluster-id,Values=sample-cluster1,sample-cluster2

날짜 적용

각 유지 관리 작업에는 대기 중인 유지 관리 작업을 설명할 때 찾을 수 있는 적용 날짜가 있습니다. 에서 보류 중인 유지 관리 작업의 결과를 읽으면 다음 AWS CLI세 날짜가 나열됩니다.

  • CurrentApplyDate - 유지 관리 작업이 즉시 또는 다음 유지 관리 기간에 적용되는 날짜입니다. 해당 유지 관리가 선택 항목일 경우 이 값은 null입니다.

  • ForcedApplyDate - 유지 관리가 사용자의 유지 관리 기간과 상관없이 자동으로 적용되는 날짜입니다.

  • AutoAppliedAfterDate - 유지 관리가 클러스터의 유지 관리 기간 동안 이 날짜 이후에 적용됩니다.

사용자가 시작한 업데이트

Amazon DocumentDB 사용자가 클러스터 또는 인스턴스에 대한 업데이트를 시작할 수 있습니다. 예를 들어 사용자가 인스턴스의 클래스를 메모리 용량이 다른 클래스로 수정하거나 클러스터의 파라미터 그룹을 수정할 수 있습니다. Amazon DocumentDB는 이러한 변경 사항을 Amazon DocumentDB에서 시작한 업데이트와 다르게 봅니다. 클러스터 또는 인스턴스 수정에 대한 자세한 정보는 다음 단원 중 하나를 참조하십시오.

대기 중인 사용자 시작 변경 사항의 목록을 보려면 다음 명령을 실행합니다.

인스턴스에서 대기 중인 사용자 시작 변경 사항을 보려면

Linux, macOS, Unix의 경우:

aws docdb describe-db-instances \ --query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]'

Windows의 경우:

aws docdb describe-db-instances ^ --query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]'

이 작업의 출력은 다음과 같습니다(JSON 형식).

이 경우, sample-cluster-instancedb.r5.xlarge 인스턴스 클래스에 대기 중인 변경 사항이 있고, sample-cluster-instance-2는 대기 중인 변경 사항이 없습니다.

[ [ "sample-cluster", "sample-cluster-instance", { "DBInstanceClass": "db.r5.xlarge" } ], [ "sample-cluster", "sample-cluster-instance-2", {} ] ]

Amazon DocumentDB 유지 관리 기간 관리

각 인스턴스 및 클러스터에는 대기 중인 변경 사항이 적용되는 주 단위 유지 관리 기간이 있습니다. 유지 관리 기간은 요청 또는 필요에 따라 수정하거나 소프트웨어 패치를 적용하는 시기를 조정할 수 있는 기간입니다. 유지 관리 이벤트가 특정 주에 예정되어 있는 경우 사용자가 지정하는 30분의 유지 관리 기간 중에 해당 이벤트가 시작됩니다. 또한 대부분의 유지 관리 이벤트가 30분의 유지 관리 기간 중에 완료됩니다. 단, 대규모 유지 관리 이벤트는 완료하는 데 30분이 넘게 걸릴 수 있습니다.

리전별로 8시간 블록 시간 중에서 30분 유지 관리 기간이 임의로 선택됩니다. 인스턴스 또는 클러스터를 생성할 때 기본 유지 관리 기간을 지정하지 않으면 Amazon DocumentDB에서 임의로 선택한 요일에 30분 유지 관리 기간을 배정합니다.

다음 표는 기본 유지 관리 기간을 할당하는 각 리전의 시간 블록 목록입니다.

리전 이름 지역 UTC 시간 블록
미국 동부(오하이오) us-east-2 03:00~11:00
미국 동부(버지니아 북부) us-east-1 03:00~11:00
미국 서부(오레곤) us-west-2 06:00~14:00
아시아 태평양(홍콩) ap-east-1 06:00~14:00
아시아 태평양(하이데라바드) ap-south-2 06:30-14:30
아시아 태평양(뭄바이) ap-south-1 06:00~14:00
아시아 태평양(서울) ap-northeast-2 13:00~21:00
아시아 태평양(싱가포르) ap-southeast-1 14:00–22:00
아시아 태평양(시드니) ap-southeast-2 12:00–20:00
아시아 태평양(도쿄) ap-northeast-1 13:00~21:00
캐나다(중부) ca-central-1 03:00~11:00
중국(베이징) cn-north-1 06:00~14:00
중국(닝샤) cn-northwest-1 06:00~14:00
유럽(프랑크푸르트) eu-central-1 21:00-05:00
유럽(아일랜드) eu-west-1 22:00~06:00
유럽(런던) eu-west-2 22:00~06:00
유럽(밀라노) eu-south-1 02:00-10:00
유럽(파리) eu-west-3 23:59-07:29
중동(UAE) me-central-1 05:00 — 13:00
남아메리카(상파울루) sa-east-1 00:00-08:00
AWS GovCloud (미국 동부) us-gov-east-1 17:00-01:00
AWS GovCloud (미국 서부) us-gov-west-1 06:00~14:00

Amazon DocumentDB 유지 관리 기간 변경

유지 관리 기간은 사용률이 가장 낮은 시간에 할당되어야 하므로 수시로 변경되어야 할 수 있습니다. 시스템 변경 사항(스토리지 조정 작업 또는 인스턴스 클래스 변경 등)을 적용 중이고 가동 중단이 필요한 경우에만 인 이 기간 동안 클러스터 또는 인스턴스를 사용할 수 없습니다. 그런 다음 필수 변경 사항을 적용하는 데 필요한 최소 시간 동안만 사용이 불가능합니다.

데이터베이스 엔진 업그레이드를 위해 Amazon DocumentDB는 개별 인스턴스가 아닌 클러스터에 대한 기본 유지 관리 기간을 사용합니다.

유지 관리 기간 변경하기

Amazon DocumentDB 운영 체제 업데이트

Amazon DocumentDB 클러스터의 인스턴스에는 때때로 운영 체제 업데이트가 필요합니다. Amazon DocumentDB는 운영 체제를 최신 버전으로 업그레이드하여 데이터베이스 성능과 고객의 전반적인 보안 태세를 개선합니다. 운영 체제 업데이트는 Amazon DocumentDB 인스턴스의 클러스터 엔진 버전이나 인스턴스 클래스를 변경하지 않습니다.

클러스터의 가용성을 최대화하기 위해서 클러스터의 리더 인스턴스를 먼저 업데이트한 다음 라이터 인스턴스를 업데이트하는 것이 좋습니다. 장애 조치 시 다운타임이 발생할 수 있으므로 리더 인스턴스와 라이터 인스턴스를 동시에 업데이트하지 않는 것이 좋습니다.

Amazon DocumentDB에 대한 대부분의 운영 체제 업데이트는 선택 사항이며 적용할 날짜가 정해져 있지 않습니다. 하지만 이러한 업데이트를 한동안 적용하지 않으면 결국에는 필수 업데이트가 되어 인스턴스의 유지 관리 기간 중에 자동으로 적용될 수 있습니다. 이는 데이터베이스의 보안 상태를 유지하는 데 도움이 됩니다. 예상치 못한 다운타임을 방지하려면 Amazon DocumentDB 인스턴스가 출시되는 즉시 운영 체제 업데이트를 적용하고 비즈니스 요구 사항에 따라 편한 시간에 인스턴스 유지 관리 기간을 설정하는 것이 좋습니다.

새로운 선택적 업데이트가 제공될 때 알림을 받으려면 보안 패치 이벤트 범주에서 RDS-EVENT-0230 구독을 신청하면 됩니다. Amazon DocumentDB 이벤트 구독에 대한 자세한 내용은 Amazon DocumentDB 이벤트 구독을 참조하십시오.

클러스터나 인스턴스 유지 관리 수행 시에는 해당 인스턴스가 기본 인스턴스일 경우 장애 조치를 실시합니다. 가용성을 높이려면 Amazon DocumentDB 클러스터에 두 개 이상의 인스턴스를 사용하는 것이 좋습니다. 자세한 정보는 Amazon DocumentDB 장애 조치을 참조하세요.

참고

일부 관리 기능의 경우 Amazon DocumentDB는 Amazon Relational Database Service(RDS)와 공유되는 운영 기술을 사용합니다.

중요

Amazon DocumentDB 인스턴스는 운영 체제 업그레이드 중에 오프라인 상태가 됩니다. 다중 인스턴스 클러스터를 사용하면 클러스터 가동 중지 시간을 최소화할 수 있습니다. 다중 인스턴스 클러스터가 없는 경우 이 유지 관리를 수행할 보조 인스턴스를 추가하여 임시로 클러스터를 생성한 다음 유지 관리가 완료되면 추가 리더 인스턴스를 삭제하도록 선택할 수 있습니다 (보조 인스턴스에 대한 일반 요금이 적용됨).

참고

여러 규정 준수 의무를 충족하려면 모든 선택 및 필수 업데이트를 적용하여 최신 상태를 유지해야 할 수 있습니다. 유지 관리 기간 동안 Amazon DocumentDB에서 제공하는 모든 업데이트를 정기적으로 적용하는 것이 좋습니다.

AWS Management Console 또는 를 사용하여 업데이트가 가능한지 여부를 확인할 수 있습니다. AWS CLI

Using the AWS Management Console

다음을 사용하여 업데이트를 사용할 수 있는지 확인하려면 AWS Management Console:

  1. 에 AWS Management Console로그인하고 https://console.aws.amazon.com/docdb 에서 Amazon DocumentDB 콘솔을 엽니다.

  2. 탐색 창에서 클러스터를 선택한 후 해당 인스턴스를 선택합니다.

  3. 유지 관리를 선택합니다.

  4. 유지 관리 보류 섹션에서 운영 체제 업데이트를 찾으십시오.

클러스터에 대한 유지 관리 열을 보여주는 Amazon DocumentDB 콘솔

운영 체제 업데이트를 선택하고 대기 중 유지 관리 섹션에서 지금 적용 또는 다음 유지 관리 창에 적용을 클릭할 수 있습니다. 유지 관리 값이 다음 창인 경우 작업에서 Defer 업그레이드를 선택하여 유지 관리 항목을 보류하십시오. 유지 관리 작업이 이미 시작된 경우에는 보류할 수 없습니다.

또는 탐색 창에서 클러스터를 클릭하여 클러스터 목록에서 인스턴스를 선택하고 작업 메뉴에서 지금 적용 또는 다음 유지 관리 창에 적용을 선택할 수 있습니다.

Using the AWS CLI

를 사용하여 업데이트를 사용할 수 있는지 확인하려면 다음 describe-pending-maintenance-actions 명령을 호출하십시오. AWS CLI

aws docdb describe-pending-maintenance-actions
{ "ResourceIdentifier": "arn:aws:docdb:us-east-1:123456789012:db:mydb2", "PendingMaintenanceActionDetails": [ { "Action": "system-update", "Description": "New Operating System update is available" } ] }

운영 체제 업데이트는 Amazon DocumentDB 엔진 버전 및 인스턴스 클래스에 따라 다릅니다. 따라서 Amazon DocumentDB 인스턴스는 서로 다른 시점에 업데이트를 받거나 이를 요구합니다. 엔진 버전 및 인스턴스 클래스에 따라 인스턴스에 운영 체제 업데이트가 지원되는 경우 업데이트가 콘솔에 표시됩니다. AWS CLI describe-pending-maintenance-actions명령을 실행하거나 DescribePendingMaintenanceActions API 작업을 호출하여 확인할 수도 있습니다.