GitHub Enterprise Server의 호스트 이름 변경 알아보기
GitHub Enterprise Server 인스턴스에 새 호스트 이름을 사용해야 하는 경우, 기존 인스턴스의 설정과 데이터를 백업하고, 새 인스턴스를 구성하고, 백업을 새 인스턴스로 복원한 다음, DNS 구성을 조정하여 트래픽을 새 인스턴스로 보내야 합니다.
새 인스턴스로 마이그레이션하려면 가동 중지 시간이 필요합니다. 필요한 가동 중지 시간은 백업해야 하는 데이터의 양, 그리고 백업 호스트와 인스턴스 간의 네트워크 연결 속도에 따라 달라집니다.
이 문서에서 "원본 인스턴스"는 이전 호스트 이름을 가진 인스턴스를 뜻하며, "대상 인스턴스"는 새 호스트 이름을 가진 인스턴스를 뜻합니다.
경고: 초기 설정 후 GitHub Enterprise Server의 호스트 이름을 변경하지 마세요. 호스트 이름을 변경하면 예기치 못한 동작이 발생합니다. 최악의 경우 인스턴스 중단 및 사용자 보안 키 무효화 등을 포함합니다. 인스턴스의 호스트 이름을 변경했고 문제가 발생한 경우, GitHub Enterprise 지원 또는 GitHub Premium 지원에 문의하십시오.
새 호스트 이름이 있는 인스턴스로 마이그레이션
-
사용하려는 새 호스트 이름이 있는 GitHub Enterprise Server의 대상 인스턴스를 구성합니다. 자세한 정보는 다음 설명서를 참조하세요.
-
인스턴스의 사용자에게 예정된 가동 중지 시간을 알립니다. 필요에 따라 로그인하는 모든 사용자에게 표시되는 필수 메시지를 만들 수 있습니다. 자세한 내용은 “엔터프라이즈에 대한 사용자 메시지 사용자 지정”을 참조하세요.
-
원본 인스턴스에서 유지 관리 모드를 사용 설정합니다. 자세한 내용은 "유지 관리 모드 사용 설정 및 예약"을(를) 참조하세요.
-
GitHub Enterprise Server Backup Utilities을(를) 사용하여 원본 인스턴스의 데이터 및 설정을 백업합니다. 자세한 내용은 "인스턴스에서 백업 구성"을(를) 참조하세요.
-
원하는 호스트 이름을 사용하여 백업을 대상 인스턴스로 복원합니다.
ghe-restore
유틸리티를 실행할 때는-c
옵션을 사용하여 대상 인스턴스의 구성을 덮어씁니다. 자세한 내용은 "인스턴스에서 백업 구성"을(를) 참조하세요. -
대상 인스턴스의 구성을 완료합니다. 자세한 내용은 "GitHub Enterprise 구성"을(를) 참조하세요.
-
대상 인스턴스에서 유지 관리 모드를 사용 설정합니다.
-
필요에 따라 대상 인스턴스가 유지 관리 모드에 있는 동안 인스턴스의 구성에 대한 유효성을 검사하고 사용자 데이터가 그대로 유지되었는지 확인합니다. 자세한 내용은 "유지 관리 모드 사용 설정 및 예약"을(를) 참조하세요.
-
트래픽을 대상 인스턴스로 전달하려면 원본 인스턴스의 호스트 이름으로 DNS
CNAME
레코드를 업데이트하여 대상 인스턴스의 IP 주소로 확인합니다.참고: 인스턴스의 웹 애플리케이션에서 복원된 사용자 생성 콘텐츠에는 원본 인스턴스의 이전 호스트 이름을 참조하는 URL이 포함될 수 있습니다. 필요에 따라 이러한 링크가 대상 인스턴스로 계속 확인되도록 하려면 DNS를 사용하여 리디렉션을 구성할 수 있습니다. 새 인스턴스의 호스트 이름으로 확인되는
CNAME
레코드에 추가로 원래 호스트 이름에서 새 호스트 이름으로 트래픽을 전달하는 두 번째 DNSCNAME
레코드를 구성합니다. 자세한 내용은 DNS 공급자에 대한 설명서를 참조하세요. -
대상 인스턴스에서 유지 관리 모드를 사용 중지합니다.