업그레이드와 관련된 GitHub Enterprise Server 알려진 문제 정보
GitHub 는 새 릴리스로의 업그레이드에 영향을 줄 수 있는 다음과 같은 문제를 알고 있습니다 GitHub Enterprise Server. 자세한 내용은 릴리스 정보에서 "알려진 문제"를 GitHub Enterprise Server 참조하세요.
업그레이드를 시도할 때 The file provided is not a valid GitHub Enterprise Server package 오류가 표시되면 인스턴스에서 GPG 서명 키를 회전해야 할 수 있습니다. 자세한 내용은 업그레이드 패키지에 대한 서명 키 회전을(를) 참조하세요.
GitHub 인스턴스 구성 및 데이터의 정기적인 백업을 강력하게 권장합니다. 업그레이드를 진행하기 전에 인스턴스를 백업한 다음 스테이징 환경에서 백업의 유효성을 검사합니다. 자세한 내용은 Backup 유틸리티를 사용하여 인스턴스에서 백업 구성 및 스테이징 인스턴스 설정을(를) 참조하세요.
SAML NameID 일치는 대/소문자를 구분합니다.
이 변경 내용은 GitHub Enterprise Server 2026년 11월 17일에 릴리스된 3.19.16, 3.20.12, 3.21.10 및 3.22.5에 적용됩니다. GitHub Enterprise Server 또는 SCIM 프로비저닝이 사용하도록 설정된 GitHub Enterprise Cloud 인스턴스에는 적용되지 않습니다.
보안 수정은 SAML NameID 값이 기존 계정과 일치하는 방식을 변경합니다. 대문자, 악센트 또는 후행 공백의 차이는 무시되지 않고 거부됩니다. 이렇게 하면 SAML 로그인이 잘못된 GitHub 계정을 선택하지 못하도록 방지할 수 있습니다.
SAML 인증 중에 IdP(ID 공급자)가 보낸 NameID 값이 사용자의 GitHub Enterprise Server에 저장된 SAML 매핑과 정확히 일치하지 않으면 인증이 실패합니다. 예를 들어, 들어오는 NameID 값 Mona이 더 이상 저장된 NameID 값 mona과 일치하지 않습니다. 사용자는 오류 Another user already owns the account. Please have your administrator check the authentication log.를 봅니다.
업그레이드하기 전에 IdP에서 보낸 SAML NameID 값이 동일한 대문자와 소문자를 포함하여 저장된 SAML 매핑 NameID 값과 정확히 일치하는지 확인합니다.
- 사이트 관리자 대시보드의
NameID탭에서 사용자의 저장된 SAML **** 을 확인합니다. 자세한 내용은 사용자의 SAML NameID 업데이트을(를) 참조하세요.ghe-saml-mapping-csv --dump를 사용하여 매핑을 내보낼 수도 있습니다. 이 유틸리티는 SCIM 프로비저닝을 사용하는 인스턴스를 지원하지 않습니다. - 사용자에 대한 수신 SAML
NameID를 확인합니다. 일시적으로 SAML 디버깅을 사용하도록 설정하고, 사용자의 SAML 로그인 시도를 재현한 다음,systemd에 대한github-unicorn저널 로그에서 SAML 응답의NameID를 검사합니다. 과도한 로깅 및 잠재적 성능 영향을 방지하려면 이후 즉시 디버깅을 비활성화합니다. 자세한 내용은 SAML 인증 문제 해결을(를) 참조하세요.
값이 다른 경우 IdP에서 보낸 값과 일치하도록 사용자의 저장된 SAML NameID 매핑을 업데이트합니다.
이전의 대/소문자를 구분하지 않는 SAML NameID 일치 동작을 복원하기 위해 노력하고 있습니다. 릴리스 정보에서 이 업데이트를 사용할 수 있게 되면 안내합니다.
3.15 이상 버전 업그레이드 일시 중지 해제
이제 3.15, 3.16, 3.17 버전 업그레이드 일시 중지가 해제되었습니다. 따라서 이제 3.15.12, 3.16.8, 3.17.5 이상 버전으로 업그레이드할 수 있습니다. 단, 3.15, 3.16, 3.17의 이전 릴리스로 업그레이드하는 것은 권장하지 않습니다. 추가 단계로, 업그레이드 전 시스템 용량을 확인하는 것이 좋습니다. 업그레이드하기 전에 시스템 용량 확인을(를) 참조하세요.
버전 3.14, 3.15, 3.16, 3.17에 대한 지원 기간이 연장되었습니다. 3.13에 대한 지원 기간은 변경되지 않습니다. 각 3.14, 3.15, 3.16, 3.17의 종료 날짜가 업데이트되었습니다. 자세한 내용은 GitHub Enterprise 서버 릴리스을(를) 참조하세요.
이 추가 지원 기간 내내 3.14, 3.15, 3.16, 3.17에 대한 패치를 계속 릴리스할 예정입니다.
필요한 루트 디스크 크기가 400GB로 증가했습니다.
참고
버전 3.15.2 이상에 대한 이전 루트 디스크 크기 요구 사항인 400GB가 제거되었습니다. 이 요구 사항은 지원 번들 및 지원 티켓의 분석을 기반으로 했습니다. 로그와 같은 일부 요인은 루트 디스크에 과도한 압력을 가하여 어플라이언스 문제를 일으켰습니다. 많은 고객이 새 하드웨어를 조달하는 것이 어렵다는 피드백을 받은 후, 점진적인 접근 방식을 위해 요구 사항을 롤백했습니다. 특히 독립 실행형 또는 독립 실행형 고가용성 토폴로지 사용 고객은 루트 디스크를 400GB로 업그레이드하는 것이 좋습니다. 루트 디스크를 400GB로 업그레이드할 수 있는 경우 다음 지침을 참조하세요.
독립 실행형 또는 HA 토폴로지 사용 고객에게는 3.15 이상 버전의 새 설치 또는 3.15로 업그레이드하여 최소 400GB의 루트 디스크 크기를 사용하는 것이 좋습니다. GitHub 스토리지 용량 늘리기의 지침을 따르는 것이 좋습니다.
암호 해독할 수 없는 레코드
3.11 또는 3.12에서 GitHub Enterprise Server 3.13으로 업그레이드하거나 3.12에서 3.14로 업그레이드하는 경우 암호 해독에 필요한 키가 없어서 해독할 수 없는 레코드에 문제가 발생할 수 있습니다. 유일한 해결 방법은 해독할 수 없는 레코드를 삭제하는 것입니다. 이 문제의 영향을 받는 레코드 유형은 2FA 레코드입니다. 즉, 사용자에게 2FA(2단계 인증)를 다시 사용하도록 요청해야 할 수도 있습니다.
업그레이드 이전
3.11 또는 3.12에서 GitHub Enterprise Server 3.13으로 업그레이드하거나 3.12에서 3.14로 업그레이드하는 경우 암호화 진단 스크립트를 실행하여 해독할 수 없는 레코드를 미리 식별할 수 있습니다. 이 스크립트는 어떤 레코드도 수정하지 않지만 대신 영향을 이해하고 이에 대한 계획을 세울 수 있습니다.
- 암호화 진단 스크립트를 다운로드합니다.
curl -L -O https://gh.io/ghes-encryption-diagnostics과 같은 명령을 사용하여 스크립트를 다운로드할 수 있습니다. - 어플라이언스의
/data/user/common디렉터리에 스크립트를 저장합니다. - 스크립트 맨 위에 있는 지침에 따라 어플라이언스에서 실행합니다. 암호를 해독할 수 없는 레코드가 있는 경우
/tmp/column_encryption_records_to_be_deleted.log에 로그됩니다. 시스템에서 레코드를 암호화하는 데 사용된 키를 찾을 수 없기 때문에 여기에 로그된 모든 기록의 암호를 해독할 수 없습니다.
이러한 레코드가 업그레이드 프로세스의 일부로 삭제된다는 점에 유의하시기 바랍니다. 이 스크립트는 업그레이드 후 2FA에 다시 등록해야 하는 사용자에 대해 경고합니다. 영향을 받은 사용자의 계정 이름이 /tmp/column_encryption_users_to_have_2fa_disabled.log에 기록됩니다. 이러한 사용자는 2FA에 다시 등록해야 합니다.
스크립트가 예기치 않은 문제가 발생하면 연락 GitHub 지원하라는 메시지가 표시됩니다. 이러한 문제와 관련된 오류가 /tmp/column_encryption_unexpected_errors.log에 로그됩니다. 심각한 상황이고 사용자가 2FA에 다시 등록할 수 없는 경우 도움을 요청 GitHub 지원 하세요.
스크립트는 "성공: 암호화된 레코드 확인됨."이라고 출력합니다. 암호화된 기록과 관련된 키를 찾을 수 있을 경우. 이러한 레코드는 업그레이드 프로세스 중에 암호 해독 및 보존되며 사용자가 수동으로 개입할 필요가 없습니다.
업그레이드하는 동안
암호화 진단 스크립트를 미리 실행할 기회가 없는 경우를 대비해 제품에 도움이 되는 메커니즘이 있습니다. 업그레이드 프로세스 중 플라이트 전 검사는 암호 해독할 수 없는 레코드를 감지하여 이를 /tmp/column_encryption_records_to_be_deleted.log에 로그합니다. 이 시퀀스는 업그레이드 후 2FA를 다시 사용하도록 설정해야 하는 사용자에 대해 경고합니다. 영향을 받은 사용자 레코드는 /tmp/column_encryption_users_to_have_2fa_disabled.log에 로그됩니다.
암호를 해독할 수 없는 레코드가 감지되면 업그레이드를 진행할지 여부를 묻는 메시지가 표시됩니다. 계속 진행하면 업그레이드 프로세스에서 암호를 해독할 수 없는 레코드가 삭제됩니다. 그렇지 않으면 업그레이드 프로세스가 종료됩니다.
업그레이드하는 동안 궁금한 사항이 있으면 GitHub 지원에게 문의하십시오. 영향을 이해할 시간과 기회가 있다면 업그레이드를 다시 시도할 수 있습니다.