Crea un pacchetto in Distributor

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 Crea pacchetto, quindi scegli 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 Posizione, scegli un bucket utilizzando il nome e il prefisso del bucket o utilizzando il bucket. URL

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.

Per il flusso di lavoro Simple Package Creation, poiché ogni file installabile viene caricato una sola volta, sono necessari passaggi aggiuntivi per eseguire le istruzioni Distributor per indirizzare un singolo file 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 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: 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 del processore supportate, consulta Architetture e piattaforme dei pacchetti supportate.

(Facoltativo) Espandi gli script ed esamina gli script che Distributor genera 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 il manifesto ed esamina il manifesto JSON del pacchetto che Distributor genera 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: Creare il manifesto 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 del nome della versione che specifichi quando aggiungi il pacchetto a Distributor. Diventa parte del AWS Systems Manager documento che Distributor viene creato quando si aggiunge 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, consulta Architetture e piattaforme dei pacchetti supportate.

Il 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 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 stai prendendo di mira. 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 si dispone di un file.zip che supporta entrambi Red Hat Enterprise Linux Nelle versioni 7.x e Amazon Linux, nella "packages" sezione sono presenti due voci che puntano allo stesso file.zip, come illustrato 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, esegui il Get-FileHash -Path path-to-.zip-file cmdlet 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 AWS CLI comando per creare un bucket, mbconsultate la 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 JSON manifesto nella AWS Systems Manager console, non caricarlo. Per ulteriori informazioni su come eseguire un AWS CLI comando per caricare file in un bucket, mvconsultate la sezione AWS CLI Command Reference.

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). È necessario il prefisso a cui aggiungere il pacchetto Distributor.

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 Crea pacchetto, quindi scegli 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 hai caricato il JSON manifesto nel bucket 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 Create package (Crea pacchetto).

Attendi Distributor per creare il pacchetto dai file.zip e dal file manifest. 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 per il nuovo pacchetto, ma puoi scegliere di aprire tu stesso questa pagina dopo il caricamento del software. La pagina dei dettagli del pacchetto non mostra tutte le informazioni sul pacco fino a Distributor completa il processo di creazione del pacchetto. Per interrompere il processo di caricamento e di creazione del pacchetto, scegli Cancel (Annulla).

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

Se non hai aggiunto il file manifest al bucket Amazon S3, il valore del --content parametro è il percorso del 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

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