Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

從 Events for Cloud Run for Anthos 遷移至 Eventarc 的 Pub/Sub 觸發條件

標準

您可以遷移事件觸發條件，讓 Google Kubernetes Engine (GKE) 服務 (包括 Knative 服務) 使用 Eventarc 接收 Pub/Sub 事件。本指南假設您要遷移現有的事件觸發條件，且 GKE 服務是在 GKE 叢集中執行。您必須為每個叢集執行遷移作業。

這個遷移路徑可避免遺失事件，並盡量減少重複事件。

遷移作業包括下列項目：

如要允許 Eventarc 管理 GKE 叢集中的資源，請啟用 GKE 目的地。
如有需要，請為執行目標 GKE 服務的 GKE 叢集啟用 Workload Identity。
找出現有事件觸發條件。
建立 Eventarc 觸發條件，指向與現有觸發條件相同的 GKE 服務。
確認 Eventarc 觸發條件是否如預期傳送事件。
刪除原始事件觸發程序，並在遷移後進行清理。

事前準備

本指南假設您已具備下列條件：

專案 Google Cloud 。
Cloud Billing 帳戶。

設定指令列環境

如要設定 gcloud 和 kubectl 指令列工具，請按照下列步驟操作：

在 Google Cloud 控制台中啟用 Cloud Shell。

啟用 Cloud Shell

Google Cloud 控制台底部會開啟 Cloud Shell 工作階段，並顯示指令列提示。Cloud Shell 是已安裝 Google Cloud CLI 的殼層環境，並已設定適用於您目前專案的值。工作階段可能要幾秒鐘的時間才能初始化。
登入帳戶：
```
gcloud auth login
```
設定 gcloud CLI 的預設設定：
```
gcloud config set project PROJECT_ID
gcloud config set run/cluster CLUSTER_NAME
gcloud config set run/cluster_location CLUSTER_LOCATION
gcloud config set run/platform gke
gcloud config set eventarc/location LOCATION
```
更改下列內容：
- PROJECT_ID：專案 ID
- CLUSTER_NAME：叢集名稱
- CLUSTER_LOCATION：GKE 支援的任何區域，例如：us-central1-a。
- LOCATION：Eventarc 觸發條件的位置，例如：us-central1。

為專案啟用下列 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

安裝 kubectl 指令列工具：
```
gcloud components install kubectl
```
更新已安裝的 gcloud CLI 元件：
```
gcloud components update
```

啟用 GKE 目的地

如要允許 Eventarc 管理 GKE 叢集中的資源，請啟用 GKE 目的地，並將 Eventarc 服務帳戶繫結至必要角色。

為 Eventarc 啟用 GKE 目的地：
```
gcloud eventarc gke-destinations init
```
系統提示繫結必要角色時，請輸入 y。

已繫結下列角色：
- roles/compute.viewer
- roles/container.developer
- roles/iam.serviceAccountAdmin

在叢集上啟用 Workload Identity Federation for GKE

如果叢集已啟用 Workload Identity Federation for GKE，可以略過這個步驟。

建議您使用 Workload Identity Federation for GKE，從 GKE 中執行的應用程式存取 Google Cloud 服務，因為這項功能可提高安全性，且更易於管理。使用 Eventarc 轉送 GKE 事件時，也需要這項功能。

如要在現有叢集上啟用 Workload Identity Federation for GKE，請參閱「使用 Workload Identity」。

找出現有事件觸發條件

遷移現有事件觸發條件前，請先擷取觸發條件詳細資料。

列出 GKE 叢集的現有事件觸發條件：

gcloud beta events triggers list --namespace EVENTS_NAMESPACE

將 EVENTS_NAMESPACE 替換為事件代理程式的命名空間。

輸出結果會與下列內容相似：

   TRIGGER             EVENT TYPE                                     TARGET
✔  trigger-id          google.cloud.pubsub.topic.v1.messagePublished  cloud-run-service-name

您需要主題 ID 才能建立 Eventarc 觸發條件。擷取現有事件觸發條件的主題 ID：

gcloud beta events triggers describe TRIGGER_ID \
  --platform gke --namespace EVENTS_NAMESPACE \
  --format="flattened(serialized_source.spec.topic,serialized_trigger.spec.filter.attributes.type,serialized_trigger.spec.subscriber.ref.name,serialized_trigger.spec.subscriber.ref.namespace)"

將 TRIGGER_ID 替換為現有事件觸發條件的 ID 或完整 ID。

輸出結果會與下列內容相似：

topic:     topic-id
type:      google.cloud.pubsub.topic.v1.messagePublished
name:      cloud-run-service-name
namespace: events

建立 Eventarc 觸發條件來取代現有觸發條件

建立 Eventarc 觸發條件前，請先設定使用者管理的服務帳戶，並授予特定角色，讓 Eventarc 管理 GKE 目的地的事件。

建立 Google Cloud 服務帳戶 (GSA)：
```
TRIGGER_GSA=SERVICE_ACCOUNT_NAME
gcloud iam service-accounts create $TRIGGER_GSA
```
將 SERVICE_ACCOUNT_NAME 替換為長度介於 6 至 30 個字元的名稱。可使用小寫英數字元和破折號。

將 pubsub.subscriber 和 monitoring.metricWriter 角色指派給服務帳戶：

PROJECT_ID=$(gcloud config get-value project)

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"

根據現有事件觸發條件的設定，建立新的 Eventarc 觸發條件。所有引數 (包括目的地服務、叢集和主題 ID) 都應與現有事件觸發條件的引數相符。

gcloud eventarc triggers create EVENTARC_TRIGGER_NAME \
  --event-filters="type=google.cloud.pubsub.topic.v1.messagePublished" \
  --location LOCATION \
  --destination-gke-service=DESTINATION_SERVICE \
  --destination-gke-cluster=CLUSTER_NAME  \
  --destination-gke-location=CLUSTER_LOCATION  \
  --destination-gke-namespace=EVENTS_NAMESPACE  \
  --destination-gke-path=/ \
  --service-account=$TRIGGER_GSA@$PROJECT_ID.iam.gserviceaccount.com \
  --transport-topic=projects/PROJECT_ID/topics/TOPIC_ID

將 EVENTARC_TRIGGER_NAME 替換為新的 Eventarc 觸發程序名稱，並將 TOPIC_ID 替換為先前擷取的 Pub/Sub 主題 ID。

這會為 Pub/Sub 主題 ID 建立 Eventarc 觸發條件。

確認觸發條件是否已成功建立：

gcloud eventarc triggers list

輸出結果會與下列內容相似：

NAME                  TYPE                                           DESTINATION_RUN_SERVICE  DESTINATION_RUN_PATH  ACTIVE
eventarc-trigger-name google.cloud.pubsub.topic.v1.messagePublished                                                 Yes

測試遷移作業並驗證輸出內容

如要測試遷移作業，請發布至 Pub/Sub 主題來觸發測試事件，然後確認每個現有事件觸發條件和 Eventarc 觸發條件，分別至少傳送一個事件。

舉例來說，觸發測試事件後，輸出內容會重複，類似如下：

  Hello, World! ID: 2896291125947199
  Hello, World! ID: 2896291125947199

您也可以參考下列情境，瞭解事件接收器如何顯示事件資料：

將訊息發布至 Pub/Sub 主題：

gcloud pubsub topics publish TOPIC_ID \
  --message "Hello, World!"

確認事件和是否成功傳送。舉例來說，查看接收 GKE 服務的記錄：

kubectl logs \
  --selector serving.knative.dev/service=DESTINATION_SERVICE \
  -c user-container \
  -n EVENTS_NAMESPACE \
  --tail=100

這兩個觸發程序的輸出內容大致如下，只有 Context Attributes 和 Extensions 不同。實際訊息資料 (subscription 資料除外) 應完全相同，這樣在遷移至 Eventarc 後，就不必變更任何事件接收器。

Eventarc 事件：

☁️  cloudevents.Event
Validation: valid
Context Attributes,
  specversion: 1.0
  type: google.cloud.pubsub.topic.v1.messagePublished
  source: //pubsub.googleapis.com/projects/project-id/topics/topic-name
  id: 2759155988927083
  time: 2021-07-22T17:47:19.964Z
  datacontenttype: application/json
Data,
  {
    "subscription": "projects/project-id/subscriptions/eventarc-us-central1-eventarc-trigger-name-sub-567",
    "message": {
      "data": "V29ybGQ=",
      "messageId": "2759155988927083",
      "publishTime": "2021-07-22T17:47:19.964Z"
    }
  }

Knative serving 事件：

☁️  cloudevents.Event
Validation: valid
Context Attributes,
  specversion: 1.0
  type: google.cloud.pubsub.topic.v1.messagePublished
  source: //pubsub.googleapis.com/projects/project-id/topics/topic-name
  id: 2759155988927083
  time: 2021-07-22T17:47:19.964Z
  dataschema: https://raw.githubusercontent.com/googleapis/google-cloudevents/master/proto/google/events/cloud/pubsub/v1/data.proto
  datacontenttype: application/json
Extensions,
  knativearrivaltime: 2021-07-22T17:47:20.723302362Z
  knsourcetrigger: link0.09767362059083662
  traceparent: 00-f3cc6d754d361a0e49e83e5973fa3565-b4a20ef4ecffe96b-00
Data,
  {
    "subscription": "cre-src_events_source-for-trigger-name_5ffa9638-8cab-4010-900a-2edb275d9eaf",
    "message": {
      "messageId": "2759155988927083",
      "data": "V29ybGQ=",
      "publishTime": "2021-07-22T17:47:19.964Z"
    }
  }

遷移後清理

測試並確認觸發條件已移轉至 Eventarc 後，即可刪除原始事件觸發條件。

刪除原始事件觸發條件：

gcloud beta events triggers delete TRIGGER_NAME \
  --platform gke \
  --namespace EVENTS_NAMESPACE \
  --quiet

您已將現有的 Knative serving 觸發條件遷移至 Eventarc。

從 Events for Cloud Run for Anthos 遷移至 Eventarc 的 Pub/Sub 觸發條件 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

事前準備

設定指令列環境

啟用 GKE 目的地

在叢集上啟用 Workload Identity Federation for GKE

找出現有事件觸發條件

建立 Eventarc 觸發條件來取代現有觸發條件

測試遷移作業並驗證輸出內容

遷移後清理

後續步驟

從 Events for Cloud Run for Anthos 遷移至 Eventarc 的 Pub/Sub 觸發條件