Überschreiben Sie Parameterwerte mit dem AWS Management Console oder AWS CLI

In einigen Fällen ist es möglicherweise empfehlenswert, dass Stack-Instances in bestimmten Regionen oder Konten andere Eigenschaftswerte besitzen als diejenigen, die im Stack-Set selbst angegeben werden. So möchten Sie beispielsweise abhängig davon, ob ein Konto für die Entwicklung oder die Produktion verwendet wird, für einen bestimmten Parameter einen anderen Wert angeben. Für diese Situationen erlaubt AWS CloudFormation Ihnen in Stack-Instances das Überschreiben von Parameterwerten nach Konto und Region. Sie können Vorlagen-Parameterwerte beim Erstellen neuer Stack-Instances oder auch bei vorhandenen Stack-Instances überschreiben. Nur Parameter, die zuvor in Stack-Instances überschrieben wurden, können wieder auf die im Stack-Set angegebenen Werte zurückgesetzt werden.

Die überschriebenen Parameterwerte werden auf Stack-Instances in den von Ihnen ausgewählten Konten und Regionen angewandt. Während Stack-Set-Aktualisierungen werden alle Parameterwerte, die für eine Stack-Instance überschrieben wurden, nicht aktualisiert, sondern behalten Ihren überschriebenen Wert bei.

Sie können nur Parameterwerte überschreiben, die im Stack-Set angegeben werden. Um einen Parameter selbst hinzuzufügen oder zu löschen, müssen Sie die Stack-Set-Vorlage aktualisieren. Wenn Sie einen Parameter zu einer Stack-Set-Vorlage hinzufügen, müssen Sie zuerst alle Stack-Instances mit dem neuen, im Stack-Set angegebenen Parameter und Wert aktualisieren, bevor Sie diesen Parameterwert in einer Stack-Instance überschreiben können. Nachdem alle Stack-Instances mit dem neuen Parameter aktualisiert wurden, können Sie den Parameterwert in den einzelnen Stack-Instances wie gewünscht überschreiben.

Informationen darüber, wie Stack-Set-Parameterwerte beim Erstellen von Stack-Instances überschrieben werden, finden Sie unter Fügen Sie Stack-Instances mit dem AWS Management Console oder hinzu AWS CLI.

Überschreiben Sie Parameter auf Stack-Instanzen mit dem AWS Management Console

1. Öffnen Sie die AWS CloudFormation Konsole unter https://console.aws.amazon.com/cloudformation.

2. StackSets. Wählen Sie auf der StackSets Seite das Stack-Set aus, in dem Sie es erstellt haben. Erstellen Sie ein Stack-Set mit dem AWS Management Console oder AWS CLI Im Rahmen dieser Anleitung haben wir ein Stack-Set mit der Bezeichnung my-awsconfig-stackset erstellt.

3. Wählen Sie das Stack-Set aus und wählen Sie im Menü „Aktionen“ die Option „ StackSetParameter überschreiben“.

4. Geben Sie auf der Seite Set deployment options (Bereitstellungsoptionen festlegen) die Konten und Regionen für die Stack-Instances ein, deren Parameter Sie überschreiben möchten.

   AWS CloudFormation stellt Stacks in den angegebenen Konten innerhalb der ersten Region bereit und fährt dann mit der nächsten fort usw., sofern die Bereitstellungsfehler einer Region eine festgelegte Fehlertoleranz nicht überschreiten.

   1. [Selbstverwaltete Berechtigungen] Wählen Sie für Deployment targets (Bereitstellungsziele) die Option Deploy stacks in accounts (Stacks in Konten bereitstellen) aus. Fügen Sie das ZielkontoIDs, mit dem Sie Ihr Stack-Set erstellt haben, ganz oder teilweise ein. Erstellen Sie ein Stack-Set mit dem AWS Management Console oder AWS CLI

      [Serviceverwaltete Berechtigungen] Wählen Sie für Deployment targets (Bereitstellungsziele) die Konten in Ihrer Organisation für die Bereitstellung aus.

      • Wählen Sie In Organisationseinheiten bereitstellen (OUs) aus. Wählen Sie eines oder mehrere Ziele ausOUs, mit denen Sie Ihr Stack-Set erstellt habenErstellen Sie ein Stack-Set mit dem AWS Management Console oder AWS CLI. Die überschriebenen Parameterwerte gelten nur für die Konten, die sich derzeit im Ziel befinden, OUs und für ihre untergeordneten Konten. OUs Konten, die dem Ziel OUs und ihrem Kind OUs in future hinzugefügt werden, verwenden die Standardwerte des Stacksets und nicht die überschriebenen Werte.

      • Wählen Sie Deploy to accounts (Für Konten bereitstellen) aus. Fügen Sie einige oder alle Ziel-OU IDs oder das Zielkonto einIDs, in dem Sie Ihr Stack-Set erstellt haben. Erstellen Sie ein Stack-Set mit dem AWS Management Console oder AWS CLI

   2. Fügen Sie für Deployment regions (Bereitstellungsregionen) eine oder mehrere der Regionen hinzu, in denen Sie Stack-Instances für dieses Stack-Set bereitgestellt haben.

      Wenn Sie mehrere Regionen hinzufügen, bestimmt die Reihenfolge der Regionen unter Specify regions (Regionen angeben) die Reihenfolge ihrer Bereitstellung.

   3. Für Deployment options (Bereitstellungsoptionen):

      • Für Maximum concurrent accounts (Maximale Anzahl paralleler Konten) behalten Sie die Standardwerte Number (Zahl) und 1 bei.

        Das bedeutet, AWS CloudFormation dass Ihr Stack jeweils nur in einem Konto bereitgestellt wird.

      • Behalten Sie für Failure tolerance (Fehlertoleranz) die Standardwerte Number (Zahl) und 0 bei.

        Das bedeutet, dass maximal eine Stack-Bereitstellung in einer der von Ihnen angegebenen Regionen fehlschlagen kann, bevor die Bereitstellung in der aktuellen Region AWS CloudFormation gestoppt und die Bereitstellung in den übrigen Regionen storniert wird.

      Wählen Sie Weiter.

5. Überprüfen Sie auf der Seite „Überschreibungen angeben“ den Parameter Frequenz und wählen Sie dann im Menü StackSet Überschreibungswert bearbeiten die Option Wert überschreiben aus.

6. Wählen Sie unter StackSet Parameterwerte überschreiben den Wert 6 Stunden für den Parameter Frequenz aus und wählen Sie Änderungen speichern aus. Sie weisen AWS CloudFormation an, den Frequency (Frequenz)-Parameterwert zu überschreiben und für alle Stack-Instances der angegebenen Konten in den angegebenen Regionen 6hours (6 Stunden) zu verwenden. Wählen Sie Weiter.

   Anmerkung

   Um alle überschriebenen Parameter wieder auf den Wert einzustellen, der im Stack-Set angegeben ist, überprüfen Sie alle Parameter und wählen Sie im Menü StackSetÜberschreibungswert bearbeiten die Option Auf Wert setzen. Dadurch werden alle überschriebenen Werte beim Aktualisieren der Stack-Instances entfernt.

7. Überprüfen Sie auf der Seite Review (Prüfen) Ihre Auswahl. Beachten Sie, dass der Parameter Frequency einen Wert in der Spalte Override value (Wert überschreiben) anzeigt, was angibt, dass sein Wert auf der Stack-Ebene überschrieben wurde.

   Bevor Sie Parameter für diese Stack-Instances überschreiben können, müssen Sie das Kontrollkästchen im Bereich Funktionen aktivieren, um zu bestätigen, dass für einige der Ressourcen, die Sie mit dem Stack-Set erstellen, möglicherweise neue IAM Ressourcen und Berechtigungen erforderlich sind. Weitere Informationen zu potenziell erforderlichen Berechtigungen finden Sie unterBestätigung von IAM Ressourcen in Vorlagen AWS CloudFormation. Wenn Sie bereit sind, wählen Sie Submit (Einsenden) aus.

8. AWS CloudFormation beginnt mit der Aktualisierung Ihrer Stack-Instances. Zeigen Sie Fortschritt und Status der Stack-Instances auf der StackSet-Detailseite an. Diese Seite wird geöffnet, wenn Sie Submit (Einsenden) auswählen.

Überschreiben Sie Parameter auf Stack-Instances mit dem AWS CLI

Wenn Sie als delegierter Administrator agieren, müssen Sie den --call-as Parameter DELEGATED_ADMIN jedes Mal, wenn Sie einen StackSets Befehl ausführen, auf einstellen.

--call-as DELEGATED_ADMIN

Führen Sie den update-stack-instances AWS CLI Befehl aus und geben Sie Folgendes --parameter-overrides an: Weitere Informationen zur Angabe --parameter-overrides finden Sie Parameterin der AWS CloudFormation API Referenz und update-stack-instancesin der AWS CLI Befehlsreferenz.

In dem hier gezeigten Beispielbefehl ändern wir die standardmäßige Snapshot-Lieferfrequenz für die Bereitstellungskanalkonfiguration von TwentyFour_Hours auf Twelve_Hours für die angegebenen Stack-Instances.

1. Führen Sie den folgenden Befehl aus. Geben Sie für den Namen des --stack-set-name Stack-Sets an my-awsconfig-stackset.

   Legen Sie die Fehlertoleranz und die maximale Anzahl gleichzeitiger Konten fest, indem Sie im Parameter FailureToleranceCount wie im folgenden Beispiel den Wert für 0 auf MaxConcurrentCount und für 1 auf --operation-preferences festlegen. Wenn Sie stattdessen Prozentwerte sehen möchten, verwenden Sie FailureTolerancePercentage oder MaxConcurrentPercentage. Für diesen Walkthrough verwenden wir Zählung, nicht Prozentsatz.

   Anmerkung

   Der Wert von MaxConcurrentCount hängt vom Wert von FailureToleranceCount ab. MaxConcurrentCount ist höchstens eins mehr als FailureToleranceCount.

   [Selbstverwaltete Berechtigungen] Geben Sie das Konto an, IDs für das Sie Parameterwerte auf Stack-Instances überschreiben möchten.

   aws cloudformation update-stack-instances --stack-set-name my-awsconfig-stackset --parameter-overrides ParameterKey=MaximumExecutionFrequency,ParameterValue=TwentyFour_Hours\\,Twelve_Hours --operation-preferences FailureToleranceCount=0,MaxConcurrentCount=1 --accounts '["012345678901"]' --regions '["eu-west-1", "us-west-2"]'

   [Vom Dienst verwaltete Berechtigungen] Geben Sie die Root-ID, OU oder das AWS Organizations Konto der Organisation anIDs, IDs für das Sie Parameter auf Stack-Instances überschreiben möchten. In diesem Beispiel überschreiben wir Parameterwerte für Stack-Instances in allen Konten in der Organisationseinheit mit ou-rcuk-1x5j1lwo ID.

   Die überschriebenen Parameterwerte gelten nur für die Konten, die sich derzeit in der Ziel-OU und ihrer untergeordneten Organisationseinheit befinden. OUs Konten, die der Ziel-OU und ihrer untergeordneten Organisationseinheit OUs in future hinzugefügt werden, verwenden die Standardwerte des Stacksets und nicht die überschriebenen Werte.

   aws cloudformation update-stack-instances --stack-set-name my-awsconfig-stackset --parameter-overrides ParameterKey=MaximumExecutionFrequency,ParameterValue=TwentyFour_Hours\\,Twelve_Hours --operation-preferences FailureToleranceCount=0,MaxConcurrentCount=1 --deployment-targets OrganizationalUnitIds='["ou-rcuk-1x5j1lwo"]' --regions '["eu-west-1", "us-west-2"]'

2. Stellen Sie sicher, dass Ihre Parameterwerte auf Stack-Instances erfolgreich überschrieben wurden, indem Sie den describe-stack-set-operation-Befehl ausführen, um den Status und die Ergebnisse des Aktualisierungsvorgangs anzuzeigen. Verwenden Sie als --operation-id die Operations-ID, die durch den Befehl update-stack-instances zurückgegeben wurde.

   aws cloudformation describe-stack-set-operation --operation-id operation_ID