AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.

프로세스 수명주기 관리 API

Ops Manager API를 사용하여 MongoDB 프로세스를 종료, 시작, 재시작 및 재동기화할 수 있습니다. 각 요청은 자동화 구성에서 프로세스를 업데이트하고 변경 사항을 즉시 게시합니다. 대상 호스트의 자동화 에이전트는 다음 체크인 시 변경 사항을 적용합니다. 프로세스가 현재 기본 프로세스인 경우 에이전트는 먼저 다른 멤버가 인계받을 수 있도록 프로세스를 단계적으로 종료한 다음 중지하거나 재시작합니다.

Each operation is asynchronous. A 200 OK response means Ops Manager published the change, not that the process has stopped, started, restarted, or resynced. The response includes no job ID. To follow the change to completion, poll the automation status resource. If the agent can't apply the change, the plan shows as failed there and the agent keeps retrying.

Every endpoint accepts an optional dryRun=true query parameter. Use it to preview a change before you apply it. Ops Manager runs all the same checks and returns the process document as it would look after the change, but sends nothing to the agent and changes nothing in your deployment. For example, after a shutdown the returned document contains "disabled": true. Review it, then send the same request without dryRun=true to apply the change.

프로세스 라이프사이클 리소스를 사용하기 전에 다음 요구 사항을 검토하십시오.

참고

그룹과 프로젝트는 동의어입니다. {PROJECT-ID}는 프로젝트 ID와 동일합니다. 기존 그룹의 경우, 그룹/프로젝트 ID가 동일하게 유지됩니다. 이 페이지에서는 설명에 대해 얘기할 때 더욱 친숙한 용어 그룹을 사용합니다. 엔드포인트는 문서에 명시된 대로 유지됩니다.

기본 URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

To use the Process Lifecycle resources, you must be an Ops Manager user with the Project Automation Admin role.

Your deployment must run Ops Manager 8.0.28 or 9.0.2 or later. Automation must be enabled for the project, and the target host's Automation Agent must be running.

If you have an unpublished automation configuration draft in the project, Ops Manager rejects every request, including a dry run, with a 409 AUTOMATION_CONFIG_DRAFT_ALREADY_EXISTS error. Publish or discard the draft before you continue.

모든 유효성 검사는 모의 실행에도 적용되므로, 모의 실행이 성공하면 실제 요청도 동일한 검사를 통과할 것으로 예상됩니다. 하지만 실제 요청은 동시 변경이나 수동 모드 유효성 검사에서 실패할 수 있습니다.

중요

외부에서 관리되는 프로젝트 또는 Kubernetes Operator(MCK) 배포의 경우 프로세스 수명 주기 작업이 지원되지 않습니다.

경고

이러한 엔드포인트는 쿼럼 보호 기능을 제공하지 않습니다. 복제 세트의 구성원을 너무 많이 종료하면 기본 서버가 없어지게 됩니다. 구성원을 한 번에 하나씩 종료하고 각 구성원이 완전히 종료될 때까지 기다린 후 다음 단계로 진행하십시오.

다음 표는 프로세스 수명 주기 리소스에 사용할 수 있는 엔드포인트를 나열합니다.

메서드
엔드포인트
설명

POST

실행 중인 프로세스를 정상적으로 종료합니다.

POST

이전에 종료되었던 프로세스를 시작합니다.

POST

실행 중인 프로세스를 정상적으로 재시작합니다.

POST

복제 세트 멤버에 대한 초기 동기화를 시작합니다.

테스트 실행이 아닌 모든 성공적인 요청은 일반적인 자동화 구성 게시 이벤트와 함께 프로젝트 활동 피드에 이벤트 하나를 추가합니다. 활동 피드는 API를 통해 이루어진 요청을 공개 API에 대한 속성으로 기록합니다.

작업
이벤트 유형
얼마나 많은 정보를 제공하는지

AUTOMATION_PROCESS_SHUTDOWN_REQUESTED

이 프로세스에 대한 종료 요청이 있었습니다. 구성원이 예기치 않게 오프라인 상태가 된 경우 이 이벤트를 확인하십시오.

AUTOMATION_PROCESS_STARTUP_REQUESTED

중단된 프로세스를 재개해달라는 요청이 있었습니다.

AUTOMATION_PROCESS_RESTART_REQUESTED

이 프로세스에 대한 재시작 요청이 있었습니다. 구성원이 일시적으로 탈퇴했거나 선거가 진행된 경우 이 이벤트를 확인하십시오.

AUTOMATION_PROCESS_RESYNC_REQUESTED

A resync request was made for this process. Check this event if a member went into STARTUP2 or RECOVERING and is re-copying data.

이 페이지 평가하기