커스텀 도메인 매핑

사용자는 Cloud Run이 배포된 서비스에 제공하는 기본 주소가 아닌 커스텀 도메인을 설정할 수 있습니다.

Cloud Run 서비스의 커스텀 도메인을 설정하려면 전역 외부 애플리케이션 부하 분산기를 사용하세요.

여러 커스텀 도메인을 동일한 Cloud Run 서비스에 매핑할 수 있습니다.

시작하기 전에

사용할 도메인이 없으면 새 도메인을 구입합니다. 모든 도메인 이름 등록기관을 사용할 수 있습니다.

전역 외부 애플리케이션 부하 분산기를 사용하여 커스텀 도메인 매핑

이 옵션을 사용하면 Cloud Run 서비스 앞에 전역 외부 애플리케이션 부하 분산기를 추가하고 부하 분산기 수준에서 커스텀 도메인을 구성합니다.

전역 외부 애플리케이션 부하 분산기를 사용할 때 한 가지 이점은 커스텀 도메인 설정에 대해 많은 제어 기능을 제공한다는 것입니다. 예를 들어 자체 TLS 인증서를 사용하거나 특정 URL 경로를 Cloud Run 서비스로 라우팅할 수 있습니다. 또한 캐싱을 위해 Cloud CDN을 구성하고 추가 보안을 위해 Google Cloud Armor를 구성할 수 있습니다.

단일 부하 분산기(예: <service>.example.com)의 커스텀 도메인 URL 패턴에서 URL 마스크를 사용하여 동적 호스트 이름 또는 경로에 여러 서비스를 매핑할 수도 있습니다.

Cloud Run으로 전역 외부 애플리케이션 부하 분산기 설정에 관한 문서를 참조하세요.

인증된 서비스에 커스텀 도메인 사용

인증된 서비스는 IAM으로 보호됩니다. 이러한 Cloud Run 서비스에는 사용자 인증 정보 생성 시 요청의 의도된 수신자(대상)를 선언하는 클라이언트 인증이 필요합니다.

대상은 일반적으로 타겟 서비스의 전체 URL이며, 기본적으로 Cloud Run 서비스의 경우 run.app으로 끝나는 생성 URL입니다. 하지만 커스텀 도메인을 사용하는 경우 서비스가 커스텀 도메인을 유효한 대상으로 수락하도록 커스텀 대상을 구성할 수 있습니다.

다음 단계

  • Terraform과 함께 전역 외부 애플리케이션 부하 분산기를 사용하여 Cloud Run용 커스텀 도메인을 설정하려면 이 샘플 코드를 살펴보세요.