Panoramica delle opzioni di errore degli stack Condizioni per sospendere il rollback dello stack Mantieni risorse con provisioning effettuato correttamente (console)Mantieni risorse con provisioning effettuato correttamente (AWS CLI)

Opzioni di errore degli stack

Puoi sviluppare in modo iterativo le applicazioni quando si verificano errori di provisioning iniziando dal punto di errore senza eseguire il rollback delle risorse con provisioning effettuato correttamente. Specificando le opzioni di errore degli stack, puoi risolvere i problemi delle risorse con stato CREATE_FAILED o UPDATE_FAILED. Puoi effettuare il provisioning di opzioni di errore per tutte le implementazioni di stack e le operazioni di set di modifica.

L'impostazione delle operazioni di creazione su Preserve successfully provisioned resources (Mantieni le risorse con provisioning effettuato correttamente) mantiene lo stato delle risorse riuscite, mentre le risorse non riuscite continuano a presentare lo stato di esito negativo fino all'esecuzione dell'operazione di aggiornamento successiva.
L'impostazione delle operazioni di aggiornamento e modifica del set su Preserve successfully provisioned resources (Mantieni le risorse con provisioning effettuato correttamente) mantiene lo stato delle risorse riuscite durante il rollback delle risorse non riuscite all'ultimo stato stabile noto. Le risorse non riuscite presenteranno lo stato UPDATE_FAILED. Le risorse per le quali non è disponibile un ultimo stato stabile noto verranno eliminate in occasione della successiva operazione stack.

Per ulteriori dettagli su come sospendere il rollback delle risorse non riuscite, consulta le sezioni seguenti:

Panoramica delle opzioni di errore degli stack
Condizioni per sospendere il rollback dello stack
Mantieni risorse con provisioning effettuato correttamente (console)
Mantieni risorse con provisioning effettuato correttamente (AWS CLI)

Panoramica delle opzioni di errore degli stack

Prima di eseguire un'operazione dalla AWS CloudFormation console, dall'API o AWS CLI, specificare il comportamento in caso di errore delle risorse assegnate. Quindi, procedi con il processo di implementazione delle risorse senza altre modifiche. In caso di guasto operativo, CloudFormation si arresta al primo errore in ogni percorso di provisioning indipendente. CloudFormation identifica le dipendenze tra le risorse per parallelizzare le azioni di approvvigionamento indipendenti. Quindi procede al provisioning delle risorse su ogni percorso di provisioning indipendente fino a quando non si verifica un errore. Un errore in un percorso non influisce sugli altri percorsi di provisioning. CloudFormation continuerà a fornire le risorse fino al completamento o si interromperà in caso di errore diverso.

Risolvi eventuali problemi per continuare il processo di distribuzione. CloudFormation esegue gli aggiornamenti necessari prima di riprovare le azioni di provisioning su risorse che non è stato possibile fornire correttamente in precedenza. Puoi risolvere i problemi inviando un'operazione Retry (Riprova), Update (Aggiorna) o Rollback. Ad esempio, se stai effettuando il provisioning di un'istanza Amazon EC2 e l'istanza EC2 non riesce durante un'operazione di creazione, potresti voler indagare sull'errore, piuttosto che eseguire immediatamente il rollback della risorsa non riuscita. Puoi rivedere le verifiche dello stato del sistema e dello stato delle istanze, quindi seleziona l'operazione Retry (Riprova) operazione una volta risolti i problemi.

Quando un'operazione di stack ha esito negativo e hai specificato Preserve successfully provisioned resources (Mantieni le risorse con provisioning effettuato correttamente) dal menu Stack failure options (Opzioni di errore dello stack), puoi selezionare le seguenti opzioni.

Retry (Riprova): riprova l'operazione di provisioning sulle risorse non riuscite e continua il provisioning del modello fino al completamento dell'operazione di stack o al successivo errore. Seleziona questa opzione se il provisioning della risorsa non è riuscito a causa di un problema che non richiede modifiche al modello, ad esempio un'autorizzazione AWS Identity and Access Management (IAM).
Update (Aggiorna): le risorse con provisioning effettuato correttamente vengono aggiornate in base agli aggiornamenti dei modelli. Le risorse che non sono state create o aggiornate verranno riprovate. Seleziona questa opzione se il provisioning della risorsa non è riuscito a causa di errori del modello e questo è stato modificato. Quando aggiorni uno stack con stato FAILED, devi selezionare Preserve successfully provisioned resources (Mantieni risorse con provisioning effettuato correttamente) per Stack failure options (Opzioni di errore dello stack) per continuare ad aggiornare lo stack.
Ripristina: CloudFormation ripristina lo stack all'ultimo stato stabile conosciuto.

Condizioni per sospendere il rollback dello stack

Per sospendere il rollback delle risorse non riuscite nello stack, è necessario che siano soddisfatte le seguenti condizioni.

Devi specificare il parametro Preserve successfully provisioned resources (Mantieni risorse con provisioning effettuato correttamente) durante un'operazione di stack. Per ulteriori informazioni sul comportamento di rollback, vedere. Impostazione delle AWS CloudFormation opzioni dello stack
Un'operazione di stack deve presentare uno stato dello stack CREATE_FAILED o UPDATE_FAILED. Per informazioni sullo stato dello stack, vedere. Codici di stato dello stack

Nota

I tipi di aggiornamento non modificabili non sono supportati.

Mantieni risorse con provisioning effettuato correttamente (console)

Create stack

Per mantenere le risorse con provisioning effettuato correttamente durante un'operazione di creazione dello stack

Accedi AWS Management Console e apri la AWS CloudFormation console all'indirizzo https://console.aws.amazon.com/cloudformation.
Scegli Create stack (Crea stack) e seleziona With new resources (standard) (Con nuove risorse [standard]).
Nella pagina Specify template (Specifica modello), scegliere un modello di stack utilizzando una delle opzioni seguenti:
- Template is ready (Il modello è pronto)
- Use a sample template (Utilizza un modello di esempio)
- Compila da Application Composer
Accetta le impostazioni desiderate e seleziona Next (Avanti).
Nella pagina Specify stack details (Specifica dettagli stack), immetti il nome dello stack nella casella Stack name (Nome stack).
Nella sezione Parameters (Parametri), specifica i parametri definiti nel modello di stack.

È possibile utilizzare o modificare qualsiasi parametro con i valori predefiniti.
Una volta definiti i valori dei parametri, seleziona Next (Avanti).
Nella pagina Configure stack options (Configura opzioni stack), puoi impostare ulteriori opzioni per lo stack.
Per Stack failure options (Opzioni di errore dello stack), seleziona Preserve successfully provisioned resources (Mantieni risorse con provisioning effettuato correttamente).
Una volta definite le opzioni di stack, seleziona Next (Avanti).
Rivedi lo stack nella pagina Review (Rivedi) e seleziona Create stack (Crea stack).

Results (Risultati): risorse che non sono riuscite a creare la transizione dello stato dello stack in CREATE_FAILED per impedire il rollback dello stack quando l'operazione di stack riscontra un errore. Le risorse con provisioning effettuato correttamente presentano lo stato CREATE_COMPLETE. Puoi monitorare lo stack nella scheda Stack events (Eventi stack).

Update stack

Per mantenere le risorse con provisioning effettuato correttamente durante un'operazione di aggiornamento dello stack

Accedi AWS Management Console e apri la AWS CloudFormation console all'indirizzo https://console.aws.amazon.com/cloudformation.
Seleziona lo stack che desideri aggiornare, quindi seleziona Update (Aggiorna).
Nella pagina Update stack (Aggiorna stack), scegli un modello di stack utilizzando una delle opzioni seguenti:
- Use current template (Utilizza modello corrente)
- Replace current template (Sostituisci modello corrente)
- Modifica il modello in Application Composer
Accetta le impostazioni desiderate e seleziona Next (Avanti).
Nella pagina Specify stack details (Specifica dettagli stack), specifica i parametri definiti nel modello di stack.

È possibile utilizzare o modificare qualsiasi parametro con i valori predefiniti.
Una volta definiti i valori dei parametri, seleziona Next (Avanti).
Nella pagina Configure stack options (Configura opzioni stack), puoi impostare ulteriori opzioni per lo stack.
Per Behavior on provisioning failure (Comportamento con errore di provisioning), seleziona Preserve successfully provisioned resources (Mantieni risorse con provisioning effettuato correttamente).
Una volta definite le opzioni di stack, seleziona Next (Avanti).
Rivedi lo stack nella pagina Review (Rivedi) e seleziona Update stack (Aggiorna stack).

Risultati: le risorse che non sono riuscite ad aggiornare la transizione dello stato dello stack in UPDATE_FAILED ed eseguire il rollback all'ultimo stato stabile noto. Le risorse senza un ultimo stato stabile noto verranno eliminate CloudFormation alla successiva operazione di stack. Le risorse di cui è stato eseguito il provisioning presentano lo stato CREATE_COMPLETE o UPDATE_COMPLETE. Puoi monitorare lo stack nella scheda Stack events (Eventi stack).

Change set

Nota

Puoi avviare un set di modifiche per uno stack con stato CREATE_FAILED o UPDATE_FAILED, ma non per uno stato UPDATE_ROLLBACK_FAILED.

Per mantenere le risorse con provisioning effettuato correttamente durante un'operazione di modifica del set

Accedi AWS Management Console e apri la AWS CloudFormation console all'indirizzo https://console.aws.amazon.com/cloudformation.
Seleziona lo stack che contiene il set di modifiche che desideri avviare, quindi scegli la scheda Change sets (Set di modifiche).
Seleziona il set di modifiche, quindi scegli Execute (Esegui).
Per Execute change set (Esegui set di modifiche), seleziona l'opzione Preserve successfully provisioned resources (Mantieni risorse con provisioning effettuato correttamente).
Seleziona Execute change set (Esegui set di modifiche).

Mantieni risorse con provisioning effettuato correttamente (AWS CLI)

Create stack

Per mantenere le risorse con provisioning effettuato correttamente durante un'operazione di creazione dello stack

Specifica l'opzione --disable-rollback o l'enumerazione on-failure DO_NOTHING durante un'operazione create-stack.

Fornisci un nome e un modello di stack per il comando create-stack con l'opzione --disable-rollback.


aws cloudformation create-stack --stack-name myteststack --template-body file://DOC-EXAMPLE-BUCKET.json --disable-rollback

Questo comando restituisce il seguente output.

{
    "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896"
}

Descrivi lo stato dello stack usando il describe-stacks comando.


aws cloudformation describe-stacks --stack-name myteststack

Questo comando restituisce il seguente output.

{
    "Stacks":  [
        {
            "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896",
            "Description": "AWS CloudFormation Sample Template",
            "Tags": [],
            "Outputs": [],
            "StackStatusReason": “The following resource(s) failed to create: [MyBucket]”,
            "CreationTime": "2013-08-23T01:02:15.422Z",
            "Capabilities": [],
            "StackName": "myteststack",
            "StackStatus": "CREATE_FAILED",
            "DisableRollback": true
        }
    ]
}

Update stack

Per preservare le risorse fornite correttamente durante un'operazione di aggiornamento dello stack

Fornisci un nome e un modello di stack esistenti per il comando update-stack con l'opzione --disable-rollback.


aws cloudformation update-stack --stack-name myteststack --template-url DOC-EXAMPLE-BUCKET.template --disable-rollback

Questo comando restituisce il seguente output.

{
    "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896"
}

Descrivi lo stato dello stack utilizzando il describe-stacks comando or. describe-stack-events


aws cloudformation describe-stacks --stack-name myteststack

Questo comando restituisce il seguente output.

{
    "Stacks":  [
        {
            "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896",
            "Description": "AWS CloudFormation Sample Template",
            "Tags": [],
            "Outputs": [],
            "CreationTime": "2013-08-23T01:02:15.422Z",
            "Capabilities": [],
            "StackName": "myteststack",
            "StackStatus": "UPDATE_COMPLETE",
            "DisableRollback": true
        }
    ]
}

Change set

Nota

Puoi avviare un set di modifiche per uno stack con stato CREATE_FAILED o UPDATE_FAILED, ma non per uno stato UPDATE_ROLLBACK_FAILED.

Per mantenere le risorse con provisioning effettuato correttamente durante un'operazione di modifica del set

Specificate l'--disable-rollbackopzione durante un'execute-change-setoperazione.

Fornisci un nome e un modello di stack per il comando execute-change-set con l'opzione --disable-rollback.


aws cloudformation execute-change-set --stack-name myteststack --change-set-name my-change-set --template-body file://template.yaml

Questo comando restituisce il seguente output.

{
 "Id": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/my-change-set/bc9555ba-a949-xmpl-bfb8-f41d04ec5784",
 "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896"
}

Avvia il set di modifiche con l'opzione --disable-rollback.


aws cloudformation execute-change-set --stack-name myteststack --change-set-name my-change-set -–disable-rollback

Determina lo stato dello stack utilizzando il describe-stack-events comando describe-stacks o.


{
   "StackEvents": [
     {
        "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896",
        "EventId": "49c966a0-7b74-11ea-8071-024244bb0672",
        "StackName": "myteststack",
        "LogicalResourceId": " MyBucket",
        "PhysicalResourceId": "MyBucket",
        "ResourceType": "AWS::S3::Bucket",
        "Timestamp": "2020-04-10T21:43:17.015Z",
        "ResourceStatus": "UPDATE_FAILED"
        "ResourceStatusReason": "User XYZ is not allowed to perform S3::UpdateBucket on MyBucket"
     }
}

Correggi gli errori di autorizzazione e riprova l'operazione.


aws cloudformation update-stack --stack-name myteststack --use-previous-template --disable-rollback

Questo comando restituisce il seguente output.

{
    "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896"
}

Descrivi lo stato dello stack usando il comando describe-stacks odescribe-stack-events.


aws cloudformation describe-stacks --stack-name myteststack

Questo comando restituisce il seguente output.

{
    "Stacks":  [
        {
            "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896",
            "Description": "AWS CloudFormation Sample Template",
            "Tags": [],
            "Outputs": [],
            "CreationTime": "2013-08-23T01:02:15.422Z",
            "Capabilities": [],
            "StackName": "myteststack",
            "StackStatus": "UPDATE_COMPLETE",
            "DisableRollback": true
        }
    ]
}

Rollback dello stack

Per eseguire il rollback di uno stack dallo stato CREATE_FAILED o UPDATE_FAILED

Utilizzate il rollback-stack comando per riportare uno stack all'ultimo stato stabile.

Avvia un rollback con il rollback-stack comando e specifica il nome dello stack.


aws cloudformation rollback-stack --stack-name myteststack

Questo comando restituisce il seguente output.

{
    "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896"
}

Nota

L'operazione rollback-stack eliminerà uno stack se non contiene un ultimo stato stabile noto.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

distribuzione dello stack

Spostamento di risorse tra stack