Skip to main content

인스턴스의 호스트 이름 변경

기존 GitHub Enterprise Server 인스턴스의 호스트 이름을 변경하려면 설정 및 데이터를 새 인스턴스로 복원해야 합니다.

GitHub Enterprise Server의 호스트 이름 변경 알아보기

GitHub Enterprise Server 인스턴스에 새 호스트 이름을 사용해야 하는 경우, 기존 인스턴스의 설정과 데이터를 백업하고, 새 인스턴스를 구성하고, 백업을 새 인스턴스로 복원한 다음, DNS 구성을 조정하여 트래픽을 새 인스턴스로 보내야 합니다.

새 인스턴스로 마이그레이션하려면 가동 중지 시간이 필요합니다. 필요한 가동 중지 시간은 백업해야 하는 데이터의 양, 그리고 백업 호스트와 인스턴스 간의 네트워크 연결 속도에 따라 달라집니다.

이 문서에서 "원본 인스턴스"는 이전 호스트 이름을 가진 인스턴스를 뜻하며, "대상 인스턴스"는 새 호스트 이름을 가진 인스턴스를 뜻합니다.

Warning

초기 설정 후 GitHub Enterprise Server의 호스트 이름을 변경하지 마세요. 호스트 이름을 변경하면 예기치 못한 동작이 발생합니다. 최악의 경우 인스턴스 중단 및 사용자 보안 키 무효화 등을 포함합니다. 인스턴스의 호스트 이름을 변경했고 문제가 발생한 경우, GitHub Enterprise 지원 또는 GitHub Premium 지원에 문의하십시오.

새 호스트 이름이 있는 인스턴스로 마이그레이션

  1. 사용하려는 새 호스트 이름이 있는 GitHub Enterprise Server의 대상 인스턴스를 구성합니다. 자세한 정보는 다음 설명서를 참조하세요.

  2. 인스턴스의 사용자에게 예정된 가동 중지 시간을 알립니다. 필요에 따라 로그인하는 모든 사용자에게 표시되는 필수 메시지를 만들 수 있습니다. 자세한 내용은 “엔터프라이즈에 대한 사용자 메시지 사용자 지정”을 참조하세요.

  3. 원본 인스턴스에서 유지 관리 모드를 사용 설정합니다. 자세한 내용은 "유지 관리 모드 사용 설정 및 예약"을(를) 참조하세요.

  4. GitHub Enterprise Server Backup Utilities을(를) 사용하여 원본 인스턴스의 데이터 및 설정을 백업합니다. 자세한 내용은 "인스턴스에서 백업 구성"을(를) 참조하세요.

  5. 원하는 호스트 이름을 사용하여 백업을 대상 인스턴스로 복원합니다. ghe-restore 유틸리티를 실행할 때는 -c 옵션을 사용하여 대상 인스턴스의 구성을 덮어씁니다. 자세한 내용은 "인스턴스에서 백업 구성"을(를) 참조하세요.

  6. 대상 인스턴스의 구성을 완료합니다. 자세한 내용은 "GitHub Enterprise 구성"을(를) 참조하세요.

  7. 대상 인스턴스에서 유지 관리 모드를 사용 설정합니다.

  8. 필요에 따라 대상 인스턴스가 유지 관리 모드에 있는 동안 인스턴스의 구성에 대한 유효성을 검사하고 사용자 데이터가 그대로 유지되었는지 확인합니다. 자세한 내용은 "유지 관리 모드 사용 설정 및 예약"을(를) 참조하세요.

  9. 트래픽을 대상 인스턴스로 전달하려면 원본 인스턴스의 호스트 이름으로 DNS CNAME 레코드를 업데이트하여 대상 인스턴스의 IP 주소로 확인합니다.

    Note

    인스턴스의 웹 애플리케이션에서 복원된 사용자 생성 콘텐츠에는 원본 인스턴스의 이전 호스트 이름을 참조하는 URL이 포함될 수 있습니다. 필요에 따라 이러한 링크가 대상 인스턴스로 계속 확인되도록 하려면 DNS를 사용하여 리디렉션을 구성할 수 있습니다. 새 인스턴스의 호스트 이름으로 확인되는 CNAME 레코드에 추가로 원래 호스트 이름에서 새 호스트 이름으로 트래픽을 전달하는 두 번째 DNS CNAME 레코드를 구성합니다. 자세한 내용은 DNS 공급자에 대한 설명서를 참조하세요.

  10. 대상 인스턴스에서 유지 관리 모드를 사용 중지합니다.