管理工作執行作業

您可以查看 Cloud Run 工作執行作業的狀態詳細資料,或刪除不必要的執行作業。如要執行、取消或覆寫工作設定,請參閱「執行工作」。

必要的角色

如要取得管理 Cloud Run 工作所需的權限,請要求管理員授予您 Cloud Run 工作的 Cloud Run 開發人員 (roles/run.developer) IAM 角色。

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

查看專案中的工作執行作業

您可以使用Google Cloud 控制台、gcloud CLI、用戶端程式庫或 REST API,查看專案中的工作執行清單:

控制台

如要查看工作的執行作業清單,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Cloud Run jobs」(Cloud Run 工作) 頁面:

    前往「Cloud Run jobs」(Cloud Run 工作)

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

  3. 在執行作業詳細資料頁面中,從清單選取要查看的執行作業。您也可以依條件篩選。

gcloud

  • 如要列出專案中所有工作的執行作業,請執行下列指令:

    gcloud run jobs executions list
  • 如要僅列出特定工作的執行作業,請執行下列指令:

    gcloud run jobs executions list --job JOB

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

    如要瞭解其他縮小傳回清單範圍的方法 (包括使用篩選器),請參閱「jobs executions list」。

  • 如要取得特定工作最新執行作業的名稱,請使用 --format 旗標:

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

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

或者,如要查看最新工作執行作業的詳細資料,請參閱「查看工作執行作業詳細資料」。

用戶端程式庫

如要透過程式碼列出所有工作執行作業,請執行下列操作:

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/executions

更改下列內容:

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

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

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

您可以使用 Google Cloud 控制台、gcloud CLI、用戶端程式庫或 REST API,查看工作執行的詳細資料:

控制台

如要查看特定工作執行作業的詳細資料,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Cloud Run jobs」(Cloud Run 工作) 頁面:

    前往「Cloud Run jobs」(Cloud Run 工作)

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

  3. 按一下要查看的工作執行作業。執行作業詳細資料會顯示在右側面板中。詳情請參閱「Tasks」(工作)、「Containers」(容器)、「Volumes」(磁碟區)、「Networking」(網路)、「Security」(安全性) 和「YAML」分頁。

gcloud

如要查看工作執行的詳細資料,請執行下列指令:

  • 如要描述特定工作執行作業,請執行下列指令:

    gcloud run jobs executions describe EXECUTION_NAME

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

    您可以使用 --format 旗標設定輸出格式,並取得其他資訊。例如 YAML:

    gcloud run jobs executions describe EXECUTION_NAME --format yaml
  • 如要說明工作的最新執行作業,請按照下列步驟操作:

    gcloud run jobs executions describe-latest --job=JOB

    將 JOB 替換為工作名稱。

用戶端程式庫

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

REST API

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

例如,使用 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/executions/EXECUTION_NAME

更改下列內容:

  • ACCESS_TOKEN:帳戶的有效存取權杖,該帳戶必須具備查看工作執行詳細資料的 IAM 權限。舉例來說,如果您已登入 gcloud,可以使用 gcloud auth print-access-token 擷取存取權杖。在 Cloud Run 容器執行個體中,您可以使用容器執行個體中繼資料伺服器擷取存取權杖。
  • PROJECT_ID: Google Cloud 專案 ID。
  • REGION:工作的 Google Cloud 區域。
  • JOB:Cloud Run 工作名稱。
  • EXECUTION_NAME:工作執行作業的名稱。

刪除工作執行作業

您可以在執行期間刪除工作執行作業。如果刪除執行作業,系統會停止執行作業。

雖然已刪除的執行作業不會顯示在執行作業清單中,但其記錄檔在記錄保留期限內仍會保留在 Cloud Logging 中,而監控資料也會保留在 Cloud Monitoring 中。

控制台

如要刪除工作執行作業,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Cloud Run jobs」(Cloud Run 工作) 頁面:

    前往「Cloud Run jobs」(Cloud Run 工作)

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

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

  4. 在「動作」選單下方,依序點選「刪除」和「刪除」。

  5. 如果系統提示您確認刪除,請點選「確認」。

gcloud

如要刪除工作執行作業,請按照下列步驟操作:

  1. 執行下列指令:

    gcloud run jobs executions delete EXECUTION_NAME

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

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

用戶端程式庫

如要透過程式碼刪除工作執行作業,請按照下列步驟操作:

REST API

如要刪除工作執行作業,請向 Cloud Run Admin API jobs 端點傳送 DELETE HTTP 要求。

例如,使用 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/executions/EXECUTION_NAME

更改下列內容:

  • ACCESS_TOKEN:帳戶的有效存取權杖,該帳戶必須具備刪除工作執行的 IAM 權限。舉例來說,如果您已登入 gcloud,可以使用 gcloud auth print-access-token 擷取存取權杖。在 Cloud Run 容器執行個體中,您可以使用容器執行個體中繼資料伺服器擷取存取權杖。
  • PROJECT_ID: Google Cloud 專案 ID。
  • REGION:工作的 Google Cloud 區域。
  • JOB:Cloud Run 工作名稱。
  • EXECUTION_NAME:工作執行作業的名稱。