커스텀 도메인
www.example.com 같은 내 도메인을 앱에 연결하고 HTTPS를 켭니다.
my-app.ntro.run 대신 www.example.com 같은 내 도메인으로 앱을 열 수 있습니다. 커스텀 도메인은 항상 현재 프로덕션 배포를 보여 주고, HTTPS 인증서는 나이트로쉽이 자동으로 발급합니다.
도메인을 등록합니다
ntro domains add www.example.com --app my-appDNS를 설정합니다
도메인을 산 곳(가비아, Cloudflare, Route 53 등)의 DNS 관리 화면에서 레코드를 추가합니다.
| 도메인 종류 | 레코드 | 값 |
|---|---|---|
하위 도메인 (www.example.com) | CNAME | via.nitroship.co |
루트 도메인 (example.com) | ALIAS / ANAME, 또는 CNAME 평탄화(flattening) | via.nitroship.co |
루트 도메인에는 일반 CNAME을 쓸 수 없어서, DNS 업체가 제공하는 ALIAS·ANAME·CNAME 평탄화 기능을 씁니다. 서버 IP 주소를 A 레코드로 직접 넣지 마세요.
확인과 인증서 발급을 기다립니다
ntro domains verify www.example.com --app my-app --wait
ntro domains list --app my-app두 단계가 끝나야 도메인이 active가 됩니다.
- 소유권 확인: DNS 레코드를 보고 이 도메인이 내 것인지 확인합니다.
- 인증서 발급: HTTPS 인증서를 따로 발급합니다.
--wait는 도메인이 active 또는 failed가 될 때까지 최대 10분 기다립니다. domains list에서 DNS 상태와 인증서 상태를 함께 볼 수 있습니다.
확인이 안 될 때
DNS 변경은 퍼지는 데 시간이 걸립니다. 잠시 기다린 뒤 ntro domains verify를 다시 실행하세요. 이미 active인 도메인은 다시 확인할 필요가 없습니다.
도메인 해제
ntro domains remove www.example.com --app my-app해제 전에 한 번 더 묻습니다. CI·스크립트에서는 --yes를 붙이세요.
API 참고: 도메인 목록
GET /v1/apps/{appId}/domains는 기본적으로 앱의 프로덕션 주소(my-app.ntro.run)와 커스텀 도메인을 등록한 순서대로 돌려줍니다. 배포마다 생기는 리비전 주소와 Git 브랜치 주소는 빠져 있으며, 필요하면 includeRevisions=true를 붙이세요. 결과가 여러 페이지면 응답의 nextCursor를 다음 요청의 cursor로 넘깁니다.