Ein Bind-Mount in einer Amazon-ECS-Aufgabendefinition angeben - Amazon Elastic Container Service

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Ein Bind-Mount in einer Amazon-ECS-Aufgabendefinition angeben

Für Amazon ECS-Aufgaben, die entweder auf Fargate- oder EC2 Amazon-Instances gehostet werden, zeigt das folgende JSON-Snippet mit der Aufgabendefinition die Syntax für dievolumes,mountPoints, und ephemeralStorage Objekte für eine Aufgabendefinition.

{
   "family": "",
   ...
   "containerDefinitions" : [
      {
         "mountPoints" : [
            {
               "containerPath" : "/path/to/mount_volume",
               "sourceVolume" : "string"
            }
          ],
          "name" : "string"
       }
    ],
    ...
    "volumes" : [
       {
          "name" : "string"
       }
    ],
    "ephemeralStorage": {
	   "sizeInGiB": integer
    }
}

Für Amazon ECS-Aufgaben, die auf EC2 Amazon-Instances gehostet werden, können Sie den optionalen host Parameter und a verwenden, sourcePath wenn Sie die Details zum Aufgabenvolumen angeben. Sind diese angegeben, wird das Bind-Mount an den Lebenszyklus der Aufgabe und nicht an den Container gebunden.

"volumes" : [
    {
        "host" : {
            "sourcePath" : "string"
        },
        "name" : "string"
    }
]

Im Folgenden finden Sie weitere detaillierte Beschreibungen der einzelnen Aufgabendefinitionsparameter.

name

Typ: Zeichenfolge

Erforderlich: Nein

Der Name des Volumes. Bis zu 255 Buchstaben (Groß- und Kleinbuchstaben), Ziffern, Bindestriche (-) und Unterstriche (_) sind erlaubt. Auf diesen Namen wird im Parameter sourceVolume des mountPoints-Objekts der Container-Definition verwiesen.

host

Erforderlich: Nein

Der host Parameter wird verwendet, um den Lebenszyklus des Bind-Mounts mit der EC2 Host-Amazon-Instance und nicht mit der Aufgabe und dem Speicherort zu verknüpfen. Wenn der Parameter host leer ist, weist der Docker-Daemon einen Host-Pfad für Ihr Daten-Volume zu, es wird aber nicht gewährleistet, dass die Daten beibehalten werden, nachdem die damit verknüpften Container nicht mehr ausgeführt werden.

Windows-Container können ganze Verzeichnisse auf dem gleichen Laufwerk wie $env:ProgramData einbinden.

Anmerkung

Der sourcePath Parameter wird nur unterstützt, wenn Aufgaben verwendet werden, die auf EC2 Amazon-Instances gehostet werden.

sourcePath

Typ: Zeichenfolge

Erforderlich: Nein

Wenn der host Parameter verwendet wird, geben Sie a an, sourcePath um den Pfad auf der EC2 Host-Amazon-Instance zu deklarieren, der dem Container präsentiert wird. Wenn dieser Parameter leer ist, weist der Docker-Daemon einen Host-Pfad für Sie zu. Wenn der host Parameter einen sourcePath Dateispeicherort enthält, bleibt das Datenvolumen am angegebenen Speicherort auf der EC2 Host-Amazon-Instance bestehen, bis Sie es manuell löschen. Wenn der sourcePath Wert auf der EC2 Host-Amazon-Instance nicht vorhanden ist, erstellt ihn der Docker-Daemon. Wenn der Speicherort nicht vorhanden ist, wird der Inhalt des Quellpfadordners exportiert.

mountPoints

Typ: Objekt-Array

Erforderlich: Nein

Die Mounting-Punkte für die Daten-Volumes in Ihrem Container. Dieser Parameter ist in der create-container-Docker-API der Option Volumes zugeordnet und die Option --volume ist der Docker-Ausführung zugeordnet.

Windows-Container können ganze Verzeichnisse auf dem gleichen Laufwerk wie $env:ProgramData einbinden. Windows-Container können keine Verzeichnisse auf einem anderen Laufwerk mounten, und es ist kein laufwerksübergreifender Mounting-Punkt möglich. Sie müssen Mounting-Punkte angeben, um ein Amazon-EBS-Volume direkt an eine Amazon-ECS-Aufgabe anzuhängen.

sourceVolume

Typ: Zeichenfolge

Erforderlich: Ja, wenn mountPoints verwendet werden

Der Name des einzubindenden Volumes.

containerPath

Typ: Zeichenfolge

Erforderlich: Ja, wenn mountPoints verwendet werden

Der Pfad in dem Container, in dem das Volume eingebunden wird.

readOnly

Typ: Boolesch

Erforderlich: Nein

Wenn dieser Wert true lautet, verfügt der Container über schreibgeschützten Zugriff auf das Volume. Lautet der Wert false, dann verfügt der Container über Schreibzugriff auf das Volume. Der Standardwert ist false.

Für Aufgaben, die auf EC2 Instances ausgeführt werden, auf denen das Windows-Betriebssystem ausgeführt wird, belassen Sie den Standardwert von. false

ephemeralStorage

Typ: Objekt

Erforderlich: Nein

Die Menge des flüchtigen Speichers, der für die Aufgabe zugewiesen werden soll. Dieser Parameter wird verwendet, um die Gesamtmenge an verfügbarem kurzlebigem Speicher für Aufgaben, die auf der Serverversion 1.4.0 oder höher (Linux) 1.0.0 oder höher (Windows) gehostet werden, AWS Fargate über die Standardmenge hinaus zu erweitern.

Sie können die Copilot-CLI, das AWS SDK oder die CLI verwenden CloudFormation, um kurzlebigen Speicher für einen Bind-Mount anzugeben.