AI Studio에 배포된 앱에 맞춤 URL 지정하기

Source: Dev.to

소개

Google AI Studio를 사용해 AI 애플리케이션을 방금 만들고 배포했습니다. 기본 URL은 다음과 같은 형태일 겁니다:

https://burning-man-animal-cuddle-614365371127.us-west1.run.app/

자동으로 생성된 이름도 재미있지만, Namecheap에서 구매한 vibe-compose.com 같은 깔끔한 맞춤 도메인을 사용하고 싶을 겁니다. 아래는 Cloud Run 서비스를 타사 도메인 등록 기관에 연결하는 단계별 가이드입니다.

1단계 – Cloud Run에 매핑 추가

1. Google Cloud Console을 열고 Cloud Run → Domains 로 이동합니다.

2. 프로젝트를 선택합니다(예: Generative Language Client).

3. Domain Mappings 섹션에서 Add Mapping 을 클릭합니다.

   

4. 대화 상자에서:

   • Select service: 배포한 앱을 선택합니다.
   • Select a verified domain: Verify a new domain… 를 클릭합니다.
   • Base domain: 루트 도메인(예: vibe-compose.com)을 입력합니다. 아직 www는 추가하지 마세요.

2단계 – 도메인 소유권 확인

Google이 도메인 소유권을 증명하기 위해 TXT 레코드 추가를 요구합니다.

1. Verify 를 클릭하면 필요한 TXT 레코드가 표시되는 모달이 나타납니다.

   
   

2. Namecheap에 로그인하고 Domain List → Manage → Advanced DNS 로 이동한 뒤 새 TXT Record 를 추가합니다:

   • Host: @
   • Value: (확인 문자열을 붙여넣기)
   • TTL: Automatic

   

3. 몇 분 정도 기다린 뒤 Cloud Console으로 돌아가 VERIFY 를 클릭합니다.

3단계 – “Naked”(루트) 도메인 매핑

확인 후 Cloud Run은 루트 도메인에 사용할 IP 주소 목록을 제공합니다.

1. Namecheap Advanced DNS 에서 다음 레코드를 추가합니다(예시 IP는 Cloud Run에서 제공된 주소로 교체).

   • A 레코드 (4개):

     • Host: @
     • Value: xxx.xxx.xxx.32.21, xxx.xxx.xxx.34.21, xxx.xxx.xxx.36.21, xxx.xxx.xxx.38.21

   • AAAA 레코드 (4개):

     • Host: @
     • Value: (Cloud Run에서 제공한 IPv6 주소)

   

4단계 – www 서브도메인 추가

www.vibe-compose.com 을 작동시키려면:

1. Cloud Run Domain Mappings 로 돌아가 다시 Add Mapping 을 클릭합니다.

2. www.vibe-compose.com 을 입력합니다. Cloud Run이 CNAME 레코드를 요구합니다.

3. Namecheap에 CNAME Record 를 추가합니다:

   • Host: www
   • Value: ghs.googlehosted.com. (끝에 점 포함)
   • TTL: Automatic

   ⚠️ ghs.googlehosted.com 을 Host 필드에 넣지 마세요; Host는 반드시 www이어야 합니다.

5단계 – 전파 대기

Cloud Run 대시보드에서 도메인 옆에 회전 아이콘(대기 중)이 보이다가 최종적으로 초록색 체크표시로 바뀝니다.

• DNS 전파: 몇 분에서 최대 24시간까지 걸릴 수 있습니다.
• 인증서 발급: DNS 레코드가 보이기 시작하면 Google이 자동으로 관리형 SSL 인증서를 생성합니다.

결론

맞춤 도메인을 매핑하면 AI Studio 프로젝트에 전문적인 마무리를 더할 수 있습니다. 위 단계를 마치면 앱에 https://vibe-compose.com (및 https://www.vibe-compose.com) 로 접근할 수 있게 되며, 자동 생성된 Cloud Run URL을 더 이상 사용하지 않아도 됩니다.

즐거운 코딩 되세요! 🚀