Amazon DocumentDB 유지 관리

Amazon DocumentDB는 주기적으로 두 가지 종류의 유지 관리를 수행합니다.

엔진 패치 및 OS 업데이트는 선택 사항, 필수 및 강제라는 동일한 세 가지 수명 주기 범주를 사용하며 각 범주에 동일한 알림 및 적용 동작을 사용합니다. 엔진 릴리스에는 수동으로 업그레이드하는 마이너 버전이라는 네 번째 범주도 있습니다. 범주는 다음과 같습니다.

엔진 패치는 단일 범주(선택 사항, 필수 또는 강제)로 릴리스되어 그대로 유지됩니다. OS 업데이트 진행 상황: 대부분은 선택 사항으로 시작되며, 적용되지 않으면 필수로 전환되고 결국 강제로 전환됩니다. 정확한 타이밍은 패치에 따라 달라지며 AHD 알림 및에서 반환한 날짜 필드에 게시됩니다describe-pending-maintenance-actions( 참조적용 날짜). Amazon DocumentDB 릴리스 정보는 엔진 변경을 발표할 때 이러한 범주 이름을 사용합니다.

엔진 패치를 적용하면 클러스터가 잠시 오프라인 상태가 됩니다. 이 주제의 나머지 부분에서는 유지 관리 기간이 작동하는 방식, 보류 중인 작업을 찾는 방법, 엔진 패치 및 마이너 버전을 적용하는 방법, OS 업데이트가 작동하는 방식, 글로벌 클러스터에 대한 특별 처리를 안내합니다.

엔진 버전 번호 지정

Amazon DocumentDB는 두 개의 개별 버전 식별자를 사용합니다.

다음 표와 같이 엔진 패치 버전의 접두사에서 엔진 버전을 확인할 수 있습니다.

클러스터가 실행 중인 패치 버전을 확인하려면를 연결하고 실행합니다db.runCommand({getEngineVersion: 1}).

릴리스된 엔진 패치 버전 목록과 각 버전에 포함된 내용은 섹션을 참조하세요릴리스 노트.

Amazon DocumentDB 유지 관리 기간 관리

모든 클러스터와 모든 인스턴스에는 예약된 수정 및 소프트웨어 패치 적용이 실행되는 기간인 주별 30분의 유지 관리 기간이 있습니다. 대부분의 이벤트는 30분 이내에 완료되며, 더 큰 이벤트는 더 오래 실행될 수 있습니다.

리소스를 생성할 때 기간을 선택하지 않으면 Amazon DocumentDB는 임의로 선택한 날짜에 리전에 정의된 8시간 일일 블록 내에서 무작위로 하나를 할당합니다. 예를 들어 저녁이나 주말 등 애플리케이션에 미치는 영향을 최소화하는 기간을 선택합니다.

데이터베이스 엔진 업그레이드의 경우 Amazon DocumentDB는 개별 인스턴스의 창이 아닌 클러스터의 창을 사용합니다.

다음 표에는 리전당 기본 시간 블록이 나와 있습니다.

Amazon DocumentDB 유지 관리 윈도우 변경

가능한 가장 낮은 트래픽 기간을 선택하고 트래픽 패턴이 이동함에 따라 시간 경과에 따라 조정합니다. 예를 들어 스케일 스토리지 작업 또는 인스턴스 클래스 변경과 같은 시스템 변경에 중단이 필요한 경우에만 기간 동안 클러스터 또는 인스턴스를 사용할 수 없으며, 해당 변경에 실제로 필요한 기간 동안만 사용할 수 있습니다.

Amazon DocumentDB 엔진 패치에 대한 알림

리전에서 필요한 엔진 패치를 사용할 수 있게 되면 해당 AWS 리전에 영향을 받는 Amazon DocumentDB 클러스터가 있는 모든 AWS 계정은 Health Dashboard (AHD) 및 이메일( AWS 계정의 루트 사용자 주소로 전송됨)을 통해 알림을 받습니다. 영향을 받는 Amazon DocumentDB 엔진 버전당 하나의 알림이 전송됩니다. AHD의 예약된 변경 사항에서 찾을 수 있습니다. 각 알림에는 패치 가용성 타이밍, 자동 적용 일정, 영향을 받는 클러스터 및 릴리스 정보가 나열됩니다.

자동 적용 창이 열리기 약 2일 전에 알림이 발송됩니다. 예를 들어 월요일 00:00 UTC에 릴리스된 필수 패치는 수요일 00:00 UTC에 자동 적용할 수 있습니다. 클러스터의 유지 관리 기간이 수요일 12:00 UTC인 경우 패치는 해당 수요일에 자동으로 적용됩니다. 자동 적용 기간이 열리고 약 12시간 후에 적용됩니다. 유지 관리 기간이 화요일 12:00 UTC인 경우 패치는 자동 적용 전 1주일 동안 대기합니다.

알림을 받은 후에는 자동 적용 날짜 이전에 패치를 자체 적용하거나 예정된 유지 관리 기간(기본값) 동안 패치가 자동으로 적용될 때까지 기다리는 두 가지 옵션이 있습니다. 자체 적용하려면 클러스터의 유지 관리 및 백업 탭을 열고 유형의 항목을 찾습니다system-update.

선택적 패치와 새 마이너 버전은 AHD 또는 이메일 알림을 생성하지 않습니다. 이를 추적하려면 Amazon DocumentDB 릴리스 정보를 확인하세요.

강제 패치(가장 드문 범주로, 가장 중요한 보안 수정용으로 예약됨)도 AHD 및 이메일을 통해 발표됩니다. 필수 패치와 달리 유지 관리 기간 외부에서 적용되므로 위의 자동 적용 타이밍 예제는 적용되지 않습니다.

프로그래밍 방식으로 패치 알림에 대응

AWS Health 는 Amazon EventBridge와 통합되어 AWS Lambda 및 Amazon Simple Queue Service(SQS)를 포함하여 20개 이상의 대상에서 이벤트 기반 애플리케이션을 구축할 수 있습니다. 엔진 패치 가용성에 프로그래밍 방식으로 대응하려면 AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_SCHEDULED 이벤트에 대해 EventBridge를 구성합니다. 여기에서 이벤트 데이터를 캡처하거나, 추가 이벤트를 발생시키거나,를 통해 푸시 알림을 보내거나 AWS Console Mobile Application, 필요한 다른 조치를 취할 수 있습니다.

Amazon DocumentDB가 패치(드문 경우)를 취소하면 AHD 알림과 취소에 대한 이메일을 받게 됩니다. Amazon EventBridge와 함께 AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_CANCELLED 이벤트 코드를 사용하여이 사례를 처리합니다. 규칙 작성에 대한 자세한 내용은 Amazon EventBridge 사용 설명서를 참조하세요.

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

AWS Management Console 또는를 사용하여 클러스터 또는 인스턴스에 대해 보류 중인 유지 관리를 AWS CLI 확인합니다.

보류 중인 업데이트는 엔진 패치와 OS 업데이트를 모두 system-update다루는 작업 유형와 함께 표시됩니다.

업데이트가 보류 중이면 다음을 수행할 수 있습니다.

유지 관리 기간은 작업이 완료되는 데 걸리는 시간이 아니라 보류 중인 작업이 시작되는 시기를 제어합니다.

적용 날짜

보류 중인 각 유지 관리 작업에는 최대 3개의 적용 날짜가 포함됩니다. 의 AWS CLI 출력에 나타나describe-pending-maintenance-actions며 작업이 실행될 시기를 나타냅니다. 필드는 선택적 유지 관리를 null 위한 것입니다.

보류 중인 작업을 연기하려면 유지 관리 기간을 이전 나중으로 이동합니다AutoAppliedAfterDate. 가 AutoAppliedAfterDate 통과하면 작업은 다음 유지 관리 기간 동안 자동으로 적용됩니다. 일단 ForcedApplyDate 통과하면 더 이상 연기할 수 없습니다. 정확한 지연 기간은 패치마다 다릅니다. 날짜는 AHD 알림 및 AWS CLI 출력에 게시됩니다.

Amazon DocumentDB 엔진 업데이트

보류 중인 엔진 패치를 식별한 경우 다음 절차 중 하나를 사용하여 적용하거나 예약합니다. AWS Management Console 또는에서 이러한 절차를 실행할 수 있습니다 AWS CLI.

패치 적용 중 읽기 가용성

Amazon DocumentDB 엔진 5.0 및 8.0은 클러스터에 여러 인스턴스가 있는 경우 패치 적용 중에 읽기 가용성을 유지합니다. Amazon DocumentDB는 리더 인스턴스를 세 그룹으로 롤링 방식으로 패치하므로 나머지 리더는 계속해서 트래픽을 처리합니다. 패치하는 동안 라이터를 잠시 사용할 수 없습니다. 제로 읽기 가동 중지 시간을 달성하려면 읽기 기본 설정을 지정하여 읽기가 라이터로 돌아가secondaryPreferred거나, 또는 primaryPreferred 작업하거나, primary secondary 단독으로 읽기 가동 중지 시간이 발생할 수 있도록 합니다.

리더는 패치를 적용하는 동안 전체 클러스터 읽기 처리량이 일시적으로 감소합니다. 처리량을 안정적으로 유지하려면 업그레이드 전에 추가 리더를 프로비저닝하고 완료 후 제거합니다.

엔진 3.6 및 4.0에서는 이러한 읽기 가용성 기능이 적용되지 않습니다. 엔진 패치로 인해 가동 중지 시간이 길어져 읽기 및 쓰기 모두에 영향을 미칩니다. 가 수행하는 메이저 버전으로 업그레이드하려면 섹션을 참조하세요Amazon DocumentDB 인플레이스 주요 버전 업그레이드.

패치 가동 중지 시간 길이

엔진 패치 가동 중지 시간은 다양합니다. 가장 큰 요인은 패치 시 인스턴스에 대한 CPU 사용률 및 메모리 압력이므로 인스턴스 크기를 올바르게 조정하는 것이 중요합니다. 가동 중지 시간을 최소화하려면 최신 Amazon DocumentDB 메이저 엔진 버전을 실행하고 여러 가용 영역에 인스턴스를 분산합니다.

패치 업데이트 및 교체

Amazon DocumentDB는 릴리스 후 패치를 모니터링합니다. 드문 경우지만 문제가 식별되면 Amazon DocumentDB는 업데이트된 버전을 준비하는 동안 롤아웃을 일시 중지합니다. 이 경우 패치를 아직 받지 않은 클러스터는 더 이상 해당 패치를 사용 가능한 유지 관리 작업으로 볼 수 없으며의 예약된 변경 알림 Health Dashboard 이 취소됩니다. 영향을 받는 버전을 이미 실행 중인 클러스터는 계속 정상적으로 작동하므로 사용자의 조치가 필요하지 않습니다.

곧 업데이트된 패치가 제공됩니다. 리전에서 사용할 수 있게 되면에 설명된 대로 Health Dashboard 및 이메일을 통해 새 알림을 받게 됩니다Amazon DocumentDB 엔진 패치에 대한 알림.

마이너 버전 업그레이드

Amazon DocumentDB는 메이저 버전 5.0 이상(예: 5.0.1)을 기반으로 마이너 버전을 게시합니다. 마이너 버전은 5.0 이전의 메이저 버전에는 게시되지 않습니다. 마이너 버전은 필수 및 선택적 엔진 패치와 다르게 작동합니다.

자세히 알아보기: Amazon DocumentDB 마이너 버전 업그레이드.

Amazon DocumentDB 운영 체제 업데이트

인스턴스에 OS 업데이트가 필요한 경우가 있습니다. Amazon DocumentDB는 OS를 업데이트하여 성능을 개선하고 보안을 강화합니다. OS 업데이트는 클러스터 엔진 버전과 인스턴스 클래스를 변경하지 않고 그대로 둡니다. 엔진 패치와 마찬가지로 OS 업데이트는이 주제의 맨 위에 설명된 선택적/필수/강제 수명 주기를 사용합니다. 엔진 패치와 달리 OS 업데이트는 연기하면 시간이 지남에 따라 이러한 범주를 전환할 수 있습니다. OS 업데이트가 제공되는 즉시 적용하고 인스턴스 유지 관리 기간을 비즈니스에 맞는 시간으로 설정합니다.

새 선택적 업데이트가 도착할 때 이벤트를 가져오려면 보안 패치 이벤트 범주RDS-EVENT-0230에서를 구독합니다. 자세한 내용은 Amazon DocumentDB 이벤트 구독을 참조하세요. 알림을 받은 후 각 인스턴스에 OS 패치를 자체 적용할 수 있습니다.

클러스터를 패치할 때 리더 인스턴스를 먼저 업데이트하고 라이터를 마지막으로 업데이트합니다. 리더와 라이터를 동시에 패치하지 마세요. 패치 중 장애 조치는 가동 중지 시간을 연장할 수 있습니다. 기본 인스턴스의 유지 관리는 장애 조치를 트리거하므로 클러스터당 둘 이상의 인스턴스를 실행하여 가용성을 유지합니다. 자세한 내용은 Amazon DocumentDB 장애 조치을 참조하세요.

OS 업데이트는 특정 엔진 버전 및 인스턴스 클래스와 연결되어 있으므로 인스턴스마다 다른 시간에 사용할 수 있습니다. 인스턴스가 적격 상태이면 콘솔에 업데이트가 표시됩니다. 명령 또는 DescribePendingMaintenanceActions API를 AWS CLI describe-pending-maintenance-actions 통해 확인할 수도 있습니다.

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

사용자 시작 업데이트

메모리가 많거나 적은 인스턴스 클래스로 바꾸거나 클러스터의 파라미터 그룹을 변경하는 등 직접 시작하는 일부 변경 사항. Amazon DocumentDB는 이를 시작하는 업데이트와 다르게 처리합니다. 자세한 내용은 다음을 참조하세요.

아직 보류 중인 사용자 시작 변경 사항을 나열하려면:

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

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

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

글로벌 클러스터 패치 적용

글로벌 클러스터에서는 기본 및 보조의 각 멤버 클러스터가 자체 유지 관리 기간 동안 업그레이드됩니다. 모든 리전에서 필요한 엔진 패치를 사용할 수 있는 경우 AHD 및 이메일 알림을 받게 됩니다. 선택적 패치와 새 마이너 버전은 알림을 생성하지 않습니다. 이에 대한 Amazon DocumentDB 릴리스 정보를 확인하세요.

자체 적용하는 경우 항상 보조 항목을 먼저 패치하고 기본 항목을 마지막으로 패치합니다. 이 순서는 롤아웃 전반에 걸쳐 장애 조치 및 전환을 계속 사용할 수 있도록 합니다.

아무 조치도 취하지 않으면 패치가 각 클러스터의 다음 유지 관리 기간인 세컨더리 먼저, 세컨더리가 완료되면 해당 기간의 기본 기간에 자동으로 적용됩니다.

기본 DB 클러스터와 보조 DB 클러스터를 동일한 버전으로 유지합니다. 관리형 리전 간 장애 조치는 모든 클러스터가 동일한 엔진 버전과 패치 수준을 공유하는 경우에만 글로벌 데이터베이스에서 작동합니다. 기본 버전보다 최신 엔진 버전을 사용하는 새 보조 버전을 추가하는 경우에도 마찬가지입니다. 글로벌 데이터베이스에 조인하기 전에 기본 버전에 새 보조 버전을 생성합니다.

패치 알림 후 장애 조치 및 전환이 계속 작동하도록 최대한 빨리 기본 및 보조를 최신 버전으로 업그레이드합니다. 장애 조치 또는 전환 요청이 거부된 경우 클러스터 간에 엔진 패치 버전을 비교하고, 일치하지 않는 경우 지연 클러스터에 사용 가능한 패치를 적용합니다.