Parametri di definizione ECS delle attività di Amazon

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: EC2 | FARGATE | EXTERNAL

Il tipo di avvio per il 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 del tipo di avvio.

Tipo: string

Campo obbligatorio: no

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

Quando avvii Windows Server ECS ottimizzato per AmazonAMI, IAM i ruoli per le attività su Windows richiedono che l'-EnableTaskIAMRoleopzione sia impostata. I container devono anche eseguire un codice di configurazione per utilizzare la funzionalità. Per ulteriori informazioni, consulta Configurazione aggiuntiva dell'istanza Amazon EC2 Windows.

Tipo: stringa

Obbligatorio: condizionale

L'Amazon Resource Name (ARN) del ruolo di esecuzione dell'attività che concede all'agente Amazon ECS Container l'autorizzazione a effettuare AWS API chiamate per tuo conto.

Tipo: string

Campo obbligatorio: no

La modalità di rete Docker da utilizzare per i container nel processo. Per ECS le attività Amazon ospitate su istanze Amazon EC2 Linux, i valori validi sononone, bridgeawsvpc, ehost. Se non viene specificata alcuna modalità di rete, la modalità di rete predefinita èbridge. Per ECS le attività di Amazon ospitate su istanze Amazon EC2 Windows, i valori validi sonodefault, eawsvpc. Se non viene specificata alcuna modalità di rete, viene utilizzata la modalità di default rete. Per ECS le attività Amazon ospitate su Fargate, è richiesta la modalità awsvpc di rete.

Se la modalità di rete è impostata su none, i container dell'attività non dispongono di connettività esterna e non è possibile specificare le mappature delle porte nella definizione del container.

Se la modalità di rete è attivabridge, l'attività utilizza la rete virtuale integrata di Docker su Linux, che viene eseguita all'interno di ogni EC2 istanza Amazon che ospita l'attività. La rete virtuale integrata su Linux utilizza il driver di rete bridge Docker.

Se la modalità di rete èhost, l'attività utilizza la rete dell'host che aggira la rete virtuale integrata di Docker mappando le porte dei container direttamente sull'EC2istanza Amazon che ospita ENI l'attività. Le mappature dinamiche delle porte non possono essere utilizzate in questa modalità di rete. Un container in una definizione di attività che utilizza questa modalità deve specificare un numero di hostPort specifico. Un numero di porta su un host non può essere utilizzato da più attività. Di conseguenza, non puoi eseguire più attività con la stessa definizione di attività su una singola EC2 istanza Amazon.

Per i tipi di EC2 avvio di Amazon, se la modalità di rete èawsvpc, all'attività viene assegnata un'interfaccia di rete elastica ed è necessario specificare un NetworkConfiguration quando si crea un servizio o si esegue un'attività con la definizione dell'attività. Per ulteriori informazioni, consulta Opzioni di Amazon ECS Task Networking per il tipo di EC2 avvio.

Se la modalità di rete è attivadefault, l'attività utilizza la rete virtuale integrata di Docker su Windows, che viene eseguita all'interno di ogni EC2 istanza Amazon che ospita l'attività. La rete virtuale integrata su Windows utilizza il driver di rete nat Docker.

Per i tipi di avvio di Fargate, quando la modalità di rete è attivaawsvpc, all'operazione viene assegnata un'interfaccia di rete elastica ed è necessario specificare a NetworkConfiguration quando si crea un servizio o si esegue un'attività con la definizione dell'attività. Per ulteriori informazioni, consulta Opzioni di ECS task networking di Amazon per il tipo di lancio Fargate. La modalità awsvpc di rete offre le massime prestazioni di rete per i container perché utilizzano lo stack EC2 di rete Amazon. Le porte dei container esposte vengono mappate direttamente alla porta dell'interfaccia di rete elastica collegata. Pertanto, non puoi utilizzare le mappature delle porte host dinamiche.

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.

Con il tipo di avvio Fargate, la modalità di rete awsvpc è obbligatoria. Se si utilizza il tipo di EC2 avvio, la modalità di rete consentita dipende dal sistema operativo dell'EC2istanza sottostante. Con Linux, può essere utilizzata qualsiasi modalità di rete. Se Windows, possono essere utilizzate le modalità default e awsvpc.

Tipo: stringa

Obbligatorio: condizionale

Impostazione predefinita: LINUX

Questo parametro è obbligatorio per le ECS attività di Amazon ospitate su Fargate.

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

I valori validi per ECS le attività di Amazon ospitate su Fargate sonoLINUX,, WINDOWS_SERVER_2019_FULL WINDOWS_SERVER_2019_COREWINDOWS_SERVER_2022_FULL, e. WINDOWS_SERVER_2022_CORE

I valori validi per ECS le attività di Amazon ospitate su Amazon EC2 sono LINUX WINDOWS_SERVER_2022_CORE WINDOWS_SERVER_2022_FULLWINDOWS_SERVER_2019_FULL,WINDOWS_SERVER_2019_CORE,WINDOWS_SERVER_2016_FULL, eWINDOWS_SERVER_2004_CORE, eWINDOWS_SERVER_20H2_CORE.

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

Valore di default: X86_64

Questo parametro è obbligatorio per le ECS attività di Amazon ospitate su Fargate. Se il parametro viene lasciato come null, il valore predefinito viene assegnato automaticamente all'avvio di un'attività ospitata su Fargate.

Quando si registra una definizione di attività, si specifica l'CPUarchitettura. I valori validi sono X86_64 e ARM64.

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

Quando hai attività Linux per il tipo di avvio Fargate o per il tipo di EC2 avvio, puoi impostare il valore su. ARM64 Per ulteriori informazioni, consulta Definizioni delle ECS attività di Amazon per carichi di ARM lavoro a 64 bit.

Tipo: stringa

Obbligatorio: condizionale

Il limite massimo di CPU unità da presentare per l'attività. È possibile specificare CPU i valori nel JSON file come stringa in CPU unità o virtual CPUs (vCPUs). Ad esempio, è possibile specificare un CPU valore 1024 in CPU unità o 1 vCPU invCPUs. Quando viene registrata la definizione dell'attività, un CPU valore v viene convertito in un numero intero che indica le CPU unità.

Per le attività eseguite su istanze esterne EC2 o su istanze esterne, questo campo è facoltativo. Se il cluster non dispone di istanze di container registrate con le CPU unità richieste disponibili, l'operazione ha esito negativo. I valori supportati per le attività eseguite su istanze esterne EC2 o su istanze esterne sono compresi tra e 0.125 vCPUs . 10 vCPUs

Per le attività in esecuzione su Fargate (sia container Linux che Windows), questo campo è obbligatorio ed è necessario utilizzare uno dei seguenti valori che determina l'intervallo di valori validi per il parametro memory. La tabella seguente mostra le combinazioni valide di livello di attività e memoriaCPU.

Tipo: stringa

Obbligatorio: condizionale

Il limite massimo di memoria da dedicare all'attività. È possibile specificare i valori di memoria nella definizione dell'attività come stringa in mebibyte (MiB) o gigabyte (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.

Per le attività ospitate su EC2 istanze Amazon, 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 Riservare la memoria delle istanze dei container Amazon ECS Linux.

Per i processi ospitati su Fargate (sia container Linux che Windows), questo campo è obbligatorio e devi utilizzare uno dei seguenti valori che determina l'intervallo di valori validi per il parametro cpu:

Tipo: stringa

Campo obbligatorio: sì

Il nome di un container. Il nome può contenere un massimo di 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 passata direttamente al Docker demone. Per impostazione predefinita, le immagini in Docker Hub il registro è disponibile. 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 è Image mappato al comando docker create-container e al parametro IMAGE del comando docker run.

Tipo: stringa

Valori validi: enabled|disabled

Campo obbligatorio: no

Speciifica se Amazon ECS risolverà il tag dell'immagine del contenitore fornito nella definizione del contenitore in un digest di immagini. Per impostazione predefinita, questo comportamento è. enabled Se imposti il valore per un contenitore comedisabled, Amazon non ECS risolverà il tag dell'immagine del contenitore in un digest e utilizzerà l'immagine originale URI specificata nella definizione del contenitore per la distribuzione. Per ulteriori informazioni sulla risoluzione dell'immagine del contenitore, consultaRisoluzione 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 Memory al comando docker create-container e --memory all'opzione docker run.

Se utilizzi il tipo di avvio Fargate, questo parametro è facoltativo.

Se utilizzi il tipo di EC2 avvio, devi specificare un valore di memoria a livello di attività o un valore di memoria a livello di contenitore. Se specifichi sia un valore di memory a livello di container che un valore di memoryReservation, memory deve essere maggiore del valore di 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.

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 mantenere la memoria del contenitore 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 MemoryReservation al comando docker create-container e --memory-reservation all'opzione 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: array di oggetti

Campo obbligatorio: no

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

Per le definizioni delle attività (sia il tipo Fargate che quello di EC2 avvio) che utilizzano la modalità awsvpc di rete, specificare solo. containerPort hostPortViene sempre ignorato e la porta del contenitore viene mappata automaticamente su una porta casuale con numero alto sull'host.

La mappatura delle porte su Windows usa l'indirizzo gateway NetNAT anziché localhost. Non vi è alcun loopback per le mappature delle porte su Windows, perciò non è possibile accedere alla porta mappata di un container dall'host stesso.

La maggior parte dei campi di questo parametro (inclusocontainerPort,hostPort,protocol) è mappata PortBindings al comando docker create-container e --publish all'opzione 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.

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

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

Tipo: integer

Campo obbligatorio: no

Il numero di cpu unità che l'agente di ECS container di Amazon riserva per il container. Su Linux, questo parametro viene CpuShares mappato alla sezione Crea un contenitore.

Questo campo è facoltativo solo per le attività che utilizzano il tipo di avvio Fargate. La quantità totale di risorse CPU riservate per tutti i contenitori che fanno parte di un'attività deve essere inferiore al valore a livello di attivitàcpu.

Linux i contenitori condividono le CPU unità non allocate con altri contenitori sull'istanza del contenitore con lo stesso rapporto tra la loro quantità allocata. Ad esempio, supponiamo di eseguire un'attività a contenitore singolo su un tipo di istanza single-core con 512 CPU unità specificate per quel contenitore. Inoltre, tale attività è l'unica in esecuzione sull'istanza di container. In questo esempio, il contenitore può utilizzare l'intera condivisione di 1.024 CPU unità in un dato momento. Tuttavia, si supponga di aver avviato un'altra copia della stessa attività su quell'istanza di container. A ogni attività è garantito un minimo di 512 CPU unità quando necessario. Allo stesso modo, se l'altro contenitore non utilizza il restoCPU, ogni contenitore può essere CPU utilizzato più spesso. Tuttavia, se entrambe le attività sono sempre state attive al 100%, sono limitate a 512 CPU unità.

Abilitato Linux istanze del contenitore, il Docker il demone sull'istanza del contenitore utilizza il CPU valore per calcolare i rapporti di CPU condivisione relativi per i contenitori in esecuzione. Il valore di CPU condivisione minimo valido consentito dal kernel Linux è 2 e il valore di CPU condivisione massimo valido consentito dal kernel Linux è 262144. Tuttavia, il CPU parametro non è obbligatorio ed è possibile utilizzare CPU valori inferiori a due e superiori a 262144 nelle definizioni dei contenitori. Per CPU valori inferiori a due (incluso null) e superiori a 262144, il comportamento varia in base alla versione di Amazon ECS Container Agent in uso:

Abilitato Windows nelle istanze di container, la CPU quota viene applicata come quota assoluta. Windows i contenitori hanno accesso solo alla quantità CPU specificata definita nella definizione dell'attività. Viene passato un CPU valore nullo o zero a Docker come0. Windows quindi interpreta questo valore come l'1% di unoCPU.

Per altri esempi, consulta Come Amazon ECS gestisce CPU le risorse di memoria.

Tipo: oggetto ResourceRequirement

Campo obbligatorio: no

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

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 di inferenza elastica.

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 è Cmd mappato al comando create-container e il COMMAND parametro a docker run. In caso di più argomenti, ognuno di questi deve essere una stringa separata nella matrice.

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

Tipo: string

Campo obbligatorio: no

La directory di lavoro nel container in cui eseguire i comandi. Questo parametro è WorkingDir mappato alla sezione Crea un contenitore del Docker Remote API e all'opzione a. --workdir 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'--env-fileopzione del comando docker run.

Quando FIPS è abilitato su un host che utilizza il tipo di EC2 avvio, i nomi dei bucket con punti (.) (ad esempio, amzn-s3-demo-bucket1.name.example) non sono supportati. La presenza di punti (.) nel nome del bucket impedisce l'avvio dell'attività perché l'agente non può estrarre il file della variabile di ambiente da Amazon S3.

Questo non è disponibile per Windows contenitori e container Windows su Fargate

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 Passa una singola variabile di ambiente a un ECS container Amazon.

Tipo: array di oggetti

Campo obbligatorio: no

Le variabili di ambiente da passare a un container. Questo parametro è Env mappato al comando docker create-container e l'opzione --env al comando 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 Trasferisci dati sensibili a un ECS contenitore Amazon.

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

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 name:internalName costrutto è analogo a in name:alias Docker collegamenti. Sono consentiti fino a 255 lettere (maiuscole e minuscole), numeri, trattini e caratteri di sottolineatura.

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

Tipo: string

Campo obbligatorio: no

Il nome host da utilizzare per il container. Questo parametro è mappato Hostname al docker create-container e --hostname all'opzione docker run.

"hostname": "string"

Tipo: array di stringhe

Campo obbligatorio: no

Un elenco di DNS server che vengono presentati al contenitore.

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

Tipo: array di stringhe

Campo obbligatorio: no

Modello: ^[a-zA-Z0-9-.]{0,253}[a-zA-Z0-9]$

Un elenco di domini di DNS ricerca che vengono presentati al contenitore. Questo parametro associa DnsSearch nel comando docker create-container l'opzione --dns-search docker run.

"dnsSearchDomains": ["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 ExtraHosts al comando docker create-container e --add-host all'opzione 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 associa ReadonlyRootfs nel comando docker create-container l'opzione --read-only 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 contenitore. Questo parametro è mappato Volumes al Docker create-container API e --volume all'opzione docker run.

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

Tipo: array di oggetti

Campo obbligatorio: no

I volumi di dati da montare da un altro container. Questo parametro è mappato VolumesFrom al comando docker create-container e --volumes-from all'opzione 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 Esempi di definizioni di ECS attività Amazon.

Questo parametro è mappato LogConfig al comando docker create-container e --log-driver all'opzione docker run. Per impostazione predefinita, i contenitori utilizzano lo stesso driver di registrazione del Docker daemon utilizza. Tuttavia, il contenitore potrebbe utilizzare un driver di registrazione diverso dal Docker daemon specificando un driver di registro con questo parametro nella definizione del contenitore. 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","fluentd","gelf","json-file","journald","logentries","splunk","syslog","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 ECS i log di Amazon a un AWS servizio o AWS Partner.

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

Tipo: array di stringhe

Campo obbligatorio: no

Un elenco di file ARNs in SSM o Amazon S3 in un file spec (CredSpec) delle credenziali che configura il contenitore per l'autenticazione Active Directory. Consigliamo di utilizzare questo parametro anziché dockerSecurityOptions. Il numero massimo di è 1. ARNs

Esistono due formati per ciascunoARN.

In entrambi i formati, MyARN sostituiscilo con ARN in SSM o Amazon S3.

credspecÈ necessario fornire un ARN Secrets Manager per un segreto contenente il nome utente, la password e il dominio a cui connettersi. Per una maggiore sicurezza, l'istanza non viene aggiunta al dominio per l'autenticazione senza dominio. Le altre applicazioni sull'istanza non possono utilizzare le credenziali senza dominio. Puoi utilizzare questo parametro per eseguire attività sulla stessa istanza, anche se le attività devono aggiungere domini diversi. Per ulteriori informazioni, vedere Utilizzo gMSAs per contenitori Windows e Utilizzo gMSAs per contenitori Linux.

Tipo: Booleano

Campo obbligatorio: no

Se il parametro è true, al container vengono assegnati privilegi elevati nell'istanza di container host (simile all'utente root). Si consiglia di non far funzionare i container con privileged. Nella maggior parte dei casi, puoi specificare i privilegi esatti necessari utilizzando i parametri specifici anziché privileged.

Questo parametro è mappato Privileged al comando docker create-container e --privileged all'opzione docker run.

Il valore predefinito è false.

"privileged": true|false

Tipo: string

Campo obbligatorio: no

L'utente da usare all'interno del container. Questo parametro è mappato User al comando docker create-container e --user all'opzione docker run.

È possibile specificare user utilizzando i seguenti formati. Se si specifica un UID oGID, è necessario specificarlo come numero intero positivo.

"user": "string"

Tipo: array di stringhe

Valori validi: "no-new-privileges" | «apparmor:PROFILE" | «label:" | «valuecredentialspec:» CredentialSpecFilePath

Campo obbligatorio: no

Un elenco di stringhe per fornire una configurazione personalizzata per più sistemi di sicurezza. Questo campo non è valido per container in attività che utilizzano il tipo di avvio Fargate.

In Linux tasks onEC2, questo parametro può essere usato per fare riferimento alle etichette personalizzate per SELinux e AppArmor sistemi di sicurezza a più livelli.

Per qualsiasi attivitàEC2, questo parametro può essere utilizzato per fare riferimento a un file di specifiche delle credenziali che configura un contenitore per l'autenticazione di Active Directory. Per ulteriori informazioni, consulta Scopri come utilizzarli gMSAs per i contenitori EC2 Windows per Amazon ECS e Utilizzo gMSA per EC2 Linux contenitori su Amazon ECS.

Questo parametro è mappato SecurityOpt al comando docker create-container e --security-opt all'opzione docker run.

"dockerSecurityOptions": ["string", ...]

Tipo: array di oggetti

Campo obbligatorio: no

Un elenco di valori ulimit da definire per un container. Questo valore sovrascrive l'impostazione della quota di risorse predefinite per il sistema operativo. Questo parametro è mappato Ulimits al comando docker create-container e --ulimit all'opzione docker run.

ECSLe attività Amazon ospitate su Fargate utilizzano i valori limite di risorse predefiniti impostati dal sistema operativo ad eccezione del parametro del limite di nofile risorse. Il limite di risorse nofile imposta una restrizione sul numero di file aperti che un container può utilizzare. Su Fargate, il limite flessibile nofile predefinito è 65535 mentre il limite rigido è 65535. Puoi impostare i valori di entrambi i limiti fino a 1048576. Per ulteriori informazioni, consulta Limiti delle risorse dei processi.

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

"ulimits": [
      {
        "name": "core"|"cpu"|"data"|"fsize"|"locks"|"memlock"|"msgqueue"|"nice"|"nofile"|"nproc"|"rss"|"rtprio"|"rttime"|"sigpending"|"stack",
        "softLimit": integer,
        "hardLimit": integer
      }
      ...
    ]

Tipo: mappatura stringa a stringa

Campo obbligatorio: no

Una mappa chiave/valore di etichette da aggiungere al container. Questo parametro è mappato Labels al comando docker create-container e --label all'opzione docker run.

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

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

Tipo: oggetto LinuxParameters

Campo obbligatorio: no

Linux-opzioni specifiche applicate al contenitore, ad esempio. KernelCapabilities

"linuxParameters": {
      "capabilities": {
        "add": ["string", ...],
        "drop": ["string", ...]
        }
      }

Tipo: matrice di oggetti ContainerDependency

Campo obbligatorio: no

Le dipendenze definite per l'avvio e la chiusura dei container. Un container 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.

Per ECS le attività di Amazon ospitate su EC2 istanze Amazon, le istanze richiedono almeno la versione 1.26.0 dell'agente container per abilitare le dipendenze dei contenitori. Tuttavia, ti consigliamo di utilizzare la versione più recente dell'agente container. Per informazioni sulla verifica della versione dell'agente e sull'aggiornamento alla versione più recente, consulta Aggiornamento dell'agente ECS container Amazon. Se utilizzi un Amazon Linux ECS ottimizzato per AmazonAMI, la tua istanza richiede almeno la versione 1.26.0-1 del ecs-init pacchetto. Le istanze di container avviate dalla versione 20190301 o successive contengono già le versioni richieste dell'agente del container e di ecs-init. Per ulteriori informazioni, consulta Linux ECS ottimizzato per Amazon AMIs.

Per ECS le attività di Amazon ospitate su Fargate, questo parametro richiede che l'attività o il servizio utilizzi una versione della piattaforma 1.3.0 o successiva (Linux) o 1.0.0 (Windows).

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

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.

Per ECS le attività di Amazon ospitate su Fargate, questo parametro richiede che l'attività o il servizio utilizzi una versione della piattaforma 1.3.0 o successiva (Linux). Il valore massimo è 120 secondi.

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.

Per ECS le attività di Amazon ospitate su Fargate, questo parametro richiede che l'attività o il servizio utilizzi una versione della piattaforma 1.3.0 o successiva (Linux). Se il parametro non è specificato, viene utilizzato il valore predefinito di 30 secondi. Il valore massimo per Fargate è 120 secondi.

Per le attività che utilizzano il tipo di EC2 avvio, se il stopTimeout parametro non è specificato, ECS_CONTAINER_STOP_TIMEOUT viene utilizzato il valore impostato per la variabile di configurazione Amazon ECS Container Agent. Se non sono impostati né il stopTimeout parametro né la variabile di configurazione dell'ECS_CONTAINER_STOP_TIMEOUTagente, i valori predefiniti di 30 secondi per Linux contenitori e 30 secondi accesi Windows vengono utilizzati contenitori. Per consentire il valore di timeout di arresto per un container, le istanze di container richiedono almeno la versione 1.26.0 dell'agente del container. Tuttavia, ti consigliamo di utilizzare la versione più recente dell'agente container. Per informazioni sulla verifica della versione dell'agente e sull'aggiornamento alla versione più recente, consulta Aggiornamento dell'agente ECS container Amazon. Se utilizzi un Amazon Linux ECS ottimizzato per AmazonAMI, la tua istanza richiede almeno la versione 1.26.0-1 del pacchetto. ecs-init Le istanze di container avviate dalla versione 20190301 o successive contengono già le versioni richieste dell'agente del container e di ecs-init. Per ulteriori informazioni, consulta Linux ECS ottimizzato per Amazon AMIs.

Tipo: oggetto SystemControl

Campo obbligatorio: no

Un elenco di parametri del kernel dello spazio dei nomi da impostare nel contenitore. Questo parametro è mappato Sysctls al comando docker create-container e all'opzione docker run. --sysctl 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 uno spazio dei nomi di IPC risorse da utilizzare per i contenitori dell'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 OpenStdin al comando docker create-container e --interactive all'opzione docker run.

Il valore predefinito è false.

Tipo: Booleano

Campo obbligatorio: no

Quando questo parametro ètrue, viene allocato a. TTY Questo parametro è mappato Tty al comando docker create-container e --tty all'opzione docker run.

Il valore predefinito è false.

Tipo: stringa

Campo obbligatorio: sì

Il nome del dispositivo dell'acceleratore di inferenza elastica. Il deviceName deve anche essere riferito in una definizione del container; consulta Elastic Inference accelerator.

Tipo: stringa

Campo obbligatorio: sì

L'acceleratore di inferenza elastica da utilizzare.

Tipo: string

Campo obbligatorio: no

Un'espressione del linguaggio di query del cluster da applicare al vincolo. Per ulteriori informazioni, consulta Crea espressioni per definire istanze di container per le attività di Amazon ECS.

Tipo: stringa

Campo obbligatorio: sì

Il tipo di vincolo. Utilizza memberOf per limitare la selezione a un gruppo di candidati validi.

Tipo: oggetto ProxyConfiguration

Campo obbligatorio: no

I dettagli di configurazione del proxy App Mesh.

Per le attività che utilizzano il tipo di EC2 avvio, le istanze del contenitore richiedono almeno la versione 1.26.0 dell'agente contenitore e almeno la versione 1.26.0-1 del pacchetto per abilitare una configurazione proxy. ecs-init Se le tue istanze di container vengono avviate dalla AMI versione ECS ottimizzata per Amazon 20190301 o successiva, contengono le versioni richieste dell'agente contenitore e. ecs-init Per ulteriori informazioni, consulta Linux ECS ottimizzato per Amazon AMIs.

Per le attività che utilizzano il tipo di avvio Fargate, questa funzionalità richiede che l'attività o il servizio utilizzi la versione della piattaforma 1.3.0 o successiva.

"proxyConfiguration": {
    "type": "APPMESH",
    "containerName": "string",
    "properties": [
        {
           "name": "string",
           "value": "string"
        }
    ]
}

Tipo: string

Campo obbligatorio: no

Nome del volume. Sono consentite fino a 255 lettere (maiuscole e minuscole), numeri, trattini () e caratteri di sottolineatura (-). _ A questo nome viene fatto riferimento nel parametro dell'oggetto di definizione del contenitore. sourceVolume mountPoints

Campo obbligatorio: no

Il host parametro viene utilizzato per collegare il ciclo di vita del bind mount all'EC2istanza Amazon host, anziché all'attività e alla posizione in cui è archiviata. Se il parametro host è vuoto, il daemon Docker assegna un percorso host per il tuo volume di dati, ma non è garantito che i dati vengano mantenuti dopo che viene interrotta l'esecuzione del container a essi associato.

I container Windows possono montare intere directory sulla stessa unità di $env:ProgramData.

Tipo: Booleano

Campo obbligatorio: no

Speciifica se un volume è configurabile all'avvio. Se impostato sutrue, è possibile configurare il volume durante l'esecuzione di un'attività autonoma o durante la creazione o l'aggiornamento di un servizio. Se impostato sutrue, non sarà possibile fornire un'altra configurazione del volume nella definizione dell'attività. Questo parametro deve essere impostato per true configurare un EBS volume Amazon da allegare a un'attività. L'impostazione configuredAtLaunch true e il rinvio della configurazione del volume alla fase di avvio consentono di creare definizioni di attività che non sono limitate a un tipo di volume o a impostazioni di volume specifiche. In questo modo la definizione delle attività è riutilizzabile in diversi ambienti di esecuzione. Per ulteriori informazioni, consulta Amazon EBS Volumes.

Tipo: DockerVolumeConfigurationoggetto

Campo obbligatorio: no

Questo parametro viene specificato quando si utilizzano volumi docker. I volumi Docker sono supportati solo quando si eseguono attività su EC2 istanze. I contenitori Windows supportano solo l'uso del local driver. Per utilizzare i montaggi vincolati, specifica invece un host.

Tipo: oggetto EFSVolumeConfiguration

Campo obbligatorio: no

Questo parametro viene specificato quando si utilizzano EFS volumi Amazon.

Tipo: FSxWindowsFileServerVolumeConfigurationoggetto

Campo obbligatorio: sì

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

Tipo: string

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: string

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 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 Usa i bind mount con Amazon ECS.

Tipo: string

Campo obbligatorio: no

Lo spazio dei nomi IPC delle risorse da utilizzare per i contenitori dell'attività. I valori validi sono host, task o none. Se host specificato, tutti i contenitori che rientrano nelle attività che hanno specificato la host IPC modalità sulla stessa istanza di contenitore condividono le stesse IPC risorse con l'EC2istanza Amazon host. Se task specificato, tutti i contenitori che si trovano all'interno dell'attività specificata condividono le stesse IPC risorse. Se none è specificato, IPC le risorse all'interno dei contenitori di un'attività sono private e non condivise con altri contenitori in un'attività o nell'istanza del contenitore. Se non viene specificato alcun valore, la condivisione dello spazio dei nomi IPC delle risorse dipende dall'impostazione del demone Docker sull'istanza del contenitore.

Se viene utilizzata la host IPC modalità, esiste un rischio maggiore di esposizione indesiderata allo spazio dei nomi. IPC

Se state impostando i parametri del kernel con namespace da utilizzare systemControls per i contenitori del task, quanto segue si applica allo spazio dei nomi delle risorse. IPC

Tipo: stringa

Valori validi: host | task

Campo obbligatorio: no

Lo spazio dei nomi del processo da utilizzare per i container nell'attività. I valori validi sono host o task. Per i container Fargate per Linux, l'unico valore valido è task. Ad esempio, i sidecar di monitoraggio potrebbero aver bisogno di pidMode per accedere a informazioni su altri container in esecuzione nella stessa attività.

Se host specificato, tutti i contenitori all'interno delle attività che hanno specificato la host PID modalità sulla stessa istanza di contenitore condividono lo stesso spazio dei nomi di processo con l'istanza Amazon EC2 host.

Se è stato specificato task, tutti i container all'interno dell'attività specificata condividono lo stesso spazio dei nomi del processo.

Se non è stato specificato alcun valore, l'impostazione predefinita è uno spazio dei nomi privato per ogni container.

Se viene utilizzata la host PID modalità, esiste un rischio maggiore di esposizione indesiderata allo spazio dei nomi dei processi.

Tipo: Booleano

Valori validi: true | false

Campo obbligatorio: no

Se questo parametro è impostato sutrue, nel payload di un'attività, Amazon ECS e Fargate accettano le richieste di inserimento dei guasti dai contenitori dell'attività. Questo parametro è impostato su false per impostazione predefinita.