Reporch IDE
커스텀 도메인 연결하기
완료된 배포에 alias 또는 외부 FQDN을 추가하고 안내된 TXT 레코드로 DNS 소유권을 검증합니다.
개요
완료된 배포 또는 릴리즈에는 Reporch가 제공하는 주소의 alias prefix를 추가하거나, 직접 소유한 외부 도메인을 연결할 수 있습니다. 외부 도메인은 FQDN을 입력하고 Reporch가 안내하는 TXT 레코드로 소유권을 검증합니다.
시작하기 전에
- 연결 대상 배포가 완료 상태이고 정상 URL로 열리는지 확인합니다.
- 외부 도메인의 DNS 레코드를 변경할 권한을 준비합니다.
- 연결할 정확한 호스트 이름을 결정합니다. 예:
app.example.com - 기존 A, AAAA, CNAME, TXT 레코드 중 같은 호스트와 충돌하는 값이 있는지 확인합니다.
실행 단계
1. 완료된 배포 선택하기
배포 대시보드에서 도메인을 연결할 배포를 엽니다. Source와 Deployment ID를 확인해 잘못된 릴리즈에 연결하지 않도록 합니다.
2. Custom Domain 열기
도메인 관리 영역에서 외부 도메인 추가를 선택합니다. Reporch 제공 주소만 원하는 경우에는 alias prefix 옵션을 사용합니다.
3. FQDN 입력하기
app.example.com처럼 호스트 이름만 입력합니다. https://, 포트, /path 또는 쿼리 문자열은 포함하지 않습니다.
4. TXT 레코드 추가하기
화면이 표시하는 TXT 레코드의 Name/Host와 Value를 DNS 제공업체에 그대로 추가합니다. 제공업체가 도메인 부분을 자동으로 붙이는지 확인해 호스트가 중복되지 않게 합니다.
5. DNS 전파 기다리기
레코드를 저장한 뒤 DNS에 조회될 때까지 기다립니다. 검증을 반복해서 누르기 전에 실제 공개 DNS에서 TXT 값이 보이는지 확인합니다.
6. 상태 새로고침하고 검증하기
Reporch에서 상태 새로고침 또는 검증 동작을 실행합니다. 검증 완료 후 연결된 호스트를 열어 HTTPS와 배포 콘텐츠를 확인합니다.
입력값 예시
| 입력 | 결과 |
|---|---|
app.example.com | 올바른 FQDN |
example.com | 루트 도메인을 연결할 때 사용할 수 있는 FQDN |
https://app.example.com | 잘못된 값: scheme 제거 필요 |
app.example.com/docs | 잘못된 값: 경로 제거 필요 |
예상 결과
- 도메인 상태가 검증·활성 상태인지 확인합니다.
https://로 열었을 때 인증서 경고가 없는지 확인합니다.- 새 도메인의 홈뿐 아니라 직접 접근해야 하는 내부 경로도 확인합니다.
- 이전 배포가 아니라 선택한 Deployment ID의 콘텐츠가 제공되는지 확인합니다.
문제 해결
- Invalid domain/FQDN: scheme, 경로, 공백을 제거하고 완전한 호스트 이름인지 확인합니다.
- 검증 대기 상태가 지속됨: 공개 DNS의 TXT 조회 결과, Host 중복 입력과 TTL을 확인합니다.
- Reserved domain 오류: Reporch가 예약한 호스트 또는 사용할 수 없는 alias인지 확인하고 다른 이름을 선택합니다.
- Release not found: 연결 대상 배포가 삭제됐거나 완료되지 않았는지 확인합니다.
- Provider integration 오류: DNS 제공업체 연동 상태를 확인하거나 화면에 제공된 수동 TXT 검증 방식을 사용합니다.
- 검증됐지만 다른 사이트가 열림: 같은 호스트의 기존 A/AAAA/CNAME 충돌과 캐시를 확인합니다.