유지 관리 모드 사용 설정 및 예약

유지 관리 모드 정보

일부 유형의 작업을 수행하려면 GitHub Enterprise Server 인스턴스을(를) 오프라인으로 전환하여 유지 관리 모드로 들어가야 합니다.

새 버전의 GitHub Enterprise Server로 업그레이드
가상 머신에 할당된 CPU, 메모리 또는 스토리지 리소스 증가
한 가상 머신에서 다른 가상 머신으로 데이터 마이그레이션
GitHub Enterprise Server Backup Utilities 스냅샷에서 데이터 복원
특정 유형의 중요한 애플리케이션 문제 해결

사용자에게 준비 시간을 제공하기 위해 나중에는 최소 30분 동안 유지 관리 기간을 예약하는 것이 좋습니다. 유지 관리 기간이 예약되면 사이트에 액세스할 때 모든 사용자에게 배너가 표시됩니다.

인스턴스가 유지 관리 모드인 경우 모든 일반 HTTP 및 Git 액세스가 거부됩니다. 여기에는 어플라이언스가 상태 코드 503(서비스를 사용할 수 없음)으로 응답하는 웹 및 API 요청이 포함됩니다. Git 페치, 복제 및 푸시 작업도 사이트를 일시적으로 사용할 수 없음을 나타내는 오류 메시지와 함께 거부됩니다. 고가용성 구성에서는 Git 복제가 일시 중지됩니다. GitHub Actions 작업이 실행되지 않습니다. 브라우저에서 사이트를 방문하면 유지 관리 페이지로 이어집니다.

제공된 IP 주소 및 범위에서만 GitHub Enterprise Server 인스턴스에 액세스할 수 있도록 IP 예외 목록을 구성하여 유지 관리 작업의 초기 유효성 검사를 수행할 수 있습니다. IP 예외 목록에 지정되지 않은 IP 주소에서 GitHub Enterprise Server 인스턴스에 액세스하려는 시도는 인스턴스가 유지 관리 모드일 때 전송된 것과 일치하는 응답을 받습니다.

유지 관리 모드를 즉시 사용 설정하거나 나중에 유지 관리 기간을 예약합니다.

페이지의 오른쪽 상단에 있는 GitHub Enterprise Server의 관리 계정에서 을 클릭합니다.
“Site admin”(사이트 관리자) 페이지에 아직 없는 경우 왼쪽 상단에서 Site admin(사이트 관리자)을 클릭합니다.
" 사이트 관리자" 사이드바에서 관리 콘솔 을 클릭합니다.
위쪽 탐색 모음에서 유지 관리를 클릭합니다.
“사용 설정 및 예약”에서 유지 관리 모드 사용을 선택한 다음, 유지 관리 모드를 즉시 사용 설정할지 또는 향후에 유지 관리 기간을 예약할지 결정합니다.
- 유지 관리 모드를 즉시 사용 설정하려면 드롭다운 메뉴를 선택하고 지금을 클릭합니다.
- 나중에 유지 관리 기간을 예약하려면 드롭다운 메뉴를 선택하고 시작 시간을 클릭합니다.
필요에 따라 사용자가 유지 관리 기간 동안 볼 수 있도록 사용자 지정 메시지를 설정하려면 "유지 관리 모드 메시지 설정" 필드에 메시지를 입력합니다.
기간의 타이밍과 선택적 메시지에 만족하면 저장을 클릭합니다. "지금"을 선택하면 인스턴스가 즉시 기본 테넌트 모드로 전환됩니다.

IP 예외 목록을 사용하여 유지 관리 모드의 변경 내용 유효성 검사

IP 예외 목록은 유지 관리 작업 후 서버 상태의 초기 유효성 검사에 적합한 GitHub Enterprise Server 인스턴스에 대한 제어 및 제한된 액세스를 제공합니다. 활성화하면 GitHub Enterprise Server 인스턴스이 유지 관리 모드에서 벗어나 구성된 IP 주소에서만 사용할 수 있습니다. 상태 변경을 반영하도록 유지 관리 모드 확인란이 업데이트됩니다.

유지 관리 모드를 다시 활성화하면 IP 예외 목록이 비활성화되고 GitHub Enterprise Server 인스턴스이 유지 관리 모드로 돌아갑니다. IP 예외 목록을 비활성화하면 GitHub Enterprise Server 인스턴스이 정상 작업으로 돌아갑니다.

명령줄 유틸리티를 사용하여 IP 예외 목록을 구성할 수도 있습니다. 자세한 내용은 "명령줄 유틸리티" 및 "관리 셸(SSH)에 액세스"을(를) 참조하세요.

페이지의 오른쪽 상단에 있는 GitHub Enterprise Server의 관리 계정에서 을 클릭합니다.
“Site admin”(사이트 관리자) 페이지에 아직 없는 경우 왼쪽 상단에서 Site admin(사이트 관리자)을 클릭합니다.
" 사이트 관리자" 사이드바에서 관리 콘솔 을 클릭합니다.
위쪽 탐색 모음에서 유지 관리를 클릭한 다음 유지 관리 모드가 이미 활성화되어 있는지 확인합니다.
"IP 예외 목록 사용 및 구성"에서 IP 예외 목록 사용을 선택합니다.
목록을 사용하도록 설정하는 확인란 오른쪽에 GitHub Enterprise Server 인스턴스에 액세스할 수 있도록 허용해야 하는 공간으로 구분된 IP 주소 또는 CIDR 블록의 유효한 목록을 입력합니다.
필요에 따라 사용자가 유지 관리 기간 동안 볼 수 있도록 사용자 지정 메시지를 설정하려면 "유지 관리 모드 메시지 설정" 필드에 메시지를 입력합니다.
저장을 클릭합니다.

$ ghe-cluster-maintenance -h
# Shows options
$ ghe-cluster-maintenance -q
# Queries the current mode
$ ghe-cluster-maintenance -s
# Sets maintenance mode
$ ghe-cluster-maintenance -s "MESSAGE"
# Sets maintenance mode with a custom message
$ ghe-cluster-maintenance -m "MESSAGE"
# Updates the custom message
$ ghe-cluster-maintenance -u
# Unsets maintenance mode

이 문서의 내용

유지 관리 모드 정보

유지 관리 모드를 즉시 사용 설정하거나 나중에 유지 관리 기간을 예약합니다.

IP 예외 목록을 사용하여 유지 관리 모드의 변경 내용 유효성 검사

REST API를 사용하여 기본 테넌트 모드 관리

SSH를 사용하여 유지 관리 모드 관리

SSH를 사용하여 클러스터의 유지 관리 모드 관리