Esegui script Python da GitHub

Esecuzione di uno script Python da GitHub

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 sui comandi, scegli AWS-RunRemoteScript.

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

   • In Source Type (Tipo di origine), selezionare GitHub.

   • Nella casella Informazione sull'origine, inserisci le informazioni necessarie per accedere all'origine nel formato seguente:

     {
         "owner": "owner_name",
         "repository": "repository_name",
         "getOptions": "branch:branch_name",
         "path": "path_to_document",
         "tokenInfo": "{{ssm-secure:SecureString_parameter_name}}"
     }

     L'esempio seguente esegue il download in una directory di script denominata complex-script.

     {
         "owner": "TestUser1",
         "repository": "SSMTestDocsRepo",
         "getOptions": "branch:myBranch",
         "path": "scripts/python/complex-script",
         "tokenInfo": "{{ssm-secure:myAccessTokenParam}}"
     }

     Nota

     "branch" è richiesto solo se gli script sono memorizzati in un ramo diverso da master.

     Per utilizzare la versione degli script che si trovano in un particolare commit nel repository, usa commitID con getOptions invece di branch. Ad esempio:

     "getOptions": "commitID:bbc1ddb94...b76d3bEXAMPLE",

   • In Riga di comando, inserisci i parametri per l'esecuzione di script. Ecco un esempio.

     mainFile.py argument-1 argument-2

     Questo esempio esegue mainFile.py, che può a sua volta eseguire altri script nella directory complex-script.

   • (Facoltativo) In Directory di lavoro, inserisci il nome di una directory dell'istanza 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, identifica i nodi 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.

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. Il comando seguente consente di scaricare ed eseguire uno script da GitHub.

   aws ssm send-command --document-name "AWS-RunRemoteScript" --instance-ids "instance-IDs" --parameters '{"sourceType":["GitHub"],"sourceInfo":["{\"owner\":\"owner_name\", \"repository\":\"repository_name\", \"path\": \"path_to_script_or_directory"}"],"commandLine":["commands_to_run"]}'

   Ecco un esempio.

   aws ssm send-command --document-name "AWS-RunRemoteScript" --instance-ids "i-02573cafcfEXAMPLE" --parameters '{"sourceType":["GitHub"],"sourceInfo":["{\"owner\":\"TestUser1\", \"repository\":\"GitHubTestPublic\", \"path\": \"scripts/python/complex-script\"}"],"commandLine":["mainFile.py argument-1 argument-2 "]}'

   Questo esempio prevede il download di una directory di script denominata complex-script. La voce commandLine esegue mainFile.py, che può a sua volta eseguire altri script nella directory complex-script.