在 Cloud Run 中建構及建立 Shell 工作

編寫範例工作

如要編寫執行殼層指令碼的 Cloud Run 工作，請按照下列步驟操作：

1. 建立名為 jobs 的新目錄，然後切換至該目錄：

   mkdir jobs
   cd jobs
   

2. 建立 Dockerfile 檔案，並加入下列內容：

   
   # Use the official Ubuntu image from Docker Hub as
   # a base image
   FROM ubuntu:24.04
   
   # Execute next commands in the directory /workspace
   WORKDIR /workspace
   
   # Copy over the script to the /workspace directory
   COPY script.sh .
   
   # Just in case the script doesn't have the executable bit set
   RUN chmod +x ./script.sh
   
   # Run the script when starting the container
   CMD [ "./script.sh" ]
   

3. 在同一個目錄中，為實際工作程式碼建立 script.sh 檔案。將下列範例行複製到其中：

   #!/bin/bash
   set -euo pipefail
   
   # In production, consider printing commands as they are executed. 
   # This helps with debugging if things go wrong and you only 
   # have the logs.
   #
   # Add -x:
   # `set -euox pipefail`
   
   CLOUD_RUN_TASK_INDEX=${CLOUD_RUN_TASK_INDEX:=0}
   CLOUD_RUN_TASK_ATTEMPT=${CLOUD_RUN_TASK_ATTEMPT:=0}
   
   echo "Starting Task #${CLOUD_RUN_TASK_INDEX}, Attempt #${CLOUD_RUN_TASK_ATTEMPT}..."
   
   # SLEEP_MS and FAIL_RATE should be a decimal
   # numbers. parse and format the input using 
   # printf. 
   #
   # printf validates the input since it 
   # quits on invalid input, as shown here:
   #
   #   $: printf '%.1f' "abc"
   #   bash: printf: abc: invalid number
   #
   SLEEP_MS=$(printf '%.1f' "${SLEEP_MS:=0}")
   FAIL_RATE=$(printf '%.1f' "${FAIL_RATE:=0}")
   
   # Wait for a specific amount of time to simulate
   # performing some work
   SLEEP_SEC=$(echo print\("${SLEEP_MS}"/1000\) | perl)
   sleep "$SLEEP_SEC" # sleep accepts seconds, not milliseconds
   
   # Fail the task with a likelihood of $FAIL_RATE
   
   # Bash does not do floating point arithmetic. Use perl 
   # to convert into integer and multiply by 100.
   FAIL_RATE_INT=$(echo print\("int(${FAIL_RATE:=0}*100"\)\) | perl)
   
   # Generate a random number between 0 and 100
   RAND=$(( RANDOM % 100))
   if (( RAND < FAIL_RATE_INT )); then 
       echo "Task #${CLOUD_RUN_TASK_INDEX}, Attempt #${CLOUD_RUN_TASK_ATTEMPT} failed."
       exit 1
   else 
       echo "Completed Task #${CLOUD_RUN_TASK_INDEX}."
   fi
   

   Cloud Run 工作可讓使用者指定工作要執行的任務數量。這段程式碼範例說明如何使用內建的 CLOUD_RUN_TASK_INDEX 環境變數。每項任務代表一個執行中的容器副本。請注意，工作通常會並行執行。如果每項工作都能獨立處理資料子集，則適合使用多項工作。

   每項工作都會知道自己的索引，並儲存在 CLOUD_RUN_TASK_INDEX 環境變數中。內建的 CLOUD_RUN_TASK_COUNT 環境變數包含透過 --tasks 參數在工作執行時提供的任務數量。

   程式碼也示範如何使用內建的 CLOUD_RUN_TASK_ATTEMPT 環境變數重試工作，其中包含這項工作重試的次數，第一次嘗試時從 0 開始，每次重試時遞增 1，最多可達 --max-retries。

   您也可以透過程式碼產生失敗，測試重試機制，並產生錯誤記錄，瞭解記錄的樣貌。

程式碼已完成，可以封裝至容器。

建構工作容器、傳送至 Artifact Registry，並部署至 Cloud Run

本快速入門導覽課程會從原始碼部署，建構容器、上傳至 Artifact Registry，並將工作部署至 Cloud Run：

gcloud run jobs deploy job-quickstart \
    --source . \
    --tasks 50 \
    --set-env-vars SLEEP_MS=10000 \
    --set-env-vars FAIL_RATE=0.1 \
    --max-retries 5 \
    --region REGION \
    --project=PROJECT_ID

其中 PROJECT_ID 是專案 ID，REGION 是區域，例如 europe-west1。請注意，您可以根據測試目的，將各種參數變更為任何值。SLEEP_MS 會模擬工作，FAIL_RATE 則會導致 X% 的工作失敗，方便您實驗平行處理及重試失敗的工作。

在 Cloud Run 執行工作

如要執行剛建立的工作，請按照下列步驟操作：

gcloud run jobs execute job-quickstart --region REGION

將 REGION 替換為建立及部署工作時使用的區域，例如 europe-west1。