View a markdown version of this page

AWSSupport-RecoverWorkSpaceWithApproval - AWS Systems Manager Riferimento al runbook dell’automazione

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à.

AWSSupport-RecoverWorkSpaceWithApproval

Description

Il AWSSupport-RecoverWorkSpaceWithApproval runbook esegue le fasi di ripristino sull'istanza Amazon WorkSpaces (WorkSpaces) specificata se il suo stato operativo èUnhealthy. A seconda dei valori specificati per i parametri di input e le istantanee disponibili, il runbook lo riavvia, ripristina e ricostruisce fino a raggiungere lo stato corrispondente. WorkSpaces Available Questo runbook utilizza l'azione di aws:approve automazione, che sospende temporaneamente l'automazione fino a quando i principali responsabili designati approvano o rifiutano le azioni di ripristino selezionate.

Importante

Il ripristino o la ricostruzione di un WorkSpace è un'azione potenzialmente distruttiva che può causare la perdita di dati. Questo perché WorkSpace viene ripristinato dall'ultima istantanea disponibile e i dati recuperati dalle istantanee possono durare fino a 12 ore.

L'opzione di ripristino ricrea sia il volume root che il volume utente in base alle istantanee più recenti. L'opzione rebuild ricrea il volume utente dall'istantanea più recente e ricrea quello WorkSpace dall'immagine associata al pacchetto da cui è stato creato. WorkSpace Le applicazioni installate o le impostazioni di sistema modificate dopo la WorkSpace creazione vengono perse. Per ulteriori informazioni sul ripristino e la ricostruzione WorkSpaces, consulta Restore a WorkSpace e Rebuild a WorkSpace nella Amazon WorkSpaces Administration Guide.

Prima di utilizzare questo runbook, ti consigliamo di consultare l'argomento Risoluzione dei WorkSpaces problemi di Amazon nella Amazon WorkSpaces Administration Guide.

Come funziona

Il runbook esegue le seguenti azioni di ripristino in sequenza, interrompendosi non appena WorkSpaces raggiunge uno stato: Available

  • Recupera lo stato iniziale di WorkSpaces e conferma che si trova in uno stato ripristinabile (Unhealthy,,Error, Impaired o). Stopped Available

  • Se lo WorkSpaces èStopped, lo avvia e attende il risultato.

  • Recupera le istantanee di ricostruzione e ripristino disponibili per. WorkSpaces

  • Invia una notifica di approvazione tramite Amazon Simple Notification Service (Amazon SNS) agli approvatori designati e mette in pausa fino all'approvazione o al rifiuto.

  • Se Reboot è approvata e impostata suYes, riavvia WorkSpaces e attende il risultato.

  • Se non lo WorkSpaces è ancora Available ed Restore è impostato suYes, ripristina l'istantanea WorkSpaces dell'ultima istantanea e attende il risultato.

  • Se non lo WorkSpaces è ancora Available ed Rebuild è impostato suYes, ricostruisce l'immagine del pacchetto WorkSpaces dall'immagine del pacchetto più recente e attende il risultato.

  • Conferma lo stato finale di is. WorkSpaces Available

Esegui questa automazione (console)

Tipo di documento

Automazione

Proprietario

Amazon

Piattaforme

/

Autorizzazioni IAM richieste

Il AutomationAssumeRole parametro richiede le seguenti azioni per utilizzare correttamente il runbook.

  • sns:Publish

  • workspaces:DescribeWorkspaces

  • workspaces:DescribeWorkspaceSnapshots

  • workspaces:RebootWorkspaces

  • workspaces:RebuildWorkspaces

  • workspaces:RestoreWorkspace

  • workspaces:StartWorkspaces

Policy IAM di esempio:


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "workspaces:DescribeWorkspaces",
                "workspaces:DescribeWorkspaceSnapshots",
                "workspaces:RebootWorkspaces",
                "workspaces:RebuildWorkspaces",
                "workspaces:RestoreWorkspace",
                "workspaces:StartWorkspaces"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": "sns:Publish",
            "Resource": "arn:aws:sns:*:*:Automation*"
        }
    ]
}
Istruzioni

Segui questi passaggi per configurare l'automazione:

  1. Aprire AWSSupport-RecoverWorkSpaceWithApprovalin Systems Manager in Documenti.

  2. Scegli Esegui automazione.

  3. Per i parametri di input, immettete quanto segue:

    • AutomationAssumeRole (Facoltativo):

      L'ARN del ruolo AWS IAM che consente a Systems Manager Automation di eseguire le azioni per tuo conto. Se non viene specificato alcun ruolo, Systems Manager Automation utilizza le autorizzazioni dell'utente che avvia questo runbook. Tipo:AWS::IAM::Role::Arn.

    • WorkspaceId (Obbligatorio):

      L'ID del file WorkSpaces da ripristinare. Deve corrispondere allo schema^ws-[0-9a-z]{8,63}$. Tipo:String.

    • Riavvio (opzionale):

      Impostato Yes per consentire il WorkSpaces riavvio di. Default: Yes. Valori consentiti: |Yes. No Tipo:String.

    • Ripristina (opzionale):

      YesImpostare per consentire WorkSpaces il ripristino di. Nel sistema viene ripristinata l'istantanea più recente del volume principale. Tutte le applicazioni installate o le impostazioni di sistema modificate dopo la creazione dell'istantanea più recente vengono perse. Il volume utente viene ricreato a partire dall'istantanea più recente e il contenuto corrente viene sovrascritto. Default: No. Valori consentiti: |. Yes No Tipo:String.

    • Ricostruisci (opzionale):

      Impostato Yes per consentire la ricostruzione WorkSpaces di. Il sistema viene aggiornato con l'immagine più recente del pacchetto da cui WorkSpaces è stato creato. Tutte le applicazioni installate o le impostazioni di sistema modificate dopo la WorkSpaces creazione vengono perse. Il volume utente viene ricreato a partire dall'istantanea più recente e il contenuto corrente viene sovrascritto. Default: No. Valori consentiti: |. Yes No Tipo:String.

    • Conferma (obbligatorio):

      Inserisci Yes per confermare che entrambe le azioni di ripristino e ricostruzione ripristinano lo WorkSpaces snapshot più recente e che i dati ripristinati dalle istantanee possono risalire a 12 ore. Schema consentito:. ^[Yy][Ee][Ss]$ Tipo:String.

    • Approvatori (obbligatorio):

      Un elenco di nomi utente o ARN IAM degli approvatori per l'azione di automazione. Puoi specificare i principali come nome utente IAM, ARN utente IAM, ARN del ruolo IAM o ARN dell'utente IAM assume il ruolo. Minimo: 1, massimo: 10. Tipo:StringList.

    • MinRequiredApprovals (Opzionale):

      Il numero minimo di approvazioni necessarie per riprendere l'esecuzione dell'automazione. Il valore non può superare il numero di approvatori definito dal parametro. Approvers Default: 1. Valori consentiti: 1 —. 10 Tipo:Integer.

    • SNSTopicArn (Obbligatorio):

      L'argomento ARN di Amazon SNS utilizzato per inviare la notifica di approvazione in sospeso. Il nome dell'argomento Amazon SNS deve essere preceduto da. Automation Tipo:String.

  4. Scegli Esegui.

  5. L'automazione si avvia.

  6. Il documento esegue le seguenti operazioni:

    • getWorkSpaceInitialState: recupera lo stato corrente di WorkSpaces.

    • assertWorkSpaceInitialState: conferma che si WorkSpaces trova in uno stato recuperabile (Available,,, Error StoppedUnhealthy, o). Impaired L'automazione termina se si WorkSpaces trova in qualsiasi altro stato.

    • branchOnWorkSpaceInitialState: filiali basate sullo WorkSpaces stato iniziale. SeStopped, procede all'avvio di WorkSpaces. IfUnhealthy, or ErrorImpaired, procede al recupero delle istantanee.

    • startWorkSpace: avvia WorkSpaces se si trovava in uno stato. Stopped

    • waitForStartWorkSpace: Attende fino a 10 minuti prima che Starting lo stato WorkSpaces venga raggiunto.

    • waitForStartWorkSpaceResult: Attende fino a 30 minuti che Available lo stato WorkSpaces raggiungaUnhealthy, ErrorImpaired, o dopo l'avvio.

    • getWorkSpaceStateAfterStart: recupera WorkSpaces lo stato dopo il tentativo di avvio.

    • branchOnWorkSpaceStateAfterStart: Se WorkSpaces èAvailable, passa all'asserzione finale. Altrimenti, procede al recupero delle istantanee.

    • getWorkSpaceSnapshots: recupera le istantanee di ricostruzione e ripristino disponibili per. WorkSpaces

    • approval: invia una notifica di approvazione all'argomento Amazon SNS specificato e sospende l'automazione per un massimo di 24 ore, in attesa che gli approvatori designati approvino o neghino le azioni di ripristino.

    • branchOnRebootAllowed: se Reboot è impostato su, procede al riavvio di. Yes WorkSpaces Altrimenti, passa al ramo di ripristino.

    • rebootWorkSpace: riavvia il. WorkSpaces

    • waitForRebootWorkSpace: Attende fino a 10 minuti prima che venga raggiunto WorkSpaces Rebooting lo stato.

    • waitForRebootWorkSpaceResult: Attende fino a 30 minuti per WorkSpaces raggiungere Unhealthy Available lo stato o dopo Error il riavvio.

    • getWorkSpaceStateAfterReboot: recupera WorkSpaces lo stato dopo il tentativo di riavvio.

    • branchOnWorkSpaceStateAfterReboot: Se WorkSpaces èAvailable, passa all'asserzione finale. Altrimenti, passa al ramo di ripristino.

    • branchOnRestoreAllowed: Se Restore è impostato suYes, procede con il ripristino di. WorkSpaces Altrimenti, procede al ramo di ricostruzione.

    • restoreWorkSpace: ripristina l'istantanea WorkSpaces dall'istantanea più recente. Se il ripristino non riesce, l'automazione passa al ramo di ricostruzione.

    • waitForRestoreWorkSpace: Attende fino a 10 minuti prima che venga raggiunto lo WorkSpaces stato. Restoring

    • waitForRestoreWorkSpaceResult: Attende fino a 30 minuti prima che Available lo stato WorkSpaces Unhealthy raggiunga o dopo il ripristino. Error

    • getWorkSpaceStateAfterRestore: recupera WorkSpaces lo stato dopo il tentativo di ripristino.

    • branchOnWorkSpaceStateAfterRestore: Se WorkSpaces èAvailable, passa all'asserzione finale. Altrimenti, procede al ramo di ricostruzione.

    • branchOnRebuildAllowed: Se Rebuild è impostato suYes, procede alla ricostruzione di. WorkSpaces Altrimenti, procede all'asserzione finale.

    • rebuildWorkSpace: ricostruisce l'immagine del WorkSpaces pacchetto più recente.

    • waitForRebuildWorkSpace: Attende fino a 10 minuti prima che lo stato venga raggiunto. WorkSpaces Rebuilding

    • waitForRebuildWorkSpaceResult: Attende fino a 30 minuti prima che Available lo stato WorkSpaces Unhealthy raggiunga o dopo la ricostruzione. Error

    • getWorkSpaceStateAfterRebuild: recupera WorkSpaces lo stato dopo il tentativo di ricostruzione.

    • assertWorkSpaceFinalState: conferma che lo WorkSpaces stato è. Available L'automazione fallisce se non WorkSpaces si trova in uno Available stato.

  7. Dopo il completamento, consulta la sezione Output per i risultati dettagliati dell'esecuzione.

Riferimenti

Systems Manager Automation