View a markdown version of this page

Aktualisieren einer Umgebung - AWS Proton
Aktualisieren Sie eine AWS verwaltete BereitstellungsumgebungAktualisieren Sie eine selbstverwaltete BereitstellungsumgebungBrechen Sie eine laufende Umgebungsbereitstellung ab

Hinweis zum Ende des Supports: Am 7. Oktober 2026 AWS endet der Support für AWS Proton. Nach dem 7. Oktober 2026 werden Sie nicht mehr auf die AWS Proton Konsole oder AWS Proton die Ressourcen zugreifen können. Ihre bereitgestellte Infrastruktur bleibt intakt. Weitere Informationen finden Sie im AWS Proton Service Deprecation and Migration Guide.

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.

Aktualisieren einer Umgebung

Wenn die AWS Proton Umgebung mit einer Umgebungskontoverbindung verknüpft ist, aktualisieren Sie den protonServiceRoleArn Parameter nicht, um eine Umgebungskontoverbindung zu aktualisieren oder eine Verbindung herzustellen, und schließen Sie ihn nicht ein.

Sie können nur dann auf eine neue Umgebungskontoverbindung aktualisieren, wenn beide der folgenden Bedingungen zutreffen:

  • Die Umgebungskontoverbindung wurde in demselben Umgebungskonto erstellt, in dem die aktuelle Umgebungskontoverbindung erstellt wurde.

  • > Die Verbindung zum Umgebungskonto ist mit der aktuellen Umgebung verknüpft.

Wenn die Umgebung nicht mit einer Umgebungskontoverbindung verknüpft ist, aktualisieren Sie den environmentAccountConnectionId Parameter nicht und schließen Sie ihn nicht ein.

Sie können entweder den protonServiceRoleArn Parameter environmentAccountConnectionId oder und den Wert aktualisieren. Sie können nicht beide aktualisieren.

Wenn Ihre Umgebung selbstverwaltete Bereitstellung verwendet, aktualisieren Sie den Parameter nicht und lassen Sie die provisioning-repository Parameter und weg. environmentAccountConnectionId protonServiceRoleArn

Es gibt vier Modi zum Aktualisieren einer Umgebung, wie in der folgenden Liste beschrieben. Bei Verwendung von definiert das deployment-type Feld den Modus. AWS CLI Wenn Sie die Konsole verwenden, sind diese Modi den Aktionen Bearbeiten, Aktualisieren, Kleine Aktualisierung und Große Aktualisierung zugeordnet, die in der Liste Aktionen aufgeführt sind.

NONE

In diesem Modus findet keine Bereitstellung statt. Nur die angeforderten Metadatenparameter werden aktualisiert.

CURRENT_VERSION

In diesem Modus wird die Umgebung bereitgestellt und mit der neuen Spezifikation, die Sie angeben, aktualisiert. Nur angeforderte Parameter werden aktualisiert. Geben Sie keine Neben- oder Hauptversionsparameter an, wenn Sie dies verwendendeployment-type.

MINOR_VERSION

In diesem Modus wird die Umgebung bereitgestellt und mit der veröffentlichten, empfohlenen (neuesten) Nebenversion der aktuell verwendeten Hauptversion standardmäßig aktualisiert. Sie können auch eine andere Nebenversion der aktuell verwendeten Hauptversion angeben.

MAJOR_VERSION

In diesem Modus wird die Umgebung standardmäßig mit der veröffentlichten, empfohlenen (neuesten) Haupt- und Nebenversion der aktuellen Vorlage bereitgestellt und aktualisiert. Sie können auch eine andere Hauptversion angeben, die höher ist als die verwendete Hauptversion, und eine Nebenversion (optional).

Aktualisieren Sie eine AWS verwaltete Bereitstellungsumgebung

Die Standardbereitstellung wird nur von Umgebungen unterstützt, in denen Folgendes bereitgestellt wird. CloudFormation

Verwenden Sie die Konsole oder aktualisieren AWS CLI Sie Ihre Umgebung.

AWS-Managementkonsole
Aktualisieren Sie eine Umgebung mithilfe der Konsole, wie in den folgenden Schritten gezeigt.
  1. Wählen Sie einen der folgenden 2 Schritte aus.
    1. In der Liste der Umgebungen.

      1. Wählen Sie in der AWS Proton Konsole Umgebungen aus.

      2. Wählen Sie in der Liste der Umgebungen das Optionsfeld links neben der Umgebung aus, die Sie aktualisieren möchten.

    2. Auf der Detailseite der Konsolenumgebung.

      1. Wählen Sie in der AWS Proton Konsole Umgebungen aus.

      2. Wählen Sie in der Liste der Umgebungen den Namen der Umgebung aus, die Sie aktualisieren möchten.

  2. Wählen Sie einen der nächsten 4 Schritte aus, um Ihre Umgebung zu aktualisieren.
    1. Um eine Bearbeitung vorzunehmen, für die keine Bereitstellung der Umgebung erforderlich ist.

      1. Zum Beispiel, um eine Beschreibung zu ändern.

        Wählen Sie Bearbeiten aus.

      2. Füllen Sie das Formular aus und wählen Sie Weiter.

      3. Überprüfe deine Bearbeitung und wähle Aktualisieren.

    2. Um nur Aktualisierungen an Metadateneingaben vorzunehmen.

      1. Wählen Sie Aktionen und dann Aktualisieren.

      2. Füllen Sie das Formular aus und wählen Sie Bearbeiten.

      3. Füllen Sie die Formulare aus und wählen Sie Weiter, bis Sie zur Seite „Überprüfen“ gelangen.

      4. Überprüfen Sie Ihre Aktualisierungen und wählen Sie Aktualisieren.

    3. Um ein Update auf eine neue Nebenversion der zugehörigen Umgebungsvorlage vorzunehmen.

      1. Wählen Sie „Aktionen“ und dann „Nebenversion aktualisieren“.

      2. Füllen Sie das Formular aus und wählen Sie Weiter.

      3. Füllen Sie die Formulare aus und wählen Sie Weiter, bis Sie zur Seite „Überprüfen“ gelangen.

      4. Überprüfen Sie Ihre Aktualisierungen und wählen Sie Aktualisieren.

    4. Um ein Update auf eine neue Hauptversion der zugehörigen Umgebungsvorlage vorzunehmen.

      1. Wählen Sie Aktionen und dann Hauptversion aktualisieren.

      2. Füllen Sie das Formular aus und wählen Sie Weiter.

      3. Füllen Sie die Formulare aus und wählen Sie Weiter, bis Sie zur Seite „Überprüfen“ gelangen.

      4. Überprüfen Sie Ihre Aktualisierungen und wählen Sie Aktualisieren.

AWS CLI

Verwenden Sie den AWS Proton AWS CLI , um eine Umgebung auf eine neue Nebenversion zu aktualisieren.

Führen Sie den folgenden Befehl aus, um Ihre Umgebung zu aktualisieren:

$ aws proton update-environment \
        --name "MySimpleEnv" \
        --deployment-type "MINOR_VERSION" \
        --template-major-version "1" \
        --template-minor-version "1" \
        --proton-service-role-arn arn:aws:iam::123456789012:role/service-role/ProtonServiceRole \
        --spec "file:///spec.yaml"

Antwort:

{
    "environment": {
        "arn": "arn:aws:proton:region-id:123456789012:environment/MySimpleEnv",
        "createdAt": "2021-04-02T17:29:55.472000+00:00",
        "deploymentStatus": "IN_PROGRESS",        
        "lastDeploymentAttemptedAt": "2021-04-02T17:48:26.307000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T17:29:55.472000+00:00",
        "name": "MySimpleEnv",
        "protonServiceRoleArn": "arn:aws:iam::123456789012:role/service-role/ProtonServiceRole",
        "templateMajorVersion": "1",
        "templateMinorVersion": "0",
        "templateName": "simple-env"
    }
}

Führen Sie den folgenden Befehl aus, um den Status abzurufen und zu bestätigen:

$ aws proton get-environment \
        --name "MySimpleEnv"

Antwort:

{
    "environment": {
        "arn": "arn:aws:proton:region-id:123456789012:environment/MySimpleEnv",
        "createdAt": "2021-04-02T17:29:55.472000+00:00",
        "deploymentStatus": "SUCCEEDED",
        "environmentName": "MySimpleEnv",
        "lastDeploymentAttemptedAt": "2021-04-02T17:48:26.307000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T17:48:26.307000+00:00",
        "protonServiceRoleArn": "arn:aws:iam::123456789012:role/service-role/ProtonServiceRole",
        "spec": "proton: EnvironmentSpec\n\nspec:\n  my_sample_input: hello\n  my_other_sample_input: everybody\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "1",
        "templateName": "simple-env"
    }
}

Aktualisieren Sie eine selbstverwaltete Bereitstellungsumgebung

Self-managed Die Bereitstellung wird nur von Umgebungen unterstützt, die mit Terraform bereitgestellt werden.

Verwenden Sie die Konsole oder AWS CLI um Ihre Umgebung zu aktualisieren.

AWS-Managementkonsole
Aktualisieren Sie eine Umgebung mithilfe der Konsole, wie in den folgenden Schritten gezeigt.
  1. Wählen Sie einen der folgenden 2 Schritte aus.
    1. In der Liste der Umgebungen.

      1. Wählen Sie in der AWS Proton Konsole Umgebungen aus.

      2. Wählen Sie in der Liste der Umgebungen das Optionsfeld links neben der Umgebungsvorlage aus, die Sie aktualisieren möchten.

    2. Auf der Detailseite der Konsolenumgebung.

      1. Wählen Sie in der AWS Proton Konsole Umgebungen aus.

      2. Wählen Sie in der Liste der Umgebungen den Namen der Umgebung aus, die Sie aktualisieren möchten.

  2. Wählen Sie einen der nächsten 4 Schritte aus, um Ihre Umgebung zu aktualisieren.
    1. Um eine Bearbeitung vorzunehmen, für die keine Bereitstellung der Umgebung erforderlich ist.

      1. Zum Beispiel, um eine Beschreibung zu ändern.

        Wählen Sie Bearbeiten aus.

      2. Füllen Sie das Formular aus und wählen Sie Weiter.

      3. Überprüfe deine Bearbeitung und wähle Aktualisieren.

    2. Um nur Aktualisierungen an Metadateneingaben vorzunehmen.

      1. Wählen Sie Aktionen und dann Aktualisieren.

      2. Füllen Sie das Formular aus und wählen Sie Bearbeiten.

      3. Füllen Sie die Formulare aus und wählen Sie Weiter, bis Sie zur Seite „Überprüfen“ gelangen.

      4. Überprüfen Sie Ihre Aktualisierungen und wählen Sie Aktualisieren.

    3. Um ein Update auf eine neue Nebenversion der zugehörigen Umgebungsvorlage vorzunehmen.

      1. Wählen Sie „Aktionen“ und dann „Nebenversion aktualisieren“.

      2. Füllen Sie das Formular aus und wählen Sie Weiter.

      3. Füllen Sie die Formulare aus und wählen Sie Weiter, bis Sie zur Seite „Überprüfen“ gelangen.

      4. Überprüfen Sie Ihre Aktualisierungen und wählen Sie Aktualisieren.

    4. Um ein Update auf eine neue Hauptversion der zugehörigen Umgebungsvorlage vorzunehmen.

      1. Wählen Sie „Aktionen“ und dann „Hauptversion aktualisieren“.

      2. Füllen Sie das Formular aus und wählen Sie Weiter.

      3. Füllen Sie die Formulare aus und wählen Sie Weiter, bis Sie zur Seite „Überprüfen“ gelangen.

      4. Überprüfen Sie Ihre Aktualisierungen und wählen Sie Aktualisieren.

AWS CLI
Benutze das AWS CLI um eine Terraform-Umgebung auf eine neue Nebenversion mit selbstverwalteter Bereitstellung zu aktualisieren.

  1. Führen Sie den folgenden Befehl aus, um Ihre Umgebung zu aktualisieren:

    $ aws proton update-environment \
    --name "pr-environment" \
    --deployment-type "MINOR_VERSION" \
    --template-major-version "1" \
    --template-minor-version "1" \
    --provisioning-repository "branch=main,name=myrepos/env-repo,provider=GITHUB" \
    --spec "file://env-spec-mod.yaml"

    Antwort:

    {
    "environment": {
        "arn": "arn:aws:proton:region-id:123456789012:environment/pr-environment",
        "createdAt": "2021-11-18T21:09:15.745000+00:00",
        "deploymentStatus": "IN_PROGRESS",
        "lastDeploymentAttemptedAt": "2021-11-18T21:25:41.998000+00:00",
        "lastDeploymentSucceededAt": "2021-11-18T21:09:15.745000+00:00",
        "name": "pr-environment",
        "provisioningRepository": {
            "arn": "arn:aws:proton:region-id:123456789012:repository/github:myrepos/env-repo",
            "branch": "main",
            "name": "myrepos/env-repo",
            "provider": "GITHUB"
        },
        "templateMajorVersion": "1",
        "templateMinorVersion": "0",
        "templateName": "pr-env-template"
    }
}

  2. Führen Sie den folgenden Befehl aus, um den Status abzurufen und zu bestätigen:

    $ aws proton get-environment \
    --name "pr-environment"

    Antwort:

    {
    "environment": {
        "arn": "arn:aws:proton:region-id:123456789012:environment/pr-environment",
        "createdAt": "2021-11-18T21:09:15.745000+00:00",
        "deploymentStatus": "SUCCEEDED",
        "lastDeploymentAttemptedAt": "2021-11-18T21:25:41.998000+00:00",
        "lastDeploymentSucceededAt": "2021-11-18T21:25:41.998000+00:00",
        "name": "pr-environment",
        "provisioningRepository": {
            "arn": "arn:aws:proton:region-id:123456789012:repository/github:myrepos/env-repo",
            "branch": "main",
            "name": "myrepos/env-repo",
            "provider": "GITHUB"
        },
        "spec": "proton: EnvironmentSpec\nspec:\n   ssm_parameter_value: \"test\"\n ssm_another_parameter_value: \"update\"\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "1",
        "templateName": "pr-env-template"
    }
}

  3. Überprüfe den Pull-Request, der von gesendet wurde AWS Proton.

    • Wenn Sie die Anfrage genehmigen, ist die Bereitstellung im Gange.

    • Wenn Sie die Anfrage ablehnen, wird die Erstellung der Umgebung abgebrochen.

    • Wenn bei der Pull-Anfrage ein Timeout auftritt, ist die Erstellung der Umgebung nicht abgeschlossen.

  4. Geben Sie den Bereitstellungsstatus an AWS Proton.

    $ aws proton notify-resource-deployment-status-change \
    --resource-arn "arn:aws:proton:region-id:123456789012:environment/pr-environment" \
    --status "SUCCEEDED"

Brechen Sie eine laufende Umgebungsbereitstellung ab

Sie können versuchen, eine Bereitstellung eines Umgebungsupdates abzubrechen, wenn das aktiviert deploymentStatus istIN_PROGRESS. AWS Proton versucht, die Bereitstellung abzubrechen. Eine erfolgreiche Stornierung ist nicht garantiert.

Wenn Sie eine Aktualisierungsbereitstellung abbrechen, wird AWS Proton versucht, die Bereitstellung abzubrechen, wie in den folgenden Schritten aufgeführt.

Mit AWS-verwaltete Bereitstellung, AWS Proton macht Folgendes:

  • Setzt den Bereitstellungsstatus aufCANCELLING.

  • Stoppt die laufende Bereitstellung und löscht alle neuen Ressourcen, die bei der Bereitstellung erstellt wurden, wennIN_PROGRESS.

  • Setzt den Bereitstellungsstatus aufCANCELLED.

  • Setzt den Zustand der Ressource auf den Zustand vor dem Start der Bereitstellung zurück.

Bei der selbstverwalteten Bereitstellung AWS Proton macht Folgendes:

  • Versucht, den Pull Request zu schließen, um zu verhindern, dass die Änderungen in deinem Repository zusammengeführt werden.

  • Setzt den Bereitstellungsstatus auf den Status, CANCELLED wenn der Pull Request erfolgreich geschlossen wurde.

Anweisungen zum Abbrechen einer Umgebungsbereitstellung finden Sie CancelEnvironmentDeployment in der AWS Proton API-Referenz.

Sie können die Konsole oder CLI verwenden, um Umgebungen abzubrechen, die gerade in Bearbeitung sind.

AWS-Managementkonsole

Verwenden Sie die Konsole, um die Bereitstellung eines Umgebungsupdates abzubrechen, wie in den folgenden Schritten gezeigt.

  1. Wählen Sie in der AWS Proton Konsole im Navigationsbereich Environments aus.

  2. Wählen Sie in der Liste der Umgebungen den Namen der Umgebung aus, in der sich das Bereitstellungsupdate befindet, das Sie abbrechen möchten.

  3. Wenn der Status Ihrer Update-Bereitstellung in Bearbeitung lautet, wählen Sie auf der Seite mit den Umgebungsdetails die Option Aktionen und dann Bereitstellung abbrechen aus.

  4. In einem Modalfenster werden Sie aufgefordert, zu bestätigen, dass Sie den Vorgang abbrechen möchten. Wählen Sie Bereitstellung abbrechen aus.

  5. Ihr Status für die Bereitstellung des Updates wird auf Storniert und dann auf Storniert gesetzt, um die Stornierung abzuschließen.

AWS CLI

Verwenden Sie den AWS Proton AWS CLI , um die Bereitstellung eines IN_PROGRESS-Umgebungsupdates auf eine neue Nebenversion 2 abzubrechen.

Die für dieses Beispiel verwendete Vorlage enthält eine Wartebedingung, sodass der Abbruch beginnt, bevor die Aktualisierungsbereitstellung erfolgreich ist.

Führen Sie den folgenden Befehl aus, um das Update abzubrechen:

$ aws proton cancel-environment-deployment \
        --environment-name "MySimpleEnv"

Antwort:

{
    "environment": {
        "arn": "arn:aws:proton:region-id:123456789012:environment/MySimpleEnv",
        "createdAt": "2021-04-02T17:29:55.472000+00:00",
        "deploymentStatus": "CANCELLING",
        "lastDeploymentAttemptedAt": "2021-04-02T18:15:10.243000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T17:48:26.307000+00:00",
        "name": "MySimpleEnv",
        "protonServiceRoleArn": "arn:aws:iam::123456789012:role/service-role/ProtonServiceRole",
        "spec": "proton: EnvironmentSpec\n\nspec:\n  my_sample_input: hello\n  my_other_sample_input: everybody\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "1",
        "templateName": "simple-env"
    }
}

Führen Sie den folgenden Befehl aus, um den Status abzurufen und zu bestätigen:“

$ aws proton get-environment \
        --name "MySimpleEnv"

Antwort:

{
    "environment": {
        "arn": "arn:aws:proton:region-id:123456789012:environment/MySimpleEnv",
        "createdAt": "2021-04-02T17:29:55.472000+00:00",
        "deploymentStatus": "CANCELLED",
        "deploymentStatusMessage": "User initiated cancellation.",
        "lastDeploymentAttemptedAt": "2021-04-02T18:15:10.243000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T17:48:26.307000+00:00",
        "name": "MySimpleEnv",
        "protonServiceRoleArn": "arn:aws:iam::123456789012:role/service-role/ProtonServiceRole",
        "spec": "proton: EnvironmentSpec\n\nspec:\n  my_sample_input: hello\n  my_other_sample_input: everybody\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "1",
        "templateName": "simple-env"
    }
}