View a markdown version of this page

Utilizzo di script nei runbook - AWS Systems Manager

• La AWS Systems Manager CloudWatch dashboard non sarà più disponibile dopo il 30 aprile 2026. I clienti possono continuare a utilizzare la CloudWatch console Amazon per visualizzare, creare e gestire le proprie CloudWatch dashboard Amazon, proprio come fanno oggi. Per ulteriori informazioni, consulta la documentazione di Amazon CloudWatch Dashboard.

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

Utilizzo di script nei runbook

I runbook di automazione supportano l'esecuzione di script come parte dell'automazione. L'automazione è uno strumento di AWS Systems Manager. Utilizzando i runbook, è possibile eseguire script direttamente in AWS senza dover creare un ambiente di calcolo separato per eseguire gli script. Poiché i runbook possono eseguire passaggi di script insieme ad altri tipi di fasi di automazione, ad esempio le approvazioni, è possibile di intervenire manualmente in situazioni critiche o ambigue. Puoi inviare l'output delle aws:executeScript azioni nei tuoi runbook ad Amazon Logs. CloudWatch Per ulteriori informazioni, consulta Uscita dell'azione Logging Automation con Logs CloudWatch.

Autorizzazioni per l'utilizzo di runbook

Per utilizzare un runbook, Systems Manager deve utilizzare le autorizzazioni di un ruolo AWS Identity and Access Management (IAM). Il metodo utilizzato dal servizio di automazione per stabilire quali autorizzazioni del ruolo utilizzare dipende da alcuni fattori e dal fatto che una fase utilizza o meno l'operazione aws:executeScript.

Per i runbook che non utilizzano aws:executeScript, il servizio di automazione utilizza una delle due fonti di autorizzazione:

  • Le autorizzazioni di un ruolo di servizio IAM, o ruolo presunto, specificate nel runbook o passate come parametro.

  • Se non viene specificato alcun ruolo di servizio IAM, le autorizzazioni dell'utente che ha avviato l'automazione.

Quando una fase di un runbook include l'aws:executeScriptazione, tuttavia, è sempre richiesto un ruolo di servizio IAM (Assume role) se il Python o PowerShell lo script specificato per l'azione richiama qualsiasi operazione API. AWS Il servizio di automazione verifica questo ruolo nell'ordine seguente:

  • Le autorizzazioni di un ruolo di servizio IAM, o ruolo presunto, specificate nel runbook o passate come parametro.

  • Se non viene trovato alcun ruolo, Automation tenta di eseguire il Python o PowerShell lo script specificato aws:executeScript senza alcuna autorizzazione. Se lo script chiama un'operazione AWS API (ad esempio l'operazione Amazon EC2CreateImage) o tenta di agire su una AWS risorsa (come un'istanza EC2), il passaggio contenente lo script ha esito negativo e Systems Manager restituisce un messaggio di errore che segnala l'errore.

Aggiunta di script ai runbook

È possibile aggiungere script ai runbook includendo lo script in linea come parte di una fase nel runbook. È inoltre possibile allegare script al runbook caricando gli script dal computer locale o specificando un bucket di Amazon Simple Storage Service (Amazon S3) in cui si trovano gli script. Al termine di una fase che esegue uno script, l'output dello script è disponibile come oggetto JSON, che è possibile utilizzare come input per le fasi successive nel runbook. Per ulteriori informazioni sull'operazione aws:executeScript e su come utilizzare gli allegati per gli script, consulta aws:ExecuteScript — Esegue uno script.

Vincoli di script per i runbook

I runbook applicano un limite di cinque file allegati. Gli script possono essere sotto forma di script Python (.py), script PowerShell Core (.ps1) o allegati come contenuti all'interno di un file .zip.