Installazione o aggiornamento dei pacchetti

Per installare o aggiornare un pacchetto una tantum (console)

1. Apri la AWS Systems Manager console all'indirizzo https://console.aws.amazon.com/systems-manager/.

2. Nel riquadro di navigazione, scegli Distributor.

3. Nella home page di Distributor, scegli il pacchetto da installare.

4. Scegli Install one time (Installa una tantum).

   Questo comando apre Run Command con il documento del comando AWS-ConfigureAWSPackage e il pacchetto Distributor già selezionati.

5. Per Document version (Versione documento), selezionare la versione del documento AWS-ConfigureAWSPackage che si desidera eseguire.

6. Per Action (Operazione), selezionare Install (Installa).

7. Per Installation type (Tipo di installazione), scegliere una delle seguenti opzioni:

   • Uninstall and reinstall (Disinstalla e reinstalla): il pacchetto viene completamente disinstallato e quindi reinstallato. L'applicazione non è disponibile fino al completamento della reinstallazione.

   • In-place update (Aggiornamento in locale): solo i file nuovi o modificati vengono aggiunti all'installazione esistente in base alle istruzioni fornite in uno script update. L'applicazione rimane disponibile durante tutto il processo di aggiornamento. Questa opzione non è supportata per i pacchetti AWS pubblicati ad eccezione del AWSEC2Launch-Agent pacchetto.

8. Per Name (Nome), verificare che sia immesso il nome del pacchetto selezionato.

9. (Facoltativo) In Version (Versione), immettere il nome della versione del pacchetto. Se lasci vuoto questo campo, Run Command installa la versione predefinita selezionata in Distributor.

10. In Targets (Destinazioni), identificare i nodi gestiti in cui si desidera eseguire questa operazione specificando i tag, selezionando le istanze manualmente o indicando un gruppo di risorse.

    Nota

    Se nell'elenco non si visualizza un nodo gestito, vedi Risoluzione dei problemi relativi alla disponibilità dei nodi gestiti.

11. In Other parameters (Altri parametri):

    • In Comment (Commento) digitare le informazioni su questo comando.

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

12. Per Rate control (Controllo velocità):

    • In Concurrency (Simultaneità), specificare un numero o una percentuale di destinazioni su cui eseguire contemporaneamente il comando.

      Nota

      Se sono state selezionate le destinazioni specificando i tag o i gruppi di risorse, e se non si conosce con certezza il numero di nodi gestiti di destinazione, limitare il numero di destinazioni che possono eseguire il documento contemporaneamente specificando una percentuale.

    • In Error threshold (Soglia di errore) specifica quando interrompere l'esecuzione del comando sulle altre destinazioni dopo un errore su un numero o una percentuale di nodi gestiti. Se ad esempio si specificano 3 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.

13. (Opzionale) Nella sezione Output options (Opzioni di output), per salvare l'output del comando in un file, selezionare la casella Write command output to an S3 bucket (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 garantiscono la possibilità di scrivere i dati in un bucket S3 sono quelle del profilo dell'istanza (per le EC2 istanze) o del ruolo di IAM servizio (macchine ad attivazione ibrida) assegnato all'istanza, non quelle dell'utente che esegue questa attività. IAM Per ulteriori informazioni, vedere Configurare le autorizzazioni di istanza richieste per Systems Manager o Creare un ruolo IAM di servizio per un ambiente ibrido. Inoltre, se il bucket S3 specificato si trova in un altro bucket Account AWS, assicurati che il profilo di istanza o il ruolo di IAM servizio associato al nodo gestito disponga delle autorizzazioni necessarie per scrivere su quel bucket.

14. Nella sezione SNSnotifiche, se desideri che vengano inviate notifiche sullo stato dell'esecuzione del comando, seleziona la casella di controllo Abilita SNS notifiche.

    Per ulteriori informazioni sulla configurazione delle SNS notifiche Amazon perRun Command, consultaMonitoraggio delle modifiche allo stato di Systems Manager tramite SNS le notifiche di Amazon.

15. Quando si è pronti per installare il pacchetto, scegliere Run (Esegui).

16. L'area Command status (Stato del comando) segnala lo stato di avanzamento dell'esecuzione. Se il comando è ancora in corso, scegliere l'icona di aggiornamento nell'angolo in alto a sinistra della console finché la colonna Overall status (Stato generale) o Detailed status (Stato dettagliato) non mostra Success (Riuscito) o Failed (Non riuscito).

17. Nell'area Targets and outputs (Destinazioni e uscite), scegli il pulsante accanto al nome del nodo gestito e seleziona View output (Visualizza output).

    La pagina di output del comando mostra i risultati di esecuzione del comando.

18. (Facoltativo) Se si sceglie di scrivere l'output dei comandi in un bucket Amazon S3, selezionare Amazon S3 per visualizzare i dati del log di output.

Per pianificare un'installazione del pacchetto (console)

1. Apri la AWS Systems Manager console all'indirizzo https://console.aws.amazon.com/systems-manager/.

2. Nel riquadro di navigazione, scegli Distributor.

3. Nella home page di Distributor, scegliere il pacchetto da installare o aggiornare.

4. Per Install package (Installa pacchetto), scegliere Install on a schedule (Installa in base a una pianificazione).

   Questo comando apre State Manager in una nuova associazione creata per te.

5. Per Name (Nome) immettere un nome (ad esempio Deploy-test-agent-package). Questo passaggio è facoltativo, ma è consigliato. Gli spazi non sono consentiti nel nome.

6. Nell'elenco Document (Documento), il nome del documento AWS-ConfigureAWSPackage è già selezionato.

7. Per Action (Operazione), verificare che sia selezionata l'opzione Install (Installa).

8. Per Installation type (Tipo di installazione), scegliere una delle seguenti opzioni:

   • Uninstall and reinstall (Disinstalla e reinstalla): il pacchetto viene completamente disinstallato e quindi reinstallato. L'applicazione non è disponibile fino al completamento della reinstallazione.

   • In-place update (Aggiornamento in locale): solo i file nuovi o modificati vengono aggiunti all'installazione esistente in base alle istruzioni fornite in uno script update. L'applicazione rimane disponibile durante tutto il processo di aggiornamento.

9. Per Name (Nome), verificare che sia inserito il nome del pacchetto.

10. Per Version (Versione), se si desidera installare una versione del pacchetto diversa dall'ultima versione pubblicata, immettere l'identificatore della versione.

11. In Targets (Destinazioni) scegliere Selecting all managed instances in this account (Selezione di tutte le istanze gestite in questo account), Specifying tags (Specifica tag) o Manually Selecting Instance (Selezione manuale dell'istanza). Se fai riferimento alle risorse con i tag, immetti una chiave e un valore del tag nei campi visualizzati.

    Nota

    Puoi scegliere i dispositivi AWS IoT Greengrass principali gestiti scegliendo Selezione di tutte le istanze gestite in questo account o Selezione manuale dell'istanza.

12. In Specify schedule (Specifica pianificazione) scegliere On Schedule (In base a pianificazione) per eseguire l'associazione in base a una pianificazione regolare o No Schedule (Nessuna pianificazione) per eseguire l'associazione una sola volta. Per ulteriori informazioni su queste opzioni, consulta Utilizzo delle associazioni in Systems Manager. Utilizza i controlli per creare una pianificazione cron o rate per l'associazione.

13. Scegliere Create Association (Crea associazione).

14. Nella pagina Association (Associazione), scegliere il pulsante accanto all'associazione creata e selezionare Apply association now (Applica associazione ora).

    State Manager crea ed esegue immediatamente l'associazione sulle destinazioni specificate. Per ulteriori informazioni sui risultati dell'esecuzione delle associazioni, consulta Utilizzo delle associazioni in Systems Manager in questa guida.

Per installare una sola volta un pacchetto (AWS CLI)

• Esegui il comando seguente nell' AWS CLI.

  aws ssm send-command \
      --document-name "AWS-ConfigureAWSPackage" \
      --instance-ids "instance-IDs" \
      --parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}'

  Nota

  Il comportamento predefinito per installationType è Uninstall and reinstall. È possibile omettere "installationType":["Uninstall and reinstall"] da questo comando quando si installa un pacchetto completo.

  Di seguito è riportato un esempio.

  aws ssm send-command \
      --document-name "AWS-ConfigureAWSPackage" \
      --instance-ids "i-00000000000000" \
      --parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["ExamplePackage"]}'

Per aggiornare un pacchetto una tantum (AWS CLI)

• Esegui il comando seguente nell' AWS CLI.

  aws ssm send-command \
      --document-name "AWS-ConfigureAWSPackage" \
      --instance-ids "instance-IDs" \
      --parameters '{"action":["Install"],"installationType":["In-place update"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}'

  Nota

  Quando si aggiungono file nuovi o modificati, è necessario includere "installationType":["In-place update"] nel comando.

  Di seguito è riportato un esempio.

  aws ssm send-command \
      --document-name "AWS-ConfigureAWSPackage" \
      --instance-ids "i-02573cafcfEXAMPLE" \
      --parameters '{"action":["Install"],"installationType":["In-place update"],"name":["ExamplePackage"]}'