Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Alias di macchine a stati nei flussi di lavoro di Step Functions

Un alias è un puntatore per un massimo di due versioni della stessa macchina a stati. È possibile creare più alias per le proprie macchine a stati. Ogni alias ha un Amazon Resource Name (ARN) univoco. L'alias ARN è una combinazione dell'ARN della macchina a stati e del nome dell'alias, separati da due punti (:). L'esempio seguente mostra il formato di un alias ARN di una macchina a stati.

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

È possibile utilizzare un alias per indirizzare il traffico tra una delle due versioni della macchina a stati. È inoltre possibile creare un alias che punti a una singola versione. Gli alias possono puntare solo a versioni di macchine a stati. Non è possibile utilizzare un alias per puntare a un altro alias. È inoltre possibile aggiornare un alias in modo che punti a una versione diversa della macchina a stati.

Creazione di un alias per una macchina a stati (Console)

È possibile creare fino a 100 alias per ogni macchina a stati utilizzando la console Step Functions o richiamando l'azione CreateStateMachineAliasAPI. Per richiedere un aumento di questo limite flessibile, utilizza la pagina Support Center nel Console di gestione AWS. Elimina gli alias non utilizzati dalla console o richiamando l'DeleteStateMachineAliasazione API.

Gestione degli alias con le operazioni dell'API Step Functions

Step Functions fornisce le seguenti operazioni API che è possibile utilizzare per creare e gestire alias di macchine a stati o ottenere informazioni sugli alias:

Per creare un alias denominato PROD che punti alla versione 1 di una macchina a stati denominata myStateMachine utilizzando il AWS Command Line Interface, utilizzare il comando. create-state-machine-alias

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

Configurazione del routing dell'alias

È possibile utilizzare un alias per indirizzare il traffico di esecuzione tra due versioni di una macchina a stati. Ad esempio, supponiamo che tu voglia lanciare una nuova versione della tua macchina a stati. È possibile ridurre i rischi associati alla distribuzione della nuova versione configurando il routing su un alias. Configurando il routing, è possibile inviare la maggior parte del traffico a una versione precedente e testata della macchina a stati. La nuova versione può quindi ricevere una percentuale inferiore, fino a quando non confermerai che il rollforward della nuova versione è sicuro.

Per definire la configurazione del routing, assicurati di pubblicare entrambe le versioni della macchina a stati a cui fa riferimento il tuo alias. Quando si avvia un'esecuzione da un alias, Step Functions sceglie in modo casuale la versione della macchina a stati da eseguire tra le versioni specificate nella configurazione del routing. Basa questa scelta sulla percentuale di traffico assegnata a ciascuna versione nella configurazione di routing degli alias.

Esecuzione di una macchina a stati utilizzando un alias (Console)

È possibile avviare le esecuzioni delle macchine a stati con un alias dalla console o richiamando l'azione StartExecutionAPI con l'ARN dell'alias. Step Functions esegue quindi la versione specificata dall'alias. Per impostazione predefinita, se non si specifica una versione o un alias quando si avvia l'esecuzione di una macchina a stati, Step Functions utilizza la revisione più recente.