Skip to main content

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

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

유지 관리 모드 정보

일부 유형의 작업을 수행하려면 your GitHub Enterprise Server instance을(를) 오프라인으로 전환하고 유지 관리 모드로 전환해야 합니다.

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

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

예약된 유지 관리에 대한 최종 사용자 배너

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

유지 관리 모드 시작 화면

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

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

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

    사이트 관리자 설정에 액세스하기 위한 우주선 아이콘 스크린샷

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

    “Site admin”(사이트 관리자) 링크 스크린샷 1. 왼쪽 사이드바에서 Management Console 을 클릭합니다. 왼쪽 사이드바의 Management Console 탭

  3. Management Console의 상단에서 유지 관리를 클릭합니다. 유지 관리 탭

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

    • 유지 관리 모드를 즉시 사용 설정하려면 드롭다운 메뉴에서 지금을 클릭합니다. 현재 유지 관리 모드를 사용 설정하는 옵션이 선택되어 있는 드롭다운 메뉴
    • 나중에 유지 관리 기간을 예약하려면 드롭다운 메뉴를 사용해 시작 시간을 클릭합니다. 2시간 안에 유지 관리 기간을 예약하는 옵션이 선택된 드롭다운 메뉴
  5. 유지 관리 모드 사용 설정을 선택합니다. 유지 관리 모드를 사용 설정하거나 예약하기 위한 확인란 1. 왼쪽 사이드바에서 Save settings(설정 저장)를 클릭합니다.

    Management Console의 설정 저장 단추 스크린샷

    참고: Management Console에 설정을 저장하면 시스템 서비스가 다시 시작되어 사용자에게 표시되는 가동 중지 시간이 발생할 수 있습니다.

  6. 구성 실행이 완료될 때까지 기다립니다.

    인스턴스 구성

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

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

유지 관리 모드를 다시 사용하도록 설정하면 IP 예외 목록이 비활성화되고 your GitHub Enterprise Server instance이(가) 유지 관리 모드로 돌아갑니다. IP 예외 목록을 사용하지 않도록 설정하면 your GitHub Enterprise Server instance이(가) 정상 작업으로 돌아갑니다.

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

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

    사이트 관리자 설정에 액세스하기 위한 우주선 아이콘 스크린샷

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

    “Site admin”(사이트 관리자) 링크 스크린샷 1. 왼쪽 사이드바에서 Management Console 을 클릭합니다. 왼쪽 사이드바의 Management Console 탭

  3. Management Console의 맨 위에서 유지 관리를 클릭하고 유지 관리 모드가 이미 활성화되어 있는지 확인합니다. 유지 관리 탭

  4. IP 예외 목록 사용을 선택합니다. IP 예외 목록을 활성화하기 위한 확인란

  5. 텍스트 상자에 your GitHub Enterprise Server instance에 액세스할 수 있도록 허용해야 하는 공간으로 구분된 IP 주소 또는 CIDR 블록의 유효한 목록을 입력합니다. IP 주소에 대한 완료된 필드

  6. 저장을 클릭합니다. IP 예외 목록이 저장된 후

GitHub Enterprise Server APIs을(를) 사용하여 유지 관리 모드 예약

GitHub Enterprise Server APIs을(를) 사용하여 다른 시간 또는 날짜에 대한 유지 관리를 예약할 수 있습니다. 자세한 내용은 “관리 콘솔”을 참조하세요.

클러스터의 모든 노드에 유지 관리 모드 사용 설정 또는 사용 안 함

ghe-cluster-maintenance 유틸리티를 사용하면 클러스터의 모든 노드에 유지 관리 모드를 설정하거나 설정 해제할 수 있습니다.

$ ghe-cluster-maintenance -h
# Shows options
$ ghe-cluster-maintenance -q
# Queries the current mode
$ ghe-cluster-maintenance -s
# Sets maintenance mode
$ ghe-cluster-maintenance -u
# Unsets maintenance mode