Aggiungere una versione a Distributor package

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

Nel riquadro di navigazione, scegli Distributor.

Sul Distributor home page, scegli il pacchetto a cui desideri aggiungere un'altra versione.

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

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.

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.

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

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.

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 si carica un file software installabile denominatoLogtool_v1.1.1.rpm, è necessario modificare alcune impostazioni predefinite nel flusso di lavoro Simple per fornire istruzioni Distributor indirizzare lo stesso software su entrambi i sistemi operativi Amazon Linux e Ubuntu. Per ovviare a questa limitazione puoi adottare una delle soluzioni riportate di seguito.

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.

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.

(Facoltativo) Espandi gli script ed esamina gli script di installazione e disinstallazione che Distributor genera per il software installabile.

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

(Facoltativo) Espandi il manifesto ed esamina il manifesto JSON del pacchetto che Distributor genera 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.

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).

Attendi Distributor per completare il caricamento del software e la creazione della nuova versione del pacchetto. Distributor mostra lo stato di caricamento per ogni file installabile. A seconda del numero e della dimensione dei pacchetti che stai aggiungendo, questa operazione può richiedere alcuni minuti. Distributor ti reindirizza automaticamente alla pagina dei dettagli del pacchetto, ma puoi scegliere di aprirla tu stesso dopo il caricamento del software. La pagina dei dettagli del pacchetto non mostra tutte le informazioni sul pacco fino a Distributor completa la creazione della nuova versione del pacchetto. Per interrompere il caricamento e la creazione della versione del pacchetto, scegli Stop upload (Interrompi caricamento).

Se Distributor non riesce a caricare nessuno dei file installabili dal software, viene visualizzato un messaggio di 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 relativi a AWS Systems Manager Distributor.

Quando Distributor dopo aver creato la nuova versione del pacchetto, nella pagina Dettagli del pacchetto, nella scheda 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.

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

Nel riquadro di navigazione, scegli Distributor.

Sul Distributor home page, scegli il pacchetto a cui desideri aggiungere un'altra versione, quindi scegli Aggiungi versione.

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

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.

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

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.

Al termine, scegli Add package version (Aggiungi versione 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.

Eseguite 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 il URL file del 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 manifesto. 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

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"