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) che specifichi se è operativa. Unhealthy A seconda dei valori specificati per i parametri di input e le istantanee disponibili, il runbook si riavvia, ripristina e ricostruisce fino a raggiungere il suo stato. WorkSpaces Available Questo runbook utilizza l'azione di aws:approve automazione, che sospende temporaneamente l'automazione fino a quando i responsabili designati non approvano o negano 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 risalire anche a 12 ore.

L'opzione di ripristino ricrea sia il volume principale 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 è stata creata. 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 and Rebuild a WorkSpace nella Amazon WorkSpaces Administration Guide.

Prima di utilizzare questo runbook, ti consigliamo di consultare l'argomento Troubleshooting Amazon WorkSpaces Issues nella Amazon Administration Guide. WorkSpaces

Come funziona

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

  • Recupera lo stato iniziale di WorkSpaces e conferma che è in uno stato recuperabile (Unhealthy,, ErrorImpaired, Stopped o). 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 si interrompe fino all'approvazione o al rifiuto.

  • Se approvato e Reboot impostato suYes, riavvia WorkSpaces e attende il risultato.

  • Se ancora non lo WorkSpaces è Available ed Restore è impostato suYes, ripristina l'istantanea WorkSpaces dall'istantanea più recente e attende il risultato.

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

  • Conferma lo stato finale dell'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. Apri AWSSupport-RecoverWorkSpaceWithApproval in Systems Manager sotto Documenti.

  2. Scegli Esegui automazione.

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

    • AutomationAssumeRole (Facoltativo):

      L'ARN del ruolo AWS IAM che consente a Systems Manager Automation di eseguire le azioni per conto dell'utente. 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 recuperare. Deve corrispondere allo schema^ws-[0-9a-z]{8,63}$. Tipo:String.

    • Riavvio (opzionale):

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

    • Ripristina (opzionale):

      Impostato Yes su WorkSpaces per consentire il ripristino. Il sistema viene ripristinato all'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 WorkSpaces la ricostruzione. 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.

    • Riconoscere (obbligatorio):

      Inserisci Yes per confermare che sia le azioni di ripristino che di ricostruzione ripristinano i dati WorkSpaces dall'istantanea più recente e che i dati ripristinati dalle istantanee possono avere anche 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 ruolo IAM o ARN utente che assume il ruolo IAM. Minimo: 1, massimo: 10. Tipo:StringList.

    • MinRequiredApprovals (Opzionale):

      Il numero minimo di approvazioni richieste 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 viene avviata.

  6. Il documento esegue i seguenti passaggi:

    • getWorkSpaceInitialState: recupera lo stato corrente di WorkSpaces.

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

    • branchOnWorkSpaceInitialState: filiali in base WorkSpaces allo stato iniziale. SeStopped, procede all'avvio di WorkSpaces. SeUnhealthy,, o ErrorImpaired, procede al recupero delle istantanee.

    • startWorkSpace: avvia WorkSpaces se era in uno stato. Stopped

    • waitForStartWorkSpace: Attende fino a 10 minuti per WorkSpaces raggiungere Starting lo stato.

    • waitForStartWorkSpaceResult: Attende fino a 30 minuti WorkSpaces per il raggiungimento Available dello statoUnhealthy, ErrorImpaired, o dopo l'avvio.

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

    • branchOnWorkSpaceStateAfterStart: Se lo WorkSpaces èAvailable, procede 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 WorkSpaces Rebooting raggiunga 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 lo WorkSpaces èAvailable, procede all'asserzione finale. Altrimenti, procede al ramo di ripristino.

    • branchOnRestoreAllowed: Se Restore è impostato suYes, procede al ripristino del. WorkSpaces Altrimenti, passa 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 per WorkSpaces raggiungere lo stato. Restoring

    • waitForRestoreWorkSpaceResult: Attende fino a 30 minuti WorkSpaces per il raggiungimento Unhealthy Available dello stato o dopo il ripristino. Error

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

    • branchOnWorkSpaceStateAfterRestore: Se lo WorkSpaces èAvailable, procede 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 pacchetto WorkSpaces dall'immagine più recente.

    • waitForRebuildWorkSpace: Attende fino a 10 minuti per raggiungere lo WorkSpaces stato. Rebuilding

    • waitForRebuildWorkSpaceResult: Attende fino a 30 minuti WorkSpaces per il raggiungimento Unhealthy Available dello stato o dopo la ricostruzione. Error

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

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

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

Riferimenti

Systems Manager Automation