Aliase für Zustandsautomaten

Ein Alias ist ein Zeiger für bis zu zwei Versionen desselben Zustandsautomaten. Sie können mehrere Aliase für Ihre Zustandsautomaten erstellen. Jeder Alias hat einen eindeutigen Amazon-Ressourcennamen (ARN). Der Alias-ARN ist eine Kombination aus dem ARN des Zustandsautomaten und dem Aliasnamen, getrennt durch einen Doppelpunkt (:). Das folgende Beispiel zeigt das Format eines Zustandsautomaten-Alias-ARN.

arn:partition:states:region:account-id:stateMachine:myStateMachine:aliasName

Sie können einen Alias verwenden, um den Datenverkehr zwischen einer der beiden Zustandsautomaten-Versionen weiterzuleiten. Sie können auch einen Alias erstellen, der auf eine einzelne Version verweist. Aliase können nur auf Zustandsautomatenversionen verweisen. Sie können keinen Alias verwenden, um auf einen anderen Alias zu verweisen. Sie können auch einen Alias aktualisieren, der auf eine andere Version des Zustandsautomaten verweist.

Erstellen eines Zustandsautomaten-Alias (Konsole)

Sie können bis zu 100 Aliase für jeden Zustandsautomaten erstellen, indem Sie die Step-Functions-Konsole verwenden oder die CreateStateMachineAlias API-Aktion aufrufen. Um eine Erhöhung dieses Soft Limits anzufordern, verwenden Sie die Seite Support Center in der AWS Management Console. Löschen Sie nicht verwendete Aliase aus der Konsole oder durch Aufrufen der DeleteStateMachineAlias API-Aktion .

So erstellen Sie einen Zustandsautomaten-Alias

1. Öffnen Sie die Step-Functions-Konsole und wählen Sie dann einen vorhandenen Zustandsautomaten aus.

2. Wählen Sie auf der Detailseite des Zustandsautomaten die Registerkarte Aliasse aus.

3. Wählen Sie Neuen Alias erstellen aus.

4. Führen Sie auf der Seite Alias erstellen die folgenden Schritte aus:

   1. Geben Sie einen Aliasnamen ein.

   2. (Optional) Geben Sie eine Beschreibung für den Alias ein.

5. Informationen zum Konfigurieren des Routings für den Alias finden Sie unter Alias-Routing-Konfiguration.

6. Wählen Sie Alias erstellen aus.

Verwalten von Aliassen mit Step-Functions-API-Operationen

Step Functions bietet die folgenden API-Operationen, mit denen Sie Zustandsautomaten-Aliase erstellen und verwalten oder Informationen über die Aliase abrufen können:

• CreateStateMachineAlias – Erstellt einen Alias für einen Zustandsautomaten.

• DescribeStateMachineAlias – Gibt Details zu einem Zustandsautomaten-Alias zurück.

• ListStateMachineAliases – Listet Aliase für den angegebenen ARN des Zustandsautomaten auf.

• UpdateStateMachineAlias – Aktualisiert die Konfiguration eines vorhandenen Zustandsautomaten-Alias, indem dessen description oder geändert wirdroutingConfiguration.

• DeleteStateMachineAlias – Löscht eine Zustandsautomatenversion.

Verwenden Sie den Befehl PROD, um einen Alias mit dem Namen zu erstellen, der auf Version 1 eines Zustandsautomaten mit dem Namen myStateMachine verweist AWS Command Line Interfacecreate-state-machine-alias.

aws stepfunctions create-state-machine-alias --name PROD  --routing-configuration "[{\"stateMachineVersionArn\":\"arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:1\",\"weight\":100}]"

Alias-Weiterleitungskonfiguration

Sie können einen Alias verwenden, um den Ausführungsdatenverkehr zwischen zwei Versionen eines Zustandsautomaten weiterzuleiten. Angenommen, Sie möchten eine neue Version Ihres Zustandsautomaten starten. Sie können die mit der Bereitstellung der neuen Version verbundenen Risiken reduzieren, indem Sie Routing für einen Alias konfigurieren. Durch die Konfiguration von Routing können Sie den größten Teil Ihres Datenverkehrs an eine frühere, getestete Version Ihres Zustandsautomaten senden. Die neue Version kann dann einen kleineren Prozentsatz erhalten, bis Sie bestätigen können, dass es sicher ist, die neue Version vorzuziehen.

Um die Routing-Konfiguration zu definieren, stellen Sie sicher, dass Sie beide Zustandsautomatenversionen veröffentlichen, auf die Ihr Alias verweist. Wenn Sie eine Ausführung über einen Alias starten, wählt Step Functions nach dem Zufallsprinzip die Zustandsautomatenversion aus, die von den in der Routing-Konfiguration angegebenen Versionen ausgeführt werden soll. Diese Auswahl basiert auf dem Prozentsatz des Datenverkehrs, den Sie jeder Version in der Alias-Routing-Konfiguration zuweisen.

So konfigurieren Sie die Routing-Konfiguration für einen Alias

• Gehen Sie auf der Seite Alias erstellen unter Routing-Konfiguration wie folgt vor:

  1. Wählen Sie für Version die erste Zustandsautomatenversion aus, auf die der Alias verweist.

  2. Aktivieren Sie das Kontrollkästchen Datenverkehr zwischen zwei Versionen aufteilen.

     Tipp

     Um auf eine einzelne Version zu verweisen, deaktivieren Sie das Kontrollkästchen Datenverkehr zwischen zwei Versionen aufteilen.

  3. Wählen Sie für Version die zweite Version aus, auf die der Alias verweisen muss.

  4. Geben Sie in den Feldern Datenverkehr in Prozent den Prozentsatz des Datenverkehrs an, der an jede Version weitergeleitet werden soll. Geben Sie beispielsweise 60 und ein, 40 um 60 Prozent des Ausführungsdatenverkehrs an die erste Version und 40 Prozent des Datenverkehrs an die zweite Version weiterzuleiten.

     Die kombinierten Prozentsätze des Datenverkehrs müssen 100 Prozent entsprechen.

Ausführen eines Zustandsautomaten mit einem Alias (Konsole)

Sie können die Ausführung von Zustandsautomaten mit einem Alias über die Konsole oder durch Aufrufen der StartExecution API-Aktion mit dem ARN des Alias starten. Step Functions führt dann die durch den Alias angegebene Version aus. Wenn Sie beim Starten einer Zustandsautomaten-Ausführung keine Version oder keinen Alias angeben, verwendet Step Functions standardmäßig die neueste Revision.

So starten Sie die Ausführung eines Zustandsautomaten mit einem Alias

1. Öffnen Sie die Step-Functions-Konsole und wählen Sie dann einen vorhandenen Zustandsautomaten aus, für den Sie einen Alias erstellt haben. Informationen zum Erstellen eines Alias finden Sie unter Erstellen eines Zustandsautomaten-Alias (Konsole).

2. Wählen Sie auf der Detailseite des Zustandsautomaten die Registerkarte Aliasse aus.

3. Gehen Sie im Abschnitt Aliasse wie folgt vor:

   1. Wählen Sie den Alias aus, mit dem Sie die Ausführung starten möchten.

   2. Wählen Sie Start execution (Ausführung starten) aus.

4. (Optional) Geben Sie im Dialogfeld Ausführung starten einen Namen für die Ausführung ein.

5. Geben Sie bei Bedarf die Ausführungseingabe ein und wählen Sie dann Ausführung starten aus.