Firebase 앱 호스팅에 배포된 앱의 브랜드 중심의 고유한 도메인 이름을 선택할 수 있습니다.
Firebase App Hosting Firebase에서 생성된 도메인이 아닌 커스텀 도메인 (예:
example.com 또는 app.example.com)을
Firebase 호스팅 사이트에 사용할 수 있습니다. Firebase App Hosting은 각 도메인의 SSL
인증서를 프로비저닝합니다.
이 문서의 나머지 부분에서는 다음 방법 중 하나로 커스텀 도메인을 연결하는 단계를 안내합니다.
서비스를 중단 없이 이용하려면 DNS 레코드를 특정 순서대로 업데이트해야 합니다. 도메인을 마이그레이션하여 앱의 다운타임을 방지하려면 안내를 따르세요.
웹 앱에 새로운 도메인을 연결하는 경우와 같이 다운타임이 문제가 되지 않는다면 새 도메인 연결 안내를 따르세요.
시작하기 전에: DNS 레코드 유형
App Hosting 도메인 설정 마법사는 도메인의 현재 구성에 따라 1~ 5개의 DNS 레코드를 추가하거나 삭제하도록 요청할 수 있습니다. 레코드의 유형 에 따라 기능이 결정됩니다. 앱 호스팅에서 요청할 수 있는 레코드 유형은 다음과 같습니다.App Hosting
| 유형 | 설명 | 독점 |
|---|---|---|
| A | 이러한 레코드에는 브라우저가 도메인에 연결하려고 할 때 사용할 주소를 알려주는 IPv4 값 (예: 8.8.8.8)이 포함되어 있습니다. | 예 |
| AAAA | 이러한 레코드에는 A 레코드와 거의 동일한 기능을 하는 다른 유형의 주소 레코드인 IPv6 값 (예: 2001:4860:4860::8888)이 포함되어 있습니다. App Hosting은(는) 현재 AAAA 레코드를 사용하지 않지만, 있는 경우 도메인에서 기존 레코드를 삭제하도록 요청합니다. | 예 |
| CNAME | 이러한 레코드에는 DNS 쿼리를 확인하기 위해 현재 도메인 대신 사용해야 하는 별도의 도메인 이름이 포함되어 있습니다. CNAME 레코드는 하위 도메인 (예: www.example.com)에서만 허용됩니다.
App Hosting은 다음과 같은 두 가지 이유로 CNAME 레코드를 사용합니다.
|
예 |
| TXT | 이러한 레코드를 사용하면 도메인에 임의의 메타데이터를 연결할 수 있습니다. App Hosting을 사용하면 TXT 레코드의 특정 형식인 fah-claim=[UUID]를 사용하여 도메인에서 제공해야 하는 커스텀 도메인을 나타낼 수 있습니다. |
아니요 |
| CAA | 이러한 레코드는 도메인의 SSL 인증서를 민팅할 수 있는 인증 기관을 지정하기 위한 허용 목록 역할을 합니다. App Hosting은 도메인의 인증서를 민팅하는 것이 차단된 경우에만 CAA 레코드를 요청합니다. | 아니요 |
시작하기 전에: 커스텀 도메인 이름
DNS 레코드를 추가하거나 수정할 때 서로 다른 도메인 제공업체의 DNS 관리 사이트 내 호스트 (또는 호스트 이름) 필드에는 서로 다른 입력 값을 입력해야 합니다. App Hosting 커스텀 도메인 마법사에서는 동일한 값 을 이름 필드에 입력해야 합니다.
아래에 자주 사용되는 제공업체의 일반적인 입력 값이 정리되어 있습니다. 자세한 안내는 도메인 제공업체의 문서를 참고하세요.
| 도메인 유형 | 맞춤 도메인 이름 |
|---|---|
| 최상위 도메인 |
일반적인 입력 값은 다음과 같습니다.
|
| 하위 도메인 | 일반적인 입력 값은 다음과 같습니다.
|
일반적인 도메인 제공업체
다음은 몇 가지 일반적인 도메인 제공업체 및 각 제공업체에 필요한 입력 유형입니다. 이 정보는 가능한 한 최신 상태로 유지되지만, 자세한 안내는 도메인 제공업체의 문서를 참고하세요.
도메인 마이그레이션
다운타임 없이 도메인을 다른 제공업체에서 App Hosting 으로 이전하려면 도메인 마이그레이션 흐름을 Firebase Console에서 사용하면 됩니다. 이 흐름은 트래픽을 App Hosting 서버로 전달하기 전에 App Hosting이 도메인에서 콘텐츠를 제공할 수 있도록 준비하는 2단계 프로세스를 안내합니다.
1단계: 커스텀 도메인 추가
- Firebase 콘솔에서 호스팅 및 서버리스 > 앱 호스팅으로 이동합니다.
- App Hosting 백엔드를 선택하려면 대시보드 보기 옵션을 사용합니다.
- 설정 탭을 선택한 후 커스텀 도메인 추가 를 클릭합니다.
- 사이트에 연결할 커스텀 도메인 이름을 입력합니다. App Hosting
- (선택사항) 커스텀 도메인의 모든 요청을
지정된 두 번째 도메인으로 리디렉션하려면 체크박스를 선택합니다 (
example.com과www.example.com을 동일한 콘텐츠로 리디렉션). - 설정 계속 을 클릭하여 DNS 레코드를 구성하고 커스텀 도메인 설정을 완료합니다.
2단계: 도메인 준비
- 도메인 설정 마법사의 도메인 마이그레이션 탭을 선택합니다.
- 앱 호스팅이 원하는 백엔드를 제공하고 도메인의 보안 TLS 연결을 설정하는 데 필요한 변경사항 집합이 포함된 첫 번째 단계인 도메인 준비의 안내를 따릅니다.App Hosting 필수 레코드의 다음 입력을 사용하여 DNS 제공업체에서 도메인의 레코드를 추가, 삭제, 저장합니다.
- 이름: 레코드에 사용할 커스텀 도메인 이름 을 입력합니다. 입력한 호스트는 콘텐츠를 제공할 도메인이며 이 도메인은 최상위 도메인 또는 하위 도메인일 수 있습니다. 도메인 제공업체에 따라 이 용어를 '호스트 이름', '이름' 또는 '도메인'으로 표시할 수도 있습니다.
- 레코드 유형: 제공된 DNS 레코드를 추가합니다.
- 값: 제공된 값을 레코드에 할당합니다. 도메인 제공업체에 따라 이 용어를 '데이터', '지정 대상', '콘텐츠', '주소', 'IP 주소'로 표시할 수도 있습니다. 값 필드의 콘텐츠는 레코드 유형에 따라 다릅니다. 예를 들어 TXT 레코드는 문자열입니다.
- 레코드 확인 을 선택합니다. App Hosting은 도메인 제공업체에서 변경한 사항을 감지하려고 시도합니다. 변경사항이 전파되려면 최대 24시간이 소요될 수 있습니다. 백엔드 대시보드의 설정 > 도메인 뷰에서 상태 를 확인할 수 있습니다.
3단계: App Hosting으로 전달
- App Hosting이 이전 단계의 레코드 업데이트를 확인하면
마법사가 최종 App Hosting으로 전달 단계로 진행됩니다. 이
단계에서는 도메인의
트래픽을 App Hosting 서버로 전달하기 위해 업데이트해야 하는 레코드를 표시합니다. 이전과 마찬가지로 필수 레코드의 다음 입력을 사용하여 DNS 제공업체에서 도메인의 레코드를 추가, 삭제, 저장합니다.
- 이름: 레코드에 사용할 커스텀 도메인 이름 을 입력합니다. 입력한 호스트는 콘텐츠를 제공할 도메인이며 이 도메인은 최상위 도메인 또는 하위 도메인일 수 있습니다. 도메인 제공업체에 따라 이 용어를 '호스트 이름', '이름' 또는 '도메인'으로 표시할 수도 있습니다.
- 레코드 유형: 제공된 DNS 레코드를 추가합니다.
- 값: 제공된 값을 레코드에 할당합니다. 도메인 제공업체에 따라 이 용어를 '데이터', '지정 대상', '콘텐츠', '주소', 'IP 주소'로 표시할 수도 있습니다. 값 필드의 콘텐츠는 레코드 유형에 따라 다릅니다. 예를 들어 TXT 레코드는 문자열입니다.
- 레코드 확인 을 선택합니다. App Hosting은 도메인 제공업체에서 변경한 사항을 감지하려고 시도합니다. 변경사항이 전파되려면 최대 24시간이 소요될 수 있습니다. 백엔드 대시보드의 설정 > 도메인 뷰에서 상태 를 확인할 수 있습니다.
새 도메인 연결
웹 앱에 새로운 도메인을 연결하는 경우와 같이 다운타임이 문제가 되지 않는다면 이 섹션의 안내를 따르세요.
1단계: 커스텀 도메인 추가
- Firebase 콘솔에서 호스팅 및 서버리스 > 앱 호스팅으로 이동합니다.
- App Hosting 백엔드를 선택하려면 대시보드 보기 옵션을 사용합니다.
- 설정 탭을 선택한 후 커스텀 도메인 추가 를 클릭합니다.
- 사이트에 연결할 커스텀 도메인 이름을 입력합니다. App Hosting
- (선택사항) 커스텀 도메인의 모든 요청을
지정된 두 번째 도메인으로 리디렉션하려면 체크박스를 선택합니다 (
example.com과www.example.com을 동일한 콘텐츠로 리디렉션). - 설정 계속 을 클릭하여 DNS 레코드를 구성하고 커스텀 도메인 설정을 완료합니다.
2단계: DNS 레코드 확인
- Firebase 콘솔의 도메인 설정 마법사는 페이지를 Firebase 앱 호스팅에 연결하기 위해 업데이트해야 하는 필수 레코드를 보여줍니다. 다음 입력을 사용하여 DNS 제공업체에서 도메인의 레코드를 추가, 삭제, 저장합니다.
- 이름: 레코드에 사용할 커스텀 도메인 이름 을 입력합니다. 입력한 호스트는 콘텐츠를 제공할 도메인이며 이 도메인은 최상위 도메인 또는 하위 도메인일 수 있습니다. 도메인 제공업체에 따라 이 용어를 '호스트 이름', '이름' 또는 '도메인'으로 표시할 수도 있습니다.
- 레코드 유형: 제공된 DNS 레코드를 추가합니다.
- 값: 제공된 값을 레코드에 할당합니다. 도메인 제공업체에 따라 이 용어를 '데이터', '지정 대상', '콘텐츠', '주소', 'IP 주소'로 표시할 수도 있습니다. 값 필드의 콘텐츠는 레코드 유형에 따라 다릅니다. 예를 들어 TXT 레코드는 문자열입니다.
- 레코드 확인 을 선택합니다. App Hosting은 도메인 제공업체에서 변경한 사항을 감지하려고 시도합니다. 변경사항이 전파되려면 최대 24시간이 소요될 수 있습니다. 백엔드 대시보드의 설정 > 도메인 뷰에서 상태 를 확인할 수 있습니다.
SSL 인증서 프로비저닝 대기
App Hosting에서 DNS 레코드를 업데이트한 후 도메인의 SSL 인증서를 프로비저닝하는 데 최대 몇 시간이 걸릴 수 있습니다. 경우에 따라 DNS를 Firebase App Hosting에 연결한 후 최대 24시간이 걸릴 수 있습니다.
브라우저의 보안 도구를 사용하면 이 인증서를 볼 수 있습니다. 도메인이 프로비저닝되는 동안 잘못된 인증서가 표시되거나 도메인에 연결하는 데 문제가 발생할 수 있습니다. 이는 정상적인 절차 중 한 부분이며 도메인 인증서를 사용할 수 있게 되면 해결됩니다.
참고: Firebase App Hosting 필요에 따라 커스텀 도메인에 SSL 인증서를 자동으로 다시 프로비저닝합니다.
커스텀 도메인의 상태 설명
| 상태 | 설명 |
|---|---|
| 설정 필요 |
DNS 레코드를 사용하여 구성을 변경해야 할 수 있습니다.
|
| 대기 중 | 커스텀 도메인을 올바르게 설정했지만 Firebase App Hosting이(가) SSL 인증서를 프로비저닝하지 않았습니다. 경우에 따라 지나치게 제한적인 CAA 레코드로 인해 커스텀 도메인의 SSL 인증서 발급이 지연될 수 있습니다. 인증 기관 `letsencrypt.org` 및 `pki.goog` 가 도메인에 SSL 인증서를 만들 수 있도록 설정되어 있는지 확인하세요. |
| 인증서 민팅 | SSL 인증서가 도메인에 대해 생성됩니다. |
| 연결됨 | 커스텀 도메인에 올바른 DNS 레코드와 SSL 인증서가 있습니다. |