Skip to main content

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

GitHub Enterprise Server 인스턴스을(를) 업그레이드하거나 백업을 복원하는 것과 같은 일부 표준 유지 관리 절차에서는 정상적인 사용을 위해 인스턴스를 오프라인으로 전환해야 합니다.

유지 관리 모드 정보

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

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

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

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

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

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

  1. 페이지의 오른쪽 상단에 있는 GitHub Enterprise Server의 관리 계정에서 을 클릭합니다.

  2. “Site admin”(사이트 관리자) 페이지에 아직 없는 경우 왼쪽 상단에서 Site admin(사이트 관리자)을 클릭합니다.

  3. " 사이트 관리자" 사이드바에서 관리 콘솔 을 클릭합니다.

  4. 위쪽 탐색 모음에서 유지 관리를 클릭합니다.

    관리 콘솔의 헤더 스크린샷. "Maintenance"라는 레이블이 지정된 탭이 주황색 윤곽선으로 강조 표시됩니다.

  5. “사용 설정 및 예약”에서 유지 관리 모드 사용을 선택한 다음, 유지 관리 모드를 즉시 사용 설정할지 또는 향후에 유지 관리 기간을 예약할지 결정합니다.

    • 유지 관리 모드를 즉시 사용 설정하려면 드롭다운 메뉴를 선택하고 지금을 클릭합니다.
    • 나중에 유지 관리 기간을 예약하려면 드롭다운 메뉴를 선택하고 시작 시간을 클릭합니다.
  6. 필요에 따라 사용자가 유지 관리 기간 동안 볼 수 있도록 사용자 지정 메시지를 설정하려면 "유지 관리 모드 메시지 설정" 필드에 메시지를 입력합니다.

  7. 기간의 타이밍과 선택적 메시지에 만족하면 저장을 클릭합니다. "지금"을 선택하면 인스턴스가 즉시 기본 테넌트 모드로 전환됩니다.

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

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

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

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

  1. 페이지의 오른쪽 상단에 있는 GitHub Enterprise Server의 관리 계정에서 을 클릭합니다.

  2. “Site admin”(사이트 관리자) 페이지에 아직 없는 경우 왼쪽 상단에서 Site admin(사이트 관리자)을 클릭합니다.

  3. " 사이트 관리자" 사이드바에서 관리 콘솔 을 클릭합니다.

  4. 위쪽 탐색 모음에서 유지 관리를 클릭한 다음 유지 관리 모드가 이미 활성화되어 있는지 확인합니다.

    관리 콘솔의 헤더 스크린샷. "Maintenance"라는 레이블이 지정된 탭이 주황색 윤곽선으로 강조 표시됩니다.

  5. "IP 예외 목록 사용 및 구성"에서 IP 예외 목록 사용을 선택합니다.

  6. 목록을 사용하도록 설정하는 확인란 오른쪽에 GitHub Enterprise Server 인스턴스에 액세스할 수 있도록 허용해야 하는 공간으로 구분된 IP 주소 또는 CIDR 블록의 유효한 목록을 입력합니다.

  7. 필요에 따라 사용자가 유지 관리 기간 동안 볼 수 있도록 사용자 지정 메시지를 설정하려면 "유지 관리 모드 메시지 설정" 필드에 메시지를 입력합니다.

  8. 저장을 클릭합니다.

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

REST API를 사용하여 GitHub Enterprise Server 인스턴스에서 기본 테넌트 모드를 관리할 수 있습니다. 자세한 내용은 "GitHub Enterprise Server를 관리하기 위한 REST API 엔드포인트"을(를) 참조하세요.

GitHub CLI을(를) 사용하여 유지 관리 모드 관리

GitHub CLI gh es 확장을 사용하여 GitHub Enterprise Server 인스턴스의 유지 관리 모드를 관리할 수 있습니다. 자세한 내용은 gh es maintenance setgh es maintenance get에 대한 GH ES CLI 사용 설명서를 참조하세요.

자세한 내용은 "GitHub CLI를 사용하여 인스턴스 관리" 항목을 참조하세요.

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

SSH 액세스 권한이 있는 경우 ghe-maintenance 명령줄 유틸리티를 사용하여 하나의 노드 또는 고가용성 구성의 여러 노드가 있는 GitHub Enterprise Server 인스턴스에 대한 유지 관리 모드를 설정하거나 해제할 수 있습니다. 자세한 내용은 "관리 셸(SSH)에 액세스" 및 "명령줄 유틸리티" 항목을 참조하세요.

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

GitHub Enterprise Server 인스턴스에 대한 SSH 액세스 권한이 있는 경우 ghe-cluster-maintenance 명령줄 유틸리티를 사용하여 클러스터의 모든 노드에 유지 관리 모드를 설정하거나 설정 해제할 수 있습니다. 자세한 내용은 "관리 셸(SSH)에 액세스" 및 "명령줄 유틸리티" 항목을 참조하세요.

$ 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