Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Parametri di definizione del lavoro per ContainerProperties
Le definizioni di Job utilizzate [https://docs.aws.amazon.com/batch/latest/APIReference/API_ContainerProperties.html](https://docs.aws.amazon.com/batch/latest/APIReference/API_ContainerProperties.html)sono suddivise in più parti:
+ Il nome della definizione del processo
+ Il tipo di definizione del processo
+ I valori predefiniti del segnaposto per la sostituzione dei parametri
+ Le proprietà del contenitore per il lavoro
+ Le proprietà di Amazon EKS per la definizione del processo necessarie per i lavori eseguiti sulle risorse Amazon EKS
+ Le proprietà del nodo necessarie per un processo parallelo a più nodi
+ Le funzionalità della piattaforma necessarie per i lavori eseguiti sulle risorse di Fargate
+ I dettagli di propagazione dei tag predefiniti della definizione del processo
+ La strategia di riprova predefinita per la definizione del processo
+ La priorità di pianificazione predefinita per la definizione del processo
+ I tag predefiniti per la definizione del processo
+ Il timeout predefinito per la definizione del processo
**Contents**
+ [Nome della definizione del processo](#jobDefinitionName)
+ [Tipo](#type)
+ [Parametri](#parameters)
+ [Proprietà del contenitore](#containerProperties)
+ [Proprietà Amazon EKS](#job-definition-parameters-eks-properties)
+ [Funzionalità della piattaforma](#job-definition-parameters-platform-capabilities)
+ [Propaga i tag](#job-definition-parameters-propagate-tags)
+ [Proprietà del nodo](#nodeProperties)
+ [Strategia per nuovi tentativi](#retryStrategy)
+ [Priorità di pianificazione](#job-definition-parameters-schedulingPriority)
+ [Tag](#job-definition-parameters-tags)
+ [Timeout](#timeout)
## Nome della definizione del processo
`jobDefinitionName`
Quando si registra una definizione di processo, è necessario specificare un nome, Il nome può avere una lunghezza massima di 128 caratteri. Deve contenere lettere maiuscole e minuscole, numeri, trattini (-) e caratteri di sottolineatura (\_). Alla prima definizione di processo registrata con quel nome viene assegnata una revisione pari a 1. Tutte le successive definizioni del processo registrate con tale nome vengono contrassegnate con un numero di revisione incrementale.
Tipo: stringa
Campo obbligatorio: sì
## Tipo
`type`
Quando si registra una definizione di processo, è necessario specificare il tipo di processo. Se il processo viene eseguito su risorse Fargate, `multinode` non è supportato. Per ulteriori informazioni sui processi in parallelo a più nodi, consulta [Creare una definizione di processo parallelo multinodo](create-multi-node-job-def.md).
▬Tipo: stringa
Valori validi: `container` \| `multinode`
Campo obbligatorio: sì
## Parametri
`parameters`
Quando invii un lavoro, puoi specificare parametri che sostituiscono i segnaposto o sostituiscono i parametri di definizione del lavoro predefiniti. I parametri delle richieste di invio del processo hanno priorità rispetto ai valori predefiniti di una definizione del processo. Ciò significa che è possibile utilizzare la stessa definizione di processo per più lavori che utilizzano lo stesso formato. È inoltre possibile modificare a livello di codice i valori del comando al momento dell'invio.
Tipo: mappatura stringa a stringa
Campo obbligatorio: no
Quando si registra una definizione di processo, è possibile utilizzare segnaposto di sostituzione dei parametri nel campo `command` delle proprietà del container del processo. La sintassi è esposta di seguito.
```
"command": [
"ffmpeg",
"-i",
"{{Ref::inputfile}}",
"-c",
"{{Ref::codec}}",
"-o",
"{{Ref::outputfile}}"
]
```
Nell'esempio precedente, sono presenti segnaposto per la sostituzione del parametro `{{Ref::inputfile}}`, `{{Ref::codec}}` e `{{Ref::outputfile}}` nel comando. È possibile utilizzare l'`parameters`oggetto nella definizione del processo per impostare valori predefiniti per questi segnaposto. Ad esempio, per impostare un valore predefinito per il segnaposto `{{Ref::codec}}`, è necessario specificare quanto segue nella definizione del processo:
```
"parameters" : {"codec" : "mp4"}
```
Quando questa definizione di processo viene inviata per l'esecuzione, l'`{{Ref::codec}}`argomento nel comando per il contenitore viene sostituito con il valore predefinito,. `mp4`
## Proprietà del contenitore
Quando registri una definizione di processo, specifica un elenco di proprietà del contenitore che vengono passate al demone Docker su un'istanza del contenitore quando il lavoro viene inserito. Di seguito sono indicate le proprietà del container consentite in una definizione di processo. Per i processi a nodo singolo, queste proprietà del container vengono impostate a livello di definizione del processo. Per i processi paralleli a più nodi, le proprietà del container vengono impostate nel livello [Proprietà del nodo](#nodeProperties), per ciascun gruppo di nodi.
`command`
Il comando che viene inviato al container. Questo parametro viene mappato su `Cmd` nella sezione [Crea un container](https://docs.docker.com/engine/api/v1.38/#operation/ContainerCreate) di [Docker Remote API](https://docs.docker.com/engine/api/v1.38/) e il parametro `COMMAND` su [https://docs.docker.com/engine/reference/commandline/run/](https://docs.docker.com/engine/reference/commandline/run/). [Per ulteriori informazioni sul `CMD` parametro Docker, vedere reference/builder/ \#cmd. https://docs.docker.com/engine/](https://docs.docker.com/engine/reference/builder/#cmd)
```
"command": ["{{string}}", ...]
```
Tipo: array di stringhe
Campo obbligatorio: no
`environment`
Le variabili di ambiente da passare a un container. Questo parametro è mappato a `Env` nella sezione [Create a container](https://docs.docker.com/engine/api/v1.38/#operation/ContainerCreate) di [Docker Remote API](https://docs.docker.com/engine/api/v1.38/) e l'opzione `--env` a [https://docs.docker.com/engine/reference/commandline/run/](https://docs.docker.com/engine/reference/commandline/run/).
Non è consigliabile utilizzare variabili d'ambiente non crittografate per informazioni sensibili, ad esempio dati di credenziali.
Le variabili di ambiente non devono iniziare con. `AWS_BATCH` Questa convenzione di denominazione è riservata alle variabili impostate dal AWS Batch servizio.
Tipo: array di coppie chiave-valore
Campo obbligatorio: no
`name`
Il nome della variabile di ambiente.
▬Tipo: stringa
Campo obbligatorio: sì, quando viene usato `environment`.
`value`
Il valore della variabile di ambiente.
▬Tipo: stringa
Campo obbligatorio: sì, quando viene usato `environment`.
```
"environment" : [
{ "name" : "{{envName1}}", "value" : "{{envValue1}}" },
{ "name" : "{{envName2}}", "value" : "{{envValue2}}" }
]
```
`executionRoleArn`
Quando registri una definizione di lavoro, puoi specificare un ruolo IAM. Il ruolo fornisce all'agente container Amazon ECS le autorizzazioni per richiamare le azioni API specificate nelle politiche associate per tuo conto. I lavori eseguiti su risorse Fargate devono fornire un ruolo di esecuzione. Per ulteriori informazioni, consulta [AWS Batch Ruolo di esecuzione IAM](execution-IAM-role.md).
▬Tipo: stringa
Campo obbligatorio: no
`fargatePlatformConfiguration`
La configurazione della piattaforma per i lavori eseguiti sulle risorse di Fargate. I lavori eseguiti su EC2 risorse non devono specificare questo parametro.
Tipo: oggetto [FargatePlatformConfiguration](https://docs.aws.amazon.com/batch/latest/APIReference/API_FargatePlatformConfiguration.html)
Campo obbligatorio: no
`platformVersion`
La versione della piattaforma AWS Fargate da utilizzare per i lavori o per `LATEST` utilizzare una versione recente e approvata della piattaforma Fargate AWS .
▬Tipo: stringa
Impostazione predefinita: `LATEST`
Campo obbligatorio: no
`image`
L'immagine utilizzata per iniziare un lavoro. Questa stringa viene trasmessa direttamente al daemon Docker. Le immagini nel registro Docker Hub sono disponibili di default. Puoi anche specificare altri repository con `{{repository-url}}/{{image}}:{{tag}}`. Il nome può contenere un massimo di 255 lettere (maiuscole e minuscole); sono consentiti numeri, trattini, caratteri di sottolineatura, due punti, punti, barre e cancelletti. Questo parametro è mappato a `Image` nella sezione [Crea un container](https://docs.docker.com/engine/api/v1.38/#operation/ContainerCreate) dell'[API remota Docker](https://docs.docker.com/engine/api/v1.38/) e al parametro `IMAGE` di [https://docs.docker.com/engine/reference/commandline/run/](https://docs.docker.com/engine/reference/commandline/run/).
L'architettura immagine Docker deve corrispondere all'architettura del processore delle risorse di calcolo su cui sono pianificate. Ad esempio, immagini Docker basate su ARM possono essere eseguite solo su risorse di calcolo basate su ARM.
+ Le immagini negli archivi pubblici di Amazon ECR utilizzano le convenzioni complete `registry/repository[:tag]` o di `registry/repository[@digest]` denominazione (ad esempio,). `public.ecr.aws/{{registry_alias}}/{{my-web-app}}:{{latest}}`
+ Le immagini nei repository Amazon ECR utilizzano la convenzione di `registry/repository:[tag]` denominazione completa. Ad esempio, `{{aws_account_id}}.dkr.ecr.{{region}}.amazonaws.com``/{{my-web-app}}:{{latest}}`.
+ Le immagini in repository ufficiali su Docker Hub utilizzano un singolo nome (ad esempio `ubuntu` o `mongo`).
+ Le immagini in altri repository su Docker Hub vengono qualificate con un nome di organizzazione (ad esempi, `amazon/amazon-ecs-agent`).
+ Le immagini in altri repository online vengono ulteriormente qualificate tramite un nome di dominio (ad esempio `quay.io/assemblyline/ubuntu`).
Tipo: stringa
Campo obbligatorio: sì
`instanceType`
Il tipo di istanza da usare per un processo parallelo a più nodi. Attualmente tutti i gruppi di nodi in un processo parallelo a più nodi devono utilizzare lo stesso tipo di istanza. Questo parametro non è valido per i processi di container a nodo singolo o per i lavori eseguiti su risorse Fargate.
▬Tipo: stringa
Campo obbligatorio: no
`jobRoleArn`
Quando registri una definizione di lavoro, puoi specificare un ruolo IAM. che fornisce al container del processo le autorizzazioni necessarie per chiamare le operazioni dell'API specificate nelle policy associate per conto dell'utente. Per ulteriori informazioni, consulta [Ruoli IAM per le attività](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html) nella *Guida per sviluppatori di Amazon Elastic Container Service*.
▬Tipo: stringa
Campo obbligatorio: no
`linuxParameters`
Modifiche specifiche di Linux che vengono applicate al container, ad esempio i dettagli per le mappature dei dispositivi.
```
"linuxParameters": {
"devices": [
{
"hostPath": "{{string}}",
"containerPath": "{{string}}",
"permissions": [
"READ", "WRITE", "MKNOD"
]
}
],
"initProcessEnabled": {{true|false}},
"sharedMemorySize": 0,
"tmpfs": [
{
"containerPath": "{{string}}",
"size": {{integer}},
"mountOptions": [
"{{string}}"
]
}
],
"maxSwap": {{integer}},
"swappiness": {{integer}}
}
```
Tipo: oggetto [LinuxParameters](https://docs.aws.amazon.com/batch/latest/APIReference/API_LinuxParameters.html)
Campo obbligatorio: no
`devices`
Elenco dei dispositivi mappati nel container. Questo parametro è mappato a `Devices` nella sezione [Crea un container](https://docs.docker.com/engine/api/v1.38/#operation/ContainerCreate) di [API Docker Remote](https://docs.docker.com/engine/api/v1.38/) e l'opzione `--device` a [docker run](https://docs.docker.com/engine/reference/run/).
Questo parametro non è applicabile ai processi eseguiti sulle risorse di Fargate.
Tipo: matrice di oggetti [Device](https://docs.aws.amazon.com/batch/latest/APIReference/API_Device.html)
Campo obbligatorio: no
`hostPath`
Percorso in cui si trova il dispositivo disponibile nell'istanza del contenitore host.
Tipo: stringa
Campo obbligatorio: sì
`containerPath`
Si trova il percorso in cui è esposto il dispositivo nel contenitore. Se questo non è specificato, il dispositivo viene esposto nello stesso percorso del percorso host.
▬Tipo: stringa
Campo obbligatorio: no
`permissions`
Autorizzazioni per il dispositivo nel container. Se questo non è specificato, le autorizzazioni sono impostate su `READ``WRITE`, e`MKNOD`.
Tipo: matrice di stringhe
Campo obbligatorio: no
Valori validi: `READ` \| `WRITE` \| `MKNOD`
`initProcessEnabled`
Se true, esegue un processo `init` nel container che inoltra segnali e raccoglie i processi. Questo parametro è mappato all'opzione `--init` su [docker run](https://docs.docker.com/engine/reference/run/). Questo parametro richiede la versione 1.25 o successiva di Docker Remote API sull'istanza di container. Per controllare la versione Docker Remote API nell'istanza di container, accedi all'istanza di container ed esegui il seguente comando: `sudo docker version | grep "Server API version"`
Tipo: Booleano
Campo obbligatorio: no
`maxSwap`
La quantità totale di memoria di swap (in MiB) che un job può utilizzare. Questo parametro viene convertito nell'opzione `--memory-swap` in [docker run](https://docs.docker.com/engine/reference/run/) dove il valore sarebbe la somma della memoria del container più il valore `maxSwap`. Per ulteriori informazioni, consulta la sezione relativa ai [dettagli `--memory-swap`](https://docs.docker.com/config/containers/resource_constraints/#--memory-swap-details) nella documentazione Docker.
Se viene specificato il valore `maxSwap` di `0`, il container non utilizzerà lo swap. I valori accettati sono `0` o qualsiasi numero intero positivo. Se il `maxSwap` parametro viene omesso, il contenitore utilizza la configurazione di swap per l'istanza del contenitore su cui viene eseguito. È necessario impostare un valore `maxSwap` per il parametro `swappiness` da utilizzare.
Questo parametro non è applicabile ai processi eseguiti sulle risorse di Fargate.
Tipo: integer
Campo obbligatorio: no
`sharedMemorySize`
Valore per le dimensioni (in MiB) del volume `/dev/shm`. Questo parametro è mappato all'opzione `--shm-size` su [docker run](https://docs.docker.com/engine/reference/run/).
Questo parametro non è applicabile ai processi eseguiti sulle risorse di Fargate.
Tipo: integer
Campo obbligatorio: no
`swappiness`
In questo modo è possibile ottimizzare il comportamento swappiness di memoria di un container. Un `swappiness` valore di `0` fa sì che lo scambio non avvenga a meno che non sia assolutamente necessario. Un valore `swappiness` di `100` produrrà lo swap delle pagine in modo aggressivo. I valori accettati sono numeri interi compresi tra `0` e `100`. Se il parametro `swappiness` non è specificato, viene utilizzato un valore predefinito `60`. Se non viene specificato un valore per `maxSwap`, questo parametro verrà ignorato. Se `maxSwap` è impostato su 0, il container non utilizza lo swap. Questo parametro è mappato all'opzione `--memory-swappiness` su [docker run](https://docs.docker.com/engine/reference/run/).
Quando utilizzi una configurazione swap container, considera quanto segue:
+ Lo spazio di swap deve essere abilitato e allocato sull'istanza di container per consentire ai container di utilizzarlo.
**Nota**
Gli Amazon ECS ottimizzati AMIs non hanno lo swap abilitato per impostazione predefinita. È necessario abilitare lo swap sull'istanza per utilizzare questa funzionalità. Per ulteriori informazioni, consulta [Instance Store Swap Volumes](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-store-swap-volumes.html) nella *Amazon EC2 User Guide* o [Come posso allocare la memoria per funzionare come spazio di swap in un' EC2 istanza Amazon utilizzando un](https://aws.amazon.com/premiumsupport/knowledge-center/ec2-memory-swap-file/) file di swap? .
+ I parametri dello spazio di swap sono supportati solo per le definizioni dei processi che utilizzano EC2 risorse.
+ Se i parametri `maxSwap` e `swappiness` vengono omessi dalla definizione di un processo, per ogni container viene ripristinato il valore `swappiness` predefinito di 60. L'utilizzo totale dello swap è limitato a due volte la riserva di memoria del contenitore.
Questo parametro non è applicabile ai processi eseguiti sulle risorse di Fargate.
Tipo: integer
Campo obbligatorio: no
`tmpfs`
Il percorso del container, le opzioni di montaggio e la dimensione montaggio tmpfs.
Tipo: matrice di oggetti [Tmpfs](https://docs.aws.amazon.com/batch/latest/APIReference/API_Tmpfs.html)
Questo parametro non è applicabile ai processi eseguiti sulle risorse di Fargate.
Campo obbligatorio: no
`containerPath`
Il percorso assoluto del file nel container in cui è montato il volume tmpfs.
Tipo: stringa
Campo obbligatorio: sì
`mountOptions`
L'elenco delle opzioni di montaggio del volume tmpfs.
Valori validi: `defaults` "" \| `ro` "" \| `rw` "" \| `suid` "" \| `nosuid` "" \| `dev` "" \| `nodev` "\|" \| `exec` "\|`noexec`" \| "`sync`" \| "`async`" \| "\|`dirsync`" "\|`remount`" "\|`mand`" \| `nomand` "\|" \| `atime` "\|" \| `noatime` "\|`diratime`" \| "\|`nodiratime`" \| `bind` "\|" \| `rbind` "\|`unbindable`" \| "\|`runbindable`" \| `private` "\|" \| `rprivate` "\|`shared`" \| "\|`rshared`" \| `slave` "\|" \| `rslave` "\|`relatime`" \| "\|`norelatime`" \| "`strictatime`" \| "`nostrictatime`" \|» `mode`"\|" `uid` "\|" `gid` "\|" `nr_inodes` "\|" `nr_blocks` "\|"`mpol`»
Tipo: matrice di stringhe
Campo obbligatorio: no
`size`
Le dimensioni (in MiB) del volume tmpfs.
Tipo: integer
Campo obbligatorio: sì
`logConfiguration`
La specifica di configurazione del registro per il lavoro.
Questo parametro è mappato a `LogConfig` nella sezione [Crea un container](https://docs.docker.com/engine/api/v1.38/#operation/ContainerCreate) di [API Docker Remote](https://docs.docker.com/engine/api/v1.38/) e l'opzione `--log-driver` a [docker run](https://docs.docker.com/engine/reference/run/). Per impostazione predefinita, i container utilizzano lo stesso driver di log utilizzato dal daemon Docker. Tuttavia, il contenitore può utilizzare un driver di registrazione diverso dal demone Docker specificando un driver di registro con questo parametro nella definizione del contenitore. Per utilizzare un driver di registrazione diverso per un contenitore, il sistema di registro deve essere configurato sull'istanza del contenitore o su un altro server di registro per fornire opzioni di registrazione remota. Per ulteriori informazioni sulle opzioni per diversi driver di log supportati, consulta [Configure logging drivers](https://docs.docker.com/engine/admin/logging/overview/) (Configurazione dei driver di log) nella documentazione di Docker.
AWS Batch attualmente supporta un sottoinsieme dei driver di registrazione disponibili per il demone Docker (mostrati nel tipo di dati). [LogConfiguration](https://docs.aws.amazon.com/batch/latest/APIReference/API_LogConfiguration.html)
Questo parametro richiede la versione 1.18 o successiva di Docker Remote API sull'istanza di container. Per controllare la versione Docker Remote API nell'istanza di container, accedi all'istanza di container ed esegui il seguente comando: `sudo docker version | grep "Server API version"`
```
"logConfiguration": {
"devices": [
{
"logDriver": "{{string}}",
"options": {
"{{optionName1}}" : "{{optionValue1}}",
"{{optionName2}}" : "{{optionValue2}}"
}
"secretOptions": [
{
"name" : "{{secretOptionName1}}",
"valueFrom" : "{{secretOptionArn1}}"
},
{
"name" : "{{secretOptionName2}}",
"valueFrom" : "{{secretOptionArn2}}"
}
]
}
]
}
```
Tipo: oggetto [LogConfiguration](https://docs.aws.amazon.com/batch/latest/APIReference/API_LogConfiguration.html)
Campo obbligatorio: no
`logDriver`
Il driver di registro da utilizzare per il lavoro. Per impostazione predefinita, AWS Batch abilita il driver di `awslogs` registro. I valori validi elencati per questo parametro sono driver di log con i quali l'agente del container Amazon ECS può comunicare per impostazione predefinita.
Questo parametro è mappato a `LogConfig` nella sezione [Crea un container](https://docs.docker.com/engine/api/v1.38/#operation/ContainerCreate) di [API Docker Remote](https://docs.docker.com/engine/api/v1.38/) e l'opzione `--log-driver` a [docker run](https://docs.docker.com/engine/reference/run/). Per impostazione predefinita, i job utilizzano lo stesso driver di registrazione utilizzato dal demone Docker. Tuttavia, il job può utilizzare un driver di registrazione diverso dal daemon Docker specificando un driver di log con questo parametro nella definizione del processo. Se si desidera specificare un altro driver di registrazione per un job, il sistema di log deve essere configurato sull'istanza del contenitore nell'ambiente di calcolo. Oppure, in alternativa, configuralo su un altro server di registro per fornire opzioni di registrazione remota. Per ulteriori informazioni sulle opzioni per diversi driver di log supportati, consulta [Configure logging drivers](https://docs.docker.com/engine/admin/logging/overview/) (Configurazione dei driver di log) nella documentazione di Docker.
AWS Batch attualmente supporta un sottoinsieme dei driver di registrazione disponibili per il demone Docker. Ulteriori driver di log potranno essere disponibili nei rilasci futuri dell'agente del container Amazon ECS.
I driver di log supportati sono `awslogs`, `fluentd`, `gelf`, `json-file`, `journald`, `logentries`, `syslog` e `splunk`.
I lavori eseguiti sulle risorse Fargate sono limitati ai driver `awslogs` e `splunk` log.
Questo parametro richiede la versione 1.18 o successiva di Docker Remote API sull'istanza di container. Per controllare la versione Docker Remote API nell'istanza di container, accedi all'istanza di container ed esegui il seguente comando: `sudo docker version | grep "Server API version"`
L'agente container Amazon ECS che viene eseguito su un'istanza di contenitore deve registrare i driver di registrazione disponibili su quell'istanza con la variabile di `ECS_AVAILABLE_LOGGING_DRIVERS` ambiente. Altrimenti, i contenitori posizionati su quell'istanza non possono utilizzare queste opzioni di configurazione del registro. Per ulteriori informazioni, consulta [Configurazione dell'agente del container Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-config.html) nella *Guida per gli sviluppatori di Amazon Elastic Container Service*.
`awslogs`
Speciifica il driver di registrazione Amazon CloudWatch Logs. Per ulteriori informazioni, consulta [Usa il driver di registro awslogs](using_awslogs.md) il [driver di registrazione di Amazon CloudWatch Logs](https://docs.docker.com/config/containers/logging/awslogs/) nella documentazione di Docker.
`fluentd`
Specifica il driver di log Fluentd. Per ulteriori informazioni, inclusi l'utilizzo e le opzioni, consulta il driver di [registrazione Fluentd nella documentazione di Docker.](https://docs.docker.com/config/containers/logging/fluentd/)
`gelf`
Specifica il driver di log GELF (Greylog Extended Format). Per ulteriori informazioni, inclusi l'utilizzo e le opzioni, consulta il driver di [registrazione Graylog Extended Format](https://docs.docker.com/config/containers/logging/gelf/) nella documentazione Docker.
`journald`
Specifica il driver di log journald. Per ulteriori informazioni, incluso l'utilizzo e le opzioni, consulta il driver di [registrazione Journald nella documentazione di Docker.](https://docs.docker.com/config/containers/logging/journald/)
`json-file`
Specifica il driver di log del file JSON. Per ulteriori informazioni, incluso l'utilizzo e le opzioni, consulta il [driver di registrazione dei file JSON nella documentazione di Docker](https://docs.docker.com/config/containers/logging/json-file/).
`splunk`
Specifica il driver di log Splunk. Per ulteriori informazioni, tra cui utilizzo e opzioni, consulta il [driver di registrazione Splunk nella documentazione di Docker](https://docs.docker.com/config/containers/logging/splunk/).
`syslog`
Specifica il driver di log syslog. Per ulteriori informazioni, incluso l'utilizzo e le opzioni, consulta il driver di registrazione [Syslog nella documentazione di Docker.](https://docs.docker.com/config/containers/logging/syslog/)
Tipo: stringa
Campo obbligatorio: sì
Valori validi: `awslogs` \| `fluentd` \| `gelf` \| `journald` \| `json-file` \| `splunk` \| `syslog`
Se disponi di un driver personalizzato non elencato in precedenza che desideri utilizzare con l'agente container Amazon ECS, puoi eseguire il fork del progetto Amazon ECS container agent [disponibile su GitHub](https://github.com/aws/amazon-ecs-agent) e personalizzarlo per funzionare con quel driver. Ti consigliamo di inviare le richieste pull per le modifiche che desideri siano incluse. Tuttavia, Amazon Web Services attualmente non supporta le richieste che eseguono copie modificate di questo software.
`options`
Opzioni di configurazione del registro da inviare a un driver di registro per il lavoro.
Questo parametro richiede la versione 1.19 o successiva di Docker Remote API sull'istanza di container.
Tipo: mappatura stringa a stringa
Campo obbligatorio: no
`secretOptions`
Un oggetto che rappresenta il segreto da inviare alla configurazione di log. Per ulteriori informazioni, consulta [Specificare dati sensibili](specifying-sensitive-data.md).
Tipo: matrice di oggetti
Campo obbligatorio: no
`name`
Il nome dell'opzione del driver di registro da impostare nel processo.
Tipo: stringa
Campo obbligatorio: sì
`valueFrom`
L'Amazon Resource Name (ARN) del segreto da esporre alla configurazione di log del contenitore. I valori supportati sono l'ARN completo del segreto di Secrets Manager o l'ARN completo del parametro nell'archivio dei parametri SSM.
Se il parametro SSM Parameter Store esiste nella Regione AWS stessa operazione che stai avviando, puoi utilizzare l'ARN completo o il nome del parametro. Se il parametro esiste in una Regione diversa, deve essere specificato l'ARN completo.
Tipo: stringa
Campo obbligatorio: sì
`memory`
*Questo parametro è obsoleto, utilizzalo al suo posto. `resourceRequirements`*
Il numero di MiB di memoria riservati per il lavoro.
Come esempio di utilizzo`resourceRequirements`, se la definizione del processo contiene una sintassi simile alla seguente.
```
"containerProperties": {
"memory": {{512}}
}
```
La sintassi equivalente utilizzata `resourceRequirements` è la seguente.
```
"containerProperties": {
"resourceRequirements": [
{
"type": "MEMORY",
"value": "{{512}}"
}
]
}
```
Tipo: integer
Campo obbligatorio: sì
`mountPoints`
I punti di montaggio per i volumi di dati nel container. Questo parametro è mappato a `Volumes` nella sezione [Create a container](https://docs.docker.com/engine/api/v1.38/#operation/ContainerCreate) di [Docker Remote API](https://docs.docker.com/engine/api/v1.38/) e l'opzione `--volume` a [https://docs.docker.com/engine/reference/commandline/run/](https://docs.docker.com/engine/reference/commandline/run/).
```
"mountPoints": [
{
"sourceVolume": "{{string}}",
"containerPath": "{{string}}",
"readOnly": {{true|false}}
}
]
```
Tipo: array di oggetti
Campo obbligatorio: no
`sourceVolume`
Il nome del volume da montare.
▬Tipo: stringa
Campo obbligatorio: sì, quando viene usato `mountPoints`.
`containerPath`
Il percorso sul contenitore in cui montare il volume host.
▬Tipo: stringa
Campo obbligatorio: sì, quando viene usato `mountPoints`.
`readOnly`
Se il valore è `true`, il container avrà accesso in sola lettura al volume. Se il valore è `false`, il container avrà accesso in scrittura al volume.
Tipo: Booleano
Campo obbligatorio: no
Impostazione predefinita: False
`networkConfiguration`
La configurazione di rete per i lavori eseguiti su risorse Fargate. I lavori eseguiti su EC2 risorse non devono specificare questo parametro.
```
"networkConfiguration": {
"assignPublicIp": "string"
}
```
Tipo: array di oggetti
Campo obbligatorio: no
`assignPublicIp`
Indica se il processo ha un indirizzo IP pubblico. Questo è necessario se il job richiede l'accesso alla rete in uscita.
▬Tipo: stringa
Valori validi: `ENABLED` \| `DISABLED`
Campo obbligatorio: no
Impostazione predefinita: `DISABLED`
`privileged`
Se il parametro è true, al container vengono assegnati privilegi elevati nell'istanza di container host (simile all'utente `root`). Questo parametro è mappato a `Privileged` nella sezione [Create a container](https://docs.docker.com/engine/api/v1.38/#operation/ContainerCreate) di [Docker Remote API](https://docs.docker.com/engine/api/v1.38/) e l'opzione `--privileged` a [https://docs.docker.com/engine/reference/commandline/run/](https://docs.docker.com/engine/reference/commandline/run/). Questo parametro non è applicabile ai processi eseguiti sulle risorse di Fargate. Non fornirlo né specificarlo come falso.
```
"privileged": {{true|false}}
```
Tipo: Booleano
Campo obbligatorio: no
`readonlyRootFilesystem`
Se il parametro è true, al container viene assegnato l'accesso in sola lettura al file system radice. Questo parametro è mappato a `ReadonlyRootfs` nella sezione [Create a container](https://docs.docker.com/engine/api/v1.38/#operation/ContainerCreate) di [Docker Remote API](https://docs.docker.com/engine/api/v1.38/) e l'opzione `--read-only` a [https://docs.docker.com/engine/reference/commandline/run/](https://docs.docker.com/engine/reference/commandline/run/).
```
"readonlyRootFilesystem": {{true|false}}
```
Tipo: Booleano
Campo obbligatorio: no
`resourceRequirements`
Il tipo e la quantità di una risorsa da assegnare a un container. Le risorse supportate includono `GPU`, `MEMORY` e `VCPU`.
```
"resourceRequirements" : [
{
"type": "GPU",
"value": "{{number}}"
}
]
```
Tipo: array di oggetti
Campo obbligatorio: no
`type`
Il tipo di risorsa da assegnare a un container. Le risorse supportate includono `GPU`, `MEMORY` e `VCPU`.
▬Tipo: stringa
Campo obbligatorio: sì, quando viene usato `resourceRequirements`.
`value`
La quantità di risorsa specificata da prenotare per il container. I valori variano in base al `type` specificato.
type="GPU"
Il numero di materiali fisici GPUs da riservare per il contenitore. Il numero di contenitori GPUs riservati per tutti i contenitori di un job non può superare il numero di risorse di calcolo disponibili GPUs sulla quale il job viene avviato.
type="MEMORY"
Il limite rigido (in MiB) della memoria da presentare al container. Se il container tenta di superare la memoria specificata qui, viene terminato. Questo parametro è mappato a `Memory` nella sezione [Crea un container](https://docs.docker.com/engine/api/v1.38/#operation/ContainerCreate) di [API Docker Remote](https://docs.docker.com/engine/api/v1.38/) e l'opzione `--memory` a [docker run](https://docs.docker.com/engine/reference/run/). Per un processo, è necessario specificare almeno 4 MiB di memoria. Questo è obbligatorio ma può essere specificato in più posizioni per i processi MNP (Multi-Node Parallel). Deve essere specificato almeno una volta per ogni nodo. Questo parametro è mappato a `Memory` nella sezione [Crea un container](https://docs.docker.com/engine/api/v1.38/#operation/ContainerCreate) di [API Docker Remote](https://docs.docker.com/engine/api/v1.38/) e l'opzione `--memory` a [docker run](https://docs.docker.com/engine/reference/run/).
Se stai cercando di massimizzare l'utilizzo delle risorse fornendo ai job quanta più memoria possibile per un particolare tipo di istanza, consulta. [Gestione della memoria delle risorse di calcolo](memory-management.md)
Per i lavori eseguiti su risorse Fargate, `value` devono corrispondere a uno dei valori supportati. Inoltre, i `VCPU` valori devono essere uno dei valori supportati per quel valore di memoria.
[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/batch/latest/userguide/job_definition_parameters.html)
type="VCPU"
Il numero di v riservato al lavoro. CPUs Questo parametro è mappato a `CpuShares` nella sezione [Crea un container](https://docs.docker.com/engine/api/v1.38/#operation/ContainerCreate) di [API Docker Remote](https://docs.docker.com/engine/api/v1.38/) e l'opzione `--cpu-shares` a [docker run](https://docs.docker.com/engine/reference/run/). Ogni vCPU equivale a 1.024 condivisioni di CPU. Per i lavori eseguiti su EC2 risorse, è necessario specificare almeno una vCPU. È obbligatorio, ma può essere specificato in diversi punti. Deve essere specificato almeno una volta per ogni nodo.
Per i lavori eseguiti su risorse Fargate, `value` deve corrispondere a uno dei valori supportati e i `MEMORY` valori devono essere uno dei valori supportati per quel valore VCPU. I valori supportati sono 0,25, 0,5, 1, 2, 4, 8 e 16.
L'impostazione predefinita per la quota di conteggio delle risorse vCPU Fargate On-Demand è 6 v. CPUs Per ulteriori informazioni sulle quote Fargate, vedere Quote [AWS Fargate](https://docs.aws.amazon.com/general/latest/gr/ecs-service.html#service-quotas-fargate) nel. *Riferimenti generali di Amazon Web Services*
▬Tipo: stringa
Campo obbligatorio: sì, quando viene usato `resourceRequirements`.
`secrets`
I segreti del lavoro che sono esposti come variabili di ambiente. Per ulteriori informazioni, consulta [Specificare dati sensibili](specifying-sensitive-data.md).
```
"secrets": [
{
"name": "{{secretName1}}",
"valueFrom": "{{secretArn1}}"
},
{
"name": "{{secretName2}}",
"valueFrom": "{{secretArn2}}"
}
...
]
```
Tipo: array di oggetti
Campo obbligatorio: no
`name`
Il nome della variabile di ambiente che contiene il segreto.
▬Tipo: stringa
Campo obbligatorio: sì, quando viene usato `secrets`.
`valueFrom`
Il segreto da esporre al container. I valori supportati sono l'Amazon Resource Name (ARN) completo del segreto Secrets Manager o l'ARN completo del parametro nell'SSM Parameter Store.
Se il parametro SSM Parameter Store esiste nello Regione AWS stesso processo che stai avviando, puoi utilizzare l'ARN completo o il nome del parametro. Se il parametro esiste in una Regione diversa, deve essere specificato l'ARN completo.
▬Tipo: stringa
Campo obbligatorio: sì, quando viene usato `secrets`.
`ulimits`
Un elenco di valori `ulimits` da impostare nel container. Questo parametro è mappato a `Ulimits` nella sezione [Create a container](https://docs.docker.com/engine/api/v1.38/#operation/ContainerCreate) di [Docker Remote API](https://docs.docker.com/engine/api/v1.38/) e l'opzione `--ulimit` a [https://docs.docker.com/engine/reference/commandline/run/](https://docs.docker.com/engine/reference/commandline/run/).
```
"ulimits": [
{
"name": {{string}},
"softLimit": {{integer}},
"hardLimit": {{integer}}
}
...
]
```
Tipo: array di oggetti
Campo obbligatorio: no
`name`
`type` di `ulimit`.
▬Tipo: stringa
Campo obbligatorio: sì, quando viene usato `ulimits`.
`hardLimit`
Il limite rigido per il tipo `ulimit`.
Tipo: integer
Campo obbligatorio: sì, quando viene usato `ulimits`.
`softLimit`
Il limite flessibile per il tipo `ulimit`.
Tipo: integer
Campo obbligatorio: sì, quando viene usato `ulimits`.
`user`
Il nome utente per l'utilizzo all'interno del container. Questo parametro è mappato a `User` nella sezione [Create a container](https://docs.docker.com/engine/api/v1.38/#operation/ContainerCreate) di [Docker Remote API](https://docs.docker.com/engine/api/v1.38/) e l'opzione `--user` a [https://docs.docker.com/engine/reference/commandline/run/](https://docs.docker.com/engine/reference/commandline/run/).
```
"user": "{{string}}"
```
▬Tipo: stringa
Campo obbligatorio: no
`vcpus`
*Questo parametro è obsoleto, utilizzalo al suo posto. `resourceRequirements`*
Il numero di v CPUs riservato per il contenitore.
Come esempio di utilizzo`resourceRequirements`, se la definizione del processo contiene righe simili a queste:
```
"containerProperties": {
"vcpus": {{2}}
}
```
Le righe equivalenti utilizzate `resourceRequirements` sono le seguenti.
```
"containerProperties": {
"resourceRequirements": [
{
"type": "VCPU",
"value": "{{2}}"
}
]
}
```
Tipo: integer
Campo obbligatorio: sì
`volumes`
Quando si registra una definizione di processo, è possibile specificare un elenco di volumi da passare al daemon Docker su un'istanza di container. Nelle proprietà del container sono consentiti i seguenti parametri:
```
"volumes": [
{
"name": "{{string}}",
"host": {
"sourcePath": "{{string}}"
},
"efsVolumeConfiguration": {
"authorizationConfig": {
"accessPointId": "{{string}}",
"iam": "{{string}}"
},
"fileSystemId": "{{string}}",
"rootDirectory": "{{string}}",
"transitEncryption": "{{string}}",
"transitEncryptionPort": {{number}}
}
}
]
```
`name`
Nome del volume. Il nome può contenere un massimo di 255 lettere (maiuscole e minuscole), numeri, trattini e caratteri di sottolineatura. Nel parametro `sourceVolume` della definizione del container `mountPoints` viene fatto riferimento a questo nome.
▬Tipo: stringa
Campo obbligatorio: no
`host`
Il contenuto del parametro `host` determina se il volume dati persiste nell'istanza di container host e dove viene archiviato. Se il parametro `host` è vuoto, il daemon Docker assegna automaticamente un percorso dell'host per il volume di dati. Tuttavia, non è garantito che i dati persistano dopo l'interruzione dell'esecuzione del contenitore ad essi associato.
Questo parametro non è applicabile ai processi eseguiti sulle risorse di Fargate.
Tipo: oggetto
Campo obbligatorio: no
`sourcePath`
Il percorso sull'istanza di container dell'host presentato al container. Se questo parametro è vuoto, il daemon Docker assegna automaticamente un percorso host.
Se il parametro `host` contiene una posizione del file `sourcePath`, il volume di dati rimane nella posizione specificata sull'istanza di container dell'host finché non viene eliminato manualmente. Se il valore `sourcePath` non è presente nell'istanza di container host, viene creato automaticamente dal daemon Docker. Se la posizione è presente, i contenuti della cartella del percorso di origine vengono esportati.
▬Tipo: stringa
Campo obbligatorio: no
`efsVolumeConfiguration`
Questo parametro viene specificato quando utilizzi un file system Amazon Elastic File System per l'archiviazione di attività. Per ulteriori informazioni, consulta [Volumi Amazon EFS](efs-volumes.md).
Tipo: oggetto
Campo obbligatorio: no
`authorizationConfig`
I dettagli di configurazione dell'autorizzazione per il file system Amazon EFS.
▬Tipo: stringa
Campo obbligatorio: no
`accessPointId`
L'ID del punto di accesso Amazon EFS da utilizzare. Se viene specificato un punto di accesso, il valore della directory principale specificato in `EFSVolumeConfiguration` deve essere omesso o impostato su. `/` Ciò impone il percorso impostato sul punto di accesso EFS. Se si utilizza un punto di accesso, la crittografia di transito deve essere abilitata in `EFSVolumeConfiguration`. Per ulteriori informazioni, consulta [Utilizzo dei punti di accesso Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html) nella *Guida per l'utente di Amazon Elastic File System*.
▬Tipo: stringa
Campo obbligatorio: no
`iam`
Determina se utilizzare il ruolo IAM del AWS Batch lavoro definito in una definizione di processo durante il montaggio del file system Amazon EFS. Se abilitato, la crittografia di transito deve essere abilitata nella casella `EFSVolumeConfiguration`. Se questo parametro viene omesso, viene utilizzato il comportamento predefinito di `DISABLED`. Per ulteriori informazioni, consulta [Usa i punti di accesso Amazon EFS](efs-volumes.md#efs-volume-accesspoints).
▬Tipo: stringa
Valori validi: `ENABLED` \| `DISABLED`
Campo obbligatorio: no
`fileSystemId`
L'ID del file system Amazon EFS da utilizzare.
▬Tipo: stringa
Campo obbligatorio: no
`rootDirectory`
La directory all'interno del file system Amazon EFS da montare come directory principale all'interno dell'host. Se questo parametro viene omesso, viene utilizzata la radice del volume Amazon EFS. Se lo specifichi`/`, ha lo stesso effetto dell'omissione di questo parametro. La lunghezza massima è 4.096 caratteri.
Se un punto di accesso EFS è specificato in`authorizationConfig`, il parametro della directory principale deve essere omesso o impostato `/` su. Ciò impone il percorso impostato sul punto di accesso Amazon EFS.
▬Tipo: stringa
Campo obbligatorio: no
`transitEncryption`
Indica se abilitare o meno la crittografia per i dati Amazon EFS in transito tra l'host Amazon ECS e il server Amazon EFS. Se si utilizza l'autorizzazione Amazon EFS IAM, è necessario abilitare la crittografia di transito. Se questo parametro viene omesso, viene utilizzato il comportamento predefinito di `DISABLED`. Per ulteriori informazioni, consulta [Crittografia dei dati in transito](https://docs.aws.amazon.com/efs/latest/ug/encryption-in-transit.html) nella *Guida per l'utente di Amazon Elastic File System*.
▬Tipo: stringa
Valori validi: `ENABLED` \| `DISABLED`
Campo obbligatorio: no
`transitEncryptionPort`
La porta da utilizzare per l'invio di dati crittografati tra l'host Amazon ECS e il server Amazon EFS. Se non si specifica una porta di crittografia di transito, verrà utilizzata la strategia di selezione della porta utilizzata dall'helper per il montaggio di Amazon EFS. Il valore deve essere compreso tra 0 e 65.535. Per ulteriori informazioni, consulta [Assistente per il montaggio di EFS](https://docs.aws.amazon.com/efs/latest/ug/efs-mount-helper.html) nella *Guida per l'utente di Amazon Elastic File System*.
Tipo: integer
Campo obbligatorio: no
## Proprietà Amazon EKS
Un oggetto con varie proprietà specifiche dei processi basati su Amazon ECS. Questo non deve essere specificato per le definizioni dei job basate su Amazon ECS.
`podProperties`
Le proprietà delle risorse del Kubernetes pod di un lavoro.
Tipo: oggetto [EksPodProperties](https://docs.aws.amazon.com/batch/latest/APIReference/API_EksPodProperties.html)
Campo obbligatorio: no
`containers`
Le proprietà del container utilizzato nel pod Amazon EKS.
Tipo: oggetto [EksContainer](https://docs.aws.amazon.com/batch/latest/APIReference/API_EksContainer.html)
Campo obbligatorio: no
`args`
Un array di argomenti per il punto di ingresso. Se non è specificato, viene utilizzato il `CMD` dell’immagine del container. Corrisponde al `args` membro nella parte [Entrypoint](https://kubernetes.io/docs/reference/kubernetes-api/workload-resources/pod-v1/#entrypoint) del [Pod](https://kubernetes.io/docs/reference/kubernetes-api/workload-resources/pod-v1/) in. Kubernetes I riferimenti alle variabili di ambiente vengono espansi utilizzando l'ambiente del container.
Se la variabile di ambiente a cui si fa riferimento non esiste, il riferimento nel comando non viene modificato. Ad esempio, se il riferimento è a "`$(NAME1)`" e la variabile di ambiente `NAME1` non esiste, la stringa del comando rimarrà "`$(NAME1)`". `$$` viene sostituito con `$` e la stringa risultante non viene espansa. Ad esempio, `$$(VAR_NAME)` viene passato come `$(VAR_NAME)` a prescindere dall’esistenza della variabile di ambiente `VAR_NAME`. *Per ulteriori informazioni, vedete [CMD](https://docs.docker.com/engine/reference/builder/#cmd) nel *riferimento a Dockerfile* e [Definire un comando e argomenti per un](https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/) pod nella documentazione. Kubernetes*
Tipo: matrice di stringhe
Campo obbligatorio: no
`command`
Il punto di ingresso per il container. Non viene eseguito in una shell (interprete di comandi). Se non è specificato, viene utilizzato il `ENTRYPOINT` dell’immagine del container. I riferimenti alle variabili di ambiente vengono espansi utilizzando l'ambiente del container.
Se la variabile di ambiente a cui si fa riferimento non esiste, il riferimento nel comando non viene modificato. Ad esempio, se il riferimento è a "`$(NAME1)`" e la variabile di ambiente `NAME1` non esiste, la stringa del comando rimarrà "`$(NAME1)`". `$$` viene sostituito con `$` e la stringa risultante non viene espansa. Ad esempio, `$$(VAR_NAME)` verrà passato come `$(VAR_NAME)` a prescindere dall’esistenza della variabile di ambiente `VAR_NAME`. Il punto di ingresso non può essere aggiornato. [https://kubernetes.io/docs/reference/kubernetes-api/workload-resources/pod-v1/#entrypoint](https://kubernetes.io/docs/reference/kubernetes-api/workload-resources/pod-v1/#entrypoint)
Tipo: matrice di stringhe
Campo obbligatorio: no
`env`
Le variabili di ambiente da passare a un container.
Le variabili di ambiente non possono iniziare con "`AWS_BATCH`". Questa convenzione di denominazione è riservata alle variabili che impostano. AWS Batch
Tipo: matrice di oggetti [EksContainerEnvironmentVariable](https://docs.aws.amazon.com/batch/latest/APIReference/API_EksContainerEnvironmentVariable.html)
Campo obbligatorio: no
`name`
Il nome della variabile di ambiente.
Tipo: stringa
Campo obbligatorio: sì
`value`
Il valore della variabile di ambiente.
▬Tipo: stringa
Campo obbligatorio: no
`image`
L'immagine Docker utilizzata per avviare il container.
Tipo: stringa
Campo obbligatorio: sì
`imagePullPolicy`
La policy di estrazione immagini per il container. I valori supportati sono `Always`, `IfNotPresent` e `Never`. Questo parametro per impostazione predefinita è `IfNotPresent`. Tuttavia, se è specificato il tag `:latest`, viene ripristinata l’impostazione predefinita `Always`. Per ulteriori informazioni, consulta [Aggiornamento delle immagini](https://kubernetes.io/docs/concepts/containers/images/#updating-images) nella *Kubernetesdocumentazione*.
▬Tipo: stringa
Campo obbligatorio: no
`name`
Il nome del container. Se il nome non è specificato, viene utilizzato il nome predefinito, "`Default`". Ogni container in un pod deve avere un nome univoco.
▬Tipo: stringa
Campo obbligatorio: no
`resources`
Il tipo e la quantità di risorse da assegnare a un container. Le risorse supportate includono `memory`, `cpu` e `nvidia.com/gpu`. Per ulteriori informazioni, consulta [Gestione delle risorse per pod e contenitori](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/) nella *Kubernetesdocumentazione*.
Tipo: oggetto [EksContainerResourceRequirements](https://docs.aws.amazon.com/batch/latest/APIReference/API_EksContainerResourceRequirements.html)
Campo obbligatorio: no
`limits`
Il tipo e la quantità di risorse specificate da prenotare per il container. I valori variano in base al `name` specificato. Le risorse possono essere chieste utilizzando oggetti `limits` o `requests`.
memory
Il limite rigido di memoria (in MiB) per il container, espresso in numeri interi con il suffisso "Mi". Se il container prova a superare la memoria qui specificata, sarà terminato. Devi specificare almeno 4 MiB di memoria per un processo. La `memory` può essere specificata in `limits` e/o `requests`. Se la `memory` è specificata in entrambi, il valore specificato in `limits` deve essere uguale al valore specificato in `requests`.
Per ottimizzare l'utilizzo delle risorse, fornisci ai processi quanta più memoria possibile per il tipo di istanza specifica in uso. Per scoprire come, consulta [Gestione della memoria delle risorse di calcolo](memory-management.md).
cpu
Il numero di CPUs questo è riservato al contenitore. I valori devono essere un multiplo pari di `0.25`. La `cpu` può essere specificata in `limits` e/o `requests`. Se la `cpu` è specificata in entrambi, il valore specificato in `limits` deve essere almeno pari al valore specificato in `requests`.
nvidia.com/gpu
Il numero di GPUs quello è riservato al contenitore. I valori devono essere un numero intero. La `memory` può essere specificata in `limits` e/o `requests`. Se la `memory` è specificata in entrambi, il valore specificato in `limits` deve essere uguale al valore specificato in `requests`.
Tipo: mappatura stringa a stringa
Valore dei vincoli di lunghezza: lunghezza minima di 1. La lunghezza massima è 256 caratteri.
Campo obbligatorio: no
`requests`
Il tipo e la quantità di risorse specificate da chiedere per il container. I valori variano in base al `name` specificato. Le risorse possono essere chieste utilizzando oggetti `limits` o `requests`.
memory
Il limite rigido di memoria (in MiB) per il container, espresso in numeri interi con il suffisso "Mi". Se il container prova a superare la memoria qui specificata, sarà terminato. Devi specificare almeno 4 MiB di memoria per un processo. La `memory` può essere specificata in `limits` e/o `requests`. Se la `memory` è specificata in entrambi, il valore specificato in `limits` deve essere uguale al valore specificato in `requests`.
Se stai cercando di massimizzare l'utilizzo delle risorse fornendo ai job quanta più memoria possibile per un particolare tipo di istanza, consulta. [Gestione della memoria delle risorse di calcolo](memory-management.md)
cpu
Il numero di questi CPUs è riservato al contenitore. I valori devono essere un multiplo pari di `0.25`. La `cpu` può essere specificata in `limits` e/o `requests`. Se la `cpu` è specificata in entrambi, il valore specificato in `limits` deve essere uguale al valore specificato in `requests`.
nvidia.com/gpu
Il numero di GPUs quelli è riservato al contenitore. I valori devono essere un numero intero. La `nvidia.com/gpu` può essere specificata in `limits` e/o `requests`. Se la `nvidia.com/gpu` è specificata in entrambi, il valore specificato in `limits` deve essere uguale al valore specificato in `requests`.
Tipo: mappatura stringa a stringa
Valore dei vincoli di lunghezza: lunghezza minima di 1. La lunghezza massima è 256 caratteri.
Campo obbligatorio: no
`securityContext`
Il contesto di sicurezza per un processo. Per ulteriori informazioni, consulta [Configurare un contesto di sicurezza per un pod o un contenitore](https://kubernetes.io/docs/tasks/configure-pod-container/security-context/) nella *Kubernetesdocumentazione*.
Tipo: oggetto [EksContainerSecurityContext](https://docs.aws.amazon.com/batch/latest/APIReference/API_EksContainerSecurityContext.html)
Campo obbligatorio: no
`privileged`
Quando questo parametro è `true`, al container sono assegnate autorizzazioni elevati nell'istanza di container host. Il livello delle autorizzazioni è simile alle autorizzazioni degli `root` utenti. Il valore predefinito è `false`. *Questo parametro corrisponde alle `privileged` politiche di [sicurezza del pod Privileged nella documentazione](https://kubernetes.io/docs/concepts/security/pod-security-policy/#privileged). Kubernetes*
Tipo: Booleano
Campo obbligatorio: no
`readOnlyRootFilesystem`
Quando questo parametro è `true`, al container viene assegnato l'accesso in sola lettura al file system root. Il valore predefinito è `false`. Questo parametro corrisponde alle `ReadOnlyRootFilesystem` politiche di [sicurezza del pod Volumes and file system](https://kubernetes.io/docs/concepts/security/pod-security-policy/#volumes-and-file-systems) presenti nella *Kubernetesdocumentazione*.
Tipo: Booleano
Campo obbligatorio: no
`runAsGroup`
Quando questo parametro è specificato, il container viene eseguito come ID gruppo specificato (`gid`). Se questo parametro non è specificato, l’impostazione predefinita è il gruppo specificato nei medatati dell’immagine. Questo parametro corrisponde alle `RunAsGroup` `MustRunAs` politiche di [sicurezza del pod Utenti e gruppi](https://kubernetes.io/docs/concepts/security/pod-security-policy/#users-and-groups) presenti nella *Kubernetesdocumentazione*.
Tipo: long
Campo obbligatorio: no
`runAsNonRoot`
Quando questo parametro è specificato, il container viene eseguito come utente con un `uid` diverso da 0. Se questo parametro non è specificato, viene applicata tale regola. Questo parametro corrisponde alle `RunAsUser` `MustRunAsNonRoot` politiche di [sicurezza del pod Utenti e gruppi](https://kubernetes.io/docs/concepts/security/pod-security-policy/#users-and-groups) presenti nella *Kubernetesdocumentazione*.
Tipo: long
Campo obbligatorio: no
`runAsUser`
Quando questo parametro è specificato, il container viene eseguito come ID utente specificato (`uid`). Se questo parametro non è specificato, l’impostazione predefinita è l’utente specificato nei medatati dell’immagine. Questo parametro corrisponde alle `RunAsUser` `MustRanAs` politiche di [sicurezza del pod Utenti e gruppi](https://kubernetes.io/docs/concepts/security/pod-security-policy/#users-and-groups) presenti nella *Kubernetesdocumentazione*.
Tipo: long
Campo obbligatorio: no
`volumeMounts`
Il volume viene montato per un container per un processo Amazon EKS. Per ulteriori informazioni sui volumi e sui montaggi dei volumi inKubernetes, consulta [Volumes](https://kubernetes.io/docs/concepts/storage/volumes/) nella *Kubernetesdocumentazione*.
Tipo: matrice di oggetti [EksContainerVolumeMount](https://docs.aws.amazon.com/batch/latest/APIReference/API_EksContainerVolumeMount.html)
Campo obbligatorio: no
`mountPath`
Il percorso sul container in cui è montato il volume.
▬Tipo: stringa
Campo obbligatorio: no
`name`
Il nome del montaggio del volume. Deve corrispondere al nome di uno dei volumi nel pod.
▬Tipo: stringa
Campo obbligatorio: no
`readOnly`
Se il valore è `true`, il container avrà accesso in sola lettura al volume. In caso contrario, il container può scrivere sul volume. Il valore predefinito è `false`.
Tipo: Booleano
Campo obbligatorio: no
`dnsPolicy`
La policy DNS per il pod. Il valore predefinito è `ClusterFirst`. Se il parametro `hostNetwork` non è specificato, l’impostazione predefinita è `ClusterFirstWithHostNet`. `ClusterFirst` indica che qualunque query DNS non corrispondente al suffisso del dominio del cluster configurato viene inoltrata al server nomi upstream ereditato dal nodo. Se non è stato specificato alcun valore per `dnsPolicy` l'operazione [RegisterJobDefinition](https://docs.aws.amazon.com/batch/latest/APIReference/API_RegisterJobDefinition.html)API, non viene restituito alcun valore `dnsPolicy` da nessuna delle [DescribeJobDefinitions](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobDefinitions.html)operazioni [DescribeJobs](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeJobs.html)API. L'impostazione delle specifiche del pod conterrà `ClusterFirst` o `ClusterFirstWithHostNet`, a seconda del valore del parametro `hostNetwork`. Per ulteriori informazioni, consulta la [politica DNS di Pod](https://kubernetes.io/docs/concepts/services-networking/dns-pod-service/#pod-s-dns-policy) nella *Kubernetesdocumentazione*.
Valori validi: `Default` \| `ClusterFirst` \| `ClusterFirstWithHostNet`
▬Tipo: stringa
Campo obbligatorio: no
`hostNetwork`
Indica se il pod utilizza l'indirizzo IP di rete degli host. Il valore predefinito è `true`. L'impostazione di questa opzione `false` abilita il modello di rete Kubernetes pod. La maggior parte dei AWS Batch carichi di lavoro è di sola uscita e non richiede il sovraccarico dell'allocazione IP per ogni pod per le connessioni in ingresso. [https://kubernetes.io/docs/concepts/workloads/pods/#pod-networking](https://kubernetes.io/docs/concepts/workloads/pods/#pod-networking)
Tipo: Booleano
Campo obbligatorio: no
`serviceAccountName`
Il nome dell’account di servizio utilizzato per l’esecuzione del pod. Per ulteriori informazioni, consulta [Account di Kubernetes servizio](https://docs.aws.amazon.com/eks/latest/userguide/service-accounts.html) e [Configurazione di un account di Kubernetes servizio per assumere un ruolo IAM](https://docs.aws.amazon.com/eks/latest/userguide/associate-service-account-role.html) nella *Amazon EKS User Guide* e [Configurare gli account di servizio per i pod](https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/) nella *Kubernetesdocumentazione*.
▬Tipo: stringa
Campo obbligatorio: no
`volumes`
Specifica i volumi per una definizione di processo che utilizza risorse Amazon EKS.
Tipo: matrice di oggetti [EksVolume](https://docs.aws.amazon.com/batch/latest/APIReference/API_EksVolume.html)
Campo obbligatorio: no
EmptyDir
Specifica la configurazione di un volume. Kubernetes `emptyDir` Un volume `emptyDir` viene creato per la prima volta quando un pod viene assegnato a un nodo. Esiste finché il pod funziona su quel nodo. Il volume `emptyDir` inizialmente è vuoto. Tutti i container nel pod possono leggere e scrivere i file nel volume `emptyDir`. Il volume `emptyDir`,tuttavia, può essere montato sullo stesso percorso o su percorsi diversi in ogni container. Quando un pod viene rimosso da un nodo per un motivo qualunque, i dati nella `emptyDir` vengono eliminati definitivamente. *Per ulteriori informazioni, consulta [EmptyDir nella documentazione.](https://kubernetes.io/docs/concepts/storage/volumes/#emptydir) Kubernetes*
Tipo: oggetto [EksEmptyDir](https://docs.aws.amazon.com/batch/latest/APIReference/API_EksEmptyDir.html)
Campo obbligatorio: no
medium
Il supporto per memorizzare il volume. Il valore predefinito è una stringa vuota, che utilizza la memoria del nodo.
""
**(Impostazione predefinita)** Utilizza la memoria su disco del nodo.
"Memory"
Usa il volume `tmpfs` supportato dalla RAM del nodo. I contenuti del volume vengono persi al riavvio del nodo e tutta la memoria sul volume viene conteggiata in base al limite di memoria del container.
▬Tipo: stringa
Campo obbligatorio: no
SizeLimit
La dimensione massima del volume. Per impostazione predefinita, non è definita alcuna dimensione massima.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Campo obbligatorio: no
Percorso dell'host
Specifica la configurazione di un Kubernetes `hostPath` volume. Un volume `hostPath` monta un file o una directory esistente dal file system del nodo host nel pod. *Per ulteriori informazioni, vedete [HostPath](https://kubernetes.io/docs/concepts/storage/volumes/#hostpath) nella Kubernetes documentazione.*
Tipo: oggetto [EksHostPath](https://docs.aws.amazon.com/batch/latest/APIReference/API_EksHostPath.html)
Campo obbligatorio: no
*path*
Il percorso del file o della directory sull'host da montare in container nel pod.
▬Tipo: stringa
Campo obbligatorio: no
nome
Nome del volume. Il nome deve essere consentito come nome sottodominio DNS. *Per ulteriori informazioni, consulta i [nomi dei sottodomini DNS nella documentazione](https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#dns-subdomain-names). Kubernetes*
Tipo: stringa
Campo obbligatorio: sì
Secret
Specifica la configurazione di un volume. Kubernetes `secret` Per ulteriori informazioni, vedere [secret](https://kubernetes.io/docs/concepts/storage/volumes/#secret) nella *Kubernetesdocumentazione*.
Tipo: oggetto [EksSecret](https://docs.aws.amazon.com/batch/latest/APIReference/API_EksSecret.html)
Campo obbligatorio: no
facoltativo
Speciifica se è necessario definire il segreto o le chiavi del segreto.
Tipo: Booleano
Campo obbligatorio: no
NomeSegreto
Il nome del segreto. Il nome deve essere consentito come nome sottodominio DNS. *Per ulteriori informazioni, consulta i [nomi dei sottodomini DNS nella documentazione](https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#dns-subdomain-names). Kubernetes*
Tipo: stringa
Campo obbligatorio: sì
## Funzionalità della piattaforma
`platformCapabilities`
Le funzionalità della piattaforma richieste dalla definizione del processo. Se non viene specificato alcun valore, il valore predefinito è `EC2`. Per i lavori eseguiti su risorse Fargate, `FARGATE` è specificato.
Se il job viene eseguito su risorse Amazon EKS, non devi specificare`platformCapabilities`.
▬Tipo: stringa
Valori validi: `EC2` \| `FARGATE`
Campo obbligatorio: no
## Propaga i tag
`propagateTags`
Specifica se propagare i tag dal processo o dalla definizione del processo all'attività Amazon ECS corrispondente. Se non viene specificato alcun valore, i tag non vengono propagati. I tag possono essere propagati alle attività solo al momento della creazione dell'attività. Per i tag con lo stesso nome, viene data la priorità ai tag di processo anziché ai tag delle definizioni di processo. Se il numero totale di tag combinati del processo e della definizione del processo è superiore a 50, il lavoro viene `FAILED` spostato nello stato.
Se il job viene eseguito su risorse Amazon EKS, non devi specificare`propagateTags`.
Tipo: Booleano
Campo obbligatorio: no
## Proprietà del nodo
`nodeProperties`
Quando si registra una definizione di processo parallelo multinodo, è necessario specificare un elenco di proprietà del nodo. Queste proprietà del nodo definiscono il numero di nodi da utilizzare nel job, l'indice del nodo principale e i diversi intervalli di nodi da utilizzare. Se il lavoro viene eseguito su risorse Fargate, non è possibile specificare. `nodeProperties` Utilizza invece `containerProperties`. Di seguito sono indicate le proprietà del nodo consentite in una definizione di processo. Per ulteriori informazioni, consulta [Multi-node lavori paralleli](multi-node-parallel-jobs.md).
Se il job viene eseguito su risorse Amazon EKS, non devi specificare`nodeProperties`.
Tipo: oggetto [NodeProperties](https://docs.aws.amazon.com/batch/latest/APIReference/API_NodeProperties.html)
Campo obbligatorio: no
`mainNode`
Specifica l'indice del nodo per il nodo principale di un processo parallelo a più nodi. Il valore dell'indice del nodo deve essere inferiore al numero di nodi.
Tipo: integer
Campo obbligatorio: sì
`numNodes`
Il numero di nodi associati a un processo parallelo multinodo.
Tipo: integer
Campo obbligatorio: sì
`nodeRangeProperties`
Un elenco di intervalli di nodi e le relative proprietà associate a un processo parallelo multinodo.
Un gruppo di nodi è un gruppo identico di nodi di processi che condividono tutti le stesse proprietà del container. È possibile utilizzare AWS Batch per specificare fino a cinque gruppi di nodi distinti per ogni job.
Tipo: matrice di oggetti [NodeRangeProperty](https://docs.aws.amazon.com/batch/latest/APIReference/API_NodeRangeProperty.html)
Campo obbligatorio: sì
`targetNodes`
L'intervallo di nodi, utilizzando i valori di indice del nodo. Un intervallo di `0:3` indica i nodi con i valori di indice compresi tra `0` e `3`. Se il valore dell'intervallo iniziale viene omesso (`:n`), viene utilizzato 0 per iniziare l'intervallo. Se il valore di chiusura dell'intervallo (`n:`) viene omesso, viene utilizzato l'indice di nodo più alto possibile per chiudere l'intervallo. Gli intervalli di nodo cumulativi devono comprendere tutti i nodi (`0:n`). È possibile annidare intervalli di nodi, ad esempio `0:10` e`4:5`. In questo caso, le proprietà dell'`4:5`intervallo hanno la precedenza sulle `0:10` proprietà.
▬Tipo: stringa
Campo obbligatorio: no
`container`
I dettagli del container per l'intervallo di nodo. Per ulteriori informazioni, consulta [Proprietà del contenitore](#containerProperties).
Tipo: oggetto [ContainerProperties](https://docs.aws.amazon.com/batch/latest/APIReference/API_ContainerProperties.html)
Campo obbligatorio: no
## Strategia per nuovi tentativi
`retryStrategy`
Quando si registra una definizione di processo, è possibile specificare una strategia per il numero di tentativi da utilizzare per i processi non riusciti inviati con questa definizione di processo. Qualsiasi strategia di nuovo tentativo specificata durante un'[SubmitJob](https://docs.aws.amazon.com/batch/latest/APIReference/API_SubmitJob.html)operazione ha la precedenza sulla strategia di nuovo tentativo definita qui. Per impostazione predefinita, ogni processo viene tentato una sola volta. Se si specifica più di un tentativo, il processo viene ritentato se fallisce. Esempi di tentativo fallito includono il processo che restituisce un codice di uscita diverso da zero o l'istanza del contenitore viene terminata. Per ulteriori informazioni, consulta [Ritentativi di lavoro automatizzati](job_retries.md).
Tipo: oggetto [RetryStrategy](https://docs.aws.amazon.com/batch/latest/APIReference/API_RetryStrategy.html)
Campo obbligatorio: no
`attempts`
Il numero di volte per cui spostare un processo nello stato `RUNNABLE`. Puoi specificare da 1 a 10 tentativi. Se il valore di `attempts` è maggiore di uno, in caso di errore il processo viene ritentato il numero di volte specificato, fino a quando viene spostato in `RUNNABLE`.
```
"attempts": {{integer}}
```
Tipo: integer
Campo obbligatorio: no
`evaluateOnExit`
Matrice di un massimo di 5 oggetti che specificano le condizioni in base alle quali il processo viene riprovato o fallito. Se viene specificato questo parametro, è necessario specificare anche il parametro `attempts`. Se `evaluateOnExit` viene specificato ma nessuna delle voci corrisponde, il processo viene ritentato.
```
"evaluateOnExit": [
{
"action": "{{string}}",
"onExitCode": "{{string}}",
"onReason": "{{string}}",
"onStatusReason": "{{string}}"
}
]
```
Tipo: matrice di oggetti [EvaluateOnExit](https://docs.aws.amazon.com/batch/latest/APIReference/API_EvaluateOnExit.html)
Campo obbligatorio: no
`action`
Specifica l'azione da eseguire se vengono soddisfatte tutte le condizioni specificate (`onStatusReason`, `onReason` e `onExitCode`). I valori non fanno distinzione tra maiuscole e minuscole.
Tipo: stringa
Campo obbligatorio: sì
Valori validi: `RETRY` \| `EXIT`
`onExitCode`
Contiene uno schema a globo da confrontare con la rappresentazione decimale di `ExitCode` ciò che viene restituito per un lavoro. Il modello può contenere fino a 512 caratteri. Può contenere solo numeri. Non può contenere lettere o caratteri speciali. Facoltativamente può terminare con un asterisco (\*) in modo che solo l'inizio della stringa debba essere una corrispondenza esatta.
▬Tipo: stringa
Campo obbligatorio: no
`onReason`
Contiene uno schema a globo da confrontare con `Reason` quello restituito per un lavoro. Il modello può contenere fino a 512 caratteri. Può contenere lettere, numeri, punti (.), due punti (:) e spazi bianchi (spazi, tabulazioni). Facoltativamente può terminare con un asterisco (\*) in modo che solo l'inizio della stringa debba essere una corrispondenza esatta.
▬Tipo: stringa
Campo obbligatorio: no
`onStatusReason`
Contiene uno schema a globo da confrontare con `StatusReason` quello restituito per un lavoro. Il modello può contenere fino a 512 caratteri. Può contenere lettere, numeri, punti (.), due punti (:) e spazi bianchi (spazi, tabulazioni). Facoltativamente può terminare con un asterisco (\*) in modo che solo l'inizio della stringa debba essere una corrispondenza esatta.
▬Tipo: stringa
Campo obbligatorio: no
## Priorità di pianificazione
`schedulingPriority`
La priorità di pianificazione per i lavori inviati con questa definizione di processo. Ciò riguarda solo i lavori in coda di lavoro con una politica di equa ripartizione. I processi con una priorità di pianificazione più alta vengono pianificati prima dei lavori con una priorità di pianificazione inferiore.
Il valore minimo supportato è 0 e il valore massimo supportato è 9999.
Tipo: integer
Campo obbligatorio: no
## Tag
`tags`
Tag di coppia chiave-valore da associare alla definizione del processo. Per ulteriori informazioni, consulta [Tagga le tue AWS Batch risorse](using-tags.md).
Tipo: mappatura stringa a stringa
Campo obbligatorio: no
## Timeout
`timeout`
È possibile configurare una durata di timeout per i processi in modo che, se un lavoro dura più a lungo, lo AWS Batch interrompa. Per ulteriori informazioni, consulta [Job timeout](job_timeouts.md). Se un lavoro viene interrotto a causa di un timeout, non viene ritentato. Qualsiasi configurazione di timeout specificata durante un'[SubmitJob](https://docs.aws.amazon.com/batch/latest/APIReference/API_SubmitJob.html)operazione ha la precedenza sulla configurazione di timeout definita qui. Per ulteriori informazioni, consulta [Job timeout](job_timeouts.md).
Tipo: oggetto [JobTimeout](https://docs.aws.amazon.com/batch/latest/APIReference/API_JobTimeout.html)
Campo obbligatorio: no
`attemptDurationSeconds`
La durata in secondi (misurata in base al `startedAt` timestamp del tentativo di lavoro) dopo la fine dei lavori non completati. AWS Batch Il valore minimo per il timeout è 60 secondi.
Per i processi dell'array, il timeout si applica ai processi figlio, non al processo dell'array padre.
Per processi paralleli multinodo (MNP), il timeout si applica all'intero processo, non ai singoli nodi.
Tipo: integer
Campo obbligatorio: no