使用 Eventarc 接收 Cloud Storage 事件

本教學課程將說明如何使用經過驗證的 Cloud Run 服務 (可透過 Eventarc 接收事件) 部署容器化應用程式。

指定 Eventarc 觸發條件的篩選器後，您就能設定事件的路由，包括事件來源和事件目標。在這種情況下，Cloud Storage 值區的更新會觸發事件，並以 HTTP 要求的形式將要求傳送至 Cloud Run 服務。

目標

在這個教學課程中，您將執行下列操作：

1. 建立 Cloud Storage bucket 做為事件來源。

2. 將事件接收器服務部署至需要驗證呼叫的 Cloud Run。

3. 建立 Eventarc 觸發條件，將 Cloud Storage 值區中的事件轉送至 Cloud Run 服務。

4. 將檔案上傳至 Cloud Storage 值區以產生事件，並在 Cloud Run 記錄檔中查看該事件。

費用

在本文件中，您會使用 Google Cloud的下列計費元件：

• Artifact Registry
• Cloud Build
• Cloud Run
• Cloud Storage
• Eventarc

您可以使用 Pricing Calculator 根據預測用量產生預估費用。 新 Google Cloud 使用者可能符合申請免費試用的資格。

事前準備

貴機構定義的安全性限制，可能會導致您無法完成下列步驟。如需疑難排解資訊，請參閱「在受限的 Google Cloud 環境中開發應用程式」。

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. Install the Google Cloud CLI.

3. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

4. To initialize the gcloud CLI, run the following command:

   gcloud init

5. Create or select a Google Cloud project.

   • Create a Google Cloud project:

     gcloud projects create PROJECT_ID

     Replace PROJECT_ID with a name for the Google Cloud project you are creating.

   • Select the Google Cloud project that you created:

     gcloud config set project PROJECT_ID

     Replace PROJECT_ID with your Google Cloud project name.

6. Make sure that billing is enabled for your Google Cloud project.

7. Install the Google Cloud CLI.

8. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

9. To initialize the gcloud CLI, run the following command:

   gcloud init

10. Create or select a Google Cloud project.

    • Create a Google Cloud project:

      gcloud projects create PROJECT_ID

      Replace PROJECT_ID with a name for the Google Cloud project you are creating.

    • Select the Google Cloud project that you created:

      gcloud config set project PROJECT_ID

      Replace PROJECT_ID with your Google Cloud project name.

11. Make sure that billing is enabled for your Google Cloud project.

12. 如果您未使用 Cloud Shell，請更新 Google Cloud CLI 元件，並使用您的帳戶登入：

    gcloud components update
    gcloud auth login

13. 啟用 API：

    gcloud services enable artifactregistry.googleapis.com \
        cloudbuild.googleapis.com \
        eventarc.googleapis.com \
        run.googleapis.com \
        storage.googleapis.com

14. 設定本教學課程中使用的設定變數：

    export REGION=us-central1
    gcloud config set run/region ${REGION}
    gcloud config set run/platform managed
    gcloud config set eventarc/location ${REGION}

15. 您或管理員必須將下列 IAM 角色授予部署者帳戶、觸發條件身分，以及 Pub/Sub 服務代理程式 (選用)。

    部署者帳戶的必要角色

    1. 如果您是專案建立者，系統會授予您基本擁有者角色 (roles/owner)。根據預設，這個身分與存取權管理 (IAM) 角色會包含完整存取大多數 Google Cloud資源所需的權限，因此您可以略過這個步驟。

       如果您不是專案建立者，則必須將必要權限授予專案中的適當實體。舉例來說，主體可以是 Google 帳戶 (適用於使用者)，也可以是服務帳戶 (適用於應用程式和運算工作負載)。詳情請參閱活動目的地的角色和權限頁面。

       如要取得完成本教學課程所需的權限，請要求管理員為您授予專案的下列 IAM 角色：

       • Cloud Build 編輯器 (roles/cloudbuild.builds.editor)
       • Cloud Run 管理員 (roles/run.admin)
       • Cloud Run 來源開發人員 (roles/run.sourceDeveloper)
       • Eventarc 管理員 (roles/eventarc.admin)
       • 記錄檔檢視存取者 (roles/logging.viewAccessor)
       • 專案 IAM 管理員 (roles/resourcemanager.projectIamAdmin)
       • 服務帳戶管理員 (roles/iam.serviceAccountAdmin)
       • 服務帳戶使用者 (roles/iam.serviceAccountUser)
       • 服務使用情形管理員 (roles/serviceusage.serviceUsageAdmin)
       • 儲存空間管理員 (roles/storage.admin)

       如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

       您或許還可透過自訂角色或其他預先定義的角色取得必要權限。

       請注意，根據預設，Cloud Build 權限包含上傳及下載 Artifact Registry 構件的權限。

    觸發條件身分的必要角色

    1. 請記下 Compute Engine 預設服務帳戶，因為您會將其附加至 Eventarc 觸發事件，以便代表觸發事件的身分，用於測試用途。啟用或使用使用 Compute Engine 的 Google Cloud 服務後，系統會自動建立這個服務帳戶，且電子郵件格式如下：

       PROJECT_NUMBER-compute@developer.gserviceaccount.com

       將 PROJECT_NUMBER 替換為您的 Google Cloud專案編號。您可以在 Google Cloud 控制台的「歡迎」頁面上找到專案編號，也可以執行下列指令：

       gcloud projects describe PROJECT_ID --format='value(projectNumber)'

       對於實際環境，我們強烈建議建立新的服務帳戶，並授予一或多個包含必要最低權限的 IAM 角色，並遵循最低權限原則。

    2. 根據預設，只有專案擁有者、專案編輯者，以及 Cloud Run 管理員和叫用者可以叫用 Cloud Run 服務。您可以依服務控制存取權，但為了測試，請將 Google Cloud 專案的 Cloud Run 叫用者角色 (run.invoker) 授予 Compute Engine 服務帳戶。這樣一來，系統就會為專案中的所有 Cloud Run 服務和工作授予這個角色。

       gcloud projects add-iam-policy-binding PROJECT_ID \
           --member=serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com \
           --role=roles/run.invoker

       請注意，如果您為經過驗證的 Cloud Run 服務建立觸發條件，但未授予 Cloud Run 叫用者角色，系統會成功建立觸發條件並啟用。不過，觸發條件無法正常運作，而且記錄中會顯示類似以下的訊息：

       The request was not authenticated. Either allow unauthenticated invocations or set the proper Authorization header.
    3. 將專案的 Eventarc 事件接收者角色 (roles/eventarc.eventReceiver) 授予 Compute Engine 預設服務帳戶，以便 Eventarc 觸發條件接收事件供應商的事件。

       gcloud projects add-iam-policy-binding PROJECT_ID \
           --member=serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com \
           --role=roles/eventarc.eventReceiver

    Pub/Sub 服務代理人的選用角色

    • 如果您是在 2021 年 4 月 8 日當天或之前啟用 Cloud Pub/Sub 服務代理，以便支援經過驗證的 Pub/Sub 推送要求，請將 服務帳戶權杖建立者角色 (roles/iam.serviceAccountTokenCreator) 授予服務代理。否則，系統會預設授予這個角色：

      gcloud projects add-iam-policy-binding PROJECT_ID \
          --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-pubsub.iam.gserviceaccount.com \
          --role=roles/iam.serviceAccountTokenCreator

清除所用資源

如果您是為了這個教學課程建立新專案，請刪除專案。如果您使用現有的專案，且想保留該專案而不採用本教學課程中新增的變更，請刪除為教學課程建立的資源。

刪除專案

如要避免付費，最簡單的方法就是刪除您為了本教學課程所建立的專案。

如要刪除專案：

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

刪除教學課程資源

1. 刪除您在本教學課程中部署的 Cloud Run 服務：

   gcloud run services delete SERVICE_NAME

   其中 SERVICE_NAME 是您選擇的服務名稱。

   您也可以從 Google Cloud 控制台刪除 Cloud Run 服務。

2. 移除您在教學課程設定期間新增的所有 gcloud CLI 預設設定。

   例如：

   gcloud config unset run/region

   或

   gcloud config unset project

3. 刪除本教學課程中建立的其他 Google Cloud 資源：

   • 刪除 Eventarc 觸發條件：

     gcloud eventarc triggers delete TRIGGER_NAME
     

     請將 TRIGGER_NAME 替換為觸發條件名稱。
   • 刪除容器映像檔

後續步驟

• 為其他事件類型建立 Eventarc 觸發條件
• 建構容器
• 開發 Cloud Run 服務