管理工作執行作業

本頁說明如何查看及刪除工作執行作業。如要執行、取消或覆寫工作設定，請參閱「執行工作」。

必要的角色

如要取得管理 Cloud Run 作業所需的權限，請要求管理員為您授予 Cloud Run 作業的 Cloud Run 開發人員 (roles/run.developer) 身分與存取權管理角色。

如需與 Cloud Run 相關聯的 IAM 角色和權限清單，請參閱 Cloud Run IAM 角色和 Cloud Run IAM 權限。如果 Cloud Run 作業與Google Cloud API (例如 Cloud 用戶端程式庫) 介接，請參閱服務身分設定指南。 如要進一步瞭解如何授予角色，請參閱部署權限和管理存取權。

查看專案中的工作執行情況

您可以使用Google Cloud 控制台或 Google Cloud CLI，查看專案中的工作執行清單：

控制台

如要查看工作執行作業清單：

  1. 前往 Cloud Run jobs 頁面

  2. 在清單中找出要管理執行作業的工作。

  3. 按一下工作，即可顯示執行作業清單。

  4. 在執行作業詳細資料頁面中，從清單選取您感興趣的執行作業。您可以選擇使用篩選器，設定所需條件，例如將「狀態」設為「已完成」：

gcloud

如要列出專案中所有工作的執行作業：

gcloud run jobs executions list

如要只列出特定工作的執行作業，請執行下列指令：

gcloud run jobs executions list --job JOB_NAME

將 JOB_NAME 替換為要篩選的工作名稱。

如要瞭解其他縮小傳回清單範圍的方法 (包括使用篩選器)，請參閱工作執行清單。

如要取得特定工作的最新執行作業名稱，請使用 --format 標記：

gcloud run jobs describe JOB_NAME --format="value(status.latestCreatedExecution.name)"

將 JOB_NAME 替換為要篩選的工作名稱。

用戶端程式庫

如要透過程式碼列出所有工作執行作業：

REST API

如要列出工作執行作業，請將 GET HTTP 要求傳送至 Cloud Run Admin API jobs 端點。

例如使用 curl：

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions

取代：

  • ACCESS_TOKEN 帳戶的有效存取權權杖，該帳戶必須具備查看工作執行的 IAM 權限。 舉例來說，如果您已登入 gcloud，可以使用 gcloud auth print-access-token 擷取存取權杖。在 Cloud Run 容器執行個體中，您可以使用容器執行個體中繼資料伺服器擷取存取權杖。
  • JOB-NAME 改為工作名稱。
  • 將 REGION 替換為職缺的 Google Cloud 地區。
  • 將 PROJECT-ID 改成 Google Cloud 專案 ID。

查看工作執行作業詳細資料

您可以使用執行作業詳細資料窗格，查看工作最近 1,000 次執行作業的詳細資料。系統會移除舊的執行作業詳細資料，且不再顯示於執行作業詳細資料窗格。不過，舊版執行的記錄和監控資料仍會保留在 Cloud Logging 和 Cloud Monitoring 中，但須遵守這些產品的保留政策。

您可以使用 Google Cloud 控制台或 Google Cloud CLI，查看工作執行的詳細資料。

控制台

如要查看特定工作執行的詳細資料：

  1. 前往 Cloud Run jobs 頁面

  2. 按一下工作，開啟工作詳細資料窗格。

  3. 按一下要查看的工作執行作業。右側面板會顯示執行作業詳細資料。

  4. 請注意「工作」、「容器」、「磁碟區」、「網路」、「安全性」和「YAML」分頁，以及「查看記錄」連結。

    • 「Tasks」會顯示工作執行中的工作相關資訊。
    • YAML 會以 YAML 格式顯示工作設定。
    • 按一下「查看記錄」連結，即可查看與執行作業相關的記錄。
    • 其他分頁會顯示執行作業時使用的作業、容器、安全性、連線等資訊。

gcloud

如要查看工作執行作業的詳細資料：

使用以下指令：

gcloud run jobs executions describe EXECUTION_NAME

將 EXECUTION_NAME 替換為執行作業的名稱。

您可以使用 --format 標記格式化輸出內容，並取得額外資訊。例如，以 YAML 格式表示：

gcloud run jobs executions describe EXECUTION_NAME --format yaml

用戶端程式庫

如要透過程式碼查看工作執行詳細資料，請按照下列步驟操作：

REST API

如要查看工作執行詳細資料，請將 GET HTTP 要求傳送至 Cloud Run Admin API jobs 端點。

例如使用 curl：

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions/EXECUTION-NAME

取代：

  • ACCESS_TOKEN，並提供帳戶的有效存取權杖，該帳戶須具備查看工作執行詳細資料的 IAM 權限。舉例來說，如果您已登入 gcloud，可以使用 gcloud auth print-access-token 擷取存取權杖。在 Cloud Run 容器執行個體中，您可以使用容器執行個體中繼資料伺服器擷取存取權杖。
  • JOB-NAME 改為工作名稱。
  • 將 EXECUTION-NAME 替換為工作執行的名稱。
  • 將 REGION 替換為職缺的 Google Cloud 地區。
  • 將 PROJECT-ID 改成 Google Cloud 專案 ID。

刪除工作執行作業

即使工作正在執行，您也可以刪除工作執行作業。刪除執行作業後，系統會停止執行作業。

雖然已刪除的執行作業不會顯示在執行作業清單中，但記錄仍會保留在 Cloud Logging 中，直到記錄保留期限結束為止，監控資料也會保留在 Cloud Monitoring 中。

控制台

如要刪除工作執行作業：

  1. 前往 Cloud Run jobs 頁面

  2. 按一下工作，開啟工作詳細資料窗格。

  3. 選取要刪除的工作執行個體。

  4. 在「動作」選單下方，按一下省略號圖示，然後點選「刪除」。

  5. 如果系統提示您確認刪除，請按一下「確認」。

gcloud

如要刪除工作執行作業：

  1. 使用以下指令：

    gcloud run jobs executions delete EXECUTION_NAME

    將 EXECUTION_NAME 替換為執行作業的名稱。

  2. 如果系統提示您確認，請回覆 y。成功後，畫面會顯示成功訊息。

用戶端程式庫

如要從程式碼刪除工作執行作業：

REST API

如要刪除工作執行作業，請將 DELETE HTTP 要求傳送至 Cloud Run Admin API jobs 端點

例如使用 curl：

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X DELETE \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions/EXECUTION-NAME

取代：

  • ACCESS_TOKEN，並提供帳戶的有效存取權權杖，該帳戶必須具備刪除工作執行的 IAM 權限。舉例來說，如果您已登入 gcloud，可以使用 gcloud auth print-access-token 擷取存取權杖。在 Cloud Run 容器執行個體中，您可以使用容器執行個體中繼資料伺服器擷取存取權杖。
  • JOB_NAME 改為工作名稱。
  • 將 EXECUTION-NAME 替換為工作執行的名稱。
  • 將 REGION 替換為職缺的 Google Cloud 地區。
  • 將 PROJECT-ID 改成 Google Cloud 專案 ID。