핫패치를 사용하여 업그레이드

핫패치 패키지를 사용하여 GitHub Enterprise Server을(를) 기능 시리즈 내의 최신 패치 릴리스로 업그레이드할 수 있습니다.

이 문서의 내용

핫패치를 사용하여 GitHub Enterprise Server을(를) 최신 패치 릴리스로 업그레이드할 수 있습니다.

핫패칭을 사용하여 최신 패치 릴리스로 업그레이드할 수 있지만 기능 릴리스는 업그레이드할 수 없습니다. 예를 들어 2.10.1에서 2.10.5로 업그레이드하는 것은 동일한 기능 시리즈에 속하므로 가능하지만, 2.10.9에서 2.11.0으로 업그레이드하는 것은 다른 기능 시리즈에 속하므로 불가능합니다.

핫패치는 반드시 다시 부팅할 필요는 없습니다. 핫패치를 설치하면 업데이트를 완료하기 위해 패키지를 다시 부팅해야 하는 경우 터미널에 메시지가 표시됩니다. 이 재부팅은 편리한 시간에 예약할 수 있지만, 특히 보안 수정 사항이 있는 경우 최대한 빨리 다시 부팅하는 것이 좋습니다.

핫패치는 구성을 실행해야 하므로, 이로 인해 GitHub Enterprise Server 인스턴스의 일부 또는 모든 서비스가 잠시 동안 오류를 일으키거나 응답이 없을 수 있습니다. 핫패치를 설치하는 동안 유지 관리 모드를 사용하도록 설정할 필요는 없지만, 이렇게 하면 사용자에게 오류나 시간 제한 대신 유지 관리 페이지가 표시되도록 할 수 있습니다. "유지 관리 모드 사용 설정 및 예약" 항목을 참조하세요.

관리 콘솔을 사용하여 핫패치를 즉시 설치하거나 나중에 설치되도록 예약할 수 있습니다. 관리 셸을 사용하여 ghe-upgrade 유틸리티로 핫패치를 설치할 수 있습니다. "업그레이드 프로세스 개요" 및 "업그레이드 요구 사항" 항목을 참조하세요.

핫패치를 사용하여 독립 실행형 인스턴스 업그레이드

핫패치를 사용하여 노드 하나가 있는 인스턴스를 업그레이드하고 대상이 패치 릴리스인 경우 관리 콘솔을(를) 사용하여 업그레이드할 수 있습니다. 기능 릴리스로 업그레이드하려면 관리 셸을 사용해야 합니다.

관리 콘솔을 사용하여 핫패치 설치

관리 콘솔에서 자동 업데이트를 사용하도록 설정하면 핫패치를 사용하여 업그레이드할 수 있습니다. 업그레이드할 수 있는 GitHub Enterprise Server의 사용 가능한 최신 버전이 표시됩니다.

표시되는 업그레이드 대상이 패치 릴리스가 아닌 기능 릴리스인 경우에는 관리 콘솔을 사용하여 핫패치를 설치할 수 없습니다. 대신, 관리 셸을 사용하여 핫패치를 설치해야 합니다.

  1. 자동 업데이트를 사용하도록 설정합니다. 자세한 내용은 "자동 업데이트 검사 사용"을(를) 참조하세요.

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

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

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

  5. 위쪽 탐색 모음에서 업데이트를 클릭합니다.

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

  6. 새 핫패치가 다운로드되면 패키지 설치 드롭다운 메뉴를 선택합니다.

    • 즉시 설치하려면 지금을 클릭합니다.
    • 나중에 설치하려면 이후 날짜를 선택합니다.

  7. 설치를 클릭합니다.

관리 셸을 사용하여 핫패치 설치

Note

자동 업데이트 검사를 사용하도록 설정한 경우 업그레이드 패키지를 다운로드할 필요가 없으며 자동으로 다운로드된 파일을 사용할 수 있습니다. 자세한 내용은 "자동 업데이트 검사 사용"을(를) 참조하세요.

  1. 에 SSH합니다. 인스턴스가 여러 노드로 구성된 경우(예: 고가용성 또는 지역 복제가 구성된 경우) 주 노드에 대한 SSH를 수행합니다. 클러스터를 사용하는 경우 임의 노드에 대해 SSH를 수행할 수 있습니다. HOSTNAME을 인스턴스의 호스트 이름 또는 노드의 호스트 이름이나 IP 주소로 바꿉니다. 자세한 내용은 "관리 셸(SSH)에 액세스"을(를) 참조하세요.

    Shell
    ssh -p 122 admin@HOSTNAME

  2. GitHub Enterprise Server 릴리스 페이지로 이동합니다. 업그레이드할 릴리스 옆에 있는 다운로드를 클릭한 다음 업그레이드 탭을 클릭합니다. 업그레이드 핫패키지(.hpkg 파일)의 URL을 복사합니다.

  3. curl을 사용하여 업그레이드 패키지를 GitHub Enterprise Server 인스턴스로 다운로드합니다.

    admin@HOSTNAME:~$ curl -L -O UPGRADE-PKG-URL

  4. 패키지 파일 이름을 사용하여 ghe-upgrade 명령을 실행합니다.

    admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.hpkg
*** verifying upgrade package signature...

  5. 하나 이상의 서비스 또는 시스템 구성 요소에 재부팅이 필요한 경우, 핫패치 업그레이드 스크립트가 사용자에게 알립니다. 예를 들어, 커널, MySQL 또는 Elasticsearch를 업데이트하려면 다시 부팅해야 할 수 있습니다.

핫패치를 사용하여 여러 노드가 있는 인스턴스 업그레이드

핫패치를 설치하는 경우 유지 관리 모드로 전환하거나 복제를 중지할 필요가 없습니다.

핫패치를 사용하여 주 노드 업그레이드

주 노드를 업그레이드하는 지침은 "관리 셸을 사용하여 핫패치 설치"를 참조하세요.

핫패치를 사용하여 추가 노드 업그레이드

고가용성 또는 지역에서 복제 구성과 같이 여러 노드로 구성된 인스턴스를 업그레이드하려면 각 복제본 노드에서 다음 절차를 한 번에 하나씩 반복해야 합니다.

  1. 노드를 업그레이드하려면 “관리 셸을 사용하여 핫패치 설치”의 지침에 따릅니다.

  2. 포트 122에서 admin 사용자로 SSH를 통해 복제본 노드에 연결합니다.

    ssh -p 122 admin@REPLICA_HOST

  3. 다음을 실행하여 업그레이드를 확인합니다.

    ghe-version

  4. 각 추가 노드에 대해 위 단계를 반복합니다.