Azure Static Web Apps에서 apex 도메인 설정

  • 아티클

하위 도메인이 없는 도메인 이름을 apex 또는 루트 도메인이라고 합니다. 예를 들어 www.example.com 도메인은 example.com apex 도메인과 조인된 www 하위 도메인입니다.

Google 및 GoDaddy와 같은 일부 도메인 등록 기관에서는 apex 도메인을 기존 URL로 가리킬 수 없습니다. 등록 기관에서 ALIAS 또는 ANAME 레코드를 지원하지 않거나 CNAME 평면화를 허용하지 않을 경우 다음 옵션을 고려합니다.

  • Azure DNS를 사용하여 도메인 구성
  • apex 도메인을 www 하위 도메인으로 전달
  • A 레코드 사용

A 레코드를 사용하면 트래픽이 정적 웹앱의 단일 지역 호스트로 전송됩니다. 사용하도록 설정하면 정적 웹앱이 더 이상 글로벌 배포의 이점을 얻을 수 없으며, 이로 인해 애플리케이션 성능에 영향을 줄 수 있습니다. 최상의 성능을 위해 APEX 도메인에 대해 ALIAS, ANAME 또는 CNAME 레코드를 사용하는 것이 좋습니다.

이 가이드에서는 apex 도메인을 구성하기 위한 3가지 옵션을 보여 줍니다.

  • 도메인 등록 기관에서 ALIAS DNS 레코드를 지원하는 경우 ALIAS 레코드로 설정하는 단계를 사용합니다.

    등록 기관에서 ALIAS 레코드를 지원하지 않지만 ANAME 레코드 또는 CNAME 평면화를 지원하는 경우 구성 설정에 대한 설명서를 참조하세요.

  • 도메인 등록 기관에서 ALIAS DNS 레코드를 지원하지 않는 경우 www 하위 도메인으로 전달의 단계를 사용합니다.

  • 위의 옵션이 적합하지 않은 경우 A 레코드로 설정하는 단계를 사용합니다. A 레코드를 사용하면 트래픽이 단일 Static Web Apps 호스트로 전송되고 앱은 더 이상 글로벌 배포에서 제공하는 성능 향상의 이점을 누릴 수 없습니다.

ALIAS 레코드로 설정

ALIAS 레코드를 만들기 전에 먼저 도메인 소유의 유효성을 검사해야 합니다.

소유권 유효성 검사

  1. Azure Portal을 엽니다.

  2. 정적 웹앱으로 이동합니다.

  3. 개요 창에서 사이트의 생성된 URL을 복사하고 나중에 사용할 수 있도록 텍스트 편집기에 따로 보관해 둡니다.

  4. 설정에서 사용자 지정 도메인을 선택합니다.

  5. + 추가를 선택합니다.

  6. 도메인 입력 탭에서 apex 도메인 이름을 입력합니다.

    예를 들어 도메인 이름이 example.com인 경우 이 상자에 example.com을 입력합니다(하위 도메인 제외).

  7. 다음을 선택합니다.

  8. 유효성 검사 + 구성 탭에서 다음 값을 입력합니다.

    설정 값
    도메인 이름 이 값은 이전 단계에서 입력한 도메인 이름과 일치해야 합니다.
    호스트 이름 레코드 종류 TXT를 선택합니다.

  9. 코드 생성을 선택합니다.

    코드가 생성될 때까지 기다립니다. 인덱싱이 완료되려면 1분 정도 걸릴 수 있습니다.

  10. TXT 레코드 값이 생성되면 생성된 값 옆에 있는 코드를 클립보드에 복사합니다.

  11. 닫기를 선택합니다.

  12. 새 브라우저 탭을 열고 도메인 등록 기관 계정에 로그인합니다.

  13. 도메인 이름의 DNS 구성 설정으로 이동합니다.

  14. 다음 값을 사용하여 새 TXT 레코드를 추가합니다.

    설정 값
    유형 TXT
    Host @을 입력합니다.
    값 Azure Portal에서 복사한 생성된 코드 값을 붙여넣습니다.
    TTL(적용 가능한 경우) 기본값으로 둡니다.

  15. DNS 레코드에 변경 내용을 저장합니다.

ALIAS 레코드 설정

  1. 도메인 이름의 DNS 구성 설정으로 돌아갑니다.

  2. 다음 값을 사용하여 새 ALIAS 레코드를 추가합니다.

    설정 값
    유형 ALIAS
    Host @을 입력합니다.
    값 Azure Portal에서 복사한 생성된 URL을 붙여넣습니다. URL에서 https:// 접두사를 제거해야 합니다.
    TTL(적용 가능한 경우) 기본값으로 둡니다.

  3. DNS 레코드에 변경 내용을 저장합니다.

    DNS 설정을 전파해야 하므로 이 프로세스를 완료하는 데 다소 시간이 걸릴 수 있습니다.

  4. 새 브라우저 탭을 열고 apex 도메인으로 이동합니다.

    DNS 레코드가 업데이트되면 브라우저에 정적 웹앱이 표시되어야 합니다. 또한 https를 사용하여 사이트가 안전하게 제공되는지 확인하기 위해 위치를 검사합니다.

www 하위 도메인으로 전달

도메인 등록 기관마다 도메인 이름을 관리하는 프로세스가 다릅니다. 등록 기관을 통해 계정에 로그인한 후 도메인 전달 옵션을 찾습니다. 일부 등록 기관은 DNS 옵션 아래에 이 기능을 나열하고 다른 등록 기관은 웹 사이트 옵션과 연결되어 있습니다.

전달을 설정할 때 www 하위 도메인으로 전달하도록 apex 도메인만 구성해야 합니다.

자세한 내용은 등록 기관의 설명서를 참조하세요.

A 레코드로 설정

A 레코드를 만들기 전에 먼저 도메인 소유의 유효성을 검사해야 합니다.

소유권 유효성 검사

  1. Azure Portal을 엽니다.

  2. 정적 웹앱으로 이동합니다.

  3. Essentials 섹션의 오른쪽 위 모서리에 있는 ‘개요’ 창에서 JSON 보기를 선택합니다.

  4. stableInboundIP 속성 값을 복사하고 나중에 사용하기 위해 텍스트 편집기에서 따로 설정합니다. 지역 Static Web Apps 호스트의 IP 주소입니다.

  5. 설정에서 사용자 지정 도메인을 선택합니다.

  6. + 추가를 선택합니다.

  7. 도메인 입력 탭에서 apex 도메인 이름을 입력합니다.

    예를 들어 도메인 이름이 example.com인 경우 이 상자에 example.com을 입력합니다(하위 도메인 제외).

  8. 다음을 선택합니다.

  9. 유효성 검사 + 구성 탭에서 다음 값을 입력합니다.

    설정 값
    도메인 이름 이 값은 이전 단계에서 입력한 도메인 이름과 일치해야 합니다.
    호스트 이름 레코드 종류 TXT를 선택합니다.

  10. 코드 생성을 선택합니다.

    코드가 생성될 때까지 기다립니다. 인덱싱이 완료되려면 1분 정도 걸릴 수 있습니다.

  11. TXT 레코드 값이 생성되면 생성된 값 옆에 있는 코드를 클립보드에 복사합니다.

  12. 닫기를 선택합니다.

  13. 새 브라우저 탭을 열고 도메인 등록 기관 계정에 로그인합니다.

  14. 도메인 이름의 DNS 구성 설정으로 이동합니다.

  15. 다음 값을 사용하여 새 TXT 레코드를 추가합니다.

    설정 값
    유형 TXT
    Host @을 입력합니다.
    값 Azure Portal에서 복사한 생성된 코드 값을 붙여넣습니다.
    TTL(적용 가능한 경우) 기본값으로 둡니다.

  16. DNS 레코드에 변경 내용을 저장합니다.

A 레코드 설정

  1. 도메인 이름의 DNS 구성 설정으로 돌아갑니다.

  2. 다음 값을 사용하여 새 A 레코드를 추가합니다.

    설정 값
    유형 A
    Host @을 입력합니다.
    값 Azure Portal에서 복사한 생성된 stableInboundIP를 붙여넣습니다.
    TTL(적용 가능한 경우) 기본값으로 둡니다.

  3. DNS 레코드에 변경 내용을 저장합니다.

    DNS 설정을 전파해야 하므로 이 프로세스를 완료하는 데 다소 시간이 걸릴 수 있습니다.

  4. 새 브라우저 탭을 열고 apex 도메인으로 이동합니다.

    DNS 레코드가 업데이트되면 브라우저에 정적 웹앱이 표시되어야 합니다. 또한 https를 사용하여 사이트가 안전하게 제공되는지 확인하기 위해 위치를 검사합니다.

다음 단계

기본 도메인 관리