빠른 시작: Pub/Sub 메시지를 사용하여 이벤트 수신(Google Cloud CLI)

Pub/Sub 메시지를 사용하여 이벤트 수신(gcloud CLI)

이 빠른 시작에서는 Eventarc를 사용하여 Pub/Sub 주제에서 이벤트를 수신하기 위한 대상으로 Google Kubernetes Engine(GKE) 서비스를 설정하는 방법을 보여줍니다.

이 빠른 시작에서는 다음을 수행합니다.

GKE 클러스터 만들기
대상으로 이벤트를 전달하는 이벤트 전달자 구성요소를 사용하여 Pub/Sub에서 이벤트를 가져오도록 서비스 계정을 설정합니다.
Eventarc에서 GKE 대상을 초기화합니다.
이벤트를 수신하는 GKE 서비스를 배포합니다.
Pub/Sub 주제를 GKE 서비스에 연결하는 Eventarc 트리거를 만듭니다.
Pub/Sub 이벤트를 생성하고 확인합니다.

시작하기 전에

Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

프로젝트 선택기로 이동

Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다. 프로젝트에 결제가 사용 설정되어 있는지 확인하는 방법을 알아보세요.

Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

프로젝트 선택기로 이동

Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다. 프로젝트에 결제가 사용 설정되어 있는지 확인하는 방법을 알아보세요.

Google Cloud CLI를 설치하고 초기화합니다. 기본 컴퓨팅 리전을 구성하라는 메시지가 표시되면 n을 입력합니다.

gcloud 구성요소를 업데이트합니다.
```
gcloud components update
```

Google Cloud, Cloud Build, Resource Manager, Google Kubernetes Engine API, Container Registry, Eventarc API를 사용 설정합니다.

gcloud services enable cloudapis.googleapis.com
gcloud services enable cloudbuild.googleapis.com
gcloud services enable cloudresourcemanager.googleapis.com
gcloud services enable container.googleapis.com
gcloud services enable containerregistry.googleapis.com
gcloud services enable eventarc.googleapis.com

이 빠른 시작에서 사용되는 구성 변수를 설정합니다.

gcloud config set project PROJECT_ID
gcloud config set run/cluster events-cluster
gcloud config set run/cluster_location us-central1
gcloud config set run/platform gke
gcloud config set eventarc/location us-central1

PROJECT_ID를 Google Cloud 프로젝트 ID로 바꿉니다.

선택사항: 다음을 입력하여 gcloud_name을 사용해 구성 설정을 확인할 수 있습니다.
```
gcloud config list
```
출력은 다음과 비슷하게 표시됩니다.
```
[eventarc]
location = us-central1
[run]
cluster = events-cluster
cluster_location = us-central1
platform = gke
```

GKE 클러스터 만들기

HttpLoadBalancing 부가기능으로 GKE 클러스터를 만듭니다. GKE 내에서 실행되는 애플리케이션에서 Google Cloud 서비스에 액세스하려면 워크로드 아이덴티티를 사용 설정합니다.

PROJECT_ID=$(gcloud config get-value project)

gcloud beta container clusters create events-cluster \
  --addons=HttpLoadBalancing \
  --machine-type=n1-standard-4 \
  --enable-autoscaling --min-nodes=2 --max-nodes=10 \
  --no-issue-client-certificate --num-nodes=2  \
  --logging=SYSTEM,WORKLOAD \
  --monitoring=SYSTEM \
  --scopes=cloud-platform,logging-write,monitoring-write,pubsub \
  --zone us-central1 \
  --release-channel=rapid \
  --workload-pool=$PROJECT_ID.svc.id.goog

클러스터 만들기가 완료될 때까지 기다립니다. 만드는 과정에서 표시되는 경고는 무시해도 됩니다. 클러스터가 만들어지면 다음과 유사한 출력이 표시됩니다.

Creating cluster events-cluster...done.
Created [https://container.googleapis.com/v1beta1/projects/my-project/zones/us-central1/clusters/events-cluster].

여기서 my-project는 Google Cloud 프로젝트 ID입니다.

그러면 my-project에 events-cluster라는 GKE 클러스터가 생성됩니다.

Google 서비스 계정 설정

사용자 제공 서비스 계정을 설정하고 이벤트 전달자 구성요소가 Pub/Sub에서 이벤트를 가져올 수 있도록 특정 역할을 부여합니다.

트리거를 만드는 데 사용되는 TRIGGER_GSA라는 서비스 계정을 만듭니다.
```
TRIGGER_GSA=eventarc-gke-triggers
gcloud iam service-accounts create $TRIGGER_GSA
```

서비스 계정에 pubsub.subscriber 및 monitoring.metricWriter 역할을 부여합니다.

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member "serviceAccount:$TRIGGER_GSA@$PROJECT_ID.iam.gserviceaccount.com" \
  --role "roles/pubsub.subscriber"

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member "serviceAccount:$TRIGGER_GSA@$PROJECT_ID.iam.gserviceaccount.com" \
  --role "roles/monitoring.metricWriter"

GKE 대상 사용 설정

Eventarc는 GKE 서비스를 타겟팅하는 트리거별로 Pub/Sub에서 이벤트를 가져와 대상으로 전달하는 이벤트 전달자 구성요소를 만듭니다. GKE 클러스터에서 구성요소를 만들고 리소스를 관리하려면 Eventarc 서비스 계정에 권한을 부여합니다.

Eventarc에 GKE 대상을 사용 설정합니다.
```
gcloud eventarc gke-destinations init
```
필요한 역할을 결합하라는 메시지가 표시되면 y를 입력합니다.

다음 역할이 서비스 계정에 결합됩니다.
- compute.viewer
- container.developer
- iam.serviceAccountAdmin

GKE 서비스 대상 만들기

사전 빌드된 이미지 gcr.io/cloudrun/hello를 사용하여 이벤트를 수신하고 로깅하는 GKE 서비스를 배포합니다.

Kubernetes 배포를 만듭니다.

SERVICE_NAME=hello-gke
kubectl create deployment $SERVICE_NAME \
--image=gcr.io/cloudrun/hello

Kubernetes 서비스로 노출합니다.

kubectl expose deployment $SERVICE_NAME \
--type LoadBalancer --port 80 --target-port 8080

Pub/Sub 트리거 만들기

메시지가 Pub/Sub 주제에 게시되면 Eventarc 트리거가 hello-gke GKE 서비스로 메시지를 전송합니다.

Pub/Sub 메시지를 리슨하는 GKE 트리거를 만듭니다.

새 Pub/Sub 주제

gcloud eventarc triggers create gke-trigger-pubsub \
  --destination-gke-cluster=events-cluster \
  --destination-gke-location=us-central1 \
  --destination-gke-namespace=default \
  --destination-gke-service=hello-gke \
  --destination-gke-path=/ \
  --event-filters="type=google.cloud.pubsub.topic.v1.messagePublished" \
  --service-account=$TRIGGER_GSA@$PROJECT_ID.iam.gserviceaccount.com

이렇게 하면 새 Pub/Sub 주제와 gke-trigger-pubsub라는 트리거가 생성됩니다.

기존 Pub/Sub 주제

gcloud eventarc triggers create gke-trigger-pubsub \
  --destination-gke-cluster=events-cluster \
  --destination-gke-location=us-central1 \
  --destination-gke-namespace=default \
  --destination-gke-service=hello-gke \
  --destination-gke-path=/ \
  --event-filters="type=google.cloud.pubsub.topic.v1.messagePublished" \
  --service-account=$TRIGGER_GSA@$PROJECT_ID.iam.gserviceaccount.com \
  --transport-topic=projects/PROJECT_ID/topics/TOPIC_ID

다음을 바꿉니다.

PROJECT_ID는 Google Cloud 프로젝트 ID입니다.
TOPIC_ID는 기존 Pub/Sub 주제의 ID입니다. 기존 Pub/Sub 주제에 대한 gke-trigger-pubsub라는 이름의 트리거를 만듭니다.

트리거가 성공적으로 생성되었는지 확인하세요.

gcloud eventarc triggers list

출력은 다음과 비슷하게 표시됩니다.

NAME: gke-trigger-pubsub
TYPE: google.cloud.pubsub.topic.v1.messagePublished
DESTINATION: GKE: hello-gke
ACTIVE: Yes

이벤트 생성 및 확인

Pub/Sub 주제에 메시지를 게시하여 GKE 서비스를 트리거하는 이벤트를 생성할 수 있습니다. 그런 다음 pod 로그에서 메시지를 볼 수 있습니다.

Pub/Sub 주제를 환경 변수로 찾아서 설정합니다.

TOPIC=$(gcloud eventarc triggers describe gke-trigger-pubsub --format='value(transport.pubsub.topic)')

Pub/Sub 주제에 메시지를 보내 이벤트를 생성합니다.
```
gcloud pubsub topics publish $TOPIC --message="Hello World"
```
GKE 서비스는 이벤트의 메시지를 로깅합니다.

이벤트 메시지를 보려면 다음 안내를 따르세요.

Pod ID를 찾습니다.

kubectl get pods

출력은 다음과 비슷하게 표시됩니다.

NAME                                         READY   STATUS             RESTARTS   AGE
hello-gke-645964f578-2mjjt                   1/1     Running            0          35s

여기서 NAME은 포드 이름입니다. 다음 단계에서 사용할 NAME를 복사합니다.

Pod의 로그를 확인합니다.
```
kubectl logs NAME
```
NAME을 복사한 포드의 이름으로 바꿉니다.

다음과 같은 로그 항목을 찾습니다.

2022/02/24 22:23:49 Hello from Cloud Run! The container started successfully and is listening for HTTP requests on $PORT
{"severity":"INFO","eventType":"google.cloud.pubsub.topic.v1.messagePublished","message":"Received event of type google.cloud.pubsub.topic.v1.messagePublished. Event data: Hello World"[...]}

삭제

Cloud Run에서는 서비스를 사용하지 않을 때 비용이 청구되지 않지만 Container Registry에 컨테이너 이미지를 저장하는 것이나 Eventarc 리소스, Pub/Sub 메시지, GKE 클러스터에 대해 요금이 부과될 수 있습니다.

이미지 삭제, Pub/Sub 주제 삭제, Pub/Sub 구독 삭제, GKE 클러스터를 삭제를 수행할 수 있습니다.

Eventarc 트리거를 삭제하려면 다음 안내를 따르세요.

gcloud eventarc triggers delete gke-trigger-pubsub

또는 Google Cloud 프로젝트를 삭제하여 비용 청구를 방지할 수 있습니다. 클라우드 프로젝트를 삭제하면 해당 프로젝트 내에서 사용되는 모든 리소스에 대한 청구가 중단됩니다.

gcloud projects delete PROJECT_ID_OR_NUMBER

PROJECT_ID_OR_NUMBER를 프로젝트 ID 또는 번호로 바꿉니다.

다음 단계

Cloud 감사 로그를 사용하여 이벤트 수신(Google Cloud CLI)