本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用作業範本
作業範本會儲存在開始作業執行時可跨 `StartJobRun` API 調用來共用的值。它支援兩種使用案例：
+ 防止重複出現 `StartJobRun` API 請求值。
+ 強制執行必須透過 `StartJobRun` API 請求提供特定值的規則。
作業範本可讓您為作業執行定義可重複使用的範本，以套用其他自訂項目，例如：
+ 設定執行程式和驅動程式運算容量
+ 設定安全性和控管屬性，例如 IAM 角色
+ 自訂要跨多個應用程式和資料管道使用的 Docker 映像檔
下列主題提供使用 範本的詳細資訊，包括如何使用它們來啟動任務執行，以及如何變更範本參數。
**Topics**
+ [建立並使用任務範本來啟動任務執行](create-job-template.md)
+ [定義作業範本參數](use-job-template-parameters.md)
+ [控制對作業範本的存取](iam-job-template.md)
# 建立並使用任務範本來啟動任務執行
本節說明建立任務範本，並使用 範本以 AWS Command Line Interface () 開始任務執行AWS CLI。
**建立作業範本**
1. 建立 `create-job-template-request.json` 檔案並指定作業範本所需的參數，如下列範例 JSON 檔案所示。如需所有可用參數的資訊，請參閱 [CreateJobTemplate](https://docs.aws.amazon.com/emr-on-eks/latest/APIReference/Welcome.html) API。
`StartJobRun` API 所需的大多數值也是 `jobTemplateData` 所必需的。如果您想在使用作業範本調用 StartJobRun 時為任何參數使用預留位置並提供值，請參閱作業範本參數的下一節。
```
{
"name": "mytemplate",
"jobTemplateData": {
"executionRoleArn": "iam_role_arn_for_job_execution",
"releaseLabel": "emr-6.7.0-latest",
"jobDriver": {
"sparkSubmitJobDriver": {
"entryPoint": "entryPoint_location",
"entryPointArguments": [ "argument1","argument2",...],
"sparkSubmitParameters": "--class --conf spark.executor.instances=2 --conf spark.executor.memory=2G --conf spark.executor.cores=2 --conf spark.driver.cores=1"
}
},
"configurationOverrides": {
"applicationConfiguration": [
{
"classification": "spark-defaults",
"properties": {
"spark.driver.memory":"2G"
}
}
],
"monitoringConfiguration": {
"persistentAppUI": "ENABLED",
"cloudWatchMonitoringConfiguration": {
"logGroupName": "my_log_group",
"logStreamNamePrefix": "log_stream_prefix"
},
"s3MonitoringConfiguration": {
"logUri": "s3://my_s3_log_location/"
}
}
}
}
}
```
1. 搭配使用 `create-job-template` 命令與儲存在本機的 `create-job-template-request.json` 檔案路徑。
```
aws emr-containers create-job-template \
--cli-input-json file://./create-job-template-request.json
```
**使用作業範本來啟動作業執行**
在 `StartJobRun` 命令中提供虛擬叢集 ID、作業範本 ID 以及作業名稱，如以下範例所示。
```
aws emr-containers start-job-run \
--virtual-cluster-id 123456 \
--name myjob \
--job-template-id 1234abcd
```
# 定義作業範本參數
作業範本參數可讓您指定作業範本中的變數。使用該作業範本啟動作業執行時，需要指定這些參數變數的值。作業範本參數會以 `${parameterName}` 格式指定。可以選擇將 `jobTemplateData` 欄位中的任何值指定為作業範本參數。針對每個作業範本參數變數，請指定其資料類型 (`STRING` 或 `NUMBER`)，並選擇性地指定預設值。以下範例顯示如何為進入點位置、主類別和 S3 日誌位置值指定作業範本參數。
**將進入點位置、主類別和 Amazon S3 日誌位置指定為作業範本參數**
1. 建立 `create-job-template-request.json` 檔案並指定作業範本所需的參數，如下列範例 JSON 檔案所示。如需有關參數的詳細資訊，請參閱 [CreateJobTemplate](https://docs.aws.amazon.com/emr-on-eks/latest/APIReference/Welcome.html) API。
```
{
"name": "mytemplate",
"jobTemplateData": {
"executionRoleArn": "iam_role_arn_for_job_execution",
"releaseLabel": "emr-6.7.0-latest",
"jobDriver": {
"sparkSubmitJobDriver": {
"entryPoint": "${EntryPointLocation}",
"entryPointArguments": [ "argument1","argument2",...],
"sparkSubmitParameters": "--class ${MainClass} --conf spark.executor.instances=2 --conf spark.executor.memory=2G --conf spark.executor.cores=2 --conf spark.driver.cores=1"
}
},
"configurationOverrides": {
"applicationConfiguration": [
{
"classification": "spark-defaults",
"properties": {
"spark.driver.memory":"2G"
}
}
],
"monitoringConfiguration": {
"persistentAppUI": "ENABLED",
"cloudWatchMonitoringConfiguration": {
"logGroupName": "my_log_group",
"logStreamNamePrefix": "log_stream_prefix"
},
"s3MonitoringConfiguration": {
"logUri": "${LogS3BucketUri}"
}
}
},
"parameterConfiguration": {
"EntryPointLocation": {
"type": "STRING"
},
"MainClass": {
"type": "STRING",
"defaultValue":"Main"
},
"LogS3BucketUri": {
"type": "STRING",
"defaultValue":"s3://my_s3_log_location/"
}
}
}
}
```
1. 搭配使用 `create-job-template` 命令與儲存在本機或 Amazon S3 中的 `create-job-template-request.json` 檔案路徑。
```
aws emr-containers create-job-template \
--cli-input-json file://./create-job-template-request.json
```
**使用具有作業範本參數的作業範本開始作業執行**
若要使用包含作業範本參數的作業範本開始作業執行，請在 `StartJobRun` API 請求中指定作業範本 ID 以及作業範本參數值，如下所示。
```
aws emr-containers start-job-run \
--virtual-cluster-id 123456 \
--name myjob \
--job-template-id 1234abcd \
--job-template-parameters '{"EntryPointLocation": "entry_point_location","MainClass": "ExampleMainClass","LogS3BucketUri": "s3://example_s3_bucket/"}'
```
# 控制對作業範本的存取
`StartJobRun` 政策可讓您強制使用者或角色只能使用您指定的作業範本來執行作業，而且如果不使用指定的作業範本，就無法執行 `StartJobRun` 操作。為此，首先確保為使用者或角色授予對指定作業範本的讀取許可，如下所示。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"emr-containers:DescribeJobRun"
],
"Resource": [
"arn:aws:emr-containers:*:*:jobtemplate/job_template_1_id",
"arn:aws:emr-containers:*:*:jobtemplate/job_template_2_id"
],
"Sid": "AllowEMRCONTAINERSDescribejobtemplate"
}
]
}
```
------
若要強制使用者或角色只能在使用指定的作業範本時調用 `StartJobRun` 操作，可將下列 `StartJobRun` 政策許可指派給指定的使用者或角色。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"emr-containers:StartJobRun"
],
"Resource": [
"arn:aws:emr-containers:*:*:/virtualclusters/virtual_cluster_id"
],
"Condition": {
"ArnLike": {
"emr-containers:JobTemplateArn": [
"arn:aws:emr-containers:*:*:jobtemplate/job_template_1_id",
"arn:aws:emr-containers:*:*:jobtemplate/job_template_2_id"
]
}
},
"Sid": "AllowEMRCONTAINERSStartjobrun"
}
]
}
```
------
如果作業範本在執行角色 ARN 欄位中指定作業範本參數，則使用者將能夠提供此參數的值，因此可以使用任意執行角色來調用 `StartJobRun`。若要限制使用者可以提供的執行角色，請參閱 [搭配使用作業執行角色與 Amazon EMR on EKS](iam-execution-role.md) 中的**控制對執行角色的存取**。
如果上述 `StartJobRun` 動作政策中未針對指定的使用者或角色指定任何條件，則將允許使用者或角色使用他們具有讀取權限的任意作業範本或使用任意執行角色，在指定虛擬叢集上調用 `StartJobRun` 動作。