Hinweis zum Ende des Supports: Am 7. Oktober 2026 AWS endet der Support für AWS Proton. Nach dem 7. Oktober 2026 können Sie nicht mehr auf die AWS Proton Konsole oder AWS Proton die Ressourcen zugreifen. Ihre bereitgestellte Infrastruktur bleibt intakt. Weitere Informationen finden Sie im [AWS Proton Service Deprecation and Migration Guide](https://docs.aws.amazon.com/proton/latest/userguide/proton-end-of-support.html). 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* und fügen Sie ihn nicht hinzu, um eine Verbindung mit einem Umgebungskonto zu aktualisieren oder eine Verbindung herzustellen. 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 verwenden`deployment-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). **Topics** + [Aktualisieren Sie eine AWS verwaltete Bereitstellungsumgebung](#ag-env-std-update) + [Aktualisieren Sie eine selbstverwaltete Bereitstellungsumgebung](#ag-env-pr-update) + [Brechen Sie eine laufende Umgebungsbereitstellung ab](#ag-env-cancel) ## Aktualisieren Sie eine AWS verwaltete Bereitstellungsumgebung Die Standardbereitstellung wird nur von Umgebungen unterstützt, in denen die Bereitstellung mit erfolgt. 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](https://console.aws.amazon.com//proton/) **Umgebungen** aus. 1. Wählen Sie in der Liste der Umgebungen das Optionsfeld links neben der Umgebung aus, die Sie aktualisieren möchten. 1. ****Auf der Detailseite der Konsolenumgebung.**** 1. Wählen Sie in der [AWS Proton Konsole](https://console.aws.amazon.com//proton/) **Umgebungen** aus. 1. Wählen Sie in der Liste der Umgebungen den Namen der Umgebung aus, die Sie aktualisieren möchten. 1. **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. 1. Füllen Sie das Formular aus und wählen Sie **Weiter**. 1. Überprüfe deine Bearbeitung und wähle „**Aktualisieren**“. 1. **Um nur die Metadateneingaben zu aktualisieren.** 1. Wählen Sie **Aktionen** und dann **Aktualisieren** aus. 1. Füllen Sie das Formular aus und wählen Sie **Bearbeiten**. 1. Füllen Sie die Formulare aus und wählen Sie **Weiter**, bis Sie zur Seite **„Überprüfen**“ gelangen. 1. Überprüfen Sie Ihre Aktualisierungen und wählen Sie **Aktualisieren**. 1. **Um eine neue Nebenversion der zugehörigen Umgebungsvorlage zu aktualisieren.** 1. Wählen Sie „**Aktionen**“ und dann **„Nebenprogramm aktualisieren**“. 1. Füllen Sie das Formular aus und wählen Sie **Weiter**. 1. Füllen Sie die Formulare aus und wählen Sie **Weiter**, bis Sie zur Seite **„Überprüfen**“ gelangen. 1. Überprüfen Sie Ihre Aktualisierungen und wählen Sie **Aktualisieren**. 1. **Um eine neue Hauptversion der zugehörigen Umgebungsvorlage zu aktualisieren.** 1. Wählen Sie **Aktionen** und dann **Hauptaktualisierung** aus. 1. Füllen Sie das Formular aus und wählen Sie **Weiter**. 1. Füllen Sie die Formulare aus und wählen Sie **Weiter**, bis Sie zur Seite **„Überprüfen**“ gelangen. 1. Ü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-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](https://console.aws.amazon.com//proton/) **Umgebungen** aus. 1. Wählen Sie in der Liste der Umgebungen das Optionsfeld links neben der Umgebungsvorlage aus, die Sie aktualisieren möchten. 1. ****Auf der Detailseite der Konsolenumgebung.**** 1. Wählen Sie in der [AWS Proton Konsole](https://console.aws.amazon.com//proton/) **Umgebungen** aus. 1. Wählen Sie in der Liste der Umgebungen den Namen der Umgebung aus, die Sie aktualisieren möchten. 1. **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. 1. Füllen Sie das Formular aus und wählen Sie **Weiter**. 1. Überprüfe deine Bearbeitung und wähle „**Aktualisieren**“. 1. **Um nur die Metadateneingaben zu aktualisieren.** 1. Wählen Sie **Aktionen** und dann **Aktualisieren** aus. 1. Füllen Sie das Formular aus und wählen Sie **Bearbeiten**. 1. Füllen Sie die Formulare aus und wählen Sie **Weiter**, bis Sie zur Seite **„Überprüfen**“ gelangen. 1. Überprüfen Sie Ihre Aktualisierungen und wählen Sie **Aktualisieren**. 1. **Um eine neue Nebenversion der zugehörigen Umgebungsvorlage zu aktualisieren.** 1. Wählen Sie „**Aktionen**“ und dann **„Nebenprogramm aktualisieren**“. 1. Füllen Sie das Formular aus und wählen Sie **Weiter**. 1. Füllen Sie die Formulare aus und wählen Sie **Weiter**, bis Sie zur Seite **„Überprüfen**“ gelangen. 1. Überprüfen Sie Ihre Aktualisierungen und wählen Sie **Aktualisieren**. 1. **Um eine neue Hauptversion der zugehörigen Umgebungsvorlage zu aktualisieren.** 1. Wählen Sie **Aktionen** und dann **Hauptaktualisierung** aus. 1. Füllen Sie das Formular aus und wählen Sie **Weiter**. 1. Füllen Sie die Formulare aus und wählen Sie **Weiter**, bis Sie zur Seite **„Überprüfen**“ gelangen. 1. Ü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" } } ``` 1. 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" } } ``` 1. Ü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. 1. 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` ist`IN_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, wann`IN_PROGRESS`. + Setzt den Bereitstellungsstatus auf`CANCELLED`. + 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 [CancelEnvironmentDeployment](https://docs.aws.amazon.com/proton/latest/APIReference/API_CancelEnvironmentDeployment.html)in der *AWS Proton API-Referenz*. Sie können die Konsole oder CLI verwenden, um laufende Umgebungen abzubrechen. ------ #### [ 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](https://console.aws.amazon.com//proton/) im Navigationsbereich **Umgebungen** aus. 1. Wählen Sie in der Liste der Umgebungen den Namen der Umgebung mit dem Bereitstellungsupdate aus, das Sie stornieren möchten. 1. 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. 1. In einem Fenster werden Sie aufgefordert, zu bestätigen, dass Sie den Vorgang abbrechen möchten. Wählen Sie **Bereitstellung abbrechen** aus. 1. Ihr Status für die Bereitstellung von Updates ist 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\$1PROGRESS-Umgebungsupdates 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" } } ``` ------