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

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 Sie eine Umgebung

Wenn die AWS Proton Umgebung mit einer Umgebungskontoverbindung verknüpft ist, aktualisieren oder fügen Sie den protonServiceRoleArn Parameter zum Aktualisieren oder Herstellen einer Verbindung mit einem Umgebungskonto nicht hinzu.

Sie können nur 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 mit dem Umgebungskonto ist mit der aktuellen Umgebung verknüpft.

Wenn die Umgebung keiner Verbindung mit einem Umgebungskonto zugeordnet ist, aktualisieren Sie den environmentAccountConnectionId Parameter nicht und fügen Sie ihn nicht hinzu.

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 für die Aktualisierung einer Umgebung, wie in der folgenden Liste beschrieben. Bei Verwendung von definiert das deployment-type Feld den Modus. AWS CLI Bei Verwendung der Konsole werden diese Modi den Aktionen Bearbeiten, Aktualisieren, Nebenaktualisierung und Hauptaktualisierung zugeordnet, die im Dropdownmenü Aktionen angezeigt werden.

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 die angeforderten Parameter werden aktualisiert. Geben Sie keine Parameter für Neben- oder Hauptversionen an, wenn Sie dies verwendendeployment-type.

MINOR_VERSION

In diesem Modus wird die Umgebung standardmäßig mit der veröffentlichten, empfohlenen (neuesten) Nebenversion der aktuell verwendeten Hauptversion bereitgestellt und 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 die Bereitstellung mit erfolgt. AWS CloudFormation

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

AWS Management Console
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 Änderung 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 die Metadateneingaben zu aktualisieren.

      1. Wählen Sie Aktionen und dann Aktualisieren aus.

      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 „Nebenprogramm 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 Hauptaktualisierung aus.

      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

Selbstverwaltete Bereitstellung wird nur von Umgebungen unterstützt, die mit Terraform bereitstellen.

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

AWS Management Console
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 Änderung 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 die Metadateneingaben zu aktualisieren.

      1. Wählen Sie Aktionen und dann Aktualisieren aus.

      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 „Nebenprogramm 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 Hauptaktualisierung aus.

      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 die 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üfen Sie die Pull-Anfrage, die 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, die 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 Update-Bereitstellung stornieren, wird AWS Proton versucht, die Bereitstellung wie in den folgenden Schritten beschrieben abzubrechen.

AWS Proton Führt mit AWS-managed Provisioning Folgendes aus:

  • Setzt den Bereitstellungsstatus auf. CANCELLING

  • Stoppt die laufende Bereitstellung und löscht alle neuen Ressourcen, die durch die Bereitstellung erstellt wurden, wannIN_PROGRESS.

  • Setzt den Bereitstellungsstatus aufCANCELLED.

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

AWS Proton Führt bei der selbstverwalteten Bereitstellung Folgendes aus:

  • Versucht, die Pull-Anfrage zu schließen, um zu verhindern, dass die Änderungen an Ihrem Repository zusammengeführt werden.

  • Setzt den Bereitstellungsstatus auf, CANCELLED wenn die Pull-Anfrage erfolgreich geschlossen wurde.

Anweisungen zum Abbrechen einer Umgebungsbereitstellung finden Sie CancelEnvironmentDeploymentin der AWS Proton APIReferenz.

Sie können die Konsole verwenden oder CLI Umgebungen stornieren, die gerade ausgeführt werden.

AWS Management Console

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 Umgebungen aus.

  2. Wählen Sie in der Liste der Umgebungen den Namen der Umgebung mit dem Bereitstellungsupdate aus, das Sie stornieren möchten.

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

  4. In einem Fenster 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 von Updates ist auf Storniert gesetzt und dann auf Storniert, um die Stornierung abzuschließen.

AWS CLI

Verwenden Sie den AWS Proton AWS CLI , um die Bereitstellung eines Updates in der PROGRESS IN_-Umgebung auf eine neue Nebenversion abzubrechen 2.

In der für dieses Beispiel verwendeten Vorlage ist eine Wartebedingung enthalten, sodass der Abbruch beginnt, bevor das Update erfolgreich bereitgestellt wird.

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"
    }
}