빠른 시작: Cloud Run 인스턴스 만들기

빠른 시작: Cloud Run 인스턴스 만들기

미리보기 — Cloud Run 인스턴스

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

이 페이지에서는 Cloud Run을 사용하여 샘플 컨테이너에서 Cloud Run 인스턴스를 만들고, 로그를 보고, gcloud CLI를 사용하여 수명 주기를 관리하는 방법을 보여줍니다.

시작하기 전에

1. Google Cloud CLI를 설치합니다.

   참고: 이전에 gcloud CLI를 설치했으면 gcloud components update를 실행하여 최신 버전이 설치되어 있는지 확인하세요.

2. gcloud CLI에서 제휴 ID를 사용하도록 구성합니다.

   자세한 내용은 제휴 ID로 gcloud CLI에 로그인을 참고하세요.

3. gcloud CLI를 초기화하려면, 다음 명령어를 실행합니다.

   gcloud init

4. 프로젝트를 만들거나 Google Cloud 선택합니다.

   프로젝트를 선택하거나 만드는 데 필요한 역할

   • 프로젝트 선택: 프로젝트를 선택하는 데 특정 IAM 역할이 필요하지 않습니다. 역할이 부여된 프로젝트를 선택할 수 있습니다.
   • 프로젝트 만들기: 프로젝트를 만들려면 resourcemanager.projects.create 권한이 포함된 프로젝트 생성자 역할 (roles/resourcemanager.projectCreator)이 필요합니다. 역할 부여 방법 알아보기.
   참고: 이 절차에서 생성한 리소스를 유지하지 않으려면 기존 프로젝트를 선택하지 말고 프로젝트를 새로 만드세요. 작업이 끝나면 프로젝트를 삭제하여 프로젝트와 관련된 모든 리소스를 삭제할 수 있습니다.

   • Google Cloud 프로젝트 만들기:

     gcloud projects create PROJECT_ID

     PROJECT_ID를 만들려는 Google Cloud 프로젝트의 이름으로 바꿉니다.

   • 생성한 Google Cloud 프로젝트를 선택합니다.

     gcloud config set project PROJECT_ID

     PROJECT_ID를 Google Cloud 프로젝트 이름으로 바꿉니다.

5. 이 가이드에 기존 프로젝트를 사용하는 경우 이 가이드를 완료하는 데 필요한 권한이 있는지 확인합니다. 새 프로젝트를 만든 경우에는 이미 필요한 권한이 있습니다.

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

7. Cloud Run Admin API 및 Cloud Logging API를 사용 설정합니다.

   API 사용 설정에 필요한 역할

   API를 사용 설정하려면 serviceusage.services.enable 권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할 (roles/owner)을 통해 이 권한이 이미 있을 수 있습니다. 그렇지 않으면 서비스 사용량 관리자 역할 (roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할 부여 방법 알아보기.

   gcloud services enable run.googleapis.com logging.googleapis.com

8. Cloud Run 인스턴스의 기본 프로젝트를 설정하려면 다음 명령어를 실행합니다.

   gcloud config set project PROJECT_ID

   이 빠른 시작에서 만든 프로젝트 이름으로 PROJECT_ID을(를) 바꿉니다.
9. gcloud beta 구성요소가 설치되어 있는지 확인합니다.

   gcloud components install beta

10. Cloud Run 가격 책정을 검토하거나 가격 계산기로 비용을 추정합니다.

필요한 역할

이 빠른 시작을 완료하는 데 필요한 권한을 얻으려면 관리자에게 다음의 IAM 역할을 부여해 달라고 요청하세요.

• 인스턴스에 대한 Cloud Run 관리자 (roles/run.admin) 역할
• 서비스 계정 사용자 (roles/iam.serviceAccountUser) 서비스 ID에 대한
• 로그 뷰어 (roles/logging.viewer) 프로젝트에 대한

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

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

인스턴스 만들기

gcloud CLI를 사용하여 샘플 컨테이너에서 Cloud Run 인스턴스를 만들려면 다음 안내를 따르세요.

1. 다음 명령어를 실행합니다.

   gcloud beta run instances create my-instance \
   --image us-docker.pkg.dev/cloudrun/container/hello \
   --region REGION \
   --port 8080 \
   --no-invoker-iam-check

   REGION을 지원되는 Google Cloud 리전으로 바꿉니다.

   --no-invoker-iam-check 플래그는 IAM 호출자 인증을 사용 중지하므로 IAM 인증 없이 인스턴스 URL에 액세스할 수 있습니다.

2. 인스턴스 생성이 완료될 때까지 기다립니다. 완료되면 명령어에 다음과 비슷한 출력이 표시됩니다.

   Creating instance...
   Importing container..............done
   Provisioning resources.......done
   Starting instance.....done
   Done.
   Instance [my-instance] has successfully been created.
   
   URL: https://my-instance-PROJECT-NUMBER.REGION.run.app
   

3. 브라우저에서 반환된 URL을 열어 실행 중인 컨테이너와 상호작용합니다.

인스턴스 로그 보기

Cloud Run 인스턴스에서 생성된 로그를 보려면 다음 안내를 따르세요.

1. Google Cloud 콘솔에서 로그 탐색기로 이동합니다.

   로그 탐색기로 이동

2. 특정 인스턴스의 로그를 필터링합니다.

   resource.type="cloud_run_instance"
   resource.labels.location="<var>REGION</var>"
   resource.labels.instance_name="my-instance"
   

정리

이 페이지에서 사용한 리소스 비용이 Google Cloud 계정에 청구되지 않도록 하려면 다음 단계를 수행합니다.

인스턴스 삭제

Cloud Run 인스턴스를 중지하고 삭제하려면 다음 안내를 따르세요.

gcloud beta run instances delete my-instance --region REGION

테스트 프로젝트 삭제

Google Cloud 프로젝트를 삭제하면 해당 프로젝트의 모든 리소스에 대한 비용 청구가 중단됩니다. 프로젝트의 모든 Google Cloud 리소스를 해제하려면 다음 단계를 따르세요.

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

프로젝트 Google Cloud 삭제:

gcloud projects delete PROJECT_ID

다음 단계

Cloud Run 인스턴스에 대한 자세한 내용은 다음을 참고하세요.

• Cloud Run 인스턴스 만들기 및 관리
• Cloud Run 인스턴스 수명 주기