Installazione o aggiornamento Distributor packages

È possibile distribuire pacchetti nei nodi AWS Systems Manager gestiti utilizzando Distributor, una capacità di. AWS Systems Manager Per distribuire i pacchetti, usa AWS Management Console o AWS Command Line Interface (AWS CLI). Al momento, puoi distribuire una sola versione di un pacchetto per ogni comando. È possibile installare nuovi pacchetti o aggiornare le installazioni esistenti in locale. Puoi scegliere di distribuire una versione specifica oppure distribuire sempre la versione più recente di un pacchetto per la distribuzione. Ti consigliamo di usare State Manager, una capacità di AWS Systems Manager, per installare pacchetti. Utilizzo State Manager aiuta a garantire che i nodi gestiti eseguano sempre la maggior parte delle up-to-date versioni del pacchetto.

Preferenza	AWS Systems Manager azione	Ulteriori informazioni
Installare o aggiornare immediatamente un pacchetto.	Run Command	Installazione o aggiornamento di un pacchetto una sola volta utilizzando la console Installazione di un pacchetto una sola volta utilizzando AWS CLI Aggiornamento di un pacchetto una sola volta utilizzando il AWS CLI
Installare o aggiornare un pacchetto in base a una pianificazione, in modo che l'installazione includa sempre la versione predefinita.	State Manager	Pianificazione dell'installazione o dell'aggiornamento di un pacchetto tramite la console Pianificazione dell'installazione di un pacchetto utilizzando AWS CLI Pianificazione dell'aggiornamento di un pacchetto utilizzando il AWS CLI
Installare automaticamente un pacchetto sui nuovi nodi gestiti che hanno un tag o set di tag specifico. Ad esempio, l'installazione dell' CloudWatch agente Amazon su nuove istanze.	State Manager	Un modo per farlo consiste nell'applicare i tag ai nuovi nodi gestiti e quindi specificare i tag come destinazioni nel State Manager associazione. State Manager installa automaticamente il pacchetto in un'associazione su nodi gestiti con tag corrispondenti. Per informazioni, consulta Comprensione degli obiettivi e dei controlli delle tariffe in State Manager associazioni.

Installazione o aggiornamento di un pacchetto una sola volta utilizzando la console

È possibile utilizzare la AWS Systems Manager console per installare o aggiornare un pacchetto una sola volta. Quando configuri un'installazione unica, Distributor utilizzaAWS Systems Manager Run Command, una capacità di AWS Systems Manager, per eseguire l'installazione.

Per installare o aggiornare un pacchetto una sola volta utilizzando la 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. Sul Distributor home page, scegli il pacchetto che desideri installare.

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

   Questo comando si apre Run Command con il documento di comando AWS-ConfigureAWSPackage e il tuo Distributor pacchetto già selezionato.

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 questo campo vuoto, 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 per Run Command, consulta Monitoraggio 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.

Pianificazione dell'installazione o dell'aggiornamento di un pacchetto tramite la console

È possibile utilizzare la AWS Systems Manager console per pianificare l'installazione o l'aggiornamento di un pacchetto. Quando pianifichi l'installazione o l'aggiornamento del pacchetto, Distributor utilizza AWS Systems Manager State Manager per installare o aggiornare.

Per pianificare l'installazione di un pacchetto utilizzando la console

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

2. Nel riquadro di navigazione, scegli Distributor.

3. Sul Distributor home page, scegli il pacchetto che desideri installare o aggiornare.

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

   Questo comando si apre State Manager a 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 ulteriori informazioni sull'utilizzo delle opzioni in Advanced options (Opzioni avanzate), Rate control (Controllo della velocità) e Output options (Opzioni di output), consulta Utilizzo delle associazioni in Systems Manager.

Installazione di un pacchetto una sola volta utilizzando AWS CLI

Puoi eseguire send-command il comando AWS CLI per installare un Distributor pacchetto una volta. Se il pacchetto è già installato, l'applicazione verrà disconnessa mentre il pacchetto viene disinstallato e sostituito con la nuova versione.

Per installare un pacchetto una sola volta usando 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 informazioni sulle altre opzioni che è possibile utilizzare con il send-command comando, vedere send-commandla AWS Systems Manager sezione del AWS CLI Command Reference.

Aggiornamento di un pacchetto una sola volta utilizzando il AWS CLI

Puoi eseguire send-command il AWS CLI per aggiornare un Distributor pacchetto senza mettere offline l'applicazione associata. Vengono sostituiti solo i file nuovi o aggiornati nel pacchetto.

Per aggiornare un pacchetto una sola volta utilizzando 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"]}'

Per informazioni sulle altre opzioni che è possibile utilizzare con il send-command comando, vedere send-commandla AWS Systems Manager sezione del AWS CLI Command Reference.

Pianificazione dell'installazione di un pacchetto utilizzando AWS CLI

È possibile eseguire create-association il comando AWS CLI per installare un Distributor pacchetto secondo una pianificazione. Il valore --name, ossia il nome del documento, è sempre AWS-ConfigureAWSPackage. Il comando seguente utilizza la chiave InstanceIds per specificare i nodi gestiti di destinazione. Se il pacchetto è già installato, l'applicazione verrà disconnessa mentre il pacchetto viene disinstallato e sostituito con la nuova versione.

aws ssm create-association \
    --name "AWS-ConfigureAWSPackage" \
    --parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}' \
    --targets [{\"Key\":\"InstanceIds\",\"Values\":[\"instance-ID1\",\"instance-ID2\"]}]

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 create-association \
    --name "AWS-ConfigureAWSPackage" \
    --parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["Test-ConfigureAWSPackage"]}' \
    --targets [{\"Key\":\"InstanceIds\",\"Values\":[\"i-02573cafcfEXAMPLE\",\"i-0471e04240EXAMPLE\"]}]

Per informazioni sulle altre opzioni che è possibile utilizzare con il create-association comando, vedere create-associationnella AWS Systems Manager sezione del AWS CLI Command Reference.

Pianificazione dell'aggiornamento di un pacchetto utilizzando il AWS CLI

Puoi eseguire create-association il AWS CLI per aggiornare un Distributor pacchetto in base a una pianificazione senza mettere offline l'applicazione associata. Vengono sostituiti solo i file nuovi o aggiornati nel pacchetto. Il valore --name, ossia il nome del documento, è sempre AWS-ConfigureAWSPackage. Il comando seguente utilizza la chiave InstanceIds per specificare le istanze di destinazione.

aws ssm create-association \
    --name "AWS-ConfigureAWSPackage" \
    --parameters '{"action":["Install"],"installationType":["In-place update"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}' \
    --targets [{\"Key\":\"InstanceIds\",\"Values\":[\"instance-ID1\",\"instance-ID2\"]}]

Nota

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

Di seguito è riportato un esempio.

aws ssm create-association \
    --name "AWS-ConfigureAWSPackage" \
    --parameters '{"action":["Install"],"installationType":["In-place update"],"name":["Test-ConfigureAWSPackage"]}' \
    --targets [{\"Key\":\"InstanceIds\",\"Values\":[\"i-02573cafcfEXAMPLE\",\"i-0471e04240EXAMPLE\"]}]

Per informazioni sulle altre opzioni utilizzabili con il create-association comando, consulta create-associationla AWS Systems Manager sezione del AWS CLI Command Reference.