GitLab 유지 관리 모드

GitLab 유지 관리 모드를 활성화하고 관리하여 유지 관리 작업 중 쓰기 작업을 최소화하는 방법을 설명합니다.

유지 관리 모드를 사용하면 관리자가 유지 관리 작업을 수행하는 동안 쓰기 operation을 최소로 줄일 수 있습니다. 주된 목적은 내부 상태를 변경하는 모든 외부 동작을 차단하는 것입니다. 내부 상태에는 PostgreSQL 데이터베이스가 포함되며, 특히 파일, Git 리포지터리, 컨테이너 리포지터리가 해당합니다. 유지 관리 모드가 활성화되면 새 동작이 들어오지 않고 내부 상태 변경이 최소화되므로 진행 중인 동작이 비교적 빠르게 끝납니다. 이 상태에서는 각종 유지 관리 작업이 더 수월합니다. 서비스를 완전히 중지하거나, 그렇지 않은 경우보다 더 짧은 기간만 제한된 상태로 운영할 수 있습니다. 예를 들어 cron job을 중지하고 큐를 비우는 작업이 비교적 빠르게 끝납니다. 유지 관리 모드는 내부 상태를 변경하지 않는 대부분의 외부 동작을 허용합니다. 큰 틀에서 HTTP POST , PUT , PATCH , DELETE 요청이 차단되며, 특수한 경우의 처리 방식 은 별도로 정리되어 있습니다. 유지 관리 모드 활성화 # 관리자는 다음 방법 중 하나로 유지 관리 모드를 활성화합니다. Web UI : 오른쪽 위 모서리에서 Admin 을 선택합니다. 왼쪽 사이드바에서 Settings > General 을 선택합니다. Maintenance Mode 를 확장하고 Enable Maintenance Mode 를 켭니다. 선택 사항으로 배너에 표시할 메시지를 추가할 수도 있습니다. Save changes 를 선택합니다. API : curl --request PUT --header "PRIVATE-TOKEN:$ADMIN_TOKEN" "<gitlab-url>/api/v4/application/settings?maintenance_mode=true" 유지 관리 모드 비활성화 # 다음 세 가지 방법 중 하나로 유지 관리 모드를 비활성화합니다. Web UI : 오른쪽 위 모서리에서 Admin 을 선택합니다. 왼쪽 사이드바에서 Settings > General 을 선택합니다. Maintenance Mode 를 확장하고 Enable Maintenance Mode 를 끕니다. 선택 사항으로 배너에 표시할 메시지를 추가할 수도 있습니다. Save changes 를 선택합니다. API : curl --request PUT --header "PRIVATE-TOKEN:$ADMIN_TOKEN" "<gitlab-url>/api/v4/application/settings?maintenance_mode=false" 유지 관리 모드에서 GitLab 기능 동작 # 유지 관리 모드가 활성화되면 페이지 상단에 배너가 표시됩니다. 이 배너는 원하는 메시지로 사용자 정의할 수 있습니다. 허용되지 않는 쓰기 operation을 사용자가 수행하려고 하면 오류가 표시됩니다. Note 동작에 대한 시각적 피드백이 실제와 다를 수 있습니다. 예를 들어 프로젝트에 별을 지정하면 Star 버튼이 Unstar 동작을 표시하도록 바뀝니다. 그러나 이는 UI만 갱신한 것이며 POST 요청의 상