모든 역할 및 권한

Eventarc를 사용하면 Google Cloud 서비스 및 기타 이벤트 제공업체의 이벤트를 다양한 대상으로 안전하게 라우팅할 수 있습니다. 이 액세스 권한을 관리하려면 이벤트 소스 및 대상에 따라 트리거를 만들거나 워크로드를 배포하는 주 구성원, 트리거 서비스 계정, Google 관리 서비스 에이전트에 특정 Identity and Access Management(IAM) 역할을 부여합니다. 자세한 내용은 표의 이벤트 타겟 열에 연결된 가이드를 참조하세요.

이벤트 소스 및 대상별 필수 역할

특정 이벤트 소스 또는 타겟으로 다음 표를 필터링하면 결과에 해당 모든 이벤트 소스 및 모든 이벤트 타겟 행이 자동으로 포함됩니다. 이러한 기준 역할은 소스별 또는 타겟별 역할 외에 적용됩니다.

예를 들어 Cloud Run Functions로 라우팅되는 Cloud Storage 직접 이벤트에 대한 역할을 부여하면 모든 이벤트 소스 및 모든 이벤트 대상 행의 역할도 적용됩니다.

이벤트 소스 주 구성원 또는 서비스 에이전트 필요한 역할 필요한 경우 이벤트 대상
모든 이벤트 소스 source-all source-cloud-storage source-pubsub Eventarc를 호출하는 주 구성원(예: 트리거 생성자) Eventarc 관리자
(roles/eventarc.admin)

프로젝트에 필요: 트리거를 만들 때 서비스 계정 지정을 포함하여 Eventarc 리소스에 대한 전체 제어 권한을 부여합니다.

모든 이벤트 대상 target-vpc target-cloud-run-functions target-cloud-run-service target-gke target-workflows
모든 이벤트 소스 source-all source-cloud-storage source-pubsub Eventarc를 호출하는 주 구성원(예: 트리거 생성자) 서비스 계정 사용자
(roles/iam.serviceAccountUser)

프로젝트 또는 서비스 계정에 필요: 사용자 관리형 서비스 계정을 트리거에 연결하고 대상을 배포할 때 런타임, 빌드 또는 워크플로 서비스 계정으로 작동할 수 있습니다.

모든 이벤트 대상 target-vpc target-cloud-run-functions target-cloud-run-service target-gke target-workflows
모든 이벤트 소스 source-all source-cloud-storage source-pubsub Eventarc 서비스 에이전트
(service-PROJECT_NUMBER@gcp-sa-eventarc.)
Eventarc 서비스 에이전트
(roles/eventarc.serviceAgent)

thought 프로젝트에 기본적으로 부여됨: 서비스 에이전트가 기본 전송 리소스를 관리하고 이벤트 소스를 검증할 수 있습니다.

Eventarc 리소스를 처음 만들 때 자동으로 부여되지만 이 역할이 삭제된 경우 복원해야 합니다.

모든 이벤트 대상 target-vpc target-cloud-run-functions target-cloud-run-service target-gke target-workflows
모든 이벤트 소스 source-all source-cloud-storage 트리거 서비스 계정 Eventarc 이벤트 수신자
(roles/eventarc.eventReceiver)

프로젝트에 필요: 트리거가 이벤트 제공업체에서 이벤트를 수신할 수 있습니다. Cloud Pub/Sub의 직접 이벤트에는 필요하지 않습니다.

모든 이벤트 대상 target-vpc target-cloud-run-functions target-cloud-run-service target-gke target-workflows
모든 이벤트 소스 source-all source-cloud-storage source-pubsub Cloud Pub/Sub 서비스 에이전트
(service-PROJECT_NUMBER@gcp-sa-pubsub.)
서비스 계정 토큰 생성자
(roles/iam.serviceAccountTokenCreator)

프로젝트에 기본적으로 부여됨(조건부): 서비스 에이전트가 인증된 푸시 요청에 대한 ID 토큰을 만들 수 있습니다.

2021년 4월 8일 이전에 Cloud Pub/Sub 서비스 에이전트를 사용 설정한 경우에만 이 역할을 수동으로 부여해야 합니다.

모든 이벤트 대상 target-vpc target-cloud-run-functions target-cloud-run-service target-gke target-workflows
Cloud Storage 직접 이벤트 source-cloud-storage Cloud Storage 서비스 에이전트
(service-PROJECT_NUMBER@gs-project-accounts.)
Pub/Sub 게시자
(roles/pubsub.publisher)

프로젝트에 필요: 서비스 에이전트가 기본 전송 주제에 버킷 알림을 게시할 수 있습니다.

모든 이벤트 대상 target-vpc target-cloud-run-functions target-cloud-run-service target-gke target-workflows
모든 이벤트 소스 source-all source-cloud-storage source-pubsub 트리거 서비스 계정 Cloud Run 호출자
(roles/run.invoker)

Cloud Run 서비스 또는 프로젝트에 필요(조건부): 트리거가 인증된 Cloud Run 대상 서비스를 호출할 수 있습니다.

Cloud Run target-cloud-run-service
모든 이벤트 소스 source-all source-cloud-storage source-pubsub 함수를 배포하는 주 구성원

배포 방법에 따라 다음 중 하나를 선택합니다.

프로젝트에 필요: 함수를 만들고 업데이트할 수 있습니다. 배포 방법에 따라 다음 중 하나를 부여합니다.

  • gcloud run deploy 또는 Cloud Run Admin API: roles/run.sourceDeveloper 및 roles/serviceusage.serviceUsageConsumer를 부여합니다.
  • gcloud functions deploy 또는 Cloud Functions v2 API: roles/cloudfunctions.developer 또는 roles/cloudfunctions.admin를 부여합니다.
Cloud Run Functions target-cloud-run-functions
모든 이벤트 소스 source-all source-cloud-storage source-pubsub 트리거 서비스 계정 Cloud Run 호출자
(roles/run.invoker)

기본 Cloud Run 서비스 또는 프로젝트에 필요(조건부): 트리거가 인증된 Cloud Run 함수를 호출할 수 있습니다.

Cloud Run Functions target-cloud-run-functions
모든 이벤트 소스 source-all source-cloud-storage source-pubsub Cloud Functions 서비스 에이전트
(service-PROJECT_NUMBER@gcf-admin-robot.)
Cloud Functions 서비스 에이전트
(roles/cloudfunctions.serviceAgent)

프로젝트에 기본적으로 부여됨(조건부): 서비스 에이전트가 Eventarc 트리거 및 기본 Cloud Run 서비스를 만들고 관리할 수 있도록 gcloud functions deploy 또는 Cloud Functions v2 API를 사용하여 함수를 배포할 때 필요합니다. Cloud Functions API를 사용 설정하면 자동으로 부여됩니다.

참고: 이 역할은 지원 중단되었으며 Cloud Functions API를 사용하여 생성된 함수에만 적용됩니다. Cloud Run을 사용하여 만든 함수의 경우 Cloud Run 역할 및 권한 페이지를 참조하세요.

Cloud Run Functions target-cloud-run-functions
모든 이벤트 소스 source-all source-cloud-storage source-pubsub 트리거 서비스 계정 Pub/Sub 구독자
(roles/pubsub.subscriber)

프로젝트에 필요: 트리거가 Pub/Sub에서 메시지를 사용하고 주제에 구독을 연결할 수 있습니다.

GKE target-gke
모든 이벤트 소스 source-all source-cloud-storage source-pubsub 트리거 서비스 계정 모니터링 측정항목 작성자
(roles/monitoring.metricWriter)

프로젝트에 필요: Eventarc의 이벤트 전달자가 Cloud Monitoring 및 측정항목을 제공하는 기타 시스템을 사용하여 측정항목을 작성할 수 있습니다.

GKE target-gke
모든 이벤트 소스 source-all source-cloud-storage source-pubsub Eventarc 서비스 에이전트
(service-PROJECT_NUMBER@gcp-sa-eventarc.)

다음 모두:

프로젝트에 필요: 서비스 에이전트가 이벤트 전달자 구성요소를 만들고 GKE 클러스터에서 리소스를 관리할 수 있습니다. gcloud eventarc gke-destinations init를 실행할 때 바인딩됩니다.

GKE target-gke
모든 이벤트 소스 source-all source-cloud-storage source-pubsub Eventarc 서비스 에이전트
(service-PROJECT_NUMBER@gcp-sa-eventarc.)
DNS 피어
(roles/dns.peer)

VPC 호스트 프로젝트에 필요(조건부): 내부 HTTP 엔드포인트 URI가 Cloud DNS에서 확인할 수 있는 내부 DNS 이름을 사용하는 경우 트리거 프로젝트의 서비스 에이전트가 DNS 피어링 영역을 사용하여 대상 네트워크에 액세스할 수 있도록 허용합니다.

VPC 네트워크의 내부 HTTP 엔드포인트 target-vpc
모든 이벤트 소스 source-all source-cloud-storage source-pubsub 트리거 서비스 계정 Workflows 호출자
(roles/workflows.invoker)

프로젝트에 필요: 트리거가 대상 워크플로 실행을 시작할 수 있습니다.

Workflows target-workflows
모든 이벤트 소스 source-all source-cloud-storage source-pubsub 워크플로 서비스 계정 로그 작성자
(roles/logging.logWriter)

프로젝트에 필요(조건부): 워크플로가 Cloud Logging에 로그를 전송하는 경우 필요합니다.

Workflows target-workflows

다음 단계