ale은 커스텀 도메인 연결을 위해 CNAME과 APEX 도메인 레코드를 지원합니다. 도메인 설정 방법은 사용 중인 도메인 제공업체에 따라 다르며, 본 가이드에서는 AWS Route 53Cloudflare를 통해 관리되는 도메인 설정 방법을 다룹니다.

이외의 DNS 제공서비스의 경우, DNS 사업자마다 레코드 등록 방법 및 세부 설정이 상이하므로 보유하고 있는 도메인의 제공업체 가이드에서 DNS 설정 > CNAME 설정 방법 을 참고하세요.

ale에서 배포된 서비스는 SSL 인증서가 자동으로 발급 및 적용됩니다. 프리뷰 URL뿐만 아니라 사용자가 연결한 커스텀 도메인에도 적용되며, 수동으로 SSL 설정을 할 필요가 없습니다.


도메인 연결 정보 조회

도메인을 연결하려는 서비스 상세페이지의 리소스탭에서 인그레스 항목의 도메인 연결을 클릭하세요. 연결하려는 도메인의 이름(예: example.com 또는 www.example.com 등)을 입력하면 DNS 설정에 필요한 CNAME, TXT 레코드 값을 조회할 수 있습니다.

AWS Route 53

연결하려는 도메인의 Route 53 대시보드 Hosted Zones 항목에서 Create record를 클릭한 후, 레코드 값을 입력하세요.

  • Record Name : ale에서 설정한 도메인(예: www.example.com)의 프리픽스(예: www)

  • Record Type : CNAME

  • Value : ale 에서 조회한 CNAME 레코드 값

ale 에 돌아와서 인증하기를 클릭하고 도메인 인증이 성공되면 연결하기를 클릭하는 것으로 도메인이 연결됩니다.

연결된 도메인에 SSL 인증서가 자동으로 발급됩니다. DNS 레코드 전파와 SSL 인증서 검증이 완료될 때까지 도메인 접속이 일시적으로 제한되거나 SSL 보안 경고가 표시될 수 있습니다.

“현재 DNS 설정값이 다릅니다. CNAME을 찾을 수 없습니다” 의 메시지는 입력된 레코드의 등록에 약간의 시간이 걸리기 때문에 나올 수 있는 오류 메시지 입니다. 잠시 후 인증하기를 다시 시도해 보세요.

연결하기 클릭 후 ‘domain connection limit exceeded’ 문구와 함께 도메인이 연결되지 않는 경우는, 서비스가 속한 스페이스에 연결 가능한 커스텀 도메인 수가 부족하기 때문입니다. 스페이스에 리소스 부여하기 페이지를 참고해 리소스를 부여하세요.

Cloudflare

서브도메인 연결하기

ale 에서 CNAME 레코드 값을 조회한 후, Cloudflare에서 구매한 도메인의 DNS Records메뉴에서 레코드를 추가하세요.

  • Type : CNAME

  • Name : ale에서 설정한 도메인(예: www.example.com)의 프리픽스(예: www)

  • Target : ale 에서 조회한 CNAME 레코드 값

  • Proxy status : DNS only(비활성화)

Proxy status가 프록싱 됨 상태인 경우, ale이 자동화한 SSL인증서 발급 등의 도메인 규칙이 적용되지 않아 도메인이 연결되지 않습니다. 반드시 DNS only(비활성화) 상태로 정해주세요.

ale에 돌아와서 인증하기를 클릭하고 도메인 인증이 성공되면 연결하기를 클릭하는 것으로 도메인이 연결됩니다.

연결된 도메인에 SSL 인증서가 자동으로 발급됩니다. DNS 레코드 전파와 SSL 인증서 검증이 완료될 때까지 도메인 접속이 일시적으로 제한되거나 SSL 보안 경고가 표시될 수 있습니다.

“현재 DNS 설정값이 다릅니다. CNAME을 찾을 수 없습니다” 의 메시지는 입력된 레코드의 등록에 약간의 시간이 걸리기 때문에 나올 수 있는 오류 메시지 입니다. 잠시 후 인증하기를 다시 시도해 보세요.

연결하기 클릭 후 ‘domain connection limit exceeded’ 문구와 함께 도메인이 연결되지 않는 경우는, 서비스가 속한 스페이스에 연결 가능한 커스텀 도메인 수가 부족하기 때문입니다. 스페이스에 리소스 부여하기 페이지를 참고해 리소스를 부여하세요.

루트도메인 연결하기

ale의 도메인 연결 화면에서 루트도메인을 입력하고 CNAME, TXT 레코드 값을 확인하세요.

루트도메인을 연결하기 위해 2개의 레코드를 모두 등록해야합니다. 아래의 항목을 참고하세요.

ale에 돌아와서 인증하기를 클릭하고 도메인 인증이 성공되면 연결하기를 클릭하는 것으로 도메인이 연결됩니다.

연결된 도메인에 SSL 인증서가 자동으로 발급됩니다. DNS 레코드 전파와 SSL 인증서 검증이 완료될 때까지 도메인 접속이 일시적으로 제한되거나 SSL 보안 경고가 표시될 수 있습니다.

“현재 DNS 설정값이 다릅니다. CNAME을 찾을 수 없습니다” 의 메시지는 입력된 레코드의 등록에 약간의 시간이 걸리기 때문에 나올 수 있는 오류 메시지 입니다. 잠시 후 인증하기를 다시 시도해 보세요.

연결하기 클릭 후 ‘domain connection limit exceeded’ 문구와 함께 도메인이 연결되지 않는 경우는, 서비스가 속한 스페이스에 연결 가능한 커스텀 도메인 수가 부족하기 때문입니다. 스페이스에 리소스 부여하기 페이지를 참고해 리소스를 부여하세요.