本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 截止日期雲端的開啟任務描述 (OpenJD) 範本
<a name="build-job-bundle"></a>

*任務套件*是您用來定義 AWS 截止日期雲端任務的工具之一。它們將[開放任務描述 (OpenJD)](https://github.com/OpenJobDescription/openjd-specifications) 範本分組，其中包含其他資訊，例如任務與任務附件搭配使用的檔案和目錄。您可以使用截止日期雲端命令列界面 (CLI) 來使用任務套件提交任務，以便佇列執行。

任務套件是一種目錄結構，其中包含 OpenJD 任務範本、定義任務的其他檔案，以及做為任務輸入所需的任務特定檔案。您可以指定將任務定義為 YAML 或 JSON 檔案的檔案。

唯一的必要檔案是 `template.yaml`或 `template.json`。您也可以包含下列檔案：

```
/template.yaml (or template.json)
/asset_references.yaml (or asset_references.json)
/parameter_values.yaml (or parameter_values.json)
/{{other job-specific files and directories}}
```

使用任務套件搭配截止日期雲端 CLI 和任務附件進行自訂任務提交，或者您可以使用圖形提交界面。例如，以下是來自 GitHub 的 Blender 範例。若要在 [Blender 範例目錄中使用下列命令執行範例](https://github.com/aws-deadline/deadline-cloud-samples/tree/mainline/job_bundles)：

```
deadline bundle gui-submit blender_render
```

![Blender 的自訂任務提交界面範例。](http://docs.aws.amazon.com/zh_tw/deadline-cloud/latest/developerguide/images/blender_submit_shared_settings.png)


任務特定的設定面板是從任務範本中定義之任務參數的`userInterface`屬性產生。

若要使用命令列提交任務，您可以使用類似以下的命令

```
deadline bundle submit \
    --yes \
    --name {{Demo}} \
     -p BlenderSceneFile={{location of scene file}} \
     -p OutputDir={{file pathe for job output}} \
      blender_render/
```

或者，您可以在 `deadline` Python 套件中使用 `deadline.client.api.create_job_from_job_bundle`函數。

隨附於 Deadline Cloud 的所有任務提交者外掛程式，例如 Autodesk Maya 外掛程式，為您的提交產生任務套件，然後使用 Deadline Cloud Python 套件將您的任務提交至 Deadline Cloud。您可以在工作站的任務歷史記錄目錄中或使用提交者來查看提交的任務套件。您可以使用下列命令來尋找任務歷史記錄目錄：

```
deadline config get settings.job_history_dir
```

當您的任務在截止日期雲端工作者上執行時，它可以存取提供任務相關資訊的環境變數。環境變數為：


| 變數名稱 | Available | 
| --- | --- | 
| DEADLINE\_FARM\_ID | 所有動作 | 
| DEADLINE\_FLEET\_ID | 所有動作 | 
| DEADLINE\_WORKER\_ID | 所有動作 | 
| DEADLINE\_QUEUE\_ID | 所有動作 | 
| DEADLINE\_JOB\_ID | 所有動作 | 
| DEADLINE\_STEP\_ID | 任務動作 | 
| DEADLINE\_SESSION\_ID | 所有動作 | 
| DEADLINE\_TASK\_ID | 任務動作 | 
| DEADLINE\_SESSIONACTION\_ID | 所有動作 | 

**Topics**
+ [任務套件的任務範本元素](build-job-bundle-template.md)
+ [任務範本的任務區塊](build-job-bundle-chunking.md)
+ [任務套件的參數值元素](build-job-bundle-parameters.md)
+ [任務套件的資產參考元素](build-job-bundle-assets.md)