유지 관리 기간 구성

유지 관리 기간 고려 사항

• 긴급 유지 관리 활동: Atlas는 구성된 유지 관리 기간이나 보호 시간과 관계없이 필요한 경우 즉시 긴급 유지 관리 활동(예: 제로데이 취약성에 대한 보안 패치)을 수행할 수 있습니다.

• 지속적인 유지 관리 작업: 클러스터에 대한 유지 관리 기간을 예약한 후에는 진행 중인 유지 관리 작업이 완료될 때까지 이를 변경할 수 없습니다.

• MongoDB 데이터베이스 업그레이드: 유지 관리에 MongoDB 패치 버전 업그레이드가 포함된 경우 Atlas는 콘솔에 현재 버전과 대상 버전을 표시합니다. Atlas가 다음 유지 관리 기간 동안 클러스터 중 하나의 MongoDB 유지 관리 버전을 업그레이드하는 경우 클러스터 카드에 대상 MongoDB 유지 관리 버전이 표시됩니다.

• 유지 관리를 위해 복제본 세트 투표 필요: Atlas는 MongoDB 매뉴얼에 설명된 유지 관리 절차와 동일한 방식으로 유지 관리를 수행합니다. 이 절차를 수행하려면 유지 관리 기간 동안 복제본 세트당 하나 이상의 복제본 세트 투표가 요구됩니다. 테스트 페일오버 기능을 사용하여 애플리케이션이 복제본 세트 투표에 대한 복원력을 갖출 수 있도록 하세요.

• 유지 관리는 가능한 한 시작 시간에 가깝게 시작: 유지 관리는 항상 가능한 한 예정된 시간에 가깝게 시작되지만 진행 중인 클러스터 업데이트 또는 예기치 않은 시스템 문제로 인해 시작 시간이 지연될 수 있습니다.

• 유지 관리 중 일시적인 성능 저하 가능성: 디스크 IOPS가 낮으면 MongoDB가 WiredTiger 스토리지 엔진을 다시 채우는 동안 클러스터의 성능이 잠시 저하될 수 있습니다. 자세한 내용은 저널링 및 WiredTiger 스토리지 엔진을 참조하세요.

• 보호된 시간: 유지 관리 기간을 구성하는 것 외에도, Atlas가 표준 업데이트를 수행하지 않는 기간인 일일 보호된 시간을 설정할 수 있습니다. Atlas는 유지 관리 기간 동안 자동으로 유지 관리를 수행합니다.

  그러나 Atlas는 유지 관리 기간이 아닐 때 클러스터 재시작이 필요하지 않거나 워크로드 성능에 영향을 미치지 않는 표준 업데이트를 수행할 수 있습니다. 보호된 시간을 활성화하면 Atlas는 보호 시간이 아닐 때 표준 업데이트를 수행합니다. 보호된 시간의 길이는 18시간을 초과할 수 없습니다.

필요한 액세스 권한

유지 관리 기간을 관리하려면 프로젝트에 대한 Organization Owner 또는 Project Owner 액세스 권한이 있어야 합니다.

절차

atlas maintenanceWindows describe [options]

atlas maintenanceWindows update [options]

atlas maintenanceWindows clear [options]

필수 유지 보수에 대응

유지 관리가 필요한 경우:

• 예약된 유지 관리 48~72시간(2~3일) 사이에 Atlas는 유지 관리가 예약된 날짜와 시간을 보여주는 배너를 프로젝트의 클러스터 목록에 표시합니다. Show Details를 클릭하면 MongoDB 버전 업데이트, OS 정책 업데이트 또는 기타 유지 관리 유형과 같은 예정된 유지 관리 작업을 볼 수 있습니다.

• Atlas는 Project Owner 역할이 있는 사용자에게 이메일을 보내고 유지 관리를 즉시 시작하거나 일주일 동안 유지 관리를 연기할 수 있는 옵션을 표시하도록 Atlas UI를 업데이트합니다.

  참고

  예약된 유지 관리 기간 알림을 받는 방법을 구성하려면 유지 관리 기간 알림 구성을 참조하세요.

atlas maintenanceWindows update [options]

# Trigger immediate maintenance for the project with the ID
# 5e2211c17a3e5a48f5497de3:
atlas maintenanceWindows update --startASAP --projectId 5e2211c17a3e5a48f5497de3 --output json

curl --header "Authorization: Bearer {ACCESS-TOKEN}" \
  --include \
  --header "Accept: application/vnd.atlas.2025-03-12+json" \
  --header "Content-Type: application/json" \
  -X PATCH "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/maintenanceWindow" \
  --data '
    {
      "startASAP": true
    }'

atlas maintenanceWindows defer [options]