Creazione di un pacchetto in Distributor

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

Nel riquadro di navigazione, scegli Distributor.

Nella home page Distributor, scegli Create package (Crea pacchetto), quindi seleziona Simple (Semplice).

Nella pagina Create package (Crea pacchetto), inserisci un nome per il pacchetto. I nomi dei pacchetti possono contenere lettere, numeri, punti, trattini e caratteri di sottolineatura. Il nome deve essere abbastanza generico da applicarsi a tutte le versioni degli allegati del pacchetto, ma abbastanza specifico da identificare lo scopo del pacchetto.

(Facoltativo) In Version name (Nome versione), immettere un nome di versione. I nomi delle versioni possono essere composti da un massimo di 512 caratteri e non possono contenere caratteri speciali.

Per Location (Posizione), scegliere un bucket utilizzando il nome e il prefisso del bucket o utilizzando l'URL del bucket.

Per Upload software (Carica software), scegli Add software (Aggiungi software), quindi passa ai file software installabili con estensione .rpm, .msi o .deb. Se il nome del file contiene spazi, il caricamento non riesce. 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 di creazione del pacchetto Simple (Semplice), poiché ogni file installabile viene caricato solo una volta, sono richieste fasi aggiuntive per indicare a Distributor di utilizzare un singolo file come destinazione di 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 in modo che lo stesso software sia la destinazione di entrambi i sistemi operativi Amazon Linux e Ubuntu. Quando si utilizzano più piattaforme, eseguire una delle seguenti operazioni.

Per Platform version (Versione della piattaforma), verifica che la versione della piattaforma del sistema operativo mostrata sia _any o una versione principale seguita da una wildcard (7.*) o l'esatta versione della release del sistema operativo specifico che deve essere valida per il software. Per ulteriori informazioni sulla specifica della versione della piattaforma del sistema operativo, consulta la fase 4 in Fase 2: creazione del manifest 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 del processore supportate, consulta Architetture e piattaforme dei pacchetti supportate.

(Facoltativo) Espandere Scripts (Script) ed esaminare gli script generati da Distributor per il software installabile.

(Facoltativo) Per fornire uno script di aggiornamento da utilizzare con gli aggiornamenti in locale, espandere Scripts (Script), scegliere la scheda Update script (Aggiorna script) e immettere i comandi di script di aggiornamento

Systems Manager non genera script di aggiornamento per conto dell'utente.

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

(Facoltativo) Espandi Manifest ed esamina il manifest del pacchetto JSON generato da Distributor per il software installabile. Se hai modificato eventuali informazioni sul software da 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 destinato a più di un sistema operativo, come descritto nella fase 8. Per ulteriori informazioni sulla modifica del manifest, consulta Fase 2: creazione del manifest del pacchetto JSON.

Scegliere Create package (Crea pacchetto).

Aggiungi la versione dello schema al manifest. In questo rilascio, la versione dello schema è sempre 2.0.

{ "schemaVersion": "2.0",

Aggiungi una versione del pacchetto definita dall'utente al manifest. Questo è anche il valore di Version name (Nome versione) specificato quando aggiungi il pacchetto a Distributor. Diventa parte del documento AWS Systems Manager che Distributor crea quando aggiungi il pacchetto. Questo valore viene anche fornito come input nel documento AWS-ConfigureAWSPackage per installare una versione del pacchetto diversa dall'ultima. Un valore version può contenere lettere, numeri, trattini bassi, trattini e punti e può avere una lunghezza massima di 128 caratteri. È consigliabile utilizzare una versione del pacchetto leggibile per semplificare a te e agli altri amministratori la specifica delle versioni esatte del pacchetto durante la distribuzione. Di seguito è riportato un esempio.

"version": "1.0.1",

(Facoltativo) Aggiungi il nome di un editore. Di seguito è riportato un esempio.

"publisher": "MyOrganization",

Aggiungi pacchetti. La sezione "packages" descrive le piattaforme, le architetture e le versioni supportate dal file .zip nel pacchetto. Per ulteriori informazioni, consultare Architetture e piattaforme dei pacchetti supportate.

platform_version può essere il valore jolly _any. Utilizzarlo per indicare che un file .zip supporta qualsiasi versione della piattaforma. È inoltre possibile specificare una versione principale seguita da un carattere jolly in modo che tutte le versioni secondarie siano supportate, ad esempio 7.*. Se si sceglie di specificare un valore platform-version per una versione del sistema operativo specifico, assicurarsi che corrisponda esattamente alla release del sistema operativo AMI che intendi utilizzare. Di seguito sono elencate le risorse consigliate per ottenere il valore corretto del sistema operativo.

"packages": {
    "platform": {
      "platform-version": {
        "architecture": {
          "file": ".zip-file-name-1.zip"
        }
      }
    },
    "another-platform": {
      "platform-version": {
        "architecture": {
          "file": ".zip-file-name-2.zip"
        }
      }
    },
    "another-platform": {
      "platform-version": {
        "architecture": {
          "file": ".zip-file-name-3.zip"
        }
      }
    }
  }

Di seguito è riportato un esempio. In questo esempio, la piattaforma del sistema operativo è amazon, la versione supportata è 2016.09, l'architettura è x86_64 e il file .zip che supporta questa piattaforma è test.zip.

{
    "amazon": {
        "2016.09": {
            "x86_64": {
                "file": "test.zip"
            }
        }
    }
},

Puoi aggiungere il valore jolly _any per indicare che il pacchetto supporta tutte le versioni dell'elemento padre. Ad esempio, per indicare che il pacchetto è supportato su qualsiasi versione di Amazon Linux, l'istruzione del pacchetto deve essere simile alla seguente. Puoi utilizzare il carattere jolly _any a livello di versione o di architettura per supportare tutte le versioni di una piattaforma, tutte le architetture di una versione oppure tutte le versioni e tutte le architetture di una piattaforma.

{
    "amazon": {
        "_any": {
            "x86_64": {
                "file": "test.zip"
            }
        }
    }
},

L'esempio seguente aggiunge _any per mostrare che il primo pacchetto, data1.zip, è supportato per tutte le architetture di Amazon Linux 2016.09. Il secondo pacchetto, data2.zip, è supportato per tutte le versioni di Amazon Linux, ma solo per i nodi gestiti con l'architettura x86_64. Entrambe le versioni _any e 2016.09 sono voci di amazon. Esiste una sola piattaforma (Amazon Linux)), ma diverse versioni, architetture e relativi file .zip supportati.

{
    "amazon": {
        "2016.09": {
            "_any": {
                "file": "data1.zip"
            }
        },
        "_any": {
            "x86_64": {
                "file": "data2.zip"
            }
        }
    }
}

È possibile fare riferimento a un file .zip più volte nella sezione "packages" del manifest, se il file .zip supporta più di una piattaforma. Ad esempio, se un file .zip supporta sia le versioni 7.x di Red Hat Enterprise Linux sia Amazon Linux, la sezione "packages" contiene due voci che puntano allo stesso file .zip, come mostrato nell'esempio seguente.

{
    "amazon": {
        "2018.03": {
            "x86_64": {
                "file": "test.zip"
            }
        }
    },
    "redhat": {
        "7.*": {
            "x86_64": {
                "file": "test.zip"
            }
        }
    }
},

Aggiungere l'elenco dei file .zip che fanno parte di questo pacchetto dalla fase 4. Ogni voce di file richiede il nome del file e il checksum del valore hash sha256. I valori checksum nel manifest devono corrispondere al valore hash sha256 nelle risorse compresse per evitare errori di installazione del pacchetto.

Per ottenere il checksum esatto dai file installabili, puoi eseguire i comandi riportati di seguito. In Linux, eseguire shasum -a 256 file-name.zip o openssl dgst -sha256 file-name.zip. In Windows, eseguire il cmdlet Get-FileHash -Path path-to-.zip-file in PowerShell.

La sezione "files" del manifest include un riferimento a ciascuno dei file .zip nel pacchetto.

"files": {
        "test-agent-x86.deb.zip": {
            "checksums": {
                "sha256": "EXAMPLE2706223c7616ca9fb28863a233b38e5a23a8c326bb4ae241dcEXAMPLE"
            }
        },
        "test-agent-x86_64.deb.zip": {
            "checksums": {
                "sha256": "EXAMPLE572a745844618c491045f25ee6aae8a66307ea9bff0e9d1052EXAMPLE"
            }
        },
        "test-agent-x86_64.nano.zip": {
            "checksums": {
                "sha256": "EXAMPLE63ccb86e830b63dfef46995af6b32b3c52ce72241b5e80c995EXAMPLE"
            }
        },
        "test-agent-rhel5-x86.nano.zip": {
            "checksums": {
                "sha256": "EXAMPLE13df60aa3219bf117638167e5bae0a55467e947a363fff0a51EXAMPLE"
            }
        },
        "test-agent-x86.msi.zip": {
            "checksums": {
                "sha256": "EXAMPLE12a4abb10315aa6b8a7384cc9b5ca8ad8e9ced8ef1bf0e5478EXAMPLE"
            }
        },
        "test-agent-x86_64.msi.zip": {
            "checksums": {
                "sha256": "EXAMPLE63ccb86e830b63dfef46995af6b32b3c52ce72241b5e80c995EXAMPLE"
            }
        },
        "test-agent-rhel5-x86.rpm.zip": {
            "checksums": {
                "sha256": "EXAMPLE13df60aa3219bf117638167e5bae0a55467e947a363fff0a51EXAMPLE"
            }
        },
        "test-agent-rhel5-x86_64.rpm.zip": {
            "checksums": {
                "sha256": "EXAMPLE7ce8a2c471a23b5c90761a180fd157ec0469e12ed38a7094d1EXAMPLE"
            }
        }
    }

Dopo aver aggiunto le informazioni sul pacchetto, salva e chiudi il file manifest.

Copiare o spostare tutti i file di archivio .zip specificati nel manifest in una cartella o una directory. Non comprimere la cartella o la directory in cui si spostano i file di archivio .zip e il file manifest.

Creare un bucket o sceglierne uno esistente. Per ulteriori informazioni consulta la sezione relativa alla creazione di un bucket nella Guida alle operazioni di base di Amazon Simple Storage Service. Per ulteriori informazioni su come eseguire un comando dell'AWS CLI per creare un bucket, consulta mb nel Riferimento ai comandi dell'AWS CLI.

Carica la cartella o la directory nel bucket. Per ulteriori informazioni, consulta Aggiungi un oggetto in un bucket nella Guida alle operazioni di base di Amazon Simple Storage Service. Se prevedi di incollare il tuo manifest JSON nella console AWS Systems Manager, non caricare il manifest. Per ulteriori informazioni su come eseguire un comando dell'AWS CLI per caricare i file in un bucket, consulta mv nel Riferimento ai comandi dell'AWS CLI.

Nella home page del bucket, scegli la cartella o la directory che hai caricato. Se hai caricato i file in una sottocartella in un bucket, prendi nota della sottocartella (nota anche come un prefisso). Il prefisso è necessario per aggiungere il pacchetto a Distributor.

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

Nel riquadro di navigazione, scegli Distributor.

Nella home page Distributor, scegli Create package (Crea pacchetto) e seleziona Advanced (Avanzato).

Nella pagina Create package (Crea pacchetto), inserisci un nome per il pacchetto. I nomi dei pacchetti possono contenere lettere, numeri, punti, trattini e caratteri di sottolineatura. Il nome deve essere abbastanza generico da applicarsi a tutte le versioni degli allegati del pacchetto, ma abbastanza specifico da identificare lo scopo del pacchetto.

Per Version name (Nome versione), immettere il valore esatto della voce version nel file manifest.

Per S3 bucket name (Nome bucket S3), scegliere il nome del bucket in cui sono stati caricati i file .zip e il manifest in Fase 3: caricamento del pacchetto e del manifest in un bucket Amazon S3.

Per S3 key prefix (Prefisso della chiave S3), immettere la sottocartella del bucket in cui sono archiviati i file .zip e il manifest.

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

(Facoltativo) Se non è stato caricato il manifest JSON nel bucket S3 in cui sono stati archiviati i file .zip, scegliere New manifest (Nuovo manifest). Puoi creare o incollare l'intero manifest nel campo Editor JSON. Per ulteriori informazioni su come creare il JSON manifest, consulta Fase 2: creazione del manifest del pacchetto JSON.

Al termine, scegli Create package (Crea pacchetto).

Attendere che Distributor crei il pacchetto dai file .zip e manifest. In base al numero e alla dimensione dei pacchetti che si stanno aggiungendo, questa operazione può richiedere alcuni minuti. Distributor esegue automaticamente il reindirizzamento alla pagina Package details (Dettagli pacchetto) per il nuovo 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 il processo di creazione del pacchetto. Per interrompere il processo di caricamento e di creazione del pacchetto, scegli Cancel (Annulla).

Per utilizzare AWS CLI per creare un pacchetto, eseguire il comando seguente, sostituendo package-name con il nome del pacchetto e path-to-manifest-file con il percorso del file manifesto JSON. amzn-s3-demo-bucket è l’URL del bucket di Amazon S3 in cui è archiviato l’intero pacchetto. Quando esegui il comando create-document in Distributor, devi specificare il valore Package per --document-type.

Se non è stato aggiunto il file manifest al bucket Amazon S3, il valore del parametro --content è il percorso al file manifest JSON.

aws ssm create-document \
    --name "package-name" \
    --content file://path-to-manifest-file \
    --attachments Key="SourceUrl",Values="amzn-s3-demo-bucket" \
    --version-name version-value-from-manifest \
    --document-type Package

Di seguito è riportato un esempio.

aws ssm create-document \
    --name "ExamplePackage" \
    --content file://path-to-manifest-file \
    --attachments Key="SourceUrl",Values="https://s3.amazonaws.com/amzn-s3-demo-bucket/ExamplePackage" \
    --version-name 1.0.1 \
    --document-type Package

Verificare che il pacchetto sia stato aggiunto e visualizzare il manifest del pacchetto eseguendo questo comando, sostituendo package-name con il nome del pacchetto. Per ottenere una versione specifica del documento (non la stessa di un pacchetto), puoi aggiungere il parametro --document-version.

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