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

Campo 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

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.

scope

▬Tipo: stringa

Valori validi: task | shared

Campo 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

Campo 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

Campo 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

Campo 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

Campo obbligatorio: no

Metadati personalizzati da aggiungere al volume Docker.

mountPoints

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.

sourceVolume

▬Tipo: stringa

Obbligatorio: sì, quando si utilizzano mountPoints

Il nome del volume da montare.

containerPath

▬Tipo: stringa

Obbligatorio: sì, quando si utilizzano mountPoints

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

readOnly

Tipo: Booleano

Campo 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 difalse.