Aggiunta di una versione del pacchetto a Distributor

Per aggiungere una versione del pacchetto, create un pacchetto, quindi utilizzate Distributor per aggiungere una versione del pacchetto aggiungendo una voce al documento AWS Systems Manager (SSM) già esistente per le versioni precedenti. Distributorè una funzionalità di AWS Systems Manager. Per risparmiare tempo, aggiorna il manifest di una versione precedente del pacchetto, modifica il valore della voce version nel manifest (ad esempio da Test_1.0 a Test_2.0) e salvalo come manifest per la nuova versione. Il flusso di lavoro Add version (Aggiungi versione) semplice nella console Distributor aggiorna automaticamente il file manifest.

Una nuova versione del pacchetto può:

• Sostituire almeno uno dei file installabili collegati alla versione corrente.

• Aggiungere nuovi file installabili per supportare piattaforme aggiuntive.

• Eliminare i file per interrompere il supporto per piattaforme specifiche.

Una versione più recente può utilizzare lo stesso bucket Amazon Simple Storage Service (Amazon S3), ma deve avere un nome di file diverso URL alla fine. Puoi utilizzare la console Systems Manager o l'opzione AWS Command Line Interface (AWS CLI) per aggiungere la nuova versione. Il caricamento di un file installabile con il nome esatto di un file installabile esistente nel bucket Amazon S3 sovrascrive il file esistente. Nessun file installabile viene copiato dalla versione precedente nella nuova versione; è necessario caricare i file installabili dalla versione precedente affinché siano parte di una nuova versione. Dopo che Distributor ha completato la creazione di una nuova versione del pacchetto, puoi eliminare o riutilizzare il bucket Amazon S3, perché Distributor copia il software in un bucket Systems Manager interno come parte del processo di controllo delle versioni.

Nota

Ogni pacchetto è limitato a un massimo di 25 versioni. Puoi eliminare le versioni che non sono più necessarie.

Aggiunta di una versione del pacchetto (console)

Prima di procedere, segui le istruzioni in Creazione di un pacchetto per creare un nuovo pacchetto per la versione. Quindi, utilizza la console Systems Manager per aggiungere una nuova versione del pacchetto a Distributor.

Aggiunta di una versione del pacchetto (semplice)

Per aggiungere una versione del pacchetto utilizzando il flusso di lavoro Simple (Semplice), prepara file installabili aggiornati o aggiungi file installabili per supportare più piattaforme e architetture. Quindi, utilizza Distributor per caricare file installabili nuovi e aggiornati e aggiungere una versione del pacchetto. Il flusso di lavoro semplificato di Aggiungi versione nella Distributor console aggiorna automaticamente il file manifesto e il documento associatoSSM.

Per aggiungere una versione del pacchetto (semplice)

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 a cui aggiungere un'altra versione.

4. Nella pagina Add version (Aggiungi versione), scegli Simple (Semplice).

5. Per Version name (Nome versione), immettere un nome della versione. Il nome della versione per la nuova versione deve essere diverso dai nomi delle versioni precedenti. I nomi delle versioni possono essere composti da un massimo di 512 caratteri e non possono contenere caratteri speciali.

6. Per S3 bucket name (Nome bucket S3), scegli un bucket S3 esistente dall'elenco. Questo può essere lo stesso bucket utilizzato per archiviare i file installabili per versioni precedenti, ma i nomi dei file installabili devono essere diversi per evitare di sovrascrivere i file installabili esistenti nel bucket.

7. Per S3 key prefix (Prefisso della chiave S3), immettere la sottocartella del bucket in cui sono archiviati le risorse installabili.

8. Per Upload software (Carica software), naviga ai file del software installabili da collegare alla nuova versione. I file installabili da versioni esistenti non vengono automaticamente copiati in una nuova versione; è necessario caricare gli eventuali file installabili da versioni precedenti del pacchetto se si desidera che i file installabili facciano parte della nuova versione. Puoi caricare più file del software in una singola operazione.

9. Per Target platform (Piattaforma di destinazione), verifica che la piattaforma del sistema operativo di destinazione visualizzata per ogni file installabile sia corretta. Se il sistema operativo mostrato non è corretto, scegli il sistema operativo corretto nell'elenco a discesa.

   Nel flusso di lavoro della funzione Versioni multiple Simple (Semplice), poiché ogni file installabile viene caricato solo una volta, sono richieste fasi aggiuntive per fare si che un singolo file sia destinato a più sistemi operativi. Ad esempio, se carichi un file del software installabile denominato Logtool_v1.1.1.rpm, alcune impostazioni predefinite nel flusso di lavoro Simple (Semplice) devono essere modificate per indicare a Distributor che lo stesso software deve essere destinato a entrambi i sistemi operativi Amazon Linux e Ubuntu. Per ovviare a questa limitazione puoi adottare una delle soluzioni riportate di seguito.

   • Utilizzare il flusso di lavoro della funzione Versioni multiple Advanced (Avanzato), comprimere ogni file installabile in un file .zip prima di iniziare e creare manualmente il manifest in modo da poter destinare un file installabile a più piattaforme o versioni del sistema operativo. Per ulteriori informazioni, consulta Aggiunta di una versione del pacchetto (avanzato).

   • Modificare manualmente il file manifest nel flusso di lavoro Simple (Semplice), in modo che il file .zip sia destinato a più piattaforme o versioni di sistema operativo. Per ulteriori informazioni su come eseguire questa operazione, consulta la fine della fase 4 in Fase 2: Creare il manifesto del pacchetto JSON.

10. Per Platform version (Versione della piattaforma), verifica che la versione della piattaforma del sistema operativo mostrata sia _any, una release principale seguita da un carattere jolly (7.*) o la release esatta del sistema operativo specifico che deve essere valida per il software. Per ulteriori informazioni sulla specifica della versione della piattaforma, consulta la fase 4 in Fase 2: Creare il manifesto del pacchetto JSON.

11. Per Architecture (Architettura), scegli l'architettura del processore corretta per ogni file installabile dall'elenco a discesa. Per ulteriori informazioni sulle architetture supportate, consulta Architetture e piattaforme dei pacchetti supportate.

12. (Facoltativo) Espandere Scripts (Script) ed esaminare gli script di installazione e disinstallazione generati da Distributor per il software installabile.

13. Per aggiungere altri file del software installabili nella versione, scegli Add software (Aggiungi software). Altrimenti, vai alla fase successiva.

14. (Facoltativo) Espandi il manifesto ed esamina il manifesto del JSON pacchetto Distributor generato per il software installabile. Se hai modificato eventuali informazioni sul software installabile dal momento in cui hai avviato questa procedura, ad esempio versione della piattaforma o piattaforma di destinazione, scegli Generate manifest (Genera manifest) per visualizzare il manifest del pacchetto aggiornato.

    Puoi modificare il manifest manualmente se desideri che un software installabile sia la destinazione di più sistemi operativi, come descritto nella fase 9. Per ulteriori informazioni sulla modifica del manifest, consulta Fase 2: Creare il manifesto del pacchetto JSON.

15. Al termine dell'aggiunta del software e dell'esame della piattaforma di destinazione, della versione e dei dati dell'architettura, scegli Add version (Aggiungi versione).

16. Attendi che Distributor termini il caricamento del software e la creazione della nuova versione del pacchetto. Distributor mostra lo stato di caricamento per ogni file installabile. In base al numero e alla dimensione dei pacchetti che stai aggiungendo, questa operazione può richiedere alcuni minuti. Distributor esegue automaticamente il reindirizzamento alla pagina Package details (Dettagli pacchetto) per il pacchetto, ma puoi scegliere di aprire questa pagina personalmente dopo che il software è stato caricato. La pagina Package details (Dettagli pacchetto) non mostra tutte le informazioni sul pacchetto finché Distributor non termina la creazione della nuova versione del pacchetto. Per interrompere il caricamento e la creazione della versione del pacchetto, scegli Stop upload (Interrompi caricamento).

17. Se Distributor non è in grado di caricare i file installabili del software, visualizza un messaggio Upload failed (Caricamento non riuscito). Per riprovare a eseguire il caricamento, scegli Retry upload (Riprova caricamento). Per ulteriori informazioni su come risolvere errori di creazione della versione del pacchetto, consulta Risoluzione dei problemi di AWS Systems ManagerDistributor.

18. Quando Distributor ha terminato la creazione della nuova versione del pacchetto, nella pagina Details (Dettagli), nella scheda Versions (Versioni), visualizza la nuova versione nell'elenco delle versioni del pacchetto disponibili. Imposta una versione predefinita del pacchetto scegliendo una versione e selezionando Set default version (Imposta versione predefinita).

    Se non imposti una versione predefinita, verrà selezionata la versione più recente del pacchetto.

Aggiunta di una versione del pacchetto (avanzato)

Per aggiungere una versione del pacchetto, create un pacchetto, quindi utilizzate Distributor per aggiungere una versione del pacchetto aggiungendo una voce al SSM documento che esiste per le versioni precedenti. Per risparmiare tempo, aggiorna il manifest di una versione precedente del pacchetto, modifica il valore della voce version nel manifest (ad esempio da Test_1.0 a Test_2.0) e salvalo come manifest per la nuova versione. È necessario disporre di un manifest aggiornato per aggiungere una nuova versione del pacchetto utilizzando il flusso di lavoro Advanced (Avanzato).

Per aggiungere una versione del pacchetto (avanzato)

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 a cui aggiungere un'altra versione, quindi seleziona Add version (Aggiungi versione).

4. Per Version name (Nome versione), immettere il valore esatto nella voce version del proprio file manifest.

5. Per S3 bucket name (Nome bucket S3), scegli un bucket S3 esistente dall'elenco. Questo può essere lo stesso bucket utilizzato per archiviare i file installabili per versioni precedenti, ma i nomi dei file installabili devono essere diversi per evitare di sovrascrivere i file installabili esistenti nel bucket.

6. Per S3 key prefix (Prefisso della chiave S3), immettere la sottocartella del bucket in cui sono archiviati le risorse installabili.

7. Per Manifest, scegliere Extract from package (Estrai dal pacchetto) per utilizzare un manifest caricato nel bucket S3 con i file .zip.

   (Facoltativo) Se non hai caricato il JSON manifesto modificato nel bucket Amazon S3 in cui hai archiviato i file.zip, scegli Nuovo manifesto. Puoi creare o incollare l'intero manifesto nel campo dell'editor. JSON Per ulteriori informazioni su come creare il JSON manifesto, vedereFase 2: Creare il manifesto del pacchetto JSON.

8. Al termine, scegli Add package version (Aggiungi versione pacchetto).

9. Nella pagina Details (Dettagli), nella scheda Versions (Versioni), visualizza la nuova versione nell'elenco delle versioni del pacchetto disponibili. Imposta una versione predefinita del pacchetto scegliendo una versione e selezionando Set default version (Imposta versione predefinita).

   Se non imposti una versione predefinita, verrà selezionata la versione più recente del pacchetto.

Aggiunta di una versione del pacchetto (AWS CLI)

È possibile utilizzare il AWS CLI per aggiungere una nuova versione del pacchetto aDistributor. Prima di eseguire questi comandi, devi creare una nuova versione del pacchetto e caricarla su S3, come descritto all'inizio di questo argomento.

Per aggiungere una versione del pacchetto (AWS CLI)

1. Esegui il comando seguente per modificare il AWS Systems Manager documento con una voce per una nuova versione del pacchetto. Replace (Sostituisci) document-name con il nome del documento. Replace (Sostituisci) amzn-s3-demo-bucket con URL il JSON manifesto che hai copiatoFase 3: caricamento del pacchetto e del manifest in un bucket Amazon S3. S3-bucket-URL-of-package è il URL bucket Amazon S3 in cui è archiviato l'intero pacchetto. Replace (Sostituisci) version-name-from-updated-manifest con il valore di version nel manifest. Imposta il parametro --document-version su $LATEST per associare il documento a questa versione del pacchetto, la versione più recente del documento.

   aws ssm update-document \
       --name "document-name" \
       --content "S3-bucket-URL-to-manifest-file" \
       --attachments Key="SourceUrl",Values="amzn-s3-demo-bucket" \
       --version-name version-name-from-updated-manifest \
       --document-version $LATEST

   Di seguito è riportato un esempio.

   aws ssm update-document \
       --name ExamplePackage \
       --content "https://s3.amazonaws.com/amzn-s3-demo-bucket/ExamplePackage/manifest.json" \
       --attachments Key="SourceUrl",Values="https://s3.amazonaws.com/amzn-s3-demo-bucket/ExamplePackage" \
       --version-name 1.1.1 \
       --document-version $LATEST

2. Esegui il comando seguente per verificare che il pacchetto sia stato aggiornato e visualizzare il manifest del pacchetto. Replace (Sostituisci) package-name con il nome del pacchetto e, facoltativamente, document-version con il numero di versione del documento (diverso dalla versione del pacchetto) che hai aggiornato. Se questa versione del pacchetto è associata alla versione più recente del documento, puoi specificare $LATEST per il valore del parametro facoltativo --document-version.

   aws ssm get-document \
       --name "package-name" \
       --document-version "document-version"

Per informazioni sulle altre opzioni che è possibile utilizzare con il update-document comando, vedere update-documentla AWS Systems Manager sezione della Guida ai AWS CLI comandi.