Esecuzione di script da Amazon S3 - 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à.

Esecuzione di script da Amazon S3

Questa sezione illustra come scaricare ed eseguire script da Amazon Simple Storage Service (Amazon S3). Il seguente argomento include informazioni e terminologia relative ad Amazon S3. Per maggiori informazioni su Amazon S3, consulta la pagina Cos'è Amazon S3? Puoi eseguire diversi tipi di script, tra cui Ansible Playbooks, Python, Ruby, Shell e. PowerShell

È anche possibile scaricare una directory che includa più script. Quando si esegue lo script principale nella directory, esegue AWS Systems Manager anche tutti gli script di riferimento inclusi nella directory.

Tieni presenti le informazioni importanti sull'esecuzione di script da Amazon S3 riportate di seguito:

  • Systems Manager non verifica che lo script possa essere eseguito su un nodo. Prima di scaricare ed eseguire lo script, verifica che il software necessario sia installato sul nodo. In alternativa, è possibile creare un documento composito che installa il software utilizzando uno degli strumenti Run Command oState Manager, quindi AWS Systems Manager, scarica ed esegue lo script.

  • Verifica che il tuo utente, ruolo o gruppo disponga delle autorizzazioni AWS Identity and Access Management (IAM) necessarie per leggere dal bucket S3.

  • Assicurati che il profilo dell'istanza sulle istanze Amazon Elastic Compute Cloud (Amazon EC2) abbia autorizzazioni s3:ListBucket e s3:GetObject. Se il profilo dell'istanza non dispone di queste autorizzazioni, il sistema non riesce a scaricare lo script dal bucket S3. Per ulteriori informazioni, consulta Utilizzo dei profili dell'istanza in Guida per l'utente di IAM.

Esecuzione di uno script Shell da Amazon S3

Le seguenti informazioni includono procedure per aiutarti a eseguire script da Amazon Simple Storage Service (Amazon S3) utilizzando la AWS Systems Manager console o (). AWS Command Line Interface AWS CLI Sebbene negli esempi vengano utilizzati script di shell, è possibile sostituirli con altri tipi di script.

Esecuzione di uno script di shell da Amazon S3 (console)

Esecuzione di uno script di shell da Amazon S3
  1. Apri la AWS Systems Manager console all'indirizzo. https://console.aws.amazon.com/systems-manager/

  2. Nel pannello di navigazione, scegli Run Command.

  3. Seleziona Esegui comando.

  4. Nell'elenco Documento di comando, scegli AWS-RunRemoteScript.

  5. In Parametri di comando, esegui le seguenti operazioni:

    • In Tipo di origine, seleziona S3.

    • Nella casella di testo Source Info (Informazioni origine), inserire le informazioni necessarie per accedere all'origine nel formato seguente. Sostituisci ogni example resource placeholder con le tue informazioni.

      Nota

      Sostituisci https://s3. aws-api-domaincon l'URL del tuo bucket. Puoi copiare l'URL del bucket in Amazon S3 nella scheda Oggetti.

      {"path":"https://s3.aws-api-domain/path to script"}

      Di seguito è riportato un esempio di :

      {"path":"https://amzn-s3-demo-bucket.s3.us-east-2.amazonaws.com/scripts/shell/helloWorld.sh"}
    • Nel campo Riga di comando, inserisci i parametri per l'esecuzione di script. Ecco un esempio.

      helloWorld.sh argument-1 argument-2
    • (Facoltativo) Nel campo Directory di lavoro, inserisci il nome di una directory sul nodo su cui si desidera scaricare ed eseguire lo script.

    • (Facoltativo) In Timeout di esecuzione, specifica il numero di secondi che il sistema dovrà attendere prima di interrompere l'esecuzione del comando di script.

  6. Nella sezione Destinazioni, scegli i nodi gestiti in cui si desidera eseguire questa operazione specificando i tag, selezionando manualmente le istanze, i dispositivi edge o indicando un gruppo di risorse.

    Suggerimento

    Se un nodo gestito che ti aspetti di vedere non è presente nell'elenco, consulta Risoluzione dei problemi relativi alla disponibilità dei nodi gestiti per suggerimenti sulla risoluzione dei problemi.

  7. In Altri parametri:

    • In Commento, digita le informazioni su questo comando.

    • In Timeout (secondi), specifica il numero di secondi che il sistema dovrà attendere prima di generare un errore per l'intera esecuzione del comando.

  8. Per Controllo velocità:

    • In Simultaneità, specifica un numero o una percentuale di nodi gestiti su cui eseguire contemporaneamente il comando.

      Nota

      Se hai selezionato le destinazioni specificando i tag applicati ai nodi gestiti o specificando i gruppi di AWS risorse e non sei sicuro del numero di nodi gestiti come target, limita il numero di destinazioni che possono eseguire il documento contemporaneamente specificando una percentuale.

    • Per Soglia di errore, specificare quando interrompere l'esecuzione del comando sulle altri nodi gestiti dopo un errore su un numero o una percentuale di nodi. Se, ad esempio, si specificano tre errori, Systems Manager interrompe l'invio del comando quando riceve il quarto errore. Anche i nodi gestiti che stanno ancora elaborando il comando potrebbero inviare errori.

  9. (Facoltativo) Nella sezione Opzioni di output, per salvare l'output del comando in un file, seleziona la casella Scrivi l'output del comando in un bucket S3. Digita i nomi del bucket e del prefisso (cartella) nelle caselle.

    Nota

    Le autorizzazioni S3 che danno la possibilità di scrivere dati in un bucket S3 sono quelle del profilo dell'istanza (per istanze EC2) o del ruolo di servizio IAM (in macchine attivate da sistemi ibridi) assegnate all'istanza, non quelle dell'utente IAM che esegue questo processo. Per ulteriori informazioni, consulta le pagine Configurazione delle autorizzazioni dell'istanza richieste per Systems Manager oppure Creazione di un ruolo di servizio IAM per un ambiente ibrido. Inoltre, se il bucket S3 specificato si trova su un Account AWS diverso, assicurarsi che il profilo dell'istanza o il ruolo di servizio IAM associato al nodo gestito disponga delle autorizzazioni necessarie per scrivere su quel bucket.

  10. Se vuoi che vengano inviate notifiche sullo stato dell'esecuzione del comando, nella sezione Notifiche SNS selezionara la casella di controllo Abilita notifiche SNS.

    Per ulteriori informazioni sulla configurazione delle notifiche Amazon SNS per Run Command, consulta Monitoraggio delle modifiche di stato di Systems Manager utilizzando le notifiche Amazon SNS.

  11. Scegli Esegui.

Esecuzione di uno script di shell da Amazon S3 (riga di comando)

  1. Installa e configura AWS Command Line Interface (AWS CLI), se non l'hai già fatto.

    Per informazioni, consulta la pagina Installazione o aggiornamento della versione più recente di AWS CLI.

  2. Eseguire il seguente comando seguente. Sostituisci ogni example resource placeholder con le tue informazioni.

    Nota

    Sostituisci https://s3. aws-api-domain/script pathcon l'URL del tuo bucket. Puoi copiare l'URL del bucket in Amazon S3 nella scheda Objects (Oggetti).

    Linux & macOS
    aws ssm send-command \ --document-name "AWS-RunRemoteScript" \ --output-s3-bucket-name "amzn-s3-demo-bucket" \ --output-s3-key-prefix "key-prefix" \ --targets "Key=InstanceIds,Values=instance-id" \ --parameters '{"sourceType":["S3"],"sourceInfo":["{\"path\":\"https://s3.aws-api-domain/script path\"}"],"commandLine":["script name and arguments"]}'
    Windows
    aws ssm send-command ^ --document-name "AWS-RunRemoteScript" ^ --output-s3-bucket-name "amzn-s3-demo-bucket" ^ --output-s3-key-prefix "key-prefix" ^ --targets "Key=InstanceIds,Values=instance-id" ^ --parameters "sourceType"="S3",sourceInfo='{\"path\":\"https://s3.aws-api-domain/script path\"}',"commandLine"="script name and arguments"
    PowerShell
    Send-SSMCommand ` -DocumentName "AWS-RunRemoteScript" ` -OutputS3BucketName "amzn-s3-demo-bucket" ` -OutputS3KeyPrefix "key-prefix" ` -Target @{Key="InstanceIds";Values=@("instance-id")} ` -Parameter @{ sourceType = "S3"; sourceInfo = '{"path": "s3://bucket-name/path/to/script"}'; commandLine = "script name and arguments" }