Specifica un volume Docker in una definizione dell'attività Amazon ECS - Amazon Elastic Container Service

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Specifica un volume Docker in una definizione dell'attività Amazon ECS

Prima che i container possano utilizzare i volumi di dati, è necessario specificare le configurazioni del punto di montaggio e del volume nella definizione di attività. Questa sezione descrive la configurazione del volume per un container. Per le attività che usano un volume Docker, specifica dockerVolumeConfiguration. Per le attività che usano un volume host di montaggio vincolato, specifica host e facoltativamente sourcePath.

Il seguente JSON della definizione di attività illustra la sintassi degli oggetti volumes e mountPoints per un container.

{
    "containerDefinitions": [
        {
            "mountPoints": [
                {
                    "sourceVolume": "string",
                    "containerPath": "/path/to/mount_volume",
                    "readOnly": boolean
                }
            ]
        }
    ],
    "volumes": [
        {
            "name": "string",
            "dockerVolumeConfiguration": {
                "scope": "string",
                "autoprovision": boolean,
                "driver": "string",
                "driverOpts": {
                    "key": "value"
                },
                "labels": {
                    "key": "value"
                }
            }
        }
    ]
}
name

▬Tipo: stringa

Obbligatorio: no

Nome del volume. Il nome può contenere un massimo di 255 lettere (maiuscole e minuscole), numeri, trattini (-) e trattini bassi (_). Nel parametro sourceVolume dell'oggetto mountPoints della definizione del container viene fatto riferimento a questo nome.

dockerVolumeConfiguration

Tipo: oggetto DockerVolumeConfiguration

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 container Windows supportano solo l’uso del driver local. Per utilizzare i montaggi vincolati, specifica invece un host.

scope

Tipo: String

Valori validi: task | shared

Obbligatorio: no

L'ambito del volume Docker che determina il suo ciclo di vita. I volumi Docker che rientrano nell'ambito task vengono automaticamente assegnati all'avvio del processo e distrutti quando il processo viene arrestato. I volumi Docker che vengono definiti come shared vengono mantenuti dopo l'arresto del processo.

autoprovision

Tipo: Booleano

Valore predefinito: false

Obbligatorio: no

Se questo valore è true, viene creato il volume Docker, se non è già presente. Questo campo è utilizzato solo se scope è shared. Se scope è task, questo parametro deve essere omesso.

driver

▬Tipo: stringa

Obbligatorio: no

Il driver del volume Docker da utilizzare. Il valore del driver deve corrispondere al nome del driver fornito da Docker perché questo nome è utilizzato per il posizionamento dell'attività. Se il driver è stato installato utilizzando la CLI del plugin Docker, utilizzare docker plugin ls per richiamare il nome del driver dall'istanza di container. Se il driver è stato installato utilizzando un altro metodo, utilizzare il rilevamento del plugin Docker per richiamare il nome del driver.

driverOpts

▬Tipo: stringa

Obbligatorio: no

Una mappa delle opzioni specifiche del driver Docker da inviare. Questo parametro fa riferimento a DriverOpts nella sezione Crea un volume di Docker.

labels

▬Tipo: stringa

Obbligatorio: no

Metadati personalizzati da aggiungere al volume Docker.

mountPoints

Tipo: array di oggetti

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.

sourceVolume

Tipo: String

Obbligatorio: sì, quando si utilizzano mountPoints

Il nome del volume da montare.

containerPath

Tipo: String

Obbligatorio: sì, quando si utilizzano mountPoints

Il percorso nel container in cui verrà montato il volume.

readOnly

Tipo: Booleano

Obbligatorio: no

Se il valore è true, il container avrà accesso in sola lettura al volume. Se il valore è false, il container avrà accesso in scrittura al volume. Il valore predefinito è false.

Per le attività eseguite su EC2 istanze che eseguono il sistema operativo Windows, lascia il valore predefinito di. false