Parametri di definizione del lavoro per ContainerProperties

Quando si registra una definizione di processo, è necessario specificare un nome, Il nome può contenere fino a 128 caratteri. Deve contenere lettere maiuscole e minuscole, numeri, trattini (-) e caratteri di sottolineatura (_). Alla prima definizione di lavoro registrata con quel nome viene assegnata una revisione di 1. Tutte le successive definizioni del processo registrate con tale nome vengono contrassegnate con un numero di revisione incrementale.

Tipo: stringa

Obbligatorio: sì

Quando si registra una definizione di processo, è necessario specificare il tipo di processo. Se il lavoro viene eseguito con risorse Fargate, multinode non è supportato. Per ulteriori informazioni sui processi in parallelo a più nodi, consulta Creare una definizione di processo parallelo multinodo.

Tipo: String

Valori validi: container | multinode

Obbligatorio: sì

Quando invii un lavoro, puoi specificare parametri che sostituiscono i segnaposto o sovrascrivono 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 lavoro 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

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'parametersoggetto nella definizione del lavoro per impostare i 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::codecargomento nel comando relativo al contenitore viene sostituito con il valore predefinito,. mp4

Il comando che viene inviato al container. Questo parametro è mappato a Cmd nella sezione Crea un container dell'API remota Docker e al parametro COMMAND di docker run. Per ulteriori informazioni sul CMD parametro Docker, vedere #cmd. https://docs.docker.com/engine/reference/builder/

"command": ["string", ...]

Tipo: array di stringhe

Obbligatorio: no

Le variabili di ambiente da passare a un container. Questo parametro è mappato a Env nella sezione Create a container di Docker Remote API e l'opzione --env a docker run.

Tipo: array di coppie chiave-valore

Obbligatorio: no

"environment" : [
    { "name" : "envName1", "value" : "envValue1" },
    { "name" : "envName2", "value" : "envValue2" }
]

Quando registri una definizione di lavoro, puoi specificare un ruolo IAM. Il ruolo fornisce all'agente container Amazon ECS le autorizzazioni per chiamare le azioni API specificate nelle politiche associate per tuo conto. I job eseguiti su risorse Fargate devono fornire un ruolo di esecuzione. Per ulteriori informazioni, consulta AWS Batch Ruolo di esecuzione IAM.

▬Tipo: stringa

Obbligatorio: no

La configurazione della piattaforma per i lavori eseguiti sulle risorse Fargate. I processi in esecuzione su risorse EC2 non devono specificare questo parametro.

Tipo: oggetto FargatePlatformConfiguration

Obbligatorio: no

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 dell'API remota Docker e al parametro IMAGE di docker run.

Tipo: stringa

Obbligatorio: sì

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 lavori in container a nodo singolo o per i lavori eseguiti su risorse Fargate.

▬Tipo: stringa

Obbligatorio: no

Quando registri una definizione di job, 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à nella Guida per sviluppatori di Amazon Elastic Container Service.

▬Tipo: stringa

Obbligatorio: no

Linux-specific modifiche applicate al contenitore, 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

Obbligatorio: no

La specifica di configurazione del registro per il lavoro.

Questo parametro è mappato a LogConfig nella sezione Crea un container di API Docker Remote e l'opzione --log-driver a docker 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 rispetto al 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 log deve essere configurato sull'istanza del contenitore o su un altro server di log per fornire opzioni di registrazione remota. Per ulteriori informazioni sulle opzioni per diversi driver di log supportati, consulta Configure logging drivers (Configurazione dei driver di log) nella documentazione di Docker.

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

Obbligatorio: no

Questo parametro è obsoleto, utilizzalo invece. resourceRequirements

Il numero di MiB di memoria riservati per il lavoro.

Ad esempioresourceRequirements, se la definizione del lavoro contiene una sintassi simile alla seguente.

"containerProperties": {
  "memory": 512
}

La sintassi equivalente utilizzata resourceRequirements è la seguente.

"containerProperties": {
  "resourceRequirements": [
    {
      "type": "MEMORY",
      "value": "512"
    }
  ]
}

Tipo: numero intero

Obbligatorio: sì

I punti di montaggio per i volumi di dati nel container. Questo parametro è mappato a Volumes nella sezione Create a container di Docker Remote API e l'opzione --volume a docker run.

"mountPoints": [
                {
                  "sourceVolume": "string",
                  "containerPath": "string",
                  "readOnly": true|false
                }
              ]

Tipo: array di oggetti

Obbligatorio: no

La configurazione di rete per i job eseguiti sulle risorse Fargate. I processi in esecuzione su risorse EC2 non devono specificare questo parametro.

"networkConfiguration": { 
   "assignPublicIp": "string"
}

Tipo: array di oggetti

Obbligatorio: no

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 di Docker Remote API e l'opzione --privileged a docker run. Questo parametro non è applicabile ai processi in esecuzione su risorse Fargate. Non fornirlo né specificarlo come falso.

"privileged": true|false

Tipo: Booleano

Obbligatorio: no

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 di Docker Remote API e l'opzione --read-only a docker run.

"readonlyRootFilesystem": true|false

Tipo: Booleano

Obbligatorio: no

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

Obbligatorio: no

I segreti del lavoro che vengono esposti come variabili di ambiente. Per ulteriori informazioni, consulta Specificare dati sensibili.

"secrets": [
    {
      "name": "secretName1",
      "valueFrom": "secretArn1"
    },
    {
      "name": "secretName2",
      "valueFrom": "secretArn2"
    }
    ...
]

Tipo: array di oggetti

Obbligatorio: no

Un elenco di valori ulimits da impostare nel container. Questo parametro è mappato a Ulimits nella sezione Create a container di Docker Remote API e l'opzione --ulimit a docker run.

"ulimits": [
  {
    "name": string,
    "softLimit": integer,
    "hardLimit": integer
  }
  ...
]

Tipo: array di oggetti

Obbligatorio: no

Il nome utente per l'utilizzo all'interno del container. Questo parametro è mappato a User nella sezione Create a container di Docker Remote API e l'opzione --user a docker run.

"user": "string"

▬Tipo: stringa

Obbligatorio: no

Questo parametro è obsoleto, utilizzalo invece. resourceRequirements

Il numero di vCPU prenotate per il container.

Ad esempioresourceRequirements, se la definizione del lavoro contiene righe simili a questa:

"containerProperties": {
  "vcpus": 2
}

Le righe equivalenti utilizzate resourceRequirements sono le seguenti.

"containerProperties": {
  "resourceRequirements": [
    {
      "type": "VCPU",
      "value": "2"
    }
  ]
}

Tipo: numero intero

Obbligatorio: sì

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
    }
  }
]

Le proprietà delle risorse Kubernetes pod di un job.

Tipo: oggetto EksPodProperties

Obbligatorio: no

Le funzionalità della piattaforma richieste dalla definizione del lavoro. Se non viene specificato alcun valore, il valore predefinito è EC2. Per i lavori eseguiti su risorse Fargate, FARGATE è specificato.

Tipo: String

Valori validi: EC2 | FARGATE

Obbligatorio: no

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 quando l'attività viene creata. 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 tra lavoro e definizione del lavoro è superiore a 50, il lavoro viene FAILED spostato nello stato.

Tipo: Booleano

Obbligatorio: no

Quando si registra una definizione di job parallelo multinodo, è necessario specificare un elenco di proprietà del nodo. Queste proprietà dei nodi definiscono il numero di nodi da utilizzare nel job, l'indice del nodo principale e i diversi intervalli di nodi da utilizzare. Se il job viene eseguito su risorse Fargate, non è possibile specificarlonodeProperties. 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.

Tipo: oggetto NodeProperties

Obbligatorio: no

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 riprova specificata durante un'SubmitJoboperazione ha la precedenza sulla strategia di riprova definita qui. Per impostazione predefinita, ogni processo viene tentato una sola volta. Se si specifica più di un tentativo, il processo viene ritentato in caso di esito negativo. Alcuni esempi di tentativo fallito includono che il job restituisce un codice di uscita diverso da zero o che l'istanza del contenitore viene terminata. Per ulteriori informazioni, consulta Ritentativi automatici del lavoro.

Tipo: oggetto RetryStrategy

Obbligatorio: no

La priorità di pianificazione per le commesse inviate con questa definizione di mansione. Ciò riguarda solo i lavori in coda di lavoro con una politica di condivisione equa. 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

Obbligatorio: no

Key-value tag di coppia da associare alla definizione del lavoro. Per ulteriori informazioni, consulta Tagga le tue AWS Batch risorse.

Tipo: mappatura stringa a stringa

Obbligatorio: no

È possibile configurare una durata di timeout per i processi in modo che, se un processo viene eseguito più a lungo, AWS Batch lo interrompa. Per ulteriori informazioni, consulta Timeout dei processi. Se un processo viene terminato a causa di un timeout, non viene riprovato. Qualsiasi configurazione di timeout specificata durante un'SubmitJoboperazione sovrascrive la configurazione di timeout definita qui. Per ulteriori informazioni, consulta Timeout dei processi.

Tipo: oggetto JobTimeout

Obbligatorio: no