Geben Sie die EBS Amazon-Volume-Konfiguration bei der ECS Amazon-Bereitstellung an

Nachdem Sie eine Aufgabendefinition mit dem configuredAtLaunch Parameter auf registriert habentrue, können Sie ein EBS Amazon-Volume bei der Bereitstellung konfigurieren, wenn Sie eine eigenständige Aufgabe ausführen oder wenn Sie einen Service erstellen oder aktualisieren.

Um ein Volume zu konfigurieren, können Sie Amazon ECS APIs verwenden oder eine JSON Datei als Eingabe für die folgenden AWS CLI Befehle übergeben:

• run-taskum eine eigenständige ECS Aufgabe auszuführen.

• start-taskum eine eigenständige ECS Aufgabe in einer bestimmten Container-Instance auszuführen. Dieser Befehl gilt nicht für Aufgaben vom Typ Fargate Launch.

• create-serviceum einen neuen ECS Dienst zu erstellen.

• update-serviceum einen bestehenden Dienst zu aktualisieren.

Anmerkung

Damit ein Container in Ihrer Aufgabe auf das bereitgestellte EBS Amazon-Volume schreiben kann, müssen Sie den Container als Root-Benutzer ausführen.

Sie können ein EBS Amazon-Volume auch mit dem konfigurieren AWS Management Console. Weitere Informationen finden Sie unter Eine Anwendung als ECS Amazon-Aufgabe ausführen, Einen ECS Amazon-Service mithilfe der Konsole erstellen und Einen ECS Amazon-Service mithilfe der Konsole aktualisieren.

Der folgende JSON Ausschnitt zeigt alle Parameter eines EBS Amazon-Volumes, die bei der Bereitstellung konfiguriert werden können. Um diese Parameter für die Volume-Konfiguration zu verwenden, ersetzen Sie sie durch Ihre eigenen Informationen. user input placeholders Weitere Informationen zu diesen Parametern finden Sie unter Volume-Konfigurationen.

"volumeConfigurations": [
        {
            "name": "ebs-volume", 
            "managedEBSVolume": {
                "encrypted": true, 
                "kmsKeyId": "arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", 
                "volumeType": "gp3", 
                "sizeInGiB": 10, 
                "snapshotId": "snap-12345", 
                "iops": 3000, 
                "throughput": 125, 
                "tagSpecifications": [
                    {
                        "resourceType": "volume", 
                        "tags": [
                            {
                                "key": "key1", 
                                "value": "value1"
                            }
                        ], 
                        "propagateTags": "NONE"
                    }
                ], 
                "roleArn": "arn:aws::iam:1111222333:role/ecsInfrastructureRole", 
                 "terminationPolicy": {
                    "deleteOnTermination": true//can't be configured for service-managed tasks, always true 
                },
                "filesystemType": "ext4"
            }
        }
    ]

Wichtig

Stellen volumeName Sie sicher, dass die, die volumeName Sie in der Konfiguration angeben, mit der in Ihrer Aufgabendefinition angegebenen übereinstimmt.

Informationen zur Überprüfung des Status eines Volume-Anhangs finden Sie unterFehlerbehebung Amazon EBS Amazon-Volumenanhängen zu ECS Amazon-Aufgaben . Informationen zur Amazon-Rolle ECS infrastructure AWS Identity and Access Management (IAM), die für das Anhängen von EBS Volumen erforderlich ist, finden Sie unterIAMRolle bei der ECS Amazon-Infrastruktur.

Im Folgenden finden Sie JSON Ausschnitte, die die Konfiguration von EBS Amazon-Volumes zeigen. Diese Beispiele können verwendet werden, indem die Snippets in JSON Dateien gespeichert und die Dateien als Parameter (unter Verwendung des --cli-input-json file://filename Parameters) für Befehle übergeben werden. AWS CLI Ersetzen Sie user input placeholders durch Ihre Informationen.

Konfigurieren Sie ein Volume für eine eigenständige Aufgabe

Der folgende Ausschnitt zeigt die Syntax für die Konfiguration von EBS Amazon-Volumes für den Anhang an eine eigenständige Aufgabe. Der folgende JSON Ausschnitt zeigt die Syntax für die Konfiguration der EinstellungenvolumeType,sizeInGiB, encrypted und. kmsKeyId Die in der JSON Datei angegebene Konfiguration wird verwendet, um ein EBS Volume zu erstellen und an die eigenständige Aufgabe anzuhängen.

{
   "cluster": "mycluster",
   "taskDefinition": "mytaskdef",
   "volumeConfigurations": [
        {
            "name": "datadir",
            "managedEBSVolume": {
                "volumeType": "gp3",
                "sizeInGiB": 100,
                "roleArn":"arn:aws:iam:1111222333:role/ecsInfrastructureRole",
                "encrypted": true,
                "kmsKeyId": "arn:aws:kms:region:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"
            }
        }
   ]
}

Konfigurieren Sie ein Volume bei der Diensterstellung

Der folgende Ausschnitt zeigt die Syntax für die Konfiguration von EBS Amazon-Volumes für den Anhang an Aufgaben, die von einem Service verwaltet werden. Die Volumes werden mithilfe von aus dem Snapshot abgerufen. snapshotId Die in der JSON Datei angegebene Konfiguration wird verwendet, um für jede vom Dienst verwaltete Aufgabe ein EBS Volume zu erstellen und es diesen zuzuordnen.

{
   "cluster": "mycluster",
   "taskDefinition": "mytaskdef",
   "serviceName": "mysvc",
   "desiredCount": 2,
   "volumeConfigurations": [
        {
            "name": "myEbsVolume",
            "managedEBSVolume": {
              "roleArn":"arn:aws:iam:1111222333:role/ecsInfrastructureRole",
              "snapshotId": "snap-12345"
            }
        }
   ]
}

Konfigurieren Sie ein Volume bei der Aktualisierung des Dienstes

Der folgende JSON Ausschnitt zeigt die Syntax für die Aktualisierung eines Services, für den zuvor keine EBS Amazon-Volumes für das Anhängen an Aufgaben konfiguriert waren. Sie müssen die Revision ARN einer Aufgabendefinition mit der configuredAtLaunch Einstellung auf angeben. true Der folgende JSON Ausschnitt zeigt die Syntax für die Konfiguration der Einstellungen volumeTypesizeInGiB, throughputiops, und und. filesystemType Diese Konfiguration wird verwendet, um für jede vom Dienst verwaltete Aufgabe ein EBS Volume zu erstellen und es diesen zuzuordnen.

{
   "cluster": "mycluster",
   "taskDefinition": "mytaskdef",
   "serviceName": "mysvc",
   "desiredCount": 2,
  "volumeConfigurations": [
        {
            "name": "myEbsVolume",
            "managedEBSVolume": {
              "roleArn":"arn:aws:iam:1111222333:role/ecsInfrastructureRole",
               "volumeType": "gp3",
                "sizeInGiB": 100,
                 "iops": 3000, 
                "throughput": 125, 
                "filesystemType": "ext4"
            }
        }
   ]
}

Einen Service so konfigurieren, dass er EBS Amazon-Volumes nicht mehr nutzt

Der folgende JSON Ausschnitt zeigt die Syntax für die Aktualisierung eines Dienstes, sodass er keine EBS Amazon-Volumes mehr nutzt. Sie müssen eine Aufgabendefinition mit ARN der configuredAtLaunch Einstellung auf false oder eine Aufgabendefinition ohne den configuredAtLaunch Parameter angeben. Sie müssen auch ein leeres volumeConfigurations Objekt angeben.

{
   "cluster": "mycluster",
   "taskDefinition": "mytaskdef",
   "serviceName": "mysvc",
   "desiredCount": 2,
   "volumeConfigurations": []
}

Kündigungsrichtlinie für EBS Amazon-Volumes

Wenn eine ECS Amazon-Aufgabe beendet wird, bestimmt Amazon ECS anhand des deleteOnTermination Werts, ob das EBS Amazon-Volume, das mit der beendeten Aufgabe verknüpft ist, gelöscht werden soll. Standardmäßig werden EBS Volumes, die Aufgaben zugeordnet sind, gelöscht, wenn die Aufgabe beendet wird. Bei eigenständigen Aufgaben können Sie diese Einstellung so ändern, dass das Volumen beim Beenden der Aufgabe erhalten bleibt.

Anmerkung

Volumes, die an Aufgaben angehängt sind, die von einem Dienst verwaltet werden, bleiben nicht erhalten und werden immer gelöscht, wenn die Aufgabe beendet wird.

Schlagwort Amazon EBS Volumes

Sie können EBS Amazon-Volumes mithilfe des tagSpecifications Objekts taggen. Mithilfe des Objekts können Sie Ihre eigenen Tags angeben und die Weitergabe von Tags aus der Aufgabendefinition oder dem Service festlegen, je nachdem, ob das Volume an eine eigenständige Aufgabe oder eine Aufgabe in einem Service angehängt ist. Die maximale Anzahl von Tags, die an ein Volume angehängt werden können, ist 50.

Wichtig

Amazon hängt die Tags AmazonECSCreated und die AmazonECSManaged reservierten Tags ECS automatisch an ein EBS Amazon-Volume an. Das bedeutet, dass Sie das Anhängen von maximal 48 zusätzlichen Tags an ein Volume steuern können. Bei diesen zusätzlichen Tags kann es sich um benutzerdefinierte, ECS verwaltete oder weitergegebene Tags handeln.

Wenn Sie Ihrem Volume von ECS Amazon verwaltete Tags hinzufügen möchten, müssen Sie dies true in Ihrem StartTask AnrufUpdateService,CreateService, RunTask oder einstellenenableECSManagedTags. Wenn Sie von Amazon ECS verwaltete Tags aktivieren, kennzeichnet Amazon ECS das Volume automatisch mit Cluster- und Serviceinformationen (aws:ecs:clusterNameundaws:ecs:serviceName). Weitere Informationen zum Taggen von ECS Amazon-Ressourcen finden Sie unter Taggen Ihrer ECS Amazon-Ressourcen.

Der folgende JSON Ausschnitt zeigt die Syntax für die Kennzeichnung jedes EBS Amazon-Volumes, das jeder Aufgabe in einem Service zugeordnet ist, mit einem benutzerdefinierten Tag. Um dieses Beispiel für die Erstellung eines Services zu verwenden, ersetzen Sie das durch Ihre eigenen Informationenuser input placeholders.

{
   "cluster": "mycluster",
   "taskDefinition": "mytaskdef",
   "serviceName": "mysvc",
   "desiredCount": 2,
   "enableECSManagedTags": true,
   "volumeConfigurations": [
        {
            "name": "datadir",
            "managedEBSVolume": {
                "volumeType": "gp3",
                "sizeInGiB": 100,
                 "tagSpecifications": [
                    {
                        "resourceType": "volume", 
                        "tags": [
                            {
                                "key": "key1", 
                                "value": "value1"
                            }
                        ], 
                        "propagateTags": "NONE"
                    }
                ]
                "roleArn":"arn:aws:iam:1111222333:role/ecsInfrastructureRole",
                "encrypted": true,
                "kmsKeyId": "arn:aws:kms:region:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"
            }
        }
   ]
}

Wichtig

Sie müssen einen volume Ressourcentyp angeben, um EBS Amazon-Volumes zu kennzeichnen.