맞춤 URL 만들기

이 페이지에서는 맞춤 URL을 구성하고 관리하는 방법을 설명합니다. 맞춤 URL을 사용하면 기본 결정적 URL 대신 입력하기 쉽고 기억하기 쉬우며 전 세계에서 사용할 수 있는 Cloud Run 서비스 URL을 얻을 수 있습니다.

  • 맞춤 URL 형식: https://CUSTOM_URL_DOMAIN.cloud.run
  • 기본 URL 형식: https://SERVICE_NAME-PROJECT_NUMBER.REGION.run.app

맞춤 URL을 사용하면 맞춤 도메인, DNS 레코드 또는 외부 부하 분산기를 설정하지 않고도 서비스를 공유할 수 있습니다.

Cloud Run 서비스에 커스텀 URL을 사용하면 다음과 같은 이점이 있습니다.

  • 간단한 URL: 서비스를 깔끔한 https://CUSTOM_URL_DOMAIN.cloud.run 형식에 매핑합니다.
  • 전역 가용성: 맞춤 URL은 표준 .run.app URL과 마찬가지로 어디서나 액세스할 수 있습니다.
  • 유연한 수명 주기: 새 버전을 배포하지 않고도 서비스 간에 맞춤 URL을 유연하게 연결, 분리 또는 이동할 수 있습니다.
  • 여러 매핑: 단일 서비스에 여러 맞춤 URL을 매핑할 수 있습니다.

시작하기 전에

  1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Google Cloud project.

  3. Google Cloud 프로젝트에서 Cloud Run 개발 환경을 설정합니다.
  4. gcloud CLI를 설치하고 초기화합니다.

필요한 역할

커스텀 URL을 관리하는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.

  • 맞춤 URL 매핑을 만들거나 업데이트하거나 삭제하려면 프로젝트에 대한 Cloud Run 관리자 (roles/run.admin) 역할이 있어야 합니다.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

제한사항

  • 기본적으로 프로젝트당 최대 50개의 도메인을 매핑할 수 있습니다.
  • 맞춤 URL 하위 도메인은 6~63자(영문 기준)여야 하고 영숫자 문자와 하이픈을 허용하는 표준 DNS 이름 지정 규칙을 준수해야 하며 하이픈으로 시작하거나 끝나면 안 됩니다.
  • 특정 하위 도메인은 제한됩니다.
  • 기본 .run.app URL과 달리 맞춤 URL은 일시적으로 사용 중지할 수 없습니다. 이러한 소스에서 트래픽이 제공되지 않도록 하려면 매핑을 삭제해야 합니다.
  • 내부 또는 내부 및 Cloud Load Balancing 트래픽으로 인그레스를 제한하는 Cloud Run 서비스는 지원되지 않습니다.
  • Terraform은 맞춤 URL에 지원되지 않습니다. 잠재적인 호환성 문제를 방지하려면 미리보기 domain_mapping 리소스를 사용하지 마세요.
  • 맞춤 URL은 완전히 독립적입니다. 서비스의 기본 .run.app URL을 사용 중지해도 맞춤 URL 매핑은 완전히 활성 상태로 유지되며 액세스할 수 있습니다.

서비스에 맞춤 URL 연결 또는 매핑

새 서비스를 배포할 때 맞춤 URL을 연결하거나 Google Cloud 콘솔 또는 gcloud를 사용하여 기존 서비스에 맞춤 URL을 매핑할 수 있습니다.

새 서비스에 맞춤 URL 연결

새 Cloud Run 서비스를 배포할 때 배포 구성의 일부로 맞춤 URL을 연결할 수 있습니다.

  1. Google Cloud 콘솔에서 Cloud Run 서비스 페이지로 이동합니다.

    Cloud Run으로 이동

  2. 컨테이너 배포를 클릭합니다.

  3. 서비스의 기본 구성 세부정보를 입력합니다.

  4. 맞춤 URL 섹션에서 맞춤 URL 추가를 클릭합니다.

  5. 유효한 맞춤 URL 도메인을 입력하세요.

  6. (선택사항) 맞춤 URL을 여러 개 추가하려면 맞춤 URL 추가를 다시 클릭합니다.

  7. 만들기를 클릭합니다.

기존 서비스에 커스텀 URL 매핑

Google Cloud 콘솔 또는 gcloud CLI를 사용하여 기존 Cloud Run 서비스에 맞춤 URL을 매핑할 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 도메인 매핑 페이지로 이동합니다.

    도메인 매핑으로 이동

  2. 맞춤 URL 추가를 클릭합니다.

  3. 서비스 목록에서 매핑할 서비스를 선택합니다.

  4. 맞춤 URL 도메인을 입력합니다.

  5. 계속을 클릭합니다.

맞춤 URL을 여러 개 추가하려면 맞춤 URL 추가를 다시 클릭하고 이전 단계를 따르세요.

gcloud

기존 서비스의 맞춤 URL 도메인 매핑을 만들려면 다음 명령어를 실행합니다.

gcloud beta run domain-mappings create \
    --service=SERVICE_NAME \
    --domain=CUSTOM_URL_DOMAIN.cloud.run

다음을 바꿉니다.

  • SERVICE_NAME: 맞춤 URL을 매핑할 서비스의 이름입니다.
  • CUSTOM_URL_DOMAIN: 연결할 하위 도메인입니다.

(선택사항) gcloud CLI를 사용하여 여러 맞춤 URL을 매핑하려면 각 맞춤 URL에 대해 매핑 생성 명령어를 반복적으로 실행합니다.

gcloud beta run domain-mappings create \
    --service=SERVICE_NAME \
    --domain=CUSTOM_URL_DOMAIN_1.cloud.run

gcloud beta run domain-mappings create \
    --service=SERVICE_NAME \
    --domain=CUSTOM_URL_DOMAIN_2.cloud.run

다음을 바꿉니다.

  • SERVICE_NAME: 배포할 서비스의 이름입니다.
  • CUSTOM_URL_DOMAIN_1: 연결할 첫 번째 하위 도메인입니다.
  • CUSTOM_URL_DOMAIN_2: 연결할 두 번째 하위 도메인입니다.

요청된 하위 도메인이 Google Cloud에서 다른 사용자 또는 서비스에 의해 이미 사용 중인 경우 오류가 표시되며 고유한 타겟을 선택해야 합니다.

맞춤 URL 목록 및 보기

모든 맞춤 URL을 나열하고 환경의 매핑 세부정보를 볼 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 Cloud Run 페이지로 이동합니다.

    Cloud Run으로 이동

  2. 서비스 이름을 클릭합니다.

  3. 네트워킹 탭으로 이동합니다.

  4. 엔드포인트 라벨 아래의 맞춤 도메인 섹션에서 연결된 URL을 찾습니다.

gcloud

프로젝트의 모든 맞춤 URL과 도메인 매핑을 나열하려면 다음 명령어를 실행합니다.

gcloud beta run domain-mappings list

특정 맞춤 URL 도메인 매핑의 세부정보를 보려면 다음을 실행하세요.

gcloud beta run domain-mappings describe \
    --domain=CUSTOM_URL_DOMAIN.cloud.run

CUSTOM_URL_DOMAIN을 설명하려는 하위 도메인으로 바꿉니다.

맞춤 잠재고객으로 보호

액세스를 제한하려면 맞춤 URL에 맞춤 잠재고객을 연결하면 됩니다.

gcloud beta run services update SERVICE_NAME \
    --add-custom-audiences=CUSTOM_URL_DOMAIN.cloud.run

다음을 바꿉니다.

  • SERVICE_NAME를 서비스 이름으로 바꿉니다.
  • CUSTOM_URL_DOMAIN: 맞춤 잠재고객 역할을 하는 하위 도메인입니다.

맞춤 URL 삭제

더 이상 필요하지 않은 맞춤 URL 매핑은 삭제할 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 도메인 매핑 페이지로 이동합니다.

    도메인 매핑으로 이동

  2. 삭제하려는 맞춤 URL 옆의 체크박스를 선택합니다.

  3. 삭제를 클릭합니다.

gcloud

Cloud Run 서비스에서 맞춤 URL 도메인 매핑을 삭제하려면 다음 명령어를 실행합니다.

gcloud beta run domain-mappings delete \
    --domain=CUSTOM_URL_DOMAIN.cloud.run

CUSTOM_URL_DOMAIN을 삭제하려는 하위 도메인으로 바꿉니다.

알려진 문제

  • 전파 지연 시간: 맞춤 URL을 만든 후 완전히 작동하기까지 몇 초 정도 걸릴 수 있습니다. 생성 직후에 URL에 액세스하면 일시적인 라우팅 오류가 발생할 수 있습니다.

  • 맞춤 URL 업데이트 또는 이동: 맞춤 URL에 대한 직접 업데이트 명령어는 없습니다. 연결된 맞춤 URL을 한 서비스에서 다른 서비스로 이동하려면 삭제 후 다시 만들기 절차를 따라야 합니다.

    콘솔

    1. Google Cloud 콘솔에서 도메인 매핑 페이지로 이동합니다.

      도메인 매핑으로 이동

    2. 이동할 맞춤 URL 옆에 있는 체크박스를 선택합니다.

    3. 삭제를 클릭합니다.

    4. 맞춤 URL 추가를 클릭합니다.

    5. 서비스 목록에서 새 타겟 서비스를 선택합니다.

    6. 이전에 신청한 정확한 맞춤 URL 도메인을 입력합니다.

    7. 만들기를 클릭하여 트래픽을 새 서비스로 리디렉션합니다.

    gcloud

    1. 이전 서비스에서 기존 매핑을 삭제합니다.

      gcloud beta run domain-mappings delete \
    --domain=CUSTOM_URL_DOMAIN.cloud.run

      CUSTOM_URL_DOMAIN을 이전에 소유권을 주장한 하위 도메인으로 바꿉니다.

    2. URL을 회수하고 새 서비스에 매핑합니다.

      gcloud beta run domain-mappings create \
    --service=NEW_SERVICE_NAME \
    --domain=CUSTOM_URL_DOMAIN.cloud.run

      다음을 바꿉니다.

      • NEW_SERVICE_NAME: 맞춤 URL을 이동할 서비스의 이름입니다.
      • CUSTOM_URL_DOMAIN: 연결할 하위 도메인입니다.

다음 단계