커스텀 도메인 및 CDN을 위해 Cloud Run을 Firebase 호스팅에 연결

주의: 2024년 10월부터 신규 사용자를 위한 Google Cloud 콘솔 및 Google Cloud CLI에서 Cloud Run 통합이 지원 중단됩니다. 기존 사용자는 2025년 1월까지 계속 액세스할 수 있습니다. 별도의 조치를 취하지 않아도 됩니다. 이러한 통합을 사용하는 이미 배포된 서비스는 계속 작동합니다. 배포한 각 통합에 개별 제품 환경을 사용하는 것으로 전환하는 것이 좋습니다. 커스텀 도메인을 구성하고 Firebase 호스팅에 연결하려면 Firebase 호스팅을 사용하여 커스텀 도메인 매핑을 참고하세요.

미리보기 — Using the Cloud Run integrations

이 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제공 서비스 약관'이 적용됩니다. GA 이전 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

Cloud Run 서비스의 새 공개 엔드포인트를 설정하려면 Cloud Run 서비스 앞에 Firebase 호스팅을 사용하면 됩니다. Firebase 호스팅을 사용하면 글로벌 CDN에 액세스하고 서비스에 무료 커스텀 도메인을 구성할 수 있습니다. Firebase 호스팅을 사용하면 Cloud Run 서비스로 호스팅 요청을 전달할 수 있지만 Firebase 호스팅 사용에 익숙하지 않으면 온보딩하는 데 시간이 걸릴 수 있습니다.

이 페이지에 설명된 Cloud Run 통합(프리뷰)을 사용하면 Firebase 호스팅을 설정할 필요 없이 새로운 Firebase 호스팅을 통해 Cloud Run 서비스를 빠르게 노출할 수 있습니다. 기존 사이트를 사용하려면 Cloud Run으로 동적 콘텐츠 제공 및 마이크로서비스 호스팅을 참조하세요.

시작하기 전에

• 통합하려는 Cloud Run 서비스가 이미 배포되었는지 확인합니다.
• Firebase 호스팅 가격 책정 가격 책정 페이지를 검토하세요. 통합에 사용되는 개별 리소스에 대해 요금이 청구됩니다.

필요한 역할

Cloud Run 통합을 사용하려면 사용자 또는 관리자가 두 가지 서로 다른 주 구성원에 IAM 역할을 부여해야 합니다.

Google 계정에 필요한 역할을 보려면 클릭하세요.

Cloud Run 통합을 사용하는 데 필요한 권한을 얻으려면 관리자에게 Google 계정에 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

• Cloud Run 개발자(roles/run.developer)
• Compute 뷰어(roles/compute.viewer)
• 서버리스 통합 개발자(roles/runapps.developer)
• 서버리스 통합 작업자(roles/runapps.operator)
• 서비스 계정 사용자(roles/iam.serviceAccountUser)

서비스 계정의 필수 역할을 보려면 클릭합니다.

Cloud Run 서비스를 배포하려면 자동 생성된 Compute Engine 기본 서비스 계정을 사용하거나 사용자 관리형 서비스 계정을 지정하면 됩니다. 서비스 계정에는 다음 역할이 있어야 합니다.

• Cloud Run 개발자(roles/run.developer)
• 로그 버킷 작성자(roles/logging.bucketWriter)
• 서비스 계정 사용자(roles/iam.serviceAccountUser)
• 스토리지 관리자(roles/storage.admin)
• Firebase 관리자(roles/firebase.admin)

Firebase 호스팅 사이트에 Cloud Run 서비스 연결

콘솔 또는 명령줄을 사용하여 Firebase 호스팅 사이트에 연결할 수 있습니다.

Console

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

   Cloud Run으로 이동

2. 서비스 목록에서 이 통합에서 사용할 서비스를 클릭합니다.

3. Integrations 탭을 클릭합니다.

4. 통합 추가를 클릭합니다.

5. Firebase 호스팅을 클릭합니다.

   

6. 하위 도메인(사이트 ID) 필드에 사이트 ID를 입력합니다. 생성 후 site_ID.web.app에 서비스가 호스팅됩니다.

7. API 목록을 사용 설정하라는 메시지가 표시되면 사용 설정을 클릭하고 API가 사용 설정될 때까지 기다립니다. Firebase 호스팅 API에는 Firebase 서비스 약관이 적용됩니다.

8. 리소스에서 이 통합으로 인해 생성되는 새 리소스를 확인합니다.

9. 제출을 클릭하고 통합 및 리소스가 생성될 때까지 기다립니다.

   • 완료되면 사이트의 공개 URL이 표시됩니다.
   • 제공된 링크를 클릭하여 Firebase Console로 바로 이동할 수도 있습니다.

gcloud

1. 최신 Google Cloud CLI로 업데이트합니다.

   gcloud components update

2. 통합을 만듭니다.

   gcloud beta run integrations create \
   --type=firebase-hosting \
   --service=SERVICE \
   --parameters='site-id=SITE_ID'

   다음과 같이 바꿉니다.

   • SITE_ID를 만들고 사용하려는 Firebase 호스팅 사이트 ID로 바꿉니다. 이 ID는 Firebase URL 'SITE_ID.web.app'의 하위 도메인으로 표시됩니다.
   • SERVICE를 사용 중인 Cloud Run 서비스 이름으로 바꿉니다.

   필요한 경우 --service-account=SERVICE_ACCOUNT_EMAIL 플래그를 포함합니다.

   • SERVICE_ACCOUNT_EMAIL을 서비스를 배포하는 데 사용되는 사용자 관리 서비스 계정 이메일 주소([e-mail])로 바꿉니다. 기본 컴퓨팅 서비스 계정(SERVICE_ACCOUNT_ID@PROJECT_ID.iam.gserviceaccount.com)을 사용하려면 이 플래그를 생략합니다.

     Cloud Run 통합을 배포할 때 지정된 서비스 계정을 계속 사용하려면 다음을 실행합니다.

     gcloud config set runapps/deployment-service-account

3. Firebase 호스팅 사이트가 생성되는 동안 1~2분 정도 기다리세요. 프로세스가 완료되면 다음 성공 메시지가 표시됩니다.

   [firebase-hosting] integration [firebase-hosting-1] has been created successfully.

   gcloud beta run integrations describe를 사용하여 상태를 확인할 수 있습니다.

Firebase 호스팅 통합 업데이트

통합을 업데이트하면 해당 통합과 연결된 모든 Google Cloud 리소스가 업데이트됩니다. Cloud Run 서비스에서 Firebase 호스팅 통합을 업데이트하려면 다음 안내를 따르세요.

Console

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

   Cloud Run으로 이동

2. 업데이트하려는 서비스를 클릭합니다.

3. Integrations 탭을 클릭합니다.

4. Firebase 호스팅 통합을 찾고 수정을 클릭합니다.

5. 필드 업데이트가 완료되면 업데이트를 클릭합니다.

gcloud

1. 다음 명령어를 사용하여 사용 가능한 통합 목록을 가져옵니다.

   gcloud beta run integrations list

2. 명령어를 실행하여 통합을 업데이트합니다.

   gcloud beta run integrations update INTEGRATION_NAME

   다음과 같이 바꿉니다.

   • INTEGRATION_NAME을 Firebase 호스팅 통합 이름으로 바꿉니다.

   원하는 경우 다음 플래그 옵션을 사용할 수 있습니다.

   옵션	설명
   --parameters	Cloud Run 서비스를 대체할 사이트 ID입니다.
   --service-account	서비스를 업데이트할 때 지정할 사용자 관리형 서비스 계정 이메일 주소입니다. 이 서비스 계정은 배포에 사용된 이전 서비스 계정을 재정의합니다.

Firebase 호스팅 통합 보기

Cloud Run 서비스에 대한 Firebase 호스팅 통합의 현재 상태를 보려면 다음 안내를 따르세요.

Console

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

   Cloud Run으로 이동

2. 서비스 목록에서 이 통합에서 사용할 서비스를 클릭합니다.

3. Integrations 탭을 클릭합니다.

4. 관심 있는 Firebase 호스팅 통합을 찾고 세부정보 보기를 클릭합니다.

gcloud

1. 다음 명령어를 사용하여 사용 가능한 통합 목록을 가져옵니다.

   gcloud beta run integrations list

2. 반환된 목록의 이름을 사용하여 세부정보를 표시합니다.

   gcloud beta run integrations describe INTEGRATION_NAME

   INTEGRATION_NAME을 Firebase 호스팅 통합 이름으로 바꿉니다.

Firebase 호스팅 통합 삭제

통합을 삭제하면 해당 통합에 연결된 모든 Google Cloud 리소스도 삭제되지만 Cloud Run 서비스는 삭제되지 않습니다.

Cloud Run 서비스에서 Firebase 호스팅 통합을 삭제하려면 다음 안내를 따르세요.

Console

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

   Cloud Run으로 이동

2. 통합을 삭제하려는 서비스를 클릭합니다.

3. Integrations 탭을 클릭합니다.

4. 관심 있는 Firebase 호스팅 통합을 찾고 통합 오른쪽에 있는 줄임표 아이콘을 클릭한 다음 삭제를 클릭합니다.

gcloud

1. 다음 명령어를 사용하여 사용 가능한 통합 목록을 가져옵니다.

   gcloud beta run integrations list

2. 반환된 목록의 이름을 사용하여 통합을 삭제합니다.

   gcloud beta run integrations delete INTEGRATION_NAME

   다음과 같이 바꿉니다.

   • INTEGRATION_NAME을 Firebase 호스팅 통합 이름으로 바꿉니다.

   원하는 경우 다음 플래그 옵션을 사용할 수 있습니다.

   옵션	설명
   --service-account	삭제 작업을 수행할 사용자 관리형 서비스 계정 이메일 주소입니다.

제한사항

Cloud Run 통합은 특정 리전에서만 지원됩니다. Cloud Run 통합에서 지원되지 않는 리전을 사용해야 하는 경우 Cloud Run으로 동적 콘텐츠 제공 및 마이크로서비스 호스팅을 참조하세요.