빠른 시작: Google Cloud 콘솔을 사용하여 Cloud Run에 함수 배포

빠른 시작: Google Cloud 콘솔을 사용하여 Cloud Run에 함수 배포

미리보기 — Cloud Run functions

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

이 페이지에서는 Cloud Run을 사용하여 Google Cloud 콘솔을 통해 HTTP 함수를 배포하는 방법을 보여줍니다.

시작하기 전에

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

4. Enable the Artifact Registry, Cloud Build, Cloud Run Admin API, and Cloud Logging APIs.

   Enable the APIs

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

7. Enable the Artifact Registry, Cloud Build, Cloud Run Admin API, and Cloud Logging APIs.

   Enable the APIs

8. 프로젝트에서 인증되지 않은 호출을 제한하는 도메인 제한 조직 정책이 적용되는 경우 비공개 서비스 테스트의 설명대로 배포된 서비스에 액세스해야 합니다.

9. Cloud Build가 소스를 빌드할 수 있게 하려면 다음을 실행하여 Compute Engine 기본 서비스 계정에 Cloud Build 서비스 계정 역할을 부여합니다.
   gcloud projects add-iam-policy-binding PROJECT_ID \
       --member=serviceAccount:[e-mail] \
       --role=roles/cloudbuild.builds.builder

   PROJECT_NUMBER를 Google Cloud 프로젝트 번호로, PROJECT_ID를 Google Cloud 프로젝트 ID로 바꿉니다. 프로젝트 ID와 프로젝트 번호를 찾는 방법은 프로젝트 만들기 및 관리를 참조하세요.

   Compute Engine 기본 서비스 계정에 Cloud Build 서비스 계정 역할을 부여하려면 전파하는 데 몇 분 정도 걸립니다.

   참고:

   iam.automaticIamGrantsForDefaultServiceAccounts 조직 정책 제약조건은 편집자 역할이 기본 서비스 계정에 자동으로 부여되지 않도록 합니다. 2024년 5월 3일 이후에 조직을 만든 경우 기본적으로 이 제약조건이 적용됩니다.

   이 제약조건을 적용하여 자동 역할 부여를 사용 중지하는 것이 좋습니다. 자동 역할 부여를 중지한 경우 기본 서비스 계정에 부여할 역할을 결정한 후 직접 이러한 역할을 부여해야 합니다.

   기본 서비스 계정에 이미 편집자 역할이 있으면 편집자 역할을 권한이 더 낮은 역할로 바꾸는 것이 좋습니다. 서비스 계정 역할을 안전하게 수정하려면 정책 시뮬레이터를 사용하여 변경사항의 영향을 확인한 후 적절한 역할을 부여하고 취소합니다.

함수 배포하기

중요: 이 빠른 시작에서는 빠른 시작에 사용 중인 프로젝트에 소유자 역할이나 편집자 역할이 있다고 가정합니다. 그렇지 않은 경우 소스에서 Cloud Run 리소스를 배포하는 데 필요한 권한은 Cloud Run 소스 개발자 역할을 참조하세요.

함수를 배포하려면 다음 단계를 따르세요.

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

   Cloud Run으로 이동

2. 함수 작성을 클릭합니다.

3. 서비스 이름 필드에 함수를 설명하는 서비스 이름(예: my-nodejs-http-function)을 입력합니다. 서비스 이름은 문자로만 시작해야 하며, 문자, 숫자, 하이픈 등 최대 49자(영문 기준)를 포함할 수 있습니다. 서비스 이름은 하이픈으로 끝날 수 없으며 리전 및 프로젝트별로 고유해야 합니다. 서비스 이름은 나중에 변경할 수 없으며 공개적으로 표시됩니다.

4. 리전 목록에서 기본값 us-central1을 사용하거나 함수를 배포할 리전을 선택합니다.

5. 런타임 목록에서 기본값을 사용하거나 런타임 버전을 선택합니다.

6. 인증 섹션에서 인증되지 않은 호출 허용을 선택합니다. 이를 선택할 수 있는 권한(Cloud Run 관리자 역할)이 없으면 서비스가 배포되고 인증이 요구됩니다.

7. 만들기를 클릭하고 Cloud Run이 자리표시자 버전을 사용해서 서비스를 만들 때까지 기다립니다.

8. 콘솔이 소스 탭으로 리디렉션되며 여기에서 함수의 소스 코드를 볼 수 있습니다. 저장 및 재배포를 클릭합니다.

9. 소스 탭에서 선택적으로 페이로드 표시를 클릭하여 수신 요청 객체를 확인할 수 있습니다.

10. 배포 후, 컨테이너 URL은 URL: 텍스트 옆에 표시됩니다. 함수 출력을 보려면 클립보드에 복사를 클릭하여 URL을 복사하고 브라우저의 주소 표시줄에 URL을 붙여넣습니다.

함수에 Eventarc 트리거를 추가하는 방법을 알아보려면 함수 배포 가이드를 참고하세요.

Cloud Run 위치

Cloud Run은 리전을 기반으로 합니다. 즉, Cloud Run 서비스를 실행하는 인프라가 특정 리전에 위치해 있으며 해당 리전 내의 모든 영역에서 중복으로 사용할 수 있도록 Google이 관리합니다.

Cloud Run 서비스를 실행하는 리전을 선택하는 데 있어 중요한 기준은 지연 시간, 가용성 또는 내구성 요구사항입니다. 일반적으로 사용자와 가장 가까운 리전을 선택할 수 있지만 Cloud Run 서비스에서 사용하는 다른 Google Cloud 제품 위치도 고려해야 합니다. 여러 위치에서 Google Cloud 제품을 함께 사용하면 서비스 지연 시간과 비용에 영향을 미칠 수 있습니다.

Cloud Run은 다음 리전에서 사용할 수 있습니다.

등급 1 가격 적용

• asia-east1(타이완)
• asia-northeast1(도쿄)
• asia-northeast2(오사카)
• europe-north1(핀란드) 낮은 CO₂
• europe-southwest1(마드리드) 낮은 CO₂
• europe-west1(벨기에) 낮은 CO₂
• europe-west4(네덜란드) 낮은 CO₂
• europe-west8(밀라노)
• europe-west9(파리) 낮은 CO₂
• me-west1(텔아비브)
• us-central1(아이오와) 낮은 CO₂
• us-east1(사우스캐롤라이나)
• us-east4(북 버지니아)
• us-east5(콜럼버스)
• us-south1(댈러스) 낮은 CO₂
• us-west1(오리건) 낮은 CO₂

등급 2 가격 적용

• africa-south1(요하네스버그)
• asia-east2(홍콩)
• asia-northeast3(대한민국 서울)
• asia-southeast1(싱가포르)
• asia-southeast2 (자카르타)
• asia-south1(인도 뭄바이)
• asia-south2(인도 델리)
• australia-southeast1(시드니)
• australia-southeast2(멜버른)
• europe-central2(폴란드 바르샤바)
• europe-west10(베를린) 낮은 CO₂
• europe-west12(토리노)
• europe-west2(영국 런던) 낮은 CO₂
• europe-west3(독일 프랑크푸르트) 낮은 CO₂
• europe-west6(스위스 취리히) 낮은 CO₂
• me-central1(도하)
• me-central2(담맘)
• northamerica-northeast1(몬트리올) 낮은 CO₂
• northamerica-northeast2(토론토) 낮은 CO₂
• southamerica-east1(브라질 상파울루) 낮은 CO₂
• southamerica-west1(칠레 산티아고) 낮은 CO₂
• us-west2(로스앤젤레스)
• us-west3(솔트레이크시티)
• us-west4(라스베이거스)

Cloud Run 서비스를 이미 만들었다면 Google Cloud 콘솔의 Cloud Run 대시보드에서 리전을 확인할 수 있습니다.

확인

삭제

Cloud Run에서는 서비스를 사용하지 않을 때 비용이 청구되지 않지만 Artifact Registry에 컨테이너 이미지를 저장하는 데 요금이 청구될 수 있습니다. 비용이 청구되지 않도록 컨테이너 이미지를 삭제하거나 Google Cloud 프로젝트를 삭제할 수 있습니다. Google Cloud 프로젝트를 삭제하면 프로젝트 내에서 사용되는 모든 리소스에 대한 비용 청구가 중지됩니다.

주의: 프로젝트를 삭제하면 다음과 같은 효과가 발생합니다.
• 프로젝트의 모든 항목이 삭제됩니다. 이 문서의 태스크에 기존 프로젝트를 사용한 경우 프로젝트를 삭제하면 프로젝트에서 수행한 다른 작업도 삭제됩니다.
• 커스텀 프로젝트 ID가 손실됩니다. 이 프로젝트를 만들 때 앞으로 사용할 커스텀 프로젝트 ID를 만들었을 수 있습니다. appspot.com URL과 같이 프로젝트 ID를 사용하는 URL을 보존하려면 전체 프로젝트를 삭제하는 대신 프로젝트 내에서 선택한 리소스만 삭제합니다.
1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

다음 단계

• Eventarc를 사용하여 Cloud Storage에서 함수 트리거

• Google Cloud CLI를 사용하여 샘플 함수를 Cloud Run에 배포하려면 빠른 시작: gcloud CLI를 사용하여 Cloud Run에 함수 배포를 참조하세요.

• Google Cloud 콘솔 및 Google Cloud CLI를 사용하여 함수를 배포하려면 함수 배포를 참조하세요.

• 기존 함수를 보고 삭제하려면 서비스 버전 관리를 참조하세요.

• 자체 도구 모음에서 함수 컨테이너를 빌드하고 Cloud Run에 배포하려면 함수 빌드를 참조하세요.