커스텀 도메인 매핑

리전 ID

REGION_ID는 앱을 만들 때 선택한 리전을 기준으로 Google이 할당하는 코드입니다. 기존 앱은 App Engine URL에 REGION_ID.r을 포함하는 것이 선택사항이고, 신규 앱은 모두 곧 필수가 될 예정입니다.

원활한 전환을 위해 리전 ID를 사용하도록 App Engine을 천천히 업데이트하고 있습니다. 아직 Google Cloud 프로젝트가 업데이트되지 않은 경우에는 앱의 리전 ID가 표시되지 않습니다. 기존 앱에서 ID는 선택사항이므로 기존 앱에서 리전 ID를 사용할 수 있게 되더라도 URL을 업데이트하거나 다른 변경을 수행할 필요가 없습니다.

리전 ID에 대해 자세히 알아보세요.

App Engine이 앱에 제공하는 기본 주소가 아닌 커스텀 도메인을 사용할 수 있습니다.

커스텀 도메인을 사용하려면 도메인을 앱에 매핑한 후 DNS 레코드를 업데이트합니다. example.com과 같은 네이키드 도메인 또는 subdomain.example.com과 같은 하위 도메인을 매핑할 수 있습니다. 와일드 카드를 사용하여 하위 도메인을 매핑할 수도 있습니다.

기본적으로 도메인을 앱에 매핑하면 App Engine은 HTTPS 연결에 사용할 SSL용 관리형 인증서를 발급합니다. 자체 SSL 인증서를 사용하는 방법을 포함하여 커스텀 도메인에서 SSL을 사용하는 방법에 대한 자세한 내용은 SSL로 커스텀 도메인 보호를 참조하세요.

앱이 다음 리전 중 한 곳에 있는 경우 커스텀 도메인을 사용하면 응답이 많이 지연될 수 있습니다.

  • us-west2
  • us-east4
  • northamerica-northeast1
  • southamerica-east1
  • europe-west2
  • europe-west3
  • asia-south1
  • asia-northeast1
  • australia-southeast1

시작하기 전에

도메인이 없는 경우 하나를 구입합니다. 도메인 이름 등록기관을 사용할 수 있지만 Google Domains를 사용할 경우 도메인이 자동으로 App Engine에 확인되므로 도메인 확인 절차를 진행할 필요가 없습니다.

커스텀 도메인을 앱에 매핑

  1. Google Cloud Console에서 App Engine 설정 페이지의 커스텀 도메인 탭으로 이동합니다.

    커스텀 도메인 페이지로 이동

  2. 커스텀 도메인 추가를 클릭합니다.

  3. 도메인이 이미 확인된 경우 사용할 도메인 선택 섹션에 도메인이 표시됩니다. 드롭다운 메뉴에서 도메인을 선택하고 계속을 클릭합니다.

    아직 도메인을 확인하지 않은 경우 다음 단계를 따르세요.

    1. 드롭다운 메뉴에서 새 도메인 확인을 선택합니다.
    2. 네이키드 도메인 이름(예: 'example.com')을 입력하고 확인을 클릭합니다.

      'www.example.com'과 같은 하위 도메인만 매핑하려면 네이키드 도메인 이름을 입력하여 소유권을 확인합니다.

    3. 표시되는 웹마스터 센터 창에 정보를 입력합니다. 웹마스터 센터 사용에 대한 도움말은 웹마스터 센터 도움말을 참조하세요.

    4. 웹마스터 센터에서 단계를 완료한 후 Google Cloud Console에서 새 커스텀 도메인 추가 페이지로 돌아갑니다.

  4. 도메인을 [project-ID] 섹션으로 지정하고 매핑할 도메인과 하위 도메인을 지정합니다.

    네이키드 도메인과 www 하위 도메인을 매핑하는 것이 좋습니다. 필요한 경우 더 많은 하위 도메인을 추가할 수 있습니다.

    원하는 매핑을 모두 추가했으면 매핑 저장을 클릭합니다.

  5. 도메인의 DNS 레코드를 보려면 계속을 클릭합니다.

    App Engine 설정 페이지의 커스텀 도메인 탭에서 언제든지 이러한 레코드를 검색할 수 있습니다.

  6. 도메인 등록기관 웹사이트에 로그인하고 이전 단계에서 표시된 레코드로 DNS 레코드를 업데이트합니다.

도메인 등록기관에서 DNS 레코드 업데이트

서비스를 App Engine의 커스텀 도메인에 매핑한 후 도메인 등록기관의 DNS 레코드를 업데이트해야 합니다. App Engine은 편의를 위해 입력해야 하는 DNS 레코드를 생성 및 표시합니다.

  1. 도메인 매핑에 대한 DNS 레코드 정보를 가져옵니다.

    Google Cloud Console에서 App Engine 설정 페이지의 커스텀 도메인 탭으로 이동합니다. 페이지에는 앱에 매핑한 모든 도메인의 DNS 레코드가 표시됩니다.

  2. 도메인 등록기관의 계정에 로그인하고 DNS 구성 페이지를 엽니다.

  3. 도메인 구성 페이지의 호스트 레코드 섹션을 찾고 도메인을 앱에 매핑할 때 가져온 각 DNS 레코드를 추가합니다.

    레코드 필드에 다음 정보를 입력합니다.

    • 레코드 유형: Google에서 만든 DNS 레코드에 표시되는 레코드 유형을 입력합니다(A, AAAA 또는 CNAME).
    • 레코드 이름:
      • A 또는 AAAA 레코드에서 @을 입력합니다.
      • CNAME 레코드에 세 번째 수준의 도메인 이름을 입력합니다. 예를 들어 www.example.com 하위 도메인을 매핑하려면 www를 입력합니다.
    • TTL: 필요에 따라 TTL을 지정합니다.
    • 데이터: Google에서 만든 DNS 레코드에 표시되는 레코드 데이터(rrdata)를 입력합니다.
      • A 또는 AAAA 레코드에서 레코드 데이터는 IP 주소입니다.
      • CNAME 레코드에서 레코드 데이터는 도메인 이름입니다.
  4. 도메인 계정의 DNS 구성 페이지에 변경사항을 저장합니다. 대부분의 경우 변경사항이 적용되는 데 몇 분 정도 걸리지만 도메인에 대한 이전 DNS 레코드의 등록기관 및 TTL(수명)에 따라 몇 시간이 걸릴 수도 있습니다. 이 온라인 dig 버전과 같이 dig 도구를 사용하여 DNS 레코드가 성공적으로 업데이트되었는지 확인할 수 있습니다.

  5. 새 URL(예: https://www.example.com)을 통해 서비스를 탐색하여 성공 여부를 테스트합니다. 자동 SSL 인증서를 발급하는 데 몇 분 정도 걸릴 수 있습니다.

다른 Google Cloud 사용자 또는 서비스 계정에 소유권 위임

도메인 소유권을 다른 사용자나 서비스 계정에 위임해야 하는 경우 웹마스터 센터 페이지를 통해 권한을 추가하면 됩니다.

  1. 웹마스터 센터 확인 페이지를 엽니다.

  2. 속성에서 사용자 또는 서비스 계정을 추가할 도메인을 클릭합니다.

  3. 확인된 소유자 목록 끝에서 소유자 추가를 클릭한 후 Google 계정 이메일 주소 또는 서비스 계정 ID를 입력합니다.

    서비스 계정 목록을 보려면 Cloud Console에서 서비스 계정 페이지를 엽니다.

    서비스 계정 페이지로 이동

하위 도메인 사용

커스텀 도메인에 와일드 카드 하위 도메인 매핑을 설정하면 애플리케이션이 일치하는 모든 하위 도메인에 대한 요청을 처리합니다.

  • 사용자가 애플리케이션 버전 이름 또는 서비스 이름과 일치하는 도메인을 탐색하면 애플리케이션에서 해당 버전을 제공합니다.
  • 사용자가 서비스 이름과 일치하는 도메인을 탐색하면 애플리케이션에서 해당 서비스를 제공합니다.
  • 기본 도메인마다 관리형 SSL 인증서는 매주 20개로 제한됩니다. 한도에 도달해도 App Engine은 모든 요청이 처리될 때까지 관리형 인증서 발급을 계속 시도합니다.

와일드 카드 매핑

세 번째 수준의 하위 도메인부터 시작하여 모든 수준에서 와일드 카드를 사용하여 하위 도메인을 매핑할 수 있습니다. 예를 들어 도메인이 example.com인 경우 웹 주소 필드에 텍스트를 입력하면 다음과 같이 매핑됩니다.

  • *.example.com을 입력하면 example.com의 모든 하위 도메인이 앱에 매핑됩니다.
  • *.private.example.com을 입력하면 private.example.com의 모든 하위 도메인이 앱에 매핑됩니다.
  • *.nichol.sharks.nhl.example.com을 입력하면 nichol.sharks.nhl.example.com의 모든 하위 도메인이 앱에 매핑됩니다.
  • *.excogitate.system.example.com을 입력하면 excogitate.system.example.com의 모든 하위 도메인이 앱에 매핑됩니다.

dispatch.yaml 파일을 사용하여 App Engine의 서비스에 와일드 카드 매핑을 사용하면 특정 서비스에 대한 요청 라우팅을 정의할 수 있습니다.

G Suite를 도메인의 다른 하위 도메인(예: sitesmail)과 함께 사용하면 이 매핑의 우선순위가 높아지고 와일드 카드 매핑이 진행되기 전에 먼저 매핑 일치 여부가 확인됩니다. 또한 다른 App Engine 앱이 다른 하위 도메인에 매핑되어 있으면 이러한 매핑도 와일드 카드 매핑보다 더 높은 우선순위를 갖습니다.

일부 DNS 제공업체는 와일드 카드 하위 도메인 매핑을 지원하지 않습니다. 특히 DNS 제공업체가 CNAME 호스트 항목에 와일드 카드를 허용해야 합니다.

서비스, 버전, 인스턴스 구성요소를 포함하는 URL에 App Engine의 서비스 라우팅 규칙에 따라 와일드 카드 라우팅 규칙이 적용됩니다.

다음 단계

SSL로 커스텀 도메인 보호