使用 Eventarc 建立觸發條件

主控台

1. 使用容器或來源部署 Cloud Run 服務。

2. 前往 Google Cloud 控制台的「Cloud Run」：

   前往 Cloud Run

3. 在服務清單中按一下現有服務。

4. 在「Service details」(服務詳細資料) 頁面中，前往「Triggers」(觸發條件) 分頁。

5. 按一下「新增觸發條件」，然後選取所需選項。

6. 在「Eventarc trigger」窗格中，修改觸發條件詳細資料，如下所示：

   1. 在「Trigger name」(觸發器名稱) 欄位中輸入觸發器名稱，或使用預設名稱。

   2. 從清單中選取「觸發條件類型」，指定下列其中一種觸發條件類型：

      • Google 來源：指定 Pub/Sub、Cloud Storage、Firestore 和其他 Google 事件供應器的觸發事件。

      • 第三方：整合提供 Eventarc 來源的非 Google 供應商。詳情請參閱「Eventarc 中的第三方事件」。

   3. 從「事件供應器」清單中選取事件供應器，即可選取提供觸發服務所需事件類型的產品。如要查看事件提供者清單，請參閱「事件提供者和目的地」。

   4. 從「事件類型」清單中選取事件類型。觸發條件設定會因支援的事件類型而異。詳情請參閱「事件類型」。

   5. 如果已啟用「區域」欄位，請為 Eventarc 觸發條件選取「位置」。一般來說，Eventarc 觸發條件的位置應與您要監控事件的 Google Cloud 資源位置一致。在大多數情況下，您也應在相同的區域中部署服務。如要進一步瞭解 Eventarc 觸發條件的所在位置，請參閱「瞭解 Eventarc 位置」。

   6. 在「服務帳戶」欄位中，選取服務帳戶。Eventarc 觸發事件會連結至服務帳戶，以便在叫用服務時做為身分使用。Eventarc 觸發事件的服務帳戶必須具備叫用服務的權限。根據預設，Cloud Run 會使用 Compute Engine 預設服務帳戶。

   7. 您可以視需要指定要傳送傳入要求的服務網址路徑。這是目的地服務中的相對路徑，應將觸發事件傳送至此路徑。例如：/、/route、route 和 route/subroute。

   8. 填妥必填欄位後，按一下「儲存觸發條件」。

7. 建立觸發條件後，請確認「Triggers」分頁上有勾號 check_circle，以驗證觸發條件的健康狀態。

gcloud

1. 使用容器或來源部署 Cloud Run 服務。

2. 執行下列指令，建立用於篩選事件的觸發條件：

   gcloud eventarc triggers create TRIGGER_NAME  \
       --location=REGION \
       --destination-run-service=SERVICE  \
       --destination-run-region=REGION \
       --event-filters="EVENT_FILTER" \
       --service-account=PROJECT_NUMBER-compute@developer.gserviceaccount.com
   

   取代：

   • TRIGGER_NAME 替換為觸發條件的名稱。

   • EVENTARC_TRIGGER_LOCATION 與 Eventarc 觸發條件的所在位置。一般來說，Eventarc 觸發事件的位置應與您要監控事件的 Google Cloud 資源位置相符。在大多數情況下，您也應在相同的地區部署服務。詳情請參閱「Eventarc 位置」。

   • SERVICE 改為您要部署的服務名稱。

   • REGION 與服務的 Cloud Run 區域。

   • PROJECT_NUMBER 換成您的 Google Cloud 專案編號。Eventarc 觸發事件會連結至服務帳戶，以便在叫用服務時做為身分使用。Eventarc 觸發事件的服務帳戶必須具備叫用服務的權限。根據預設，Cloud Run 會使用預設的 Compute 服務帳戶。

   • event-filters 標記可指定觸發事件監控的事件篩選器。符合所有 event-filters 的事件會觸發對服務的呼叫。每個觸發條件都必須有支援的事件類型。建立後即無法變更事件篩選器類型。如要變更事件篩選器類型，您必須建立新的觸發條件，並刪除舊的觸發條件。您可以選擇在 ATTRIBUTE=VALUE 表單中重複使用支援的篩選器，藉此新增更多篩選器。--event-filters

Terraform

如要為 Cloud Run 服務建立 Eventarc 觸發條件，請參閱「使用 Terraform 建立觸發條件」一文。

主控台

使用 Google Cloud 控制台建立函式時，您也可以為函式新增觸發條件。請按照下列步驟為函式建立觸發條件：

1. 前往 Google Cloud 控制台的 Cloud Run：

   前往 Cloud Run

2. 按一下「編寫函式」，然後輸入函式詳細資料。如要進一步瞭解如何在部署期間設定函式，請參閱「部署函式」。

3. 在「觸發條件」部分中，按一下「新增觸發條件」。

4. 選取所需選項。

5. 在「Eventarc trigger」窗格中，修改觸發條件詳細資料，如下所示：

   1. 在「Trigger name」欄位中輸入觸發事件名稱，或使用預設名稱。

   2. 從清單中選取「觸發條件類型」，指定下列其中一種觸發條件類型：

      • Google 來源：指定 Pub/Sub、Cloud Storage、Firestore 和其他 Google 事件供應器的觸發事件。

      • 第三方：整合提供 Eventarc 來源的非 Google 供應商。詳情請參閱「Eventarc 中的第三方事件」。

   3. 從「事件供應工具」清單中選取事件供應工具，即可選取提供可觸發函式所需事件類型的產品。如要查看事件提供者清單，請參閱「事件提供者和目的地」。

   4. 從「事件類型」清單中選取事件類型。觸發條件設定會因支援的事件類型而異。詳情請參閱「事件類型」。

   5. 如果已啟用「區域」欄位，請為 Eventarc 觸發條件選取「位置」。一般來說，Eventarc 觸發條件的位置應與您要監控事件的 Google Cloud 資源位置一致。在大多數情況下，您也應在相同的地區部署函式。如要進一步瞭解 Eventarc 觸發條件的所在位置，請參閱「瞭解 Eventarc 位置」。

   6. 在「服務帳戶」欄位中，選取服務帳戶。Eventarc 觸發事件會連結至服務帳戶，以便在叫用函式時做為身分使用。Eventarc 觸發事件的服務帳戶必須具備叫用函式的權限。根據預設，Cloud Run 會使用 Compute Engine 預設服務帳戶。

   7. 您可以視需要指定要傳送傳入要求的服務網址路徑。這是目的地服務中的相對路徑，應將觸發事件傳送至此路徑。例如：/、/route、route 和 route/subroute。

6. 填妥必填欄位後，按一下「儲存觸發條件」。

gcloud

使用 gcloud CLI 建立函式時，您必須先部署函式，然後再建立觸發條件。請按照下列步驟為函式建立觸發條件：

1. 在包含程式碼範例的目錄中執行下列指令，即可部署函式：

   gcloud run deploy FUNCTION \
           --source . \
           --function FUNCTION_ENTRYPOINT \
           --base-image BASE_IMAGE_ID \
           --region REGION
   

   取代：

   • FUNCTION 替換為您要部署的函式名稱。您可以將這個參數完全省略，這樣系統會提示您輸入名稱。

   • FUNCTION_ENTRYPOINT 與原始碼中函式的進入點。這是 Cloud Run 在函式執行時執行的程式碼。這個標記的值必須是來源程式碼中存在的函式名稱或完全限定的類別名稱。

   • BASE_IMAGE_ID 與函式的基礎映像檔環境。如要進一步瞭解基礎映像檔和各個映像檔所包含的套件，請參閱「執行階段基礎映像檔」。

   • REGION 與您要部署函式的 Google Cloud 區域。例如：us-central1。

2. 執行下列指令，建立用於篩選事件的觸發條件：

   gcloud eventarc triggers create TRIGGER_NAME  \
       --location=REGION \
       --destination-run-service=FUNCTION  \
       --destination-run-region=REGION \
       --event-filters="EVENT_FILTER" \
       --service-account=PROJECT_NUMBER-compute@developer.gserviceaccount.com
   

   取代：

   • TRIGGER_NAME 替換為觸發條件的名稱。

   • EVENTARC_TRIGGER_LOCATION 與 Eventarc 觸發條件的所在位置。一般來說，Eventarc 觸發事件的位置應與您要監控事件的 Google Cloud 資源位置相符。在大多數情況下，您也應在相同的區域中部署函式。詳情請參閱「Eventarc 位置」。

   • FUNCTION 改為您要部署的函式名稱。

   • REGION 與函式的 Cloud Run 區域。

   • PROJECT_NUMBER 換成您的 Google Cloud 專案編號。Eventarc 觸發事件會連結至服務帳戶，以便在叫用函式時做為身分識別資訊使用。Eventarc 觸發事件的服務帳戶必須具備叫用函式的權限。根據預設，Cloud Run 會使用預設的 Compute 服務帳戶。

   • event-filters 標記可指定觸發事件監控的事件篩選器。符合所有 event-filters 的事件會觸發對函式的呼叫，每個觸發條件都必須有支援的事件類型。建立後即無法變更事件篩選器類型。如要變更事件篩選器類型，您必須建立新的觸發條件，並刪除舊的觸發條件。您可以選擇在 ATTRIBUTE=VALUE 表單中重複使用支援的篩選器，藉此新增更多篩選器。--event-filters

Terraform

如要為 Cloud Run 函式建立 Eventarc 觸發條件，請參閱「使用 Terraform 建立觸發條件」一文。

主控台

部署函式後，請按照下列步驟修改函式的 ack 期限：

1. 前往 Google Cloud 控制台的「Cloud Run」：

   前往 Cloud Run

2. 在「Services」清單中找出要更新的函式，然後按一下即可開啟該函式的詳細資料。

3. 開啟「觸發條件」分頁。

4. 按一下觸發事件名稱，開啟「觸發事件詳細資料」。

5. 按一下「主題」連結，開啟主題編輯窗格。

6. 按一下「Subscription ID」名稱，前往訂閱方塊，然後按一下頁面頂端的「Edit」。

7. 將「確認期限」的值設為 600，然後按一下「更新」，儲存變更。

gcloud

將每個觸發事件的 ack 期限更新為 600 秒的最大值。請注意，下列指令會參照您在上一個步驟中設定的值變數 (TRIGGER_NAME 和 REGION)。

## Per Cloud Run function:

# Update Ack Deadline to max (600s)
SUBSCRIPTION_ID=$(gcloud eventarc triggers describe "$TRIGGER_NAME" --location $REGION --format json | jq -r '.transport.pubsub.subscription')
gcloud pubsub subscriptions update "$SUBSCRIPTION_ID" --ack-deadline=600

針對所有服務和函式觸發事件執行大量更新作業，將其 ack 截止時間設為 600 秒：

### Match all Cloud Run service triggers and update all deadlines to 600s (max timeout)
### This will change ALL Cloud Run Service and Cloud Run function
TRIGGER_NAMES=($(gcloud eventarc triggers list | awk '/Cloud Run service/ {print $1}'))

if [ ${#TRIGGER_NAMES[@]} -eq 0 ]; then
  echo "No matching triggers found"
fi

for trigger in "${TRIGGER_NAMES[@]}"; do
echo "Updating ack deadline for trigger: $trigger"
SUBSCRIPTION_ID=$(gcloud eventarc triggers describe "$trigger" --location $REGION --format json | jq -r '.transport.pubsub.subscription')

if [ -z "$SUBSCRIPTION_ID" ]; then
    echo "Error: Could not retrieve subscription ID for trigger: $trigger"
    continue # Skip to the next trigger
fi
gcloud pubsub subscriptions update "$SUBSCRIPTION_ID" --ack-deadline=600
echo "Ack deadline updated for subscription: $SUBSCRIPTION_ID"
done