Creazione di un pacchetto in Distributor

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

Nel pannello di navigazione, scegli Distributor.

Nella home page Distributor, scegli Crea pacchetto, quindi seleziona Semplice.

Nella pagina 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 Nome della versione, immetti un nome di versione. I nomi delle versioni possono essere composti da un massimo di 512 caratteri e non possono contenere caratteri speciali.

Per Posizione, scegli un bucket utilizzando il nome e il prefisso del bucket o utilizzandone l'URL.

Per Carica software, scegli 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 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 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, devi modificare alcune impostazioni predefinite nel flusso di lavoro Semplice, per indirizzare lo stesso software su versioni supportate sia dal sistema operativo di Amazon Linux che da quello di Ubuntu Server. Quando si utilizzano più piattaforme, esegui una delle seguenti operazioni.

Per 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 manifesto del pacchetto JSON.

Per 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 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 Script, scegliere la scheda 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 Aggiungi software. Altrimenti, vai alla fase successiva.

(Facoltativo) Espandi Manifesto ed esamina il manifesto 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 Genera manifesto per visualizzare il manifesto del pacchetto aggiornato.

Puoi modificare il manifesto 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 manifesto, consulta Fase 2: creazione del manifesto del pacchetto JSON.

Scegli Crea pacchetto.

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

{ "schemaVersion": "2.0",

Aggiungi una versione del pacchetto definita dall'utente al manifesto. Questo è anche il valore di 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 di :

"version": "1.0.1",

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

"publisher": "MyOrganization",

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

platform-versionPuò 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 scegli di specificare un platform-version valore per una versione specifica del sistema operativo, assicurati che corrisponda alla versione di rilascio esatta del sistema operativo AMI che hai scelto come target. 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 di : 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 2023.8 e _any sono voci di amazon. Esiste una sola piattaforma (Amazon Linux)), ma diverse versioni, architetture e relativi file .zip supportati.

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

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

{
    "amazon": {
        "2023.8.20250715 ": {
            "x86_64": {
                "file": "test.zip"
            }
        }
    },
    "redhat": {
        "8.*": {
            "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 manifesto 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, esegui il Get-FileHash -Path path-to-.zip-file cmdlet in. PowerShell

La sezione "files" del manifesto 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-rhel8-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-rhel8-x86.rpm.zip": {
            "checksums": {
                "sha256": "EXAMPLE13df60aa3219bf117638167e5bae0a55467e947a363fff0a51EXAMPLE"
            }
        }
    }

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

Copiare o spostare tutti i file di archivio .zip specificati nel manifesto 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 AWS CLI comando per creare un bucket, consulta mbla sezione AWS CLI Command Reference.

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 hai intenzione di incollare il tuo manifest JSON nella AWS Systems Manager console, non caricarlo. Per ulteriori informazioni su come eseguire un AWS CLI comando per caricare file in un bucket, consulta la sezione AWS CLI Command mvReference.

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.

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

Nel pannello di navigazione, scegli Distributor.

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

Nella pagina 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 Nome della versione, immetti il valore esatto della voce version nel file manifest.

Per Nome del bucket S3, scegli il nome del bucket in cui sono stati caricati i file .zip e il manifesto in Fase 3: caricamento del pacchetto e del manifesto in un bucket Amazon S3.

Per Prefisso della chiave S3, immetti la sottocartella del bucket in cui sono archiviati i file .zip e il manifesto.

Per Manifesto, scegli Estrai dal pacchetto per utilizzare un manifesto caricato nel bucket Amazon S3 con i file .zip.

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

Al termine, scegli 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 Dettagli del pacchetto per il nuovo pacchetto, ma puoi scegliere di aprire questa pagina personalmente dopo che il software è stato caricato. La pagina Dettagli del 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 Annulla.

Per utilizzarlo AWS CLI per creare un pacchetto, esegui il comando seguente, sostituendolo package-name con il nome del pacchetto e path-to-manifest-file con il percorso del file manifest JSON. amzn-s3-demo-bucket è l'URL del bucket 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 di :

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

Verifica che il pacchetto sia stato aggiunto e mostra il manifesto del pacchetto eseguendo il comando seguente, sostituendolo con il nome del pacchetto. package-name 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"