指定工作適用的 VM OS 映像檔

gcloud

1. 建立 JSON 檔案，指定作業的設定詳細資料。如要為工作指定 VM OS 映像檔，請加入 image 欄位。

   舉例來說，如要建立使用特定 VM OS 映像檔的基本指令碼工作，請建立內容如下的 JSON 檔案：

   {
       "taskGroups": [
           {
               "taskSpec": {
                   "runnables": [
                       {
                           "script": {
                               "text": "echo Hello world from task ${BATCH_TASK_INDEX}."
                           }
                       }
                   ]
               },
               "taskCount": 3,
               "parallelism": 1
           }
       ],
       "allocationPolicy": {
         "instances": [
           {
             "policy": {
               "bootDisk": {
                 "image": "VM_OS_IMAGE_URI"
               }
             }
           }
         ]
       },
       "logsPolicy": {
       "destination": "CLOUD_LOGGING"
     }
   }
   

   將 VM_OS_IMAGE_URI 替換為 VM OS 映像檔的相對資源名稱。請使用下列其中一種方式：

   • 指定批次作業系統前置字串。如要使用特定 Batch OS 的最新映像檔，請採用下列格式：

     BATCH_OS_PREFIX
     

     將 BATCH_OS_PREFIX 替換為其中一個 Batch VM OS 映像檔前置字串，例如 batch-debian 是 Batch Debian OS 的前置字串。

   • 指定映像檔系列。如要使用特定映像檔系列的最新映像檔，請使用下列格式：

     projects/IMAGE_PROJECT_ID/global/images/family/IMAGE_FAMILY
     

     更改下列內容：

     • IMAGE_PROJECT_ID：包含圖片的專案專案 ID。舉例來說，如要指定所有 Batch 映像檔，請輸入 batch-custom-image。
     • IMAGE_FAMILY：映像檔系列，包含一或多個特定映像檔，代表作業系統的類型和主要版本。舉例來說，如要查看 Batch 的所有 VM OS 映像檔系列，請查看 VM OS 映像檔清單。

   • 指定映像檔版本。如要使用特定版本的 VM OS 映像檔，請採用下列格式：

     projects/IMAGE_PROJECT_ID/global/images/IMAGE_NAME
     

     更改下列內容：

     • IMAGE_PROJECT_ID：包含圖片的專案專案 ID。舉例來說，如要指定所有 Batch 映像檔，請輸入 batch-custom-image。
     • IMAGE_NAME：映像檔名稱，代表特定版本的 VM OS 映像檔。舉例來說，如要查看 Batch 的所有 VM OS 映像檔版本，請查看 VM OS 映像檔清單。

2. 如要建立工作，請執行下列 gcloud batch jobs submit 指令：

   gcloud batch jobs submit JOB_NAME \
       --location LOCATION \
       --config JSON_CONFIGURATION_FILE
   

   更改下列內容：

   • JOB_NAME：這項工作的名稱。
   • LOCATION：這項工作的地點。
   • JSON_CONFIGURATION_FILE：JSON 檔案的路徑，內含作業的設定詳細資料。

API

如要使用 Batch API 建立工作，請使用 jobs.create 方法，並指定工作設定詳細資料。如要為工作指定 VM OS 映像檔，請加入 image 欄位。舉例來說，如要建立使用特定 VM OS 映像檔的基本指令碼工作，請發出下列 POST 要求：

POST https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs?job_id=JOB_NAME

{
    "taskGroups": [
        {
            "taskSpec": {
                "runnables": [
                    {
                        "script": {
                            "text": "echo Hello world from task ${BATCH_TASK_INDEX}."
                        }
                    }
                ]
            },
            "taskCount": 3,
            "parallelism": 1
        }
    ],
    "allocationPolicy": {
      "instances": [
        {
          "policy": {
            "bootDisk": {
              "image": "VM_OS_IMAGE_URI"
            }
          }
        }
      ]
    },
    "logsPolicy": {
    "destination": "CLOUD_LOGGING"
  }
}

更改下列內容：

• PROJECT_ID：專案的專案 ID。
• LOCATION：這份工作的地點。
• JOB_NAME：這項工作的名稱。

• VM_OS_IMAGE_URI：VM OS 映像檔的相對資源名稱。請使用下列其中一種方式：

  • 指定批次作業系統前置字串。如要使用特定 Batch OS 的最新映像檔，請採用下列格式：

  BATCH_OS_PREFIX
  

  將 BATCH_OS_PREFIX 替換為其中一個 Batch VM OS 映像檔前置字串，例如 batch-debian 是 Batch Debian OS 的前置字串。

  • 指定映像檔系列。如要使用特定映像檔系列的最新映像檔，請使用下列格式：

    projects/IMAGE_PROJECT_ID/global/images/family/IMAGE_FAMILY
    

    更改下列內容：

    • IMAGE_PROJECT_ID：包含圖片的專案專案 ID。舉例來說，如要指定所有 Batch 映像檔，請輸入 batch-custom-image。
    • IMAGE_FAMILY：映像檔系列，包含一或多個特定映像檔，代表作業系統的類型和主要版本。舉例來說，如要查看 Batch 的所有 VM OS 映像檔系列，請查看 VM OS 映像檔清單。

  • 指定映像檔版本。如要使用特定版本的 VM OS 映像檔，請採用下列格式：

    projects/IMAGE_PROJECT_ID/global/images/IMAGE_NAME
    

    更改下列內容：

    • IMAGE_PROJECT_ID：包含圖片的專案專案 ID。舉例來說，如要指定所有 Batch 映像檔，請輸入 batch-custom-image。
    • IMAGE_NAME：映像檔名稱，代表特定版本的 VM OS 映像檔。舉例來說，如要查看 Batch 的所有 VM OS 映像檔版本，請查看 VM OS 映像檔清單。