Parametri di definizione dell'attività di Amazon ECS per istanze gestite da Amazon ECS

Tipo: stringa

Campo obbligatorio: sì

Quando registri una definizione di attività, le assegni una famiglia, ovvero una sorta di nome per più versioni della definizione di attività, specificando un numero di revisione. Alla prima definizione di attività registrata in una determinata famiglia viene assegnato il numero di revisione 1 e a qualsiasi definizione di attività registrata successivamente viene assegnato un numero di revisione sequenziale.

Tipo: array di stringhe

Campo obbligatorio: no

Valori validi: MANAGED_INSTANCES

La capacità per la quale è stata convalidata la definizione di attività. In questo modo viene avviato un controllo per garantire che tutti i parametri utilizzati nella definizione di attività soddisfino i requisiti per Istanze gestite da Amazon ECS.

▬Tipo: stringa

Campo obbligatorio: no

Quando registri una definizione di attività, puoi fornire un ruolo di attività per un ruolo IAM che consenta ai contenitori inclusi nell'attività di chiamare per tuo conto i dati specificati nelle politiche associate. AWS APIs Per ulteriori informazioni, consulta Ruolo IAM dell'attività Amazon ECS.

▬Tipo: stringa

Obbligatorio: condizionale

L'Amazon Resource Name (ARN) del ruolo di esecuzione dell'attività che concede all'agente container Amazon ECS l'autorizzazione a effettuare chiamate AWS API per tuo conto. Per ulteriori informazioni, consulta Ruolo IAM di esecuzione di attività Amazon ECS.

▬Tipo: stringa

Campo obbligatorio: no

Impostazione predefinita: awsvpc

La modalità di rete da utilizzare per i contenitori coinvolti nell'operazione. Per le attività Amazon ECS ospitate su Istanze gestite Amazon ECS, i valori validi sono awsvpc e host. Se non viene specificata alcuna modalità di rete, la modalità di rete predefinita èawsvpc.

Se la modalità di rete è attivahost, l'operazione ignora l'isolamento della rete e i container utilizzano direttamente lo stack di rete dell'host.

Se la modalità di rete è awsvpc, al processo viene assegnata un'interfaccia di rete elastica e, quando crei un servizio o esegui un processo con la definizione di attività, devi specificare NetworkConfiguration. Per ulteriori informazioni, consulta Rete di attività di Amazon ECS per istanze gestite Amazon ECS.

Le modalità di awsvpc rete host e offrono le massime prestazioni di rete per i container perché utilizzano lo stack EC2 di rete Amazon. Con le modalità di rete host e awsvpc, le porte dei container esposte sono mappate direttamente alla porta host corrispondente (per la modalità di rete host) o alla porta dell'interfaccia di rete elastica collegata (per la modalità di rete awsvpc). Pertanto, non puoi utilizzare le mappature delle porte host dinamiche.

▬Tipo: stringa

Campo obbligatorio: no

Di default: LINUX

Quando registri una definizione di attività, devi specificare la famiglia del sistema operativo.

Il valore valido per questo campo è LINUX.

Tutte le definizioni di attività utilizzate in un servizio devono avere lo stesso valore per questo parametro.

Quando una definizione di attività fa parte di un servizio, questo valore deve corrispondere al valore platformFamily del servizio.

▬Tipo: stringa

Obbligatorio: condizionale

Quando registri una definizione di attività, devi specificare l'architettura della CPU. I valori validi sono X86_64 e ARM64.

Se non specifichi un valore, Amazon ECS tenta di inserire attività sull'architettura CPU disponibile in base alla configurazione del provider di capacità. Per garantire che le attività vengano posizionate su un'architettura CPU specifica, specifica un valore per cpuArchitecture nella definizione dell'attività.

Tutte le definizioni di attività utilizzate in un servizio devono avere lo stesso valore per questo parametro.

Per ulteriori informazioni su ARM64, consultare Definizioni di attività Amazon ECS per carichi di lavoro ARM a 64 bit.

▬Tipo: stringa

Obbligatorio: condizionale

Il limite rigido di unità CPU da presentare per il processo. Puoi specificare i valori della CPU nel file JSON come stringa in unità CPU o in modalità virtuale CPUs (vCPUs). Ad esempio, è possibile specificare un valore di CPU come 1024 in unità CPU o 1 vCPU in vCPUs. Quando la definizione dell'attività viene registrata, un valore vCPU viene convertito in un numero intero che indica le unità CPU.

Questo campo è facoltativo. Se il cluster non dispone di istanze di container registrate con le unità CPU richieste disponibili, l'operazione ha esito negativo. I valori supportati sono compresi tra 0.125 v CPUs e 10 vCPUs.

▬Tipo: stringa

Obbligatorio: condizionale

Il limite rigido di memoria da presentare al processo. È possibile specificare i valori di memoria nella definizione dell'attività come stringa in mebibytes (MiB) o gigabytes (GB). Ad esempio, è possibile specificare un valore di memoria 3072 in MiB o 3 GB in GB. Quando la definizione di attività è registrata, un valore GB viene convertito in un numero intero che indica il MiB.

Questo campo è facoltativo e può essere utilizzato qualsiasi valore. Se viene specificato un valore di memoria a livello di attività, il valore di memoria a livello di container è facoltativo. Se il cluster non dispone di istanze di container registrate con la memoria richiesta disponibile, l'attività non va a buon fine. Puoi ottimizzare l'utilizzo delle risorse assegnando alle attività quanta più memoria possibile per un determinato tipo di istanza. Per ulteriori informazioni, consulta Allocazione della memoria di un'istanza di container Amazon ECS Linux.

Tipo: oggetto EphemeralStorage

Campo obbligatorio: no

La quantità di archiviazione temporanea in GB da allocare per l'attività. Questo parametro viene utilizzato per espandere la quantità totale di archiviazione temporanea disponibile, oltre l'importo predefinito, per le attività ospitate su AWS Fargate. Per ulteriori informazioni, consulta Utilizzo di montaggio vincolato con Amazon ECS.

▬Tipo: stringa

Campo obbligatorio: no

Il namespace della risorsa IPC da utilizzare per i container nell'attività. I valori validi sono host, task o none. Se host specificato, tutti i contenitori che rientrano nelle attività che hanno specificato la modalità host IPC sulla stessa istanza di contenitore condividono le stesse risorse IPC con l'istanza Amazon EC2 host. Se è stato specificato task, tutti i container all'interno dell'attività specificata condividono le stesse risorse IPC. Se è stato specificato none, le risorse IPC all'interno dei container di un'attività sono private e non condivise con altri container in un'attività o sull'istanza di container. Se non viene specificato alcun valore, la condivisione dello spazio dei nomi delle risorse IPC dipende dalla configurazione di runtime del contenitore.

▬Tipo: stringa

Campo obbligatorio: no

Il namespace del processo da utilizzare per i container nell'attività. I valori validi sono host o task. Se specificato, tutti i contenitori che host si trovano all'interno delle attività che hanno specificato la modalità host PID sulla stessa istanza di contenitore condividono lo stesso spazio dei nomi di processo con l'istanza Amazon EC2 host. Se è stata specificata l'task, tutti i container all'interno dell'attività specificata condividono lo stesso namespace del processo. Se non è stato specificato alcun valore, l'impostazione di default è un namespace privato.

Se viene utilizzata la modalità host PID, esiste un maggiore rischio di esposizione a spazi dei nomi di attività indesiderati.

Tipo: oggetto ProxyConfiguration

Campo obbligatorio: no

I dettagli di configurazione del proxy App Mesh.

▬Tipo: stringa

Campo obbligatorio: no

Una parte di una coppia chiave-valore che costituisce un tag. Una chiave è un'etichetta generale che funge da categoria per più valori di tag specifici.

▬Tipo: stringa

Campo obbligatorio: no

La parte facoltativa di una coppia chiave-valore che costituisce un tag. Un valore agisce come descrittore all'interno di una categoria di tag (chiave).

Tipo: oggetto InferenceAccelerator

Campo obbligatorio: no

Gli accelerator di inferenza elastica da utilizzare per i container nell'attività.

Tipo: matrice di oggetti TaskDefinitionPlacementConstraint

Campo obbligatorio: no

Una matrice di oggetti vincolo di posizionamento da utilizzare per l'attività. Puoi specificare un massimo di 10 vincoli per attività (questo limite include i vincoli nella definizione di attività e quelli specificati in fase di runtime).

Amazon ECS supporta i vincoli di posizionamento distinctInstace e memberOf per le attività in esecuzione sulle Istanze gestite da Amazon ECS. I seguenti attributi sono supportati per le attività che utilizzano il vincolo di posizionamento memberOf:

Per ulteriori informazioni sul posizionamento dei vincoli, consultare Definisci quali istanze di container Amazon ECS utilizza per le attività.

Tipo: stringa

Campo obbligatorio: sì

Nome del volume. Può essere costituito da un massimo di 255 lettere (maiuscole e minuscole), numeri e trattini. Nel parametro sourceVolume della definizione del container mountPoints viene fatto riferimento a questo nome.

Tipo: oggetto HostVolumeProperties

Campo obbligatorio: no

Questo parametro viene specificato quando si utilizzano volumi host di montaggi vincolati. Il contenuto del parametro host determina se il volume host di montaggio vincolato viene mantenuto nell'istanza di container host e il punto in cui viene archiviato. Se il host parametro è vuoto, il sistema assegna un percorso host per il volume di dati. Tuttavia, non è garantito che i dati siano mantenuti dopo l'interruzione del funzionamento dei container associati.

Tipo: oggetto DockerVolumeConfiguration

Campo obbligatorio: no

Questo parametro viene specificato quando si utilizzano volumi docker.

Tipo: oggetto EFSVolumedi configurazione

Campo obbligatorio: no

Questo parametro viene specificato quando si utilizza un file system Amazon EFS per l'archiviazione delle attività.

Tipo: oggetto FSxWindowsFileServerVolumeConfiguration

Campo obbligatorio: no

Questo parametro viene specificato quando utilizzi il file system Amazon FSx for Windows File Server per l'archiviazione delle attività.

Tipo: Booleano

Campo obbligatorio: no

Specificare se il volume deve essere configurato al momento dell'avvio. Viene utilizzato per creare volumi Amazon EBS per attività autonome o attività create come parte di un servizio. Ogni revisione della definizione di attività può avere un solo volume configurato all'avvio nella configurazione del volume.

Tipo: stringa

Campo obbligatorio: sì

Il nome di un container. Sono consentite fino a 255 lettere (maiuscole e minuscole), numeri, trattini e caratteri di sottolineatura. Se colleghi più container in una definizione di attività, il parametro name di uno dei container può essere inserito nel parametro links di un altro container. Questo per collegare i container.

Tipo: stringa

Campo obbligatorio: sì

L'immagine utilizzata per avviare un container. Questa stringa viene trasmessa direttamente al daemon Docker. Per impostazione predefinita, le immagini nel registro Docker Hub sono disponibili. Puoi anche specificare altri repository con repository-url/image:tag o repository-url/image@digest. 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 su Image nel comando creazione container e nel parametro IMAGE del docker di esecuzione del comando.

▬Tipo: stringa

Valori validi: enabled|disabled

Campo obbligatorio: no

Specificare se Amazon ECS risolverà il tag dell'immagine del container fornito nella definizione del container in un digest di immagini. Per impostazione predefinita, questo comportamento è enabled. Se si imposta il valore per un container come disabled, Amazon ECS non risolverà il tag dell'immagine del container in un digest e utilizzerà l'URI dell'immagine originale specificato nella definizione del container per l'implementazione. Per ulteriori informazioni sulla risoluzione dell'immagine del container, consultare Risoluzione dell'immagine del contenitore.

Tipo: integer

Campo obbligatorio: no

La quantità (in MiB) della memoria da presentare al container. Se il container tenta di superare la memoria specificata qui, viene terminato. La quantità totale di memoria prenotata per tutti i container all'interno di un processo deve essere inferiore al valore memory del processo, se specificato. Questo parametro è mappato a Memory nella creazione container del comando del docker e l'opzione --memory per docker run.

Il daemon Docker 20.10.0 o versione successiva prenota un minimo di 6 MiB di memoria per un container. Pertanto, non specificare meno di 6 MiB di memoria per i container.

Il daemon Docker 19.03.13-ce o versione precedente prenota un minimo di 4 MiB di memoria per un container. Pertanto, non specificare meno di 4 MiB di memoria per i container.

Tipo: integer

Campo obbligatorio: no

Il limite flessibile (in MiB) della memoria da prenotare per il container. Quando la memoria di sistema è in conflitto, Docker tenta di conservare la memoria del container entro questo limite flessibile. Tuttavia, il container può utilizzare una quantità maggiore di memoria, se necessario. Il container può utilizzare memoria fino al limite rigido specificato con il parametro memory (se applicabile) o tutta la memoria disponibile sull'istanza di container, a seconda di quale evento si verifica prima. Questo parametro è mappato a MemoryReservation nella creazione container del comando del docker e l'opzione --memory-reservation per docker run.

Se non viene specificato un valore di memoria a livello di attività, è necessario specificare un numero intero diverso da zero per uno o entrambi i codici memory o memoryReservation in una definizione del container. Se specifichi entrambe, memory deve essere superiore a memoryReservation. Se specifichi memoryReservation, tale valore viene sottratto dalle risorse di memoria disponibili per l'istanza di container in cui il container viene posizionato. in caso contrario, viene utilizzato il valore memory.

Ad esempio, supponiamo che il container normalmente utilizza 128 MiB di memoria, ma con picchi occasionali di 256 MiB di memoria per brevi periodi di tempo. Puoi impostare un valore di memoryReservation di 128 MiB e un limite rigido memory di 300 MiB. Questa configurazione consente al container di riservare 128 MiB di memoria solo dalle risorse restanti nell'istanza di container. Allo stesso tempo, questa configurazione consente al container di utilizzare più risorse di memoria quando necessario.

Il daemon Docker 20.10.0 o versione successiva prenota un minimo di 6 MiB di memoria per un container. Pertanto, non specificare meno di 6 MiB di memoria per i container.

Il daemon Docker 19.03.13-ce o versione precedente prenota un minimo di 4 MiB di memoria per un container. Pertanto, non specificare meno di 4 MiB di memoria per i container.

Tipo: integer

Campo obbligatorio: no

Il numero di unità cpu prenotate per il container. Questo parametro è mappato a CpuShares nella creazione container del comando del docker e l'opzione --cpu-shares per docker run.

Questo campo è facoltativo per le attività che utilizzano fornitori di EC2 capacità e l'unico requisito è che la quantità totale di CPU riservata per tutti i contenitori all'interno di un'attività sia inferiore al valore a livello di attivitàcpu.

I container Linux condividono unità CPU non assegnate con altri container nell'istanza di container con lo stesso rapporto della quantità assegnata. Ad esempio, se si esegue un'attività di container singolo in un tipo di istanza single-core con 512 unità di CPU specificate per quel container e questa è l'unica attività in esecuzione nell'istanza di container, tale container potrebbe utilizzare tutte le quote di 1.024 unità di CPU in qualsiasi momento. Tuttavia, se hai avviato un'altra copia della stessa attività su quell'istanza di container, a ogni attività viene garantito un minimo di 512 unità CPU quando necessario. Inoltre, ogni container potrebbe passare a un maggiore utilizzo della CPU se l'altro container non la utilizza. Se entrambe le attività fossero sempre attive al 100%, sarebbero limitate a 512 unità CPU.

Sulle istanze di container Linux, il daemon Docker nell'istanza di container utilizza il valore CPU per calcolare i relativi rapporti di quote di CPU per i container in esecuzione. Per ulteriori informazioni, consulta CPU share constraint nella documentazione Docker. Il valore minimo valido per il valore della quota di CPU ammesso dal kernel Linux è 2. Tuttavia, il parametro CPU non è obbligatorio e puoi usare valori di CPU minori di 2 nelle definizioni del container. Per i valori di CPU inferiori a 2 (incluso un valore nullo), il comportamento varia in base alla versione dell'agente del container Amazon ECS:

Sulle istanze di container Windows, il limite di CPU viene applicato come un limite assoluto o una quota. I container Windows hanno accesso solo alla quantità di CPU descritta nella definizione dell'attività. Un valore di CPU null o zero viene passato a Docker come 0, che Windows interpreta come 1% di una CPU.

Tipo: array di oggetti

Campo obbligatorio: no

Le mappature delle porte espongono le porte di rete del container al mondo esterno. Ciò consente ai client di accedere all'applicazione. Viene anche utilizzato per la comunicazione tra container all'interno della stessa attività.

Per le definizioni di attività che utilizzano la modalità di rete awsvpc, specifica solo il parametro containerPort. hostPort viene sempre ignorato e la porta del container viene mappata automaticamente su una casuale con numero alto sull'host.

La maggior parte dei campi di questo parametro (inclusi containerPort, hostPort e protocol) è associata a PortBindings nella sezione creazione container del comando e l'opzione --publish per docker run. Se la modalità di rete di una definizione di attività è impostata su host, le porte host devono essere non definite o devono corrispondere alla porta del container nella mappatura della porta.

Se specifichi una porta dell'host, utilizza la seguente sintassi.

"portMappings": [
    {
        "containerPort": integer,
        "hostPort": integer
    }
    ...
]

Se desideri una porta dell'host assegnata automaticamente, utilizza la seguente sintassi.

"portMappings": [
    {
        "containerPort": integer
    }
    ...
]

Tipo: oggetto RepositoryCredentials

Campo obbligatorio: no

Le credenziali dell'archivio per l'autenticazione di un registro privato.

Per ulteriori informazioni, consulta Utilizzo di immagini non AWS containerizzate in Amazon ECS.

Tipo: Booleano

Campo obbligatorio: no

Se il parametro essential di un container è contrassegnato come true e tale container dà esito negativo o si interrompe per qualsiasi motivo, tutti gli altri container che fanno parte del processo vengono interrotti. Se il parametro essential di un container è contrassegnato come false, il suo esito negativo non influenza il resto dei container in un'attività. Se questo parametro viene omesso, un container si considera essenziale.

Tutti i processi devono avere almeno un container essenziale. Se disponi di un'applicazione composta da più container, raggruppa i container utilizzati per scopi comuni in componenti e separa i diversi componenti in più definizioni di attività. Per ulteriori informazioni, consulta Progetta la tua applicazione per Amazon ECS.

Tipo: array di stringhe

Campo obbligatorio: no

Il punto di ingresso che viene trasmesso al container. Questo parametro è mappato a Entrypoint nella creazione container del comando del docker e l'opzione --entrypoint per docker run.

"entryPoint": ["string", ...]

Tipo: array di stringhe

Campo obbligatorio: no

Il comando che viene inviato al container. Questo parametro è mappato a Cmd nella creazione container del comando del docker e il parametro COMMAND per docker run. In caso di più argomenti, ognuno di questi deve essere una stringa separata nell'array.

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

▬Tipo: stringa

Campo obbligatorio: no

La directory di lavoro nel container in cui eseguire i comandi. Questo parametro è mappato a WorkingDir nella creazione container del comando del docker e l'opzione --workdir per docker run.

La politica di riavvio del container e i parametri di configurazione associati. Quando configuri una politica di riavvio per un container, Amazon ECS può riavviare il container senza dover sostituire l'attività. Per ulteriori informazioni, consulta Riavviare singoli container nelle attività Amazon ECS con policy di riavvio dei container.

Comando di controllo dell'integrità del container e parametri di configurazione associati per il container. Per ulteriori informazioni, consulta Determina lo stato delle attività di Amazon ECS utilizzando i controlli dello stato dei container.

Tipo: integer

Campo obbligatorio: no

Il numero di unità cpu che l'agente del container Amazon ECS riserverà per il container. Su Linux, questo parametro è mappato a CpuShares nella sezione Create a container.

Questo campo è facoltativo per le attività eseguite su istanze gestite da Amazon ECS. La quantità totale di CPU riservata per tutti i container all'interno di un'attività deve essere inferiore al valore cpu a livello di attività.

I container Linux condividono unità CPU non assegnate con altri container nell'istanza di container con lo stesso rapporto della quantità assegnata. Ad esempio, supponiamo di eseguire un'attività di container singolo in un tipo di istanza single core con 512 unità di CPU specificate per tale container. Inoltre, tale attività è l'unica in esecuzione sull'istanza di container. In questo esempio, il container può utilizzare la condivisione completa di 1.024 unità CPU in qualsiasi momento. Tuttavia, si supponga di aver avviato un'altra copia della stessa attività su quell'istanza di container. A ogni attività viene garantito un minimo di 512 unità CPU quando necessario. Analogamente, se l'altro container non utilizza la CPU rimanente, ogni container può passare a un maggiore utilizzo della CPU. Tuttavia, se entrambe le attività sono sempre attive al 100%, sono limitate a 512 unità CPU.

Sulle istanze di container Linux, il daemon Docker nell'istanza di container utilizza il valore CPU per calcolare i relativi rapporti di quote di CPU per i container in esecuzione. Il valore minimo valido per la quota di CPU ammesso dal kernel Linux è 2, mentre quello massimo valido per la quota di CPU ammesso dal kernel Linux è 262.144. Tuttavia, il parametro CPU non è obbligatorio e puoi usare valori di CPU minori di 2 e superiori a 262.144 nelle definizioni del container. Per i valori di CPU minori di 2 (incluso un valore null) e superiori a 262.144, il comportamento varia in base alla versione dell'agente del container Amazon ECS:

Per ulteriori esempi, consulta Modalità di gestione delle risorse di CPU e memoria di Amazon ECS.

Tipo: oggetto ResourceRequirement

Campo obbligatorio: no

Il numero di GPUs fisiche che l'agente del container Amazon ECS riserva per il container. Il numero di contenitori GPUs riservati per tutti i contenitori di un'attività non deve superare il numero di disponibili GPUs sull'istanza del contenitore su cui viene avviata l'attività. Per ulteriori informazioni, consulta Definizioni di attività Amazon ECS per carichi di lavoro GPU.

Tipo: oggetto ResourceRequirement

Campo obbligatorio: no

Per il tipo InferenceAccelerator, il value corrisponde a deviceName per un InferenceAccelerator specificato in una definizione di attività. Per ulteriori informazioni, consulta Nome dell'acceleratore Elastic Inference (obsoleto).

Tipo: Booleano

Campo obbligatorio: no

Si supponga che il parametro essential di un container sia contrassegnato come true e che tale container abbia esito negativo o si arresti per qualsiasi motivo. Di conseguenza, tutti gli altri container che fanno parte dell'attività vengono arrestati. Se il parametro essential di un container è contrassegnato come false, il suo esito negativo non influenza il resto dei container in un'attività. Se questo parametro viene omesso, un container si considera essenziale.

Tutti i processi devono avere almeno un container essenziale. Supponiamo di avere un'applicazione composta da più container. In questo caso, si raggruppano i container utilizzati per uno scopo comune in componenti e si separano i diversi componenti in più definizioni delle attività. Per ulteriori informazioni, consulta Progetta la tua applicazione per Amazon ECS.

"essential": true|false

Tipo: array di stringhe

Campo obbligatorio: no

Il punto di ingresso che viene trasmesso al container.

"entryPoint": ["string", ...]

Tipo: array di stringhe

Campo obbligatorio: no

Il comando che viene inviato al container. Questo parametro è mappato a Cmd nella creazione container del comando e il parametro COMMAND per docker run. In caso di più argomenti, ognuno di questi deve essere una stringa separata nella matrice.

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

▬Tipo: stringa

Campo obbligatorio: no

La directory di lavoro nel container in cui eseguire i comandi. Questo parametro è mappato a WorkingDir nella sezione Create a container di Docker Remote API e l'opzione --workdir a docker run.

"workingDirectory": "string"

Tipo: array di oggetti

Campo obbligatorio: no

Un elenco di file contenenti le variabili di ambiente da passare a un container. Questo parametro è mappato all'opzione --env-file al comando esecuzione del docker.

Puoi specificare fino a 10 file di ambiente. Il file deve avere un'estensione .env. Ogni riga di un file di ambiente deve contenere una variabile di ambiente nel formato VARIABLE=VALUE. Le righe che iniziano con # vengono trattate come commenti e vengono ignorate.

Se nella definizione del container sono specificate singole variabili di ambiente, hanno la precedenza sulle variabili contenute in un file di ambiente. Se vengono specificati più file di ambiente che contengono la stessa variabile, vengono elaborati dall'alto verso il basso. Consigliamo di utilizzare nomi di variabili univoci. Per ulteriori informazioni, consulta Passare una singola variabile di ambiente a un container Amazon ECS.

Tipo: array di oggetti

Campo obbligatorio: no

Le variabili di ambiente da passare a un container. Questo parametro è mappato a Env nella creazione container del comando del docker e l'opzione --env al comando per docker run.

"environment" : [
    { "name" : "string", "value" : "string" },
    { "name" : "string", "value" : "string" }
]

Tipo: array di oggetti

Campo obbligatorio: no

Un oggetto che rappresenta il segreto da esporre al container. Per ulteriori informazioni, consulta Trasferimento di dati sensibili a un container Amazon ECS.

"secrets": [
    {
        "name": "environment_variable_name",
        "valueFrom": "arn:aws:ssm:region:aws_account_id:parameter/parameter_name"
    }
]

Tipo: Booleano

Campo 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 creazione container del comando del docker e l'opzione --privileged per docker run.

▬Tipo: stringa

Campo obbligatorio: no

L'utente da usare all'interno del container. Questo parametro è mappato a User nella creazione container del comando del docker e l'opzione --user per docker run.

È possibile specificare user utilizzando i seguenti formati. Un eventuale UID o GID deve essere specificato come numero intero positivo.

Tipo: Booleano

Campo obbligatorio: no

Quando questo parametro è true, al container viene assegnato il file system root di sola lettura. Questo parametro è mappato a ReadonlyRootfs nella creazione container del comando del docker e l'opzione --read-only per docker run.

Tipo: array di stringhe

Campo obbligatorio: no

Un elenco di stringhe per fornire etichette personalizzate per SELinux sistemi di sicurezza AppArmor multilivello. Questo campo non è valido per container in attività che utilizzano Fargate.

Tipo: matrice di oggetti Ulimit

Campo obbligatorio: no

Un elenco di valori ulimits da impostare nel container. Se viene specificato un valore ulimit in una definizione di attività, questo sostituisce i valori predefiniti impostati da Docker. Questo parametro è mappato a Ulimits nella creazione container del comando del docker e l'opzione --ulimit per docker run. Valori di denominazione validi vengono visualizzati nel tipo di dati Ulimit.

I processi di Amazon ECS ospitati su Fargate utilizzano i valori del limite di risorse di default impostati dal sistema operativo, ad eccezione del parametro del limite di risorse nofile che viene sovrascritto da Fargate. Il limite di risorse nofile imposta una restrizione sul numero di file aperti che un container può utilizzare. Il limite flessibile nofile di default è 1024 mentre il limite rigido predefinito è 65535.

Questo parametro richiede la versione 1.18 o successiva dell'API Docker Remote sull'istanza del contenitore. Per controllare la versione Docker Remote API nell'istanza di container, accedi all'istanza di container ed esegui il seguente comando: sudo docker version --format '{{.Server.APIVersion}}'

Tipo: mappatura stringa a stringa

Campo obbligatorio: no

Una key/value mappa di etichette da aggiungere al contenitore. Questo parametro è mappato a Labels nella creazione container del comando del docker e l'opzione --label per docker run.

Questo parametro richiede la versione 1.18 o successiva dell'API Docker Remote sull'istanza del contenitore.

"dockerLabels": {"string": "string"
      ...}

Tipo: Booleano

Campo obbligatorio: no

Quando questo parametro è true, le reti sono disabilitate all'interno del container.

Il valore predefinito è false.

"disableNetworking": true|false

Tipo: array di stringhe

Campo obbligatorio: no

Il parametro link consente ai container di comunicare tra loro senza la necessità di mappatura delle porte. Questo parametro è supportato solo se la modalità di rete di una definizione delle attività è impostata su bridge. Il costrutto name:internalName è analogo a name:alias nei collegamenti Docker. Il nome può contenere un massimo di 255 lettere (maiuscole e minuscole), numeri, trattini e trattini bassi.

"links": ["name:internalName", ...]

▬Tipo: stringa

Campo obbligatorio: no

Il nome host da utilizzare per il container. Questo parametro è mappato a Hostname nella creazione container del docker e l'opzione --hostname per docker run.

"hostname": "string"

Tipo: array di stringhe

Campo obbligatorio: no

Un elenco di server DNS presentato al container.

"dnsServers": ["string", ...]

Tipo: array di oggetti

Campo obbligatorio: no

Un elenco di nomi host e mappature di indirizzi IP da aggiungere al file /etc/hosts nel container.

Questo parametro è mappato a ExtraHosts nella creazione container del comando del docker e l'opzione --add-host per docker run.

"extraHosts": [
      {
        "hostname": "string",
        "ipAddress": "string"
      }
      ...
    ]

Tipo: Booleano

Campo 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 creazione container del comando del docker e l'opzione --read-only per docker run.

Il valore predefinito è false.

"readonlyRootFilesystem": true|false

Tipo: array di oggetti

Campo obbligatorio: no

I punti di montaggio per i volumi di dati nel container. Questo parametro è mappato ai Volumes nella creazione container dell'API Docker e l'opzione --volume per docker run.

I container Windows possono montare intere directory sulla stessa unità di $env:ProgramData. I container Windows non possono montare le directory su un'unità diversa e i punti di montaggio non possono essere utilizzati tra le unità. È necessario specificare i punti di montaggio per collegare un volume Amazon EBS direttamente a un'attività Amazon ECS.

Tipo: array di oggetti

Campo obbligatorio: no

I volumi di dati da montare da un altro container. Questo parametro è mappato a VolumesFrom nella creazione container del comando del docker e l'opzione --volumes-from per docker run.

"volumesFrom": [
                {
                  "sourceContainer": "string",
                  "readOnly": true|false
                }
              ]

Tipo: oggetto LogConfiguration

Campo obbligatorio: no

La specifica di configurazione dei log per il container.

Per definizioni dell'attività di esempio che utilizzano una configurazione di log, consulta Esempio di definizione di attività di Amazon ECS.

Questo parametro è mappato a LogConfig nella creazione container del comando del docker e l'opzione --log-driver per docker run. Per impostazione predefinita, i container utilizzano lo stesso driver di log utilizzato dal daemon Docker. Tuttavia, il container può utilizzare un driver di log diverso da quello del daemon Docker, specificando un driver di log con questo parametro nella definizione del container. Per utilizzare un altro driver di log per un container, il sistema di log deve essere configurato correttamente nell'istanza di container (o su un altro server di log per le opzioni di logging in remoto).

Si noti quanto segue quando si specifica una configurazione di log per i container:

"logConfiguration": {
      "logDriver": "awslogs",""splunk", "awsfirelens",
      "options": {"string": "string"
        ...},
	"secretOptions": [{
		"name": "string",
		"valueFrom": "string"
	}]
}

Tipo: oggetto FirelensConfiguration

Campo obbligatorio: no

La FireLens configurazione per il contenitore. Si utilizza per specificare e configurare un router di log per i log del container. Per ulteriori informazioni, consulta Inviare i log di Amazon ECS a un servizio o AWSAWS Partner.

{
    "firelensConfiguration": {
        "type": "fluentd",
        "options": {
            "KeyName": ""
        }
    }
}

Tipo: matrice di oggetti ResourceRequirement

Campo obbligatorio: no

Il tipo e la quantità di una risorsa da assegnare a un container. L'unica risorsa supportata è la GPU.

Tipo: integer

Campo obbligatorio: no

Valori di esempio: 120

Tempo di attesa (in secondi) prima di rinunciare a risolvere le dipendenze per un container.

Ad esempio, vengono specificati due container in una definizione di attività: containerA ha una dipendenza sul containerB quando raggiunge lo stato COMPLETE, SUCCESS o HEALTHY. Se per containerB è specificato un valore startTimeout e non raggiunge lo stato desiderato entro tale periodo di tempo, allora containerA non viene avviato.

Il valore massimo è 600 secondi (10 minuti).

Tipo: integer

Campo obbligatorio: no

Valori di esempio: 120

Durata (in secondi) di attesa prima che sia forzata la chiusura se il container non si arresta da solo normalmente.

Se il parametro non è specificato, viene utilizzato il valore predefinito di 30 secondi. Il valore massimo è di 86.400 secondi (24 ore).

Tipo: matrice di oggetti ContainerDependency

Campo obbligatorio: no

Le dipendenze definite per l'avvio e la chiusura dei container. Un contenitore può contenere più dipendenze. Se una dipendenza è definita per l'avvio del container, per la sua chiusura è invertita. Per un esempio, consulta Dipendenze per i container.

Questo parametro richiede che l'attività o il servizio utilizzi la versione della piattaforma 1.3.0 o successive (Linux) o 1.0.0 (Windows).

"dependsOn": [
    {
        "containerName": "string",
        "condition": "string"
    }
]

Tipo: oggetto SystemControl

Campo obbligatorio: no

Un elenco di parametri kernel associati a un namespace da impostare nel container. Questo parametro è mappato a Sysctls nella creazione container del comando del docker e l'opzione --sysctl per docker run. Ad esempio, puoi configurare l'impostazione net.ipv4.tcp_keepalive_time per mantenere le connessioni di lunga durata.

Non è consigliabile specificare i parametri systemControls correlati alla rete per più container in un'unica attività che utilizza anche la modalità di rete awsvpc o host. Ciò comporta i seguenti svantaggi:

Se stai impostando un namespace della risorsa IPC per utilizzare i container nell'attività, ai controlli di sistema si applicano le seguenti condizioni. Per ulteriori informazioni, consulta Modalità IPC.

"systemControls": [
    {
         "namespace":"string",
         "value":"string"
    }
]

Tipo: Booleano

Campo obbligatorio: no

Quando questo parametro è true, puoi implementare le applicazioni containerizzate che richiedono l'allocazione di stdin o tty. Questo parametro è mappato a OpenStdin nella creazione container del comando del docker e l'opzione --interactive per docker run.

Il valore predefinito è false.

Tipo: Booleano

Campo obbligatorio: no

Quando il parametro è true, è allocato un TTY. Questo parametro è mappato a Tty nella creazione container del comando del docker e l'opzione --tty per docker run.

Il valore predefinito è false.

Tipo: oggetto LinuxParameters

Campo obbligatorio: no

Le modifiche specifiche di Linux che vengono applicate al container, ad esempio le funzionalità kernel Linux.