• La AWS Systems Manager CloudWatch dashboard non sarà più disponibile dopo il 30 aprile 2026. I clienti possono continuare a utilizzare la CloudWatch console Amazon per visualizzare, creare e gestire le proprie CloudWatch dashboard Amazon, proprio come fanno oggi. Per ulteriori informazioni, consulta la [documentazione di Amazon CloudWatch Dashboard](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html).
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# AWS Systems Manager Distributor
Distributor, uno strumento in AWS Systems Manager, consente di creare pacchetti e pubblicare software su nodi AWS Systems Manager gestiti. È possibile creare pacchetti e pubblicare il proprio software o utilizzarlo Distributor per trovare e pubblicare pacchetti software AWS forniti dagli agenti, ad esempio pacchetti di terze parti come **Trend Micro**. **AmazonCloudWatchAgent**La pubblicazione di un pacchetto pubblicizza versioni specifiche del documento del pacchetto ai nodi gestiti identificati utilizzando node IDs Account AWS IDs, tag o un. Regione AWS Per cominciare a utilizzare Distributor, apri la [console di Systems Manager](https://console.aws.amazon.com//systems-manager/distributor). Nel pannello di navigazione, scegli **Distributor**.
Dopo aver creato un pacchetto in Distributor, puoi installare il pacchetto in uno dei modi seguenti:
+ Una sola volta con [AWS Systems Manager Run Command](run-command.md).
+ In base a una pianificazione con [AWS Systems Manager State Manager](systems-manager-state.md).
**Importante**
I pacchetti distribuiti da venditori di terze parti non sono gestiti AWS e vengono pubblicati dal fornitore del pacchetto. Consigliamo di condurre ulteriore due diligence per garantire il rispetto dei controlli di sicurezza interni. La sicurezza è una responsabilità condivisa tra te AWS e te. Questo è descritto come il modello di responsabilità condivisa. Per ulteriori informazioni consulta il [Modello di responsabilità condivisa](https://aws.amazon.com/compliance/shared-responsibility-model/).
## Quali sono i vantaggi di Distributor per la mia organizzazione?
Distributor offre questi vantaggi:
+ **Un solo pacchetto, molte piattaforme**
Quando creai un pacchetto in Distributor, il sistema crea un documento AWS Systems Manager (documento SSM). È possibile allegare file con estensione zip a questo documento. Quando lanci Distributor, il sistema elabora le istruzioni nel documento SSM e installa il pacchetto software nel file .zip sulle destinazioni specificate. Distributor supporta più sistemi operativi, tra cui Windows, Ubuntu Server, Debian Server, e Red Hat Enterprise Linux. Per ulteriori informazioni sulle piattaforme supportate, consulta [Architetture e piattaforme dei pacchetti supportate](#what-is-a-package-platforms).
+ **Controlla l'accesso ai pacchetti nei gruppi di istanze gestite**
Puoi utilizzare Run Command o State Manager per controllare quali nodi gestiti ricevono un pacchetto e quale versione del pacchetto. Run Command e State Manager sono strumenti di AWS Systems Manager. I nodi gestiti possono essere raggruppati per istanza o dispositivo IDs, Account AWS numeri, tag o Regioni AWS. Puoi utilizzare le associazioni di State Manager per distribuire diverse versioni di un pacchetto a diversi gruppi di istanze.
+ **Molti pacchetti di AWS agenti inclusi e pronti all'uso**
Distributorinclude molti pacchetti di AWS agenti pronti per la distribuzione nei nodi gestiti. Cercare i pacchetti nellaDistributor `Packages`che sono pubblicati da `Amazon`. A titolo di esempio si possono menzionare `AmazonCloudWatchAgent` e `AWSPVDriver`.
+ **Distribuzione automatica **
Per mantenere aggiornato il tuo ambiente, utilizza State Manager per programmare i pacchetti per l'implementazione automatica nei nodi gestiti di destinazione quando vengono avviati per la prima volta.
## A chi è consigliato l'uso di Distributor?
+ Qualsiasi AWS cliente che desideri creare pacchetti software nuovi o implementare pacchetti software esistenti, inclusi i pacchetti AWS pubblicati, su più nodi gestiti di Systems Manager contemporaneamente.
+ Sviluppatori software che creano pacchetti software.
+ Amministratori responsabili dell'aggiornamento dei nodi gestiti di Systems Manager con la maggior parte dei pacchetti up-to-date software.
## Quali sono le funzionalità di Distributor?
+ **Implementazione dei pacchetti nelle istanze di Windows e Linux**
ConDistributor, puoi distribuire pacchetti software su AWS IoT Greengrass istanze Amazon Elastic Compute Cloud (Amazon EC2) e dispositivi principali per Linux e. Windows Server Per un elenco dei tipi di sistema operativo dell'istanza supportati, consulta [Architetture e piattaforme dei pacchetti supportate](#what-is-a-package-platforms).
**Nota**
Distributor è supportato dal sistema operativo macOS.
+ **Distribuisci i pacchetti una sola volta o in base a una pianificazione automatica**
Puoi scegliere di distribuire i pacchetti una sola volta, in base a una pianificazione periodica o ogni volta che la versione del pacchetto predefinita viene modificata.
+ **Reinstallazione completa dei pacchetti o esecuzione di aggiornamenti in locale**
Per installare una nuova versione di un pacchetto, è possibile disinstallare completamente la versione corrente e sostituirla con una nuova oppure aggiornare solo la versione corrente con componenti nuovi e aggiornati, in base a uno *script di aggiornamento* fornito. L'applicazione del pacchetto non è disponibile durante una reinstallazione, ma può rimanere disponibile durante un aggiornamento in locale. Gli aggiornamenti locali sono particolarmente utili per applicazioni di monitoraggio della sicurezza o altri scenari in cui è necessario evitare tempi di inattività dell'applicazione.
+ **Accesso alle funzionalità da console PowerShell, CLI e SDK Distributor**
Puoi lavorare con Distributor la console Systems Manager, AWS Command Line Interface (AWS CLI) o l' AWS SDK di tua scelta. AWS Strumenti per PowerShell
+ **Controllo degli accessi IAM**
Utilizzando le policy AWS Identity and Access Management (IAM), è possibile controllare quali membri dell'organizzazione possono creare, aggiornare, distribuire o eliminare pacchetti o versioni di pacchetti. Ad esempio, potresti voler assegnare a un amministratore le autorizzazioni per distribuire i pacchetti, ma non per modificarli o per creare nuove versioni di pacchetti.
+ **Supporto delle funzionalità di registrazione e verifica**
Puoi controllare e registrare le azioni Distributor degli utenti all'interno della tua azienda Account AWS attraverso l'integrazione con altri Servizi AWS. Per ulteriori informazioni, consulta [Verifica e registrazione dell'attività Distributor](distributor-logging-auditing.md).
## Cos'è un pacchetto in Distributor?
Un *pacchetto* è una raccolta di software o di risorse installabili che include quanto segue.
+ Un file .zip del software per ogni piattaforma del sistema operativo di destinazione. Ogni file .zip deve includere quanto segue.
+ Un copione **install** e uno **uninstall** script. Windows Serveri nodi gestiti basati richiedono PowerShell script (script denominati `install.ps1` and`uninstall.ps1`). I nodi gestiti basati su Linux richiedono script di shell (script denominati e). `install.sh` `uninstall.sh` AWS Systems Manager SSM Agentlegge ed esegue le istruzioni contenute negli script and. **install** **uninstall**
+ Un file eseguibile. SSM Agent deve trovare questo eseguibile per installare il pacchetto nei nodi gestiti di destinazione.
+ Un file manifest in formato JSON che descrive il contenuto del pacchetto. Il file manifest non è incluso nel file .zip, ma è archiviato nello stesso bucket Amazon Simple Storage Service (Amazon S3) dei file .zip che formano il pacchetto. Il manifest identifica la versione del pacchetto e mappa i file .zip del pacchetto agli attributi del nodo gestito di destinazione, ad esempio la versione del sistema operativo o l'architettura. Per informazioni su come creare il manifest, consulta [Fase 2: creazione del manifesto del pacchetto JSON](distributor-working-with-packages-create.md#packages-manifest).
Quando scegli la creazione del pacchetto **Simple (Semplice)** nella console Distributor, Distributor genera automaticamente gli script di installazione e disinstallazione, gli hash del file e il manifest del pacchetto JSON, in base al nome file dell'eseguibile software e alle piattaforme e architetture di destinazione.
### Architetture e piattaforme dei pacchetti supportate
È possibile utilizzare Distributor per pubblicare pacchetti sulle seguenti piattaforme di nodi gestiti di Systems Manager. Il valore di una versione deve corrispondere esattamente alla versione della release dell'AMI del sistema operativo Amazon Machine Image (AMI) di destinazione. Per ulteriori informazioni su come determinare questa versione, consulta la fase 4 di [Fase 2: creazione del manifesto del pacchetto JSON](distributor-working-with-packages-create.md#packages-manifest).
**Nota**
Systems Manager non supporta tutti i seguenti sistemi operativi per i dispositivi AWS IoT Greengrass principali. Per ulteriori informazioni, vedere [Configurazione dei dispositivi AWS IoT Greengrass principali](https://docs.aws.amazon.com/greengrass/v2/developerguide/setting-up.html) nella *Guida per gli AWS IoT Greengrass Version 2 sviluppatori*.
| Platform (Piattaforma) | Valore del codice nel file manifest | Architetture supportate |
| --- | --- | --- |
| AlmaLinux | almalinux | x86\$164 ARM64 |
| Amazon Linux 2 e Amazon Linux 2023 | `amazon` | x86\$164 o x86 ARM64(tipi di istanze Amazon Linux 2 e AL2023 A1) |
| Debian Server | `debian` | x86\$164 o x86 |
| openSUSE | `opensuse` | x86\$164 |
| openSUSE Leap | `opensuseleap` | x86\$164 |
| Oracle Linux | `oracle` | x86\$164 |
| Red Hat Enterprise Linux (RHEL) | `redhat` | x86\$164 ARM64 (RHEL 7.6 e versioni successive, tipi di istanza A1) |
| Rocky Linux | rocky | x86\$164 ARM64 |
| SUSE Linux Enterprise Server (SLES) | `suse` | x86\$164 |
| Ubuntu Server | `ubuntu` | x86\$164 o x86 ARM64 (Ubuntu Server 16 e versioni successive, tipi di istanza A1) |
| Windows Server | `windows` | x86\$164 |
**Topics**
+ [Quali sono i vantaggi di Distributor per la mia organizzazione?](#distributor-benefits)
+ [A chi è consigliato l'uso di Distributor?](#distributor-who)
+ [Quali sono le funzionalità di Distributor?](#distributor-features)
+ [Cos'è un pacchetto in Distributor?](#what-is-a-package)
+ [Configurazione di Distributor](distributor-getting-started.md)
+ [Utilizzo dei pacchetti Distributor](distributor-working-with.md)
+ [Verifica e registrazione dell'attività Distributor](distributor-logging-auditing.md)
+ [Risoluzione dei problemi AWS Systems ManagerDistributor](distributor-troubleshooting.md)
# Configurazione di Distributor
Prima di utilizzare Distributor uno strumento per creare, gestire e distribuire pacchetti software, segui questi passaggi. AWS Systems Manager
## Completare i prerequisiti Distributor
Prima di utilizzare uno strumento Distributor AWS Systems Manager, assicurati che l'ambiente soddisfi i seguenti requisiti.
**Prerequisiti di Distributor**
| Requisito | Description |
| --- | --- |
| SSM Agent | AWS Systems Manager SSM Agentla versione 2.3.274.0 o successiva deve essere installata nei nodi gestiti su cui si desidera eseguire la distribuzione o da cui si desidera rimuovere i pacchetti. Per installare o aggiornare SSM Agent, consulta [Utilizzo di SSM Agent](ssm-agent.md). |
| AWS CLI | (Facoltativo) Per utilizzare AWS Command Line Interface (AWS CLI) anziché la console Systems Manager per creare e gestire pacchetti, installa la versione più recente di AWS CLI sul tuo computer locale. Per ulteriori informazioni su come installare o aggiornare CLI, consulta [Installazione di AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) nella *Guida per l'utente di AWS Command Line Interface *. |
| AWS Strumenti per PowerShell | (Facoltativo) Per utilizzare Tools for PowerShell anziché la console Systems Manager per creare e gestire pacchetti, installa la versione più recente di Tools for PowerShell sul tuo computer locale. Per ulteriori informazioni su come installare o aggiornare gli strumenti per PowerShell, vedere [Configurazione di AWS Tools for Windows PowerShell or AWS Tools for PowerShell Core nella](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html) *Guida per l'AWS Strumenti per PowerShell utente*. |
**Nota**
Systems Manager non supporta la distribuzione di pacchetti ai nodi gestiti di Oracle Linux utilizzando Distributor.
## Verificare o creare un profilo dell'istanza IAM con le autorizzazioni di Distributor
Per impostazione predefinita, AWS Systems Manager non dispone dell'autorizzazione per eseguire azioni sulle istanze. È necessario concedere l'accesso utilizzando un profilo di istanza AWS Identity and Access Management (IAM). Un profilo dell'istanza è un container che trasmette le informazioni sul ruolo IAM a un'istanza di Amazon Elastic Compute Cloud (Amazon EC2) all'avvio. Questo requisito si applica alle autorizzazioni per tutti gli strumenti di Systems Manager, non solo per Distributor.
**Nota**
Quando configuri i dispositivi edge per eseguire il software AWS IoT Greengrass Core e SSM Agent specifichi un ruolo di servizio IAM che consente a Systems Manager di eseguire azioni su di esso. Non è necessario configurare dispositivi edge gestiti con un profilo dell'istanza.
Se già utilizzi altri strumenti di Systems Manager, ad esempio Run Command e State Manager, un profilo dell'istanza con le autorizzazioni richieste per Distributor è già associato alle tue istanze. Il modo più semplice per assicurarti di disporre delle autorizzazioni per eseguire Distributor attività è allegare la SSMManaged InstanceCore policy di **Amazon** al profilo della tua istanza. Per ulteriori informazioni, consulta la pagina [Configurazione delle autorizzazioni dell'istanza richieste per Systems Manager](setup-instance-permissions.md).
## Controllo dell'accesso utenti ai pacchetti
Utilizzando le policy AWS Identity and Access Management (IAM), puoi controllare chi può creare, distribuire e gestire i pacchetti. Puoi anche controllare quali operazioni API di Run Command e State Manager possono eseguire sui nodi gestiti. Ad esempioDistributor, entrambi Run Command e State Manager due sono strumenti in AWS Systems Manager.
**Formato ARN**
I pacchetti definiti dall'utente sono associati al documento Amazon Resource Names (ARNs) e hanno il seguente formato.
```
arn:aws:ssm:region:account-id:document/document-name
```
Di seguito è riportato un esempio di :
```
arn:aws:ssm:us-west-1:123456789012:document/ExampleDocumentName
```
Puoi utilizzare un paio di policy IAM predefinite AWS fornite, una per gli utenti finali e una per gli amministratori, per concedere le autorizzazioni per le attività. Distributor In alternativa, puoi creare policy IAM personalizzate adatte ai tuoi specifici requisiti di autorizzazione.
Per ulteriori informazioni sull'utilizzo delle variabili nelle policy IAM, consulta [Elementi delle policy IAM: variabili](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_variables.html).
Per informazioni su come creare policy e collegarle a utenti o gruppi, consulta le pagine [Creazione di policy IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) e [Aggiunta e rimozione di policy IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) nella *Guida per l'utente di IAM*.
## Creazione o scelta di un bucket Amazon S3 per archiviare i pacchetti Distributor
Quando crei un pacchetto utilizzando il flusso di lavoro **Semplice** nella console AWS Systems Manager , scegli un bucket Amazon Simple Storage Service (Amazon S3) esistente in cui Distributor carica il software. Distributor è uno strumento di AWS Systems Manager. Nel flusso di lavoro **Avanzato**, è necessario caricare i file .zip del software o le risorse in un bucket Amazon S3 prima di iniziare. Sia che crei un pacchetto utilizzando i flussi di lavoro **Semplice** o **Avanzato** nella console o l'API, prima di iniziare a creare il pacchetto devi disporre di un bucket Amazon S3. Come parte del processo di creazione del pacchetto, Distributor copia il software installabile e le risorse da questo bucket in un archivio Systems Manager interno. Poiché le risorse vengono copiate in una memoria interna, puoi eliminare o riutilizzare il bucket Amazon S3 al termine della creazione del pacchetto.
Per ulteriori informazioni sulla creazione di un bucket, consulta la sezione relativa alla [creazione di un bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/CreatingABucket.html) 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 la sezione Command [https://docs.aws.amazon.com/cli/latest/reference/s3/mb.html](https://docs.aws.amazon.com/cli/latest/reference/s3/mb.html)Reference.AWS CLI *
# Utilizzo dei pacchetti Distributor
Puoi utilizzare la console AWS Systems Manager, gli strumenti a riga di comando AWS (AWS CLI e AWS Strumenti per PowerShell) e gli SDK AWS per aggiungere, gestire o distribuire i pacchetti in Distributor. Distributor è uno strumento di AWS Systems Manager. Prima di aggiungere un pacchetto a Distributor:
+ Crea e comprimi le risorse installabili.
+ (Facoltativo) Crea un file manifest JSON per il pacchetto. Questa operazione non è necessaria per utilizzare il processo di creazione del pacchetto **Simple (Semplice)** nella console Distributor. La creazione del pacchetto semplice genera automaticamente un file manifest JSON.
Puoi utilizzare la console AWS Systems Manager o un editor di testo o JSON per creare il file manifest.
+ Avere un bucket Amazon Simple Storage Service (Amazon S3) pronto per memorizzare le risorse o il software installabili. Se stai utilizzando il processo di creazione del pacchetto **Advanced (Avanzato)**, carica le risorse nel bucket Amazon S3 prima di iniziare.
**Nota**
Puoi eliminare o riutilizzare questo bucket al termine della creazione del pacchetto perché Distributor sposta i contenuti del pacchetto in un bucket interno Systems Manager come parte del processo di creazione del pacchetto.
I pacchetti pubblicati da AWS sono già compressi e pronti per la distribuzione. Per distribuire un pacchetto pubblicato da AWS verso i nodi gestiti, consulta [Installazione o aggiornamento dei pacchetti Distributor](distributor-working-with-packages-deploy.md).
Puoi condividere pacchetti Distributor tra Account AWS. Quando si utilizza un pacchetto condiviso da un altro account in AWS CLI i comandi utilizzano il pacchetto Amazon Resource Name (ARN) anziché il nome del pacchetto.
**Topics**
+ [Visualizzare i pacchetti in Distributor](distributor-view-packages.md)
+ [Creazione di un pacchetto in Distributor](distributor-working-with-packages-create.md)
+ [Modifica delle autorizzazioni del pacchetto Distributor nella console](distributor-working-with-packages-ep.md)
+ [Modifica dei tag del pacchetto Distributor nella console](distributor-working-with-packages-tags.md)
+ [Aggiunta di una versione a un pacchetto Distributor](distributor-working-with-packages-version.md)
+ [Installazione o aggiornamento dei pacchetti Distributor](distributor-working-with-packages-deploy.md)
+ [Disinstallazione di un pacchetto Distributor](distributor-working-with-packages-uninstall.md)
+ [Eliminazione di un pacchetto Distributor](distributor-working-with-packages-dpkg.md)
# Visualizzare i pacchetti in Distributor
Per visualizzare i pacchetti disponibili per l'installazione, è possibile utilizzare la AWS Systems Manager console o lo strumento da riga di AWS comando preferito. Distributorè uno strumento in AWS Systems Manager. Per accedereDistributor, apri la AWS Systems Manager console e scegli **Distributor**nel riquadro di navigazione a sinistra. Vedrai tutti i pacchetti a tua disposizione.
La sezione seguente descrive come visualizzare i pacchetti Distributor utilizzando lo strumento a riga di comando preferito.
## Visualizzazione dei pacchetti utilizzando la riga di comando
Questa sezione contiene informazioni su come utilizzare lo strumento a riga di comando preferito per visualizzare Distributor utilizzando i comandi forniti.
------
#### [ Linux & macOS ]
**Per visualizzare i pacchetti usando Linux AWS CLI**
+ Per visualizzare tutti i pacchetti, esclusi i pacchetti condivisi, esegui il comando seguente.
```
aws ssm list-documents \
--filters Key=DocumentType,Values=Package
```
+ Per visualizzare tutti i pacchetti di proprietà di Amazon, esegui il comando seguente.
```
aws ssm list-documents \
--filters Key=DocumentType,Values=Package Key=Owner,Values=Amazon
```
+ Per visualizzare tutti i pacchetti di proprietà di terze parti, esegui il comando seguente.
```
aws ssm list-documents \
--filters Key=DocumentType,Values=Package Key=Owner,Values=ThirdParty
```
------
#### [ Windows ]
**Per visualizzare i pacchetti utilizzando Windows AWS CLI**
+ Per visualizzare tutti i pacchetti, esclusi i pacchetti condivisi, esegui il comando seguente.
```
aws ssm list-documents ^
--filters Key=DocumentType,Values=Package
```
+ Per visualizzare tutti i pacchetti di proprietà di Amazon, esegui il comando seguente.
```
aws ssm list-documents ^
--filters Key=DocumentType,Values=Package Key=Owner,Values=Amazon
```
+ Per visualizzare tutti i pacchetti di proprietà di terze parti, esegui il comando seguente.
```
aws ssm list-documents ^
--filters Key=DocumentType,Values=Package Key=Owner,Values=ThirdParty
```
------
#### [ PowerShell ]
**Per visualizzare i pacchetti utilizzando gli Strumenti per PowerShell**
+ Per visualizzare tutti i pacchetti, esclusi i pacchetti condivisi, esegui il comando seguente.
```
$filter = New-Object Amazon.SimpleSystemsManagement.Model.DocumentKeyValuesFilter
$filter.Key = "DocumentType"
$filter.Values = "Package"
Get-SSMDocumentList `
-Filters @($filter)
```
+ Per visualizzare tutti i pacchetti di proprietà di Amazon, esegui il comando seguente.
```
$typeFilter = New-Object Amazon.SimpleSystemsManagement.Model.DocumentKeyValuesFilter
$typeFilter.Key = "DocumentType"
$typeFilter.Values = "Package"
$ownerFilter = New-Object Amazon.SimpleSystemsManagement.Model.DocumentKeyValuesFilter
$ownerFilter.Key = "Owner"
$ownerFilter.Values = "Amazon"
Get-SSMDocumentList `
-Filters @($typeFilter,$ownerFilter)
```
+ Per visualizzare tutti i pacchetti di proprietà di terze parti, esegui il comando seguente.
```
$typeFilter = New-Object Amazon.SimpleSystemsManagement.Model.DocumentKeyValuesFilter
$typeFilter.Key = "DocumentType"
$typeFilter.Values = "Package"
$ownerFilter = New-Object Amazon.SimpleSystemsManagement.Model.DocumentKeyValuesFilter
$ownerFilter.Key = "Owner"
$ownerFilter.Values = "ThirdParty"
Get-SSMDocumentList `
-Filters @($typeFilter,$ownerFilter)
```
------
# Creazione di un pacchetto in Distributor
Per creare un pacchetto, prepara il software o le risorse installabili, un file per piattaforma del sistema operativo. Per creare un pacchetto è richiesto almeno un file.
A volte, piattaforme diverse potrebbero utilizzare lo stesso file, ma tutti i file collegati al pacchetto devono essere elencati nella sezione `Files` del manifesto. Se stai creando un pacchetto utilizzando il flusso di lavoro semplice nella console, il manifesto viene generato automaticamente. Il numero massimo di file che puoi collegare a un singolo documento è 20. La dimensione massima di ogni file è di 1 GB. Per ulteriori informazioni sulle piattaforme supportate, consulta [Architetture e piattaforme dei pacchetti supportate](distributor.md#what-is-a-package-platforms).
Quando crei un pacchetto, il sistema crea un nuovo [Documento SSM](documents.md). Il documento consente di distribuire il pacchetto nei nodi gestiti.
Solo a scopo dimostrativo, è disponibile un pacchetto di esempio, [ExamplePackage.zip](https://docs.aws.amazon.com/systems-manager/latest/userguide/samples/ExamplePackage.zip), da scaricare dal nostro sito Web. Il pacchetto di esempio include un manifest JSON completo e tre file.zip contenenti i programmi di installazione per la versione 7.0.0. PowerShell Gli script di installazione e disinstallazione non contengono comandi validi. Anche se è necessario comprimere ogni software installabile e gli script in un file .zip per creare un pacchetto nel flusso di lavoro **Avanzato**, le risorse installabili non vengono compresse nel flusso di lavoro **Semplice**.
**Topics**
+ [Crea un pacchetto utilizzando il flusso di lavoro Semplice](#distributor-working-with-packages-create-simple)
+ [Creare un pacchetto utilizzando il flusso di lavoro Avanzato](#distributor-working-with-packages-create-adv)
## Crea un pacchetto utilizzando il flusso di lavoro Semplice
Questa sezione descrive come creare un pacchetto in Distributor scegliendo il flusso di lavoro di creazione del pacchetto **Semplice** nella console Distributor. Distributor è uno strumento di AWS Systems Manager. Per creare un pacchetto, prepara le risorse installabili, un file per ogni piattaforma del sistema operativo. Per creare un pacchetto è richiesto almeno un file. Il processo di creazione del pacchetto **Semplice** genera automaticamente script di installazione e disinstallazione, hash del file e un manifesto in formato JSON. Il flusso di lavoro **Semplice** gestisce il processo di caricamento e compressione dei file installabili e la creazione di un nuovo pacchetto e del [documento SSM](documents.md) associato. Per ulteriori informazioni sulle piattaforme supportate, consulta [Architetture e piattaforme dei pacchetti supportate](distributor.md#what-is-a-package-platforms).
Quando si utilizza il metodo semplice per creare un pacchetto, Distributor crea script `install` e `uninstall` per l'utente. Tuttavia, quando si crea un pacchetto per un aggiornamento in locale, è necessario fornire i propri contenuti dello script `update` nella scheda **Aggiorna script**. Quando si aggiungono comandi di input per uno script `update`, Distributor include questo script nel pacchetto.zip creato per l'utente, insieme agli script `install` e `uninstall`.
**Nota**
Utilizza l'opzione di aggiornamento `In-place` per aggiungere file nuovi o aggiornati a un'installazione di pacchetti esistente senza disconnettere l'applicazione associata.
**Creazione di un pacchetto tramite il flusso di lavoro semplice**
1. AWS Systems Manager Apri [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)la console all'indirizzo.
1. Nel pannello di navigazione, scegli **Distributor**.
1. Nella home page Distributor, scegli **Crea pacchetto**, quindi seleziona **Semplice**.
1. 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.
1. (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.
1. Per **Posizione**, scegli un bucket utilizzando il nome e il prefisso del bucket o utilizzandone l'URL.
1. 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.
1. 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.
+ Utilizza il flusso di lavoro **Avanzato**, comprimi ogni file installabile in un file .zip prima di iniziare e creare manualmente il manifesto, in modo da poter destinare un file installabile a più piattaforme o versioni del sistema operativo. Per ulteriori informazioni, consulta [Creare un pacchetto utilizzando il flusso di lavoro Avanzato](#distributor-working-with-packages-create-adv).
+ Modifica manualmente il file manifest nel flusso di lavoro **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: creazione del manifesto del pacchetto JSON](#packages-manifest).
1. Per **Versione della piattaforma**, verifica che la versione della piattaforma del sistema operativo mostrata sia **\$1any** o una versione principale seguita da una wildcard (7.\$1) 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](#packages-manifest).
1. 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](distributor.md#what-is-a-package-platforms).
1. (Facoltativo) Espandere **Script** ed esaminare gli script generati da Distributor per il software installabile.
1. (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.
1. Per aggiungere altri file del software installabile, scegli **Aggiungi software**. Altrimenti, vai alla fase successiva.
1. (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](#packages-manifest).
1. Scegli **Crea pacchetto**.
Attendi che Distributor termini il caricamento del software e la creazione del pacchetto. Distributor mostra lo stato di caricamento per ogni file installabile. 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**.
Se Distributor non è in grado di caricare i file installabili del software, visualizza un messaggio **Caricamento non riuscito**. Per riprovare a eseguire il caricamento, scegli **Riprova caricamento**. Per ulteriori informazioni su come risolvere gli errori di creazione del pacchetto, consulta [Risoluzione dei problemi AWS Systems ManagerDistributor](distributor-troubleshooting.md).
## Creare un pacchetto utilizzando il flusso di lavoro Avanzato
In questa sezione, vengono fornite ulteriori informazioni su come utenti esperti possono creare un pacchetto in Distributor dopo il caricamento di risorse installabili compresse con script di installazione e disinstallazione e un file manifest JSON, in un bucket di Amazon S3.
Per creare un pacchetto, preparare i file .zip delle risorse installabili, un file .zip per ogni piattaforma del sistema operativo. Per creare un pacchetto è richiesto almeno un file .zip. Quindi, crea un manifesto JSON. Il manifesto include i puntatori per i file del codice del pacchetto. Dopo aver aggiunto i file del codice richiesti a una cartella o a una directory e dopo aver popolato il manifesto con i valori corretti, carica il pacchetto in un bucket S3.
Un pacchetto di esempio, [ExamplePackage.zip](https://docs.aws.amazon.com/systems-manager/latest/userguide/samples/ExamplePackage.zip), può essere scaricato dal nostro sito Web. Il pacchetto di esempio include un manifesto JSON completato e tre file .zip.
**Topics**
+ [Fase 1: creazione dei file ZIP](#packages-zip)
+ [Fase 2: creazione del manifesto del pacchetto JSON](#packages-manifest)
+ [Fase 3: caricamento del pacchetto e del manifesto in un bucket Amazon S3](#packages-upload-s3)
+ [Fase 4: aggiunta di un pacchetto a Distributor](#distributor-working-with-packages-add)
### Fase 1: creazione dei file ZIP
La base del pacchetto è costituita da almeno un file .zip con software o risorse installabili. Un pacchetto include un file .zip per ogni sistema operativo da supportare, a meno che questo non possa essere installato su più sistemi operativi. Ad esempio, le versioni supportate delle istanze di Red Hat Enterprise Linux e di Amazon Linux, in genere, possono eseguire gli stessi file eseguibili .RPM, quindi è sufficiente collegare un solo file .zip al pacchetto per supportare entrambi i sistemi operativi.
**File richiesti**
Gli elementi seguenti sono obbligatori in ogni file .zip.
+ Un copione **install** e uno **uninstall** script. Windows Serveri nodi gestiti basati richiedono PowerShell script (script denominati `install.ps1` and`uninstall.ps1`). I nodi gestiti basati su Linux richiedono script shell, denominati `install.sh` e `uninstall.sh`. SSM Agent esegue le istruzioni negli script **install** e **uninstall**.
Ad esempio, gli script di installazione potrebbero eseguire un programma di installazione, ad esempio .rpm o .msi, potrebbero copiare file o impostare opzioni di configurazione.
+ Un file eseguibile, pacchetti di installazione (.rpm, .deb, .msi e così via), altri script o file di configurazione.
**File facoltativi**
Il seguente elemento è facoltativo in ogni file.zip:
+ Uno script **update**. Fornire uno script di aggiornamento consente di utilizzare l'opzione `In-place update` per installare un pacchetto. Quando si desidera aggiungere file nuovi o aggiornati a un'installazione di pacchetto esistente, l'`In-place update`opzione non mette offline l'applicazione del pacchetto durante l'aggiornamento. Windows Serveri nodi gestiti basati richiedono uno PowerShell script (denominato script`update.ps1`). I nodi gestiti basati su Linux richiedono uno script shell (nome script `update.sh`). SSM Agent esegue le istruzioni nello script **update**.
Per ulteriori informazioni sull'installazione o sull'aggiornamento dei pacchetti, consulta [Installazione o aggiornamento dei pacchetti Distributor](distributor-working-with-packages-deploy.md).
[Per esempi di file con estensione zip, inclusi esempi **install** e **uninstall** script, scaricate il pacchetto di esempio, ExamplePackage .zip.](https://docs.aws.amazon.com/systems-manager/latest/userguide/samples/ExamplePackage.zip)
### Fase 2: creazione del manifesto del pacchetto JSON
Dopo la preparazione e la compressione dei file installabili, crea un manifesto JSON. Di seguito è riportato il modello. Le parti del modello del manifesto sono descritte nella procedura in questa sezione. Puoi utilizzare un editor JSON per creare questo manifesto in un file separato. In alternativa, puoi creare il manifesto nella AWS Systems Manager console quando crei un pacchetto.
```
{
"schemaVersion": "2.0",
"version": "your-version",
"publisher": "optional-publisher-name",
"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"
}
}
}
},
"files": {
".zip-file-name-1.zip": {
"checksums": {
"sha256": "checksum"
}
},
".zip-file-name-2.zip": {
"checksums": {
"sha256": "checksum"
}
}
}
}
```
**Per creare un manifesto del pacchetto JSON**
1. Aggiungi la versione dello schema al manifesto. In questo rilascio, la versione dello schema è sempre `2.0`.
```
{ "schemaVersion": "2.0",
```
1. 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",
```
1. (Facoltativo) Aggiungi il nome di un publisher. Di seguito è riportato un esempio di :
```
"publisher": "MyOrganization",
```
1. 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](distributor.md#what-is-a-package-platforms).
*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.\$1. 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.
+ Su nodi gestiti basati su Windows Server, la versione di release è disponibile sotto forma di dati Windows Management Instrumentation (WMI). Puoi eseguire il seguente comando dal prompt dei comandi per ottenere le informazioni sulla versione, quindi puoi analizzare i risultati per `version`.
```
wmic OS get /format:list
```
+ In un nodo gestito basato su Linux, per ottenere la versione devi cercare prima il rilascio del sistema operativo (il comando seguente). Cerca il valore di `VERSION_ID`.
```
cat /etc/os-release
```
Se non vengono restituiti i risultati richiesti, esegui il secondo comando per ottenere le informazioni di rilascio LSB dal file `/etc/lsb-release`, quindi cerca il valore di `DISTRIB_RELEASE`.
```
lsb_release -a
```
Se questi metodi non riescono, in genere è possibile individuare il rilascio in base alla distribuzione. Ad esempio, su Debian Server puoi analizzare il file `/etc/debian_version` oppure su Red Hat Enterprise Linux il `/etc/redhat-release`.
```
hostnamectl
```
```
"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"
}
}
}
},
```
1. 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](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/get-filehash?view=powershell-6)
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"
}
}
}
```
1. Dopo aver aggiunto le informazioni sul pacchetto, salva e chiudi il file manifest.
Di seguito è riportato un esempio di un manifesto completato. Questo esempio mostra un file .zip, `NewPackage_LINUX.zip`, che supporta più di una piattaforma, ma viene indicato nella sezione `"files"` una sola volta.
```
{
"schemaVersion": "2.0",
"version": "1.7.1",
"publisher": "Amazon Web Services",
"packages": {
"windows": {
"_any": {
"x86_64": {
"file": "NewPackage_WINDOWS.zip"
}
}
},
"amazon": {
"_any": {
"x86_64": {
"file": "NewPackage_LINUX.zip"
}
}
},
"ubuntu": {
"_any": {
"x86_64": {
"file": "NewPackage_LINUX.zip"
}
}
}
},
"files": {
"NewPackage_WINDOWS.zip": {
"checksums": {
"sha256": "EXAMPLEc2c706013cf8c68163459678f7f6daa9489cd3f91d52799331EXAMPLE"
}
},
"NewPackage_LINUX.zip": {
"checksums": {
"sha256": "EXAMPLE2b8b9ed71e86f39f5946e837df0d38aacdd38955b4b18ffa6fEXAMPLE"
}
}
}
}
```
#### Esempio di pacchetto
Un pacchetto di esempio, [ExamplePackage.zip](https://docs.aws.amazon.com/systems-manager/latest/userguide/samples/ExamplePackage.zip), è disponibile per il download dal nostro sito Web. Il pacchetto di esempio include un manifesto JSON completato e tre file .zip.
### Fase 3: caricamento del pacchetto e del manifesto in un bucket Amazon S3
Preparare il pacchetto copiando o spostando tutti i file .zip in una cartella o una directory. Un pacchetto valido richiede il manifesto creato in [Fase 2: creazione del manifesto del pacchetto JSON](#packages-manifest) e tutti i file .zip identificati nel file manifest.
**Per caricare il pacchetto e il manifesto in Amazon S3**
1. 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.
1. Creare un bucket o sceglierne uno esistente. Per ulteriori informazioni consulta la sezione relativa alla [creazione di un bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/CreatingABucket.html) 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 [https://docs.aws.amazon.com/cli/latest/reference/s3/mb.html](https://docs.aws.amazon.com/cli/latest/reference/s3/mb.html)la sezione *AWS CLI Command* Reference.
1. Carica la cartella o la directory nel bucket. Per ulteriori informazioni, consulta [Aggiungi un oggetto in un bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/PuttingAnObjectInABucket.html) 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 [https://docs.aws.amazon.com/cli/latest/reference/s3/mv.html](https://docs.aws.amazon.com/cli/latest/reference/s3/mv.html)*Reference.
1. 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.
### Fase 4: aggiunta di un pacchetto a Distributor
Puoi usare la AWS Systems Manager console, gli strumenti della riga di AWS comando (AWS CLI and AWS Strumenti per PowerShell) o AWS SDKs aggiungere un nuovo pacchetto aDistributor. Quando aggiungi un pacchetto, stai aggiungendo un nuovo [documento SSM](documents.md). Il documento consente di implementare il pacchetto nei nodi gestiti.
**Topics**
+ [Aggiunta di un pacchetto tramite la console](#create-pkg-console)
+ [Aggiungi un pacchetto utilizzando il AWS CLI](#create-pkg-cli)
#### Aggiunta di un pacchetto tramite la console
È possibile utilizzare la AWS Systems Manager console per creare un pacchetto. Tieni pronto il nome del bucket in cui hai caricato il pacchetto in [Fase 3: caricamento del pacchetto e del manifesto in un bucket Amazon S3](#packages-upload-s3).
**Per aggiungere un pacchetto a Distributor (console)**
1. Apri la AWS Systems Manager console all'indirizzo [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Nel pannello di navigazione, scegli **Distributor**.
1. Nella home page Distributor, scegli **Create package (Crea pacchetto)** e seleziona **Advanced (Avanzato)**.
1. 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.
1. Per **Nome della versione**, immetti il valore esatto della voce `version` nel file manifest.
1. 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](#packages-upload-s3).
1. Per **Prefisso della chiave S3**, immetti la sottocartella del bucket in cui sono archiviati i file .zip e il manifesto.
1. 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](#packages-manifest).
1. Al termine, scegli **Crea pacchetto**.
1. 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**.
#### Aggiungi un pacchetto utilizzando il AWS CLI
È possibile utilizzare il AWS CLI per creare un pacchetto. Tieni pronto l'URL del bucket da cui hai caricato il pacchetto in [Fase 3: caricamento del pacchetto e del manifesto in un bucket Amazon S3](#packages-upload-s3).
**Per aggiungere un pacchetto ad Amazon S3 utilizzando AWS CLI**
1. 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
```
1. 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"
```
Per informazioni sulle altre opzioni che puoi utilizzare con il comando **create-document**, consulta [https://docs.aws.amazon.com/cli/latest/reference/ssm/create-document.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/create-document.html) nella sezione AWS Systems Manager *Riferimento ai comandi AWS CLI *. Per informazioni sulle altre opzioni che puoi utilizzare con il comando **get-document** , consulta [https://docs.aws.amazon.com/cli/latest/reference/ssm/get-document.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/get-document.html).
# Modifica delle autorizzazioni del pacchetto Distributor nella console
Dopo aver aggiunto un pacchetto aDistributor, uno strumento in AWS Systems Manager, puoi modificare le autorizzazioni del pacchetto nella console Systems Manager. Puoi aggiungerne altre Account AWS alle autorizzazioni di un pacchetto. I pacchetti possono essere condivisi solo con altri account nella stessa Regione AWS . La condivisione tra regioni non è supportata. Per impostazione predefinita, i pacchetti sono impostati su **Privato**, il che significa che solo coloro che hanno accesso al creatore del pacchetto Account AWS possono visualizzare le informazioni sul pacchetto e aggiornare o eliminare il pacchetto. Se le autorizzazioni **Private (Privato)** sono accettabili, puoi ignorare questa procedura.
**Nota**
È possibile aggiornare le autorizzazioni dei pacchetti condivisi con 20 o meno account.
**Per modificare le autorizzazioni del pacchetto nella console**
1. Apri la AWS Systems Manager console all'indirizzo [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Nel pannello di navigazione, scegli **Distributor**.
1. Nella pagina **Packages (Pacchetti)** scegli il pacchetto di cui desideri modificare le autorizzazioni.
1. Nella scheda **Package details (Dettagli pacchetto)** scegli **Edit permissions (Modifica autorizzazioni)** per modificare le autorizzazioni.
1. Per **Edit permissions (Modifica autorizzazioni)**, scegliere **Shared with specific accounts (Condiviso con account specifici)**.
1. In **Shared with specific accounts (Condiviso con account specifici)** aggiungi i numeri degli account Account AWS , uno alla volta. Al termine, seleziona **Salva**.
# Modifica dei tag del pacchetto Distributor nella console
Dopo aver aggiunto un pacchetto aDistributor, uno strumento in AWS Systems Manager, è possibile modificare i tag del pacchetto nella console Systems Manager. Questi tag vengono applicati al pacchetto e non sono connessi ai tag sui nodi gestiti in cui desideri implementare il pacchetto. I tag sono coppie chiave-valore che prevedono una distinzione tra lettere maiuscole e minuscole e che consentono di raggruppare e filtrare i pacchetti in base a criteri rilevanti per la tua organizzazione. Se non desideri aggiungere tag, puoi procedere con l'installazione del pacchetto o con l'aggiunta di una nuova versione.
**Per modificare i tag del pacchetto nella console**
1. Apri la AWS Systems Manager console all'indirizzo [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Nel pannello di navigazione, scegli **Distributor**.
1. Nella pagina **Packages (Pacchetti)** scegli il pacchetto di cui desideri modificare i tag.
1. Nella scheda **Package details (Dettagli pacchetto** in **Tags**, scegli **Edit (Modifica)**.
1. Per **Add tags (Aggiungi tag)**, inserire una chiave tag oppure una coppia chiave-valore del tag, quindi scegliere **Add (Aggiungi)**. Ripeti se desideri aggiungere ulteriori tag. Per eliminare i tag, scegli **X** sul tag nella parte inferiore della finestra.
1. Dopo aver aggiunto i tag al pacchetto, scegli **Save (Salva)**.
# Aggiunta di una versione a un pacchetto Distributor
Per aggiungere una versione del pacchetto, [crea un pacchetto](distributor-working-with-packages-create.md), quindi utilizza Distributor per aggiungere una versione del pacchetto aggiungendo una voce al documento AWS Systems Manager (SSM) già esistente per le versioni precedenti. Distributorè uno strumento in AWS Systems Manager. Per risparmiare tempo, aggiorna il manifesto di una versione precedente del pacchetto, modifica il valore della voce `version` nel manifesto (ad esempio da `Test_1.0` a `Test_2.0`) e salvalo come manifesto per la nuova versione. Il flusso di lavoro **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 URL con un nome file diverso indicato 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.
**Topics**
+ [Aggiunta di una versione del pacchetto utilizzando la console](#add-pkg-version)
+ [Aggiungere una versione del pacchetto utilizzando il AWS CLI](#add-pkg-version-cli)
## Aggiunta di una versione del pacchetto utilizzando la console
Prima di procedere, segui le istruzioni in [Creazione di un pacchetto in Distributor](distributor-working-with-packages-create.md) 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 utilizzando il flusso di lavoro Simple (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 **Aggiungi versione** semplificato nella console Distributor aggiorna automaticamente il file manifest e il documento SSM associato.
**Per aggiungere una versione del pacchetto utilizzando il flusso di lavoro Simple (Semplice)**
1. Apri la AWS Systems Manager console all'indirizzo [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Nel pannello di navigazione, scegli **Distributor**.
1. Nella home page di Distributor, scegli il pacchetto a cui aggiungere un'altra versione.
1. Nella pagina **Add version (Aggiungi versione)**, scegli **Simple (Semplice)**.
1. 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.
1. Per **Nome del 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.
1. Per **Prefisso della chiave S3**, immetti la sottocartella del bucket in cui sono archiviate le risorse installabili.
1. 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.
1. 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 controllo delle versioni **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`, devi modificare alcune impostazioni predefinite nel flusso di lavoro **Semplice**, per istruire Distributor, affinché diriga lo stesso software sia sul sistema operativo di Amazon Linux che di Ubuntu Server. Per ovviare a questa limitazione puoi adottare una delle soluzioni riportate di seguito.
+ Utilizza il flusso di lavoro di controllo delle versioni **Avanzato**, comprimi ogni file installabile in un file .zip prima di iniziare e creare manualmente il manifesto, 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 utilizzando il flusso di lavoro Avanzato](#add-pkg-version-adv).
+ Modifica manualmente il file manifest nel flusso di lavoro **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: creazione del manifesto del pacchetto JSON](distributor-working-with-packages-create.md#packages-manifest).
1. Per **Versione della piattaforma**, verifica che la versione della piattaforma del sistema operativo mostrata sia **\$1any** o una versione principale seguita da un carattere jolly (8.\$1) o l'esatta versione di rilascio 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: creazione del manifesto del pacchetto JSON](distributor-working-with-packages-create.md#packages-manifest).
1. 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](distributor.md#what-is-a-package-platforms).
1. (Facoltativo) Espandere **Scripts (Script)** ed esaminare gli script di installazione e disinstallazione generati da Distributor per il software installabile.
1. Per aggiungere altri file del software installabili nella versione, scegli **Add software (Aggiungi software)**. Altrimenti, vai alla fase successiva.
1. (Facoltativo) Espandi **Manifesto** ed esamina il manifesto del pacchetto JSON generato da Distributor 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 **Genera manifesto** per visualizzare il manifesto del pacchetto aggiornato.
Puoi modificare il manifesto 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 manifesto, consulta [Fase 2: creazione del manifesto del pacchetto JSON](distributor-working-with-packages-create.md#packages-manifest).
1. Al termine dell'aggiunta del software e dell'esame della piattaforma di destinazione, della versione e dei dati dell'architettura, scegli **Aggiungi versione**.
1. 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 **Dettagli del pacchetto** per il 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 la creazione della nuova versione del pacchetto. Per interrompere il caricamento e la creazione della versione del pacchetto, scegli **Interrompi caricamento**.
1. Se Distributor non è in grado di caricare i file installabili del software, visualizza un messaggio **Caricamento non riuscito**. Per riprovare a eseguire il caricamento, scegli **Riprova caricamento**. Per ulteriori informazioni su come risolvere errori di creazione della versione del pacchetto, consulta [Risoluzione dei problemi AWS Systems ManagerDistributor](distributor-troubleshooting.md).
1. Quando Distributor ha terminato la creazione della nuova versione del pacchetto, nella pagina **Dettagli**, 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 **Imposta versione predefinita**.
Se non imposti una versione predefinita, verrà selezionata la versione più recente del pacchetto.
### Aggiunta di una versione del pacchetto utilizzando il flusso di lavoro Avanzato
Per aggiungere una versione del pacchetto, [crea un pacchetto](distributor-working-with-packages-create.md), quindi utilizza Distributor per aggiungere una versione del pacchetto aggiungendo una voce al documento SSM che esiste per versioni precedenti. Per risparmiare tempo, aggiorna il manifesto di una versione precedente del pacchetto, modifica il valore della voce `version` nel manifesto (ad esempio da `Test_1.0` a `Test_2.0`) e salvalo come manifesto per la nuova versione. È necessario disporre di un manifesto aggiornato per aggiungere una nuova versione del pacchetto utilizzando il flusso di lavoro **Avanzato**.
**Per aggiungere una versione del pacchetto utilizzando il flusso di lavoro Avanzato**
1. Apri la AWS Systems Manager console all'indirizzo [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Nel pannello di navigazione, scegli **Distributor**.
1. Nella home page di Distributor, scegli il pacchetto a cui aggiungere un'altra versione, quindi seleziona **Aggiungi versione**.
1. Per **Nome versione**, immetti il valore esatto nella voce `version` del proprio file manifest.
1. Per **Nome del 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.
1. Per **Prefisso della chiave S3**, immetti la sottocartella del bucket in cui sono archiviate le risorse installabili.
1. Per **Manifesto**, scegli **Estrai dal pacchetto** per utilizzare un manifesto caricato nel bucket S3 con i file .zip.
(Facoltativo) Se non è stato caricato il manifesto JSON rivisto nel bucket Amazon 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](distributor-working-with-packages-create.md#packages-manifest).
1. Al completamento del manifesto, scegli **Aggiungi versione del pacchetto**.
1. Nella pagina **Dettagli**, 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 **Imposta versione predefinita**.
Se non imposti una versione predefinita, verrà selezionata la versione più recente del pacchetto.
## Aggiungere una versione del pacchetto utilizzando il 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 utilizzando il AWS CLI**
1. Eseguite il comando seguente per modificare il AWS Systems Manager documento con una voce per una nuova versione del pacchetto. Sostituiscilo *document-name* con il nome del documento. Sostituiscilo *amzn-s3-demo-bucket* con l'URL del manifesto JSON che hai copiato. [Fase 3: caricamento del pacchetto e del manifesto in un bucket Amazon S3](distributor-working-with-packages-create.md#packages-upload-s3) *S3-bucket-URL-of-package*è l'URL del bucket Amazon S3 in cui è archiviato l'intero pacchetto. 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 di :
```
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
```
1. Esegui il comando seguente per verificare che il pacchetto sia stato aggiornato e visualizzare il manifesto del pacchetto. Sostituiscilo *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 [https://docs.aws.amazon.com/cli/latest/reference/ssm/update-document.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/update-document.html)la AWS Systems Manager sezione della Guida ai *AWS CLI comandi*.
# Installazione o aggiornamento dei pacchetti Distributor
È possibile distribuire pacchetti nei nodi AWS Systems Manager gestiti utilizzando Distributor uno strumento in AWS Systems Manager. Per distribuire i pacchetti, usa Console di gestione AWS o AWS Command Line Interface ()AWS CLI. Al momento, puoi distribuire una sola versione di un pacchetto per ogni comando. È possibile installare nuovi pacchetti o aggiornare le installazioni esistenti in locale. Puoi scegliere di implementare una versione specifica oppure sempre quella più recente di un pacchetto per la distribuzione. Ti consigliamo di utilizzareState Manager, uno strumento in AWS Systems Manager, per installare i pacchetti. L'utilizzo State Manager aiuta a garantire che i nodi gestiti eseguano sempre la maggior parte della up-to-date versione del pacchetto.
**Importante**
I pacchetti installati tramite Distributor devono essere disinstallati solo utilizzando Distributor. In caso contrario, Systems Manager può comunque registrare l'applicazione come `INSTALLED` e portare ad altri risultati indesiderati.
| Preferenza | AWS Systems Manager azione | Ulteriori informazioni |
| --- | --- | --- |
| Installare o aggiornare immediatamente un pacchetto. | Run Command | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html) |
| Installare o aggiornare un pacchetto in base a una pianificazione, in modo che l'installazione includa sempre la versione predefinita. | State Manager | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html) |
| Installare automaticamente un pacchetto sui nuovi nodi gestiti che hanno un tag o set di tag specifico. Ad esempio, l'installazione dell' CloudWatch agente Amazon su nuove istanze. | State Manager | Uno dei modi per farlo consiste nell'applicare i tag ai nuovi nodi gestiti, quindi specificare i tag come destinazioni nell'associazione di State Manager. State Manager installa automaticamente il pacchetto in un'associazione sui nodi gestiti che hanno tag corrispondenti. Per informazioni, consulta [Comprensioni su destinazioni e controlli di velocità nelle associazioni di State Manager](systems-manager-state-manager-targets-and-rate-controls.md). |
**Topics**
+ [Installazione o aggiornamento di un pacchetto una tantum utilizzando la console](#distributor-deploy-pkg-console)
+ [Pianificazione dell'installazione o dell'aggiornamento di un pacchetto utilizzando la console](#distributor-deploy-sm-pkg-console)
+ [Installazione di un pacchetto una sola volta utilizzando il AWS CLI](#distributor-deploy-pkg-cli)
+ [Aggiornamento di un pacchetto una sola volta utilizzando il AWS CLI](#distributor-update-pkg-cli)
+ [Pianificazione dell'installazione di un pacchetto utilizzando il AWS CLI](#distributor-smdeploy-pkg-cli)
+ [Pianificazione dell'aggiornamento di un pacchetto utilizzando il AWS CLI](#distributor-smupdate-pkg-cli)
## Installazione o aggiornamento di un pacchetto una tantum utilizzando la console
Puoi utilizzare la AWS Systems Manager console per installare o aggiornare un pacchetto una sola volta. Quando si configura un'installazione singola[AWS Systems Manager Run Command](run-command.md), Distributor utilizza uno strumento per eseguire l'installazione. AWS Systems Manager
**Per installare o aggiornare un pacchetto una tantum utilizzando la console**
1. Apri la AWS Systems Manager console all'indirizzo [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Nel pannello di navigazione, scegli **Distributor**.
1. Nella home page di Distributor, scegli il pacchetto da installare.
1. Scegli **Install one time (Installa una tantum)**.
Questo comando apre Run Command con il documento del comando `AWS-ConfigureAWSPackage` e il pacchetto Distributor già selezionati.
1. Per **Document version (Versione documento)**, selezionare la versione del documento `AWS-ConfigureAWSPackage` che si desidera eseguire.
1. Per **Action (Operazione)**, selezionare **Install (Installa)**.
1. Per **Installation type (Tipo di installazione)**, scegliere una delle seguenti opzioni:
+ **Uninstall and reinstall (Disinstalla e reinstalla)**: il pacchetto viene completamente disinstallato e quindi reinstallato. L'applicazione non è disponibile fino al completamento della reinstallazione.
+ **In-place update (Aggiornamento in locale)**: solo i file nuovi o modificati vengono aggiunti all'installazione esistente in base alle istruzioni fornite in uno script `update`. L'applicazione rimane disponibile durante tutto il processo di aggiornamento. Questa opzione non è supportata per i pacchetti AWS pubblicati ad eccezione del `AWSEC2Launch-Agent` pacchetto.
1. Per **Name (Nome)**, verificare che sia immesso il nome del pacchetto selezionato.
1. (Facoltativo) In **Version (Versione)**, immettere il nome della versione del pacchetto. Se lasci vuoto questo campo, Run Command installa la versione predefinita selezionata in Distributor.
1. In **Targets (Destinazioni)**, identificare i nodi gestiti in cui si desidera eseguire questa operazione specificando i tag, selezionando le istanze manualmente o indicando un gruppo di risorse.
**Nota**
Se nell'elenco non si visualizza un nodo gestito, vedi [Risoluzione dei problemi relativi alla disponibilità dei nodi gestiti](fleet-manager-troubleshooting-managed-nodes.md).
1. In **Altri parametri**:
+ In **Commento**, digita le informazioni su questo comando.
+ In **Timeout (secondi)**, specifica il numero di secondi che il sistema dovrà attendere prima di generare un errore per l'intera esecuzione del comando.
1. Per **Rate control (Controllo velocità)**:
+ In **Concurrency (Simultaneità)**, specificare un numero o una percentuale di destinazioni su cui eseguire contemporaneamente il comando.
**Nota**
Se sono state selezionate le destinazioni specificando i tag o i gruppi di risorse, e se non si conosce con certezza il numero di nodi gestiti di destinazione, limitare il numero di destinazioni che possono eseguire il documento contemporaneamente specificando una percentuale.
+ In **Error threshold (Soglia di errore)** specifica quando interrompere l'esecuzione del comando sulle altre destinazioni dopo un errore su un numero o una percentuale di nodi gestiti. Se ad esempio si specificano tre errori, Systems Manager interrompe l'invio del comando quando riceve il quarto errore. Anche i nodi gestiti che stanno ancora elaborando il comando potrebbero inviare errori.
1. (Facoltativo) Nella sezione **Opzioni di output**, per salvare l'output del comando in un file, seleziona la casella **Scrivi l'output del comando in un bucket S3**. Digita i nomi del bucket e del prefisso (cartella) nelle caselle.
**Nota**
Le autorizzazioni S3 che danno la possibilità di scrivere dati in un bucket S3 sono quelle del profilo dell'istanza (per istanze EC2) o del ruolo di servizio IAM (in macchine attivate da sistemi ibridi) assegnate all'istanza, non quelle dell'utente IAM che esegue questo processo. Per ulteriori informazioni, consulta le pagine [Configurazione delle autorizzazioni dell'istanza richieste per Systems Manager](setup-instance-permissions.md) oppure [Creazione di un ruolo di servizio IAM per un ambiente ibrido](hybrid-multicloud-service-role.md). Inoltre, se il bucket S3 specificato si trova su un Account AWS diverso, assicurarsi che il profilo dell'istanza o il ruolo di servizio IAM associato al nodo gestito disponga delle autorizzazioni necessarie per scrivere su quel bucket.
1. Se vuoi che vengano inviate notifiche sullo stato dell'esecuzione del comando, nella sezione **Notifiche SNS** selezionara la casella di controllo **Abilita notifiche SNS**.
Per ulteriori informazioni, sulla configurazione delle notifiche Amazon SNS per Run Command consulta [Monitoraggio delle modifiche di stato di Systems Manager utilizzando le notifiche Amazon SNS](monitoring-sns-notifications.md).
1. Quando si è pronti per installare il pacchetto, scegliere **Run (Esegui)**.
1. L'area **Command status (Stato del comando)** segnala lo stato di avanzamento dell'esecuzione. Se il comando è ancora in corso, scegliere l'icona di aggiornamento nell'angolo in alto a sinistra della console finché la colonna **Overall status (Stato generale)** o **Detailed status (Stato dettagliato)** non mostra **Success (Riuscito)** o **Failed (Non riuscito)**.
1. Nell'area **Targets and outputs (Destinazioni e uscite)**, scegli il pulsante accanto al nome del nodo gestito e seleziona **View output (Visualizza output)**.
La pagina di output del comando mostra i risultati di esecuzione del comando.
1. (Facoltativo) Se si sceglie di scrivere l'output dei comandi in un bucket Amazon S3, seleziona **Amazon S3** per visualizzare i dati del log di output.
## Pianificazione dell'installazione o dell'aggiornamento di un pacchetto utilizzando la console
È possibile utilizzare la AWS Systems Manager console per pianificare l'installazione o l'aggiornamento di un pacchetto. Quando pianifichi l'installazione o l'aggiornamento del un pacchetto, Distributor utilizza [AWS Systems Manager State Manager](systems-manager-state.md) per eseguire l'installazione o l'aggiornamento.
**Per pianificare un'installazione del pacchetto utilizzando la console**
1. Apri la AWS Systems Manager console all'indirizzo [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Nel pannello di navigazione, scegli **Distributor**.
1. Nella home page di Distributor, scegliere il pacchetto da installare o aggiornare.
1. Per **Install package (Installa pacchetto)**, scegliere **Install on a schedule (Installa in base a una pianificazione)**.
Questo comando apre State Manager in una nuova associazione creata per te.
1. Per **Name (Nome)** immettere un nome (ad esempio **Deploy-test-agent-package**). Questo passaggio è facoltativo, ma è consigliato. Gli spazi non sono consentiti nel nome.
1. Nell'elenco **Document (Documento)**, il nome del documento `AWS-ConfigureAWSPackage` è già selezionato.
1. Per **Action (Operazione)**, verificare che sia selezionata l'opzione **Install (Installa)**.
1. Per **Installation type (Tipo di installazione)**, scegliere una delle seguenti opzioni:
+ **Uninstall and reinstall (Disinstalla e reinstalla)**: il pacchetto viene completamente disinstallato e quindi reinstallato. L'applicazione non è disponibile fino al completamento della reinstallazione.
+ **In-place update (Aggiornamento in locale)**: solo i file nuovi o modificati vengono aggiunti all'installazione esistente in base alle istruzioni fornite in uno script `update`. L'applicazione rimane disponibile durante tutto il processo di aggiornamento.
1. Per **Name (Nome)**, verificare che sia inserito il nome del pacchetto.
1. Per **Version (Versione)**, se si desidera installare una versione del pacchetto diversa dall'ultima versione pubblicata, immettere l'identificatore della versione.
1. In **Targets (Destinazioni)** scegliere **Selecting all managed instances in this account (Selezione di tutte le istanze gestite in questo account)**, **Specifying tags (Specifica tag)** o **Manually Selecting Instance (Selezione manuale dell'istanza)**. Se fai riferimento alle risorse con i tag, immetti una chiave e un valore del tag nei campi visualizzati.
**Nota**
Puoi scegliere i dispositivi AWS IoT Greengrass principali gestiti **scegliendo Selezione di tutte le istanze gestite in questo account** o **Selezione manuale dell'istanza**.
1. In **Specify schedule (Specifica pianificazione)** scegliere **On Schedule (In base a pianificazione)** per eseguire l'associazione in base a una pianificazione regolare o **No Schedule (Nessuna pianificazione)** per eseguire l'associazione una sola volta. Per ulteriori informazioni su queste opzioni, consulta [Utilizzo delle associazioni in Systems Manager](state-manager-associations.md). Utilizza i controlli per creare una pianificazione `cron` o rate per l'associazione.
1. Scegli **Crea associazione**.
1. Nella pagina **Association (Associazione)**, scegliere il pulsante accanto all'associazione creata e selezionare **Apply association now (Applica associazione ora)**.
State Manager crea ed esegue immediatamente l'associazione sulle destinazioni specificate. Per ulteriori informazioni sui risultati dell'esecuzione delle associazioni, consulta [Utilizzo delle associazioni in Systems Manager](state-manager-associations.md) in questa guida.
Per ulteriori informazioni sull'utilizzo delle opzioni in **Advanced options (Opzioni avanzate)**, **Rate control (Controllo della velocità)** e **Output options (Opzioni di output)**, consulta [Utilizzo delle associazioni in Systems Manager](state-manager-associations.md).
## Installazione di un pacchetto una sola volta utilizzando il AWS CLI
È possibile eseguire **send-command** l'installazione AWS CLI di un Distributor pacchetto una sola volta. Se il pacchetto è già installato, l'applicazione verrà disconnessa mentre il pacchetto viene disinstallato e sostituito con la nuova versione.
**Per installare un pacchetto una sola volta usando il AWS CLI**
+ Esegui il comando seguente nell' AWS CLI.
```
aws ssm send-command \
--document-name "AWS-ConfigureAWSPackage" \
--instance-ids "instance-IDs" \
--parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}'
```
**Nota**
Il comportamento predefinito per `installationType` è `Uninstall and reinstall`. È possibile omettere `"installationType":["Uninstall and reinstall"]` da questo comando quando si installa un pacchetto completo.
Di seguito è riportato un esempio di :
```
aws ssm send-command \
--document-name "AWS-ConfigureAWSPackage" \
--instance-ids "i-00000000000000" \
--parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["ExamplePackage"]}'
```
Per informazioni sulle altre opzioni che è possibile utilizzare con il **send-command** comando, vedere [https://docs.aws.amazon.com/cli/latest/reference/ssm/send-command.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/send-command.html)la AWS Systems Manager sezione del *AWS CLI Command Reference*.
## Aggiornamento di un pacchetto una sola volta utilizzando il AWS CLI
È possibile eseguire **send-command** il AWS CLI per aggiornare un Distributor pacchetto senza mettere offline l'applicazione associata. Vengono sostituiti solo i file nuovi o aggiornati nel pacchetto.
**Per aggiornare un pacchetto una sola volta utilizzando il AWS CLI**
+ Esegui il comando seguente nell' AWS CLI.
```
aws ssm send-command \
--document-name "AWS-ConfigureAWSPackage" \
--instance-ids "instance-IDs" \
--parameters '{"action":["Install"],"installationType":["In-place update"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}'
```
**Nota**
Quando si aggiungono file nuovi o modificati, è necessario includere `"installationType":["In-place update"]` nel comando.
Di seguito è riportato un esempio di :
```
aws ssm send-command \
--document-name "AWS-ConfigureAWSPackage" \
--instance-ids "i-02573cafcfEXAMPLE" \
--parameters '{"action":["Install"],"installationType":["In-place update"],"name":["ExamplePackage"]}'
```
Per informazioni sulle altre opzioni che è possibile utilizzare con il **send-command** comando, vedere [https://docs.aws.amazon.com/cli/latest/reference/ssm/send-command.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/send-command.html)la AWS Systems Manager sezione del *AWS CLI Command Reference*.
## Pianificazione dell'installazione di un pacchetto utilizzando il AWS CLI
È possibile eseguire l'installazione AWS CLI di un Distributor pacchetto **create-association** in base a una pianificazione. Il valore `--name`, ossia il nome del documento, è sempre `AWS-ConfigureAWSPackage`. Il comando seguente utilizza la chiave `InstanceIds` per specificare i nodi gestiti di destinazione. Se il pacchetto è già installato, l'applicazione verrà disconnessa mentre il pacchetto viene disinstallato e sostituito con la nuova versione.
```
aws ssm create-association \
--name "AWS-ConfigureAWSPackage" \
--parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}' \
--targets [{\"Key\":\"InstanceIds\",\"Values\":[\"instance-ID1\",\"instance-ID2\"]}]
```
**Nota**
Il comportamento predefinito per `installationType` è `Uninstall and reinstall`. È possibile omettere `"installationType":["Uninstall and reinstall"]` da questo comando quando si installa un pacchetto completo.
Di seguito è riportato un esempio di :
```
aws ssm create-association \
--name "AWS-ConfigureAWSPackage" \
--parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["Test-ConfigureAWSPackage"]}' \
--targets [{\"Key\":\"InstanceIds\",\"Values\":[\"i-02573cafcfEXAMPLE\",\"i-0471e04240EXAMPLE\"]}]
```
Per informazioni sulle altre opzioni utilizzabili con il **create-association** comando, consulta [https://docs.aws.amazon.com/cli/latest/reference/ssm/create-association.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/create-association.html)la AWS Systems Manager sezione del *AWS CLI Command Reference*.
## Pianificazione dell'aggiornamento di un pacchetto utilizzando il AWS CLI
È possibile eseguire l'aggiornamento AWS CLI di un Distributor pacchetto **create-association** in base a una pianificazione senza mettere offline l'applicazione associata. Vengono sostituiti solo i file nuovi o aggiornati nel pacchetto. Il valore `--name`, ossia il nome del documento, è sempre `AWS-ConfigureAWSPackage`. Il comando seguente utilizza la chiave `InstanceIds` per specificare le istanze di destinazione.
```
aws ssm create-association \
--name "AWS-ConfigureAWSPackage" \
--parameters '{"action":["Install"],"installationType":["In-place update"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}' \
--targets [{\"Key\":\"InstanceIds\",\"Values\":[\"instance-ID1\",\"instance-ID2\"]}]
```
**Nota**
Quando si aggiungono file nuovi o modificati, è necessario includere `"installationType":["In-place update"]` nel comando.
Di seguito è riportato un esempio di :
```
aws ssm create-association \
--name "AWS-ConfigureAWSPackage" \
--parameters '{"action":["Install"],"installationType":["In-place update"],"name":["Test-ConfigureAWSPackage"]}' \
--targets [{\"Key\":\"InstanceIds\",\"Values\":[\"i-02573cafcfEXAMPLE\",\"i-0471e04240EXAMPLE\"]}]
```
Per informazioni sulle altre opzioni utilizzabili con il **create-association** comando, [https://docs.aws.amazon.com/cli/latest/reference/ssm/create-association.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/create-association.html)consulta la AWS Systems Manager sezione della Guida ai *AWS CLI comandi*.
# Disinstallazione di un pacchetto Distributor
Puoi usare Console di gestione AWS o il AWS Command Line Interface (AWS CLI) per disinstallare Distributor i pacchetti dai tuoi nodi AWS Systems Manager gestiti utilizzandoRun Command. Distributore Run Command sono strumenti in AWS Systems Manager. In questa versione, puoi disinstallare una sola versione di un pacchetto per ogni comando. Puoi disinstallare una versione specifica oppure la versione predefinita.
**Importante**
I pacchetti installati tramite Distributor devono essere disinstallati solo utilizzando Distributor. In caso contrario, Systems Manager può comunque registrare l'applicazione come `INSTALLED` e portare ad altri risultati indesiderati.
**Topics**
+ [Disinstallazione di un pacchetto utilizzando la console](#distributor-pkg-uninstall-console)
+ [Disinstallazione di un pacchetto utilizzando AWS CLI](#distributor-pkg-uninstall-cli)
## Disinstallazione di un pacchetto utilizzando la console
Puoi utilizzare Run Command nella console Systems Manager per disinstallare un pacchetto una sola volta. Distributor utilizza [AWS Systems Manager Run Command](run-command.md) per disinstallare i pacchetti.
**Per disinstallare un pacchetto utilizzando la console**
1. Apri la AWS Systems Manager console all'indirizzo [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Nel pannello di navigazione, scegli **Run Command**.
1. Nella home page di Run Command, scegli **Run command (Esegui comando)**.
1. Scegli il documento del comando `AWS-ConfigureAWSPackage`.
1. In **Action (Operazione)** scegli **Uninstall (Disinstalla)**
1. In **Name (Nome)** digita il nome del pacchetto da disinstallare.
1. Per **Targets (Obiettivi)**, scegli il metodo di destinazione dei file utilizzato dai tuoi nodi gestiti. È possibile specificare una chiave di tag e valori condivisi dalle destinazioni. È inoltre possibile specificare le destinazioni scegliendo attributi, ad esempio un'ID, una piattaforma e una versione SSM Agent.
1. Puoi utilizzare le opzioni avanzate per aggiungere commenti sull'operazione, modificare i valori **Concurrency (Concorrenza)** ed **Error threshold (Soglia errore)** in **Rate control (Controllo frequenza)**, specificare le opzioni di output oppure configurare le notifiche di Amazon Simple Notification Service (Amazon SNS). Per ulteriori informazioni, consulta [Esecuzione di comandi dalla console](https://docs.aws.amazon.com/systems-manager/latest/userguide/rc-console.html) in questa guida.
1. Quando sei pronto a disinstallare il pacchetto, scegli **Run (Esegui)**, quindi **View results (Visualizza risultati)**.
1. Nell'elenco di comandi scegli il comando `AWS-ConfigureAWSPackage` che hai eseguito. Se il comando è ancora in corso, scegli l'icona di aggiornamento nell'angolo in alto a destra della console.
1. Quando la colonna **Status** (Stato) mostra **Success** (Riuscito) o **Failed** (Non riuscito), scegli la scheda **Output**.
1. Scegli **View output (Visualizza output)**. La pagina di output del comando mostra i risultati di esecuzione del comando.
## Disinstallazione di un pacchetto utilizzando AWS CLI
È possibile utilizzare AWS CLI per disinstallare un Distributor pacchetto dai nodi gestiti utilizzandoRun Command.
**Per disinstallare un pacchetto utilizzando il AWS CLI**
+ Esegui il comando seguente nell' AWS CLI.
```
aws ssm send-command \
--document-name "AWS-ConfigureAWSPackage" \
--instance-ids "instance-IDs" \
--parameters '{"action":["Uninstall"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}'
```
Di seguito è riportato un esempio di :
```
aws ssm send-command \
--document-name "AWS-ConfigureAWSPackage" \
--instance-ids "i-02573cafcfEXAMPLE" \
--parameters '{"action":["Uninstall"],"name":["Test-ConfigureAWSPackage"]}'
```
Per informazioni sulle altre opzioni che è possibile utilizzare con il **send-command** comando, vedere [https://docs.aws.amazon.com/cli/latest/reference/ssm/send-command.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/send-command.html)la AWS Systems Manager sezione della Guida di *riferimento ai AWS CLI comandi*.
# Eliminazione di un pacchetto Distributor
In questa sezione viene descritto come eliminare un pacchetto. Non è possibile eliminare una versione di un pacchetto, ma solo l'intero pacchetto.
## Eliminazione di un pacchetto utilizzando la console
È possibile utilizzare la AWS Systems Manager console per eliminare un pacchetto o una versione del pacchetto daDistributor, uno strumento in AWS Systems Manager. L'eliminazione di un pacchetto cancella tutte le relative versioni da Distributor.
**Per eliminare una pacchetto utilizzando la console**
1. Apri la AWS Systems Manager console all'indirizzo [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Nel pannello di navigazione, scegli **Distributor**.
1. Nella home page di **Distributor**, scegliere il pacchetto da eliminare.
1. Nella pagina dei dettagli del pacchetto, scegli **Delete package (Elimina pacchetto)**.
1. Quando viene richiesto di confermare l'eliminazione, scegli **Delete package (Elimina pacchetto)**.
## Eliminazione di una versione del pacchetto utilizzando la console
Puoi utilizzare la console Systems Manager per eliminare una versione del pacchetto da Distributor.
**Per eliminare una versione del pacchetto utilizzando la console**
1. Apri la AWS Systems Manager console all'indirizzo [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Nel pannello di navigazione, scegli **Distributor**.
1. Nella home page di **Distributor**, scegliere il pacchetto di cui eliminare la versione.
1. Nella pagina delle versioni del pacchetto, scegliere la versione da eliminare e scegliere **Delete version (Elimina versione)**.
1. Quando viene richiesto di confermare l'eliminazione, scegliere **Delete package version (Elimina versione del pacchetto)**.
## Eliminazione di un pacchetto utilizzando la riga di comando
Puoi utilizzare lo strumento a riga di comando preferito per eliminare un pacchetto da Distributor.
------
#### [ Linux & macOS ]
**Per eliminare un pacchetto utilizzando il AWS CLI**
1. Esegui il comando seguente per elencare i documenti per i pacchetti specifici. Nei risultati di questo comando, cerca il pacchetto da eliminare.
```
aws ssm list-documents \
--filters Key=Name,Values=package-name
```
1. Eseguire il comando seguente per eliminare un pacchetto. Sostituire *package-name* con il nome del pacchetto.
```
aws ssm delete-document \
--name "package-name"
```
1. Eseguire di nuovo il comando **list-documents** per verificare che il pacchetto sia stato eliminato. Il pacchetto che hai eliminato non viene incluso nell'elenco.
```
aws ssm list-documents \
--filters Key=Name,Values=package-name
```
------
#### [ Windows ]
**Per eliminare un pacchetto utilizzando il AWS CLI**
1. Esegui il comando seguente per elencare i documenti per i pacchetti specifici. Nei risultati di questo comando, cerca il pacchetto da eliminare.
```
aws ssm list-documents ^
--filters Key=Name,Values=package-name
```
1. Eseguire il comando seguente per eliminare un pacchetto. Sostituire *package-name* con il nome del pacchetto.
```
aws ssm delete-document ^
--name "package-name"
```
1. Eseguire di nuovo il comando **list-documents** per verificare che il pacchetto sia stato eliminato. Il pacchetto che hai eliminato non viene incluso nell'elenco.
```
aws ssm list-documents ^
--filters Key=Name,Values=package-name
```
------
#### [ PowerShell ]
**Per eliminare un pacchetto utilizzando Tools for PowerShell**
1. Esegui il comando seguente per elencare i documenti per i pacchetti specifici. Nei risultati di questo comando, cerca il pacchetto da eliminare.
```
$filter = New-Object Amazon.SimpleSystemsManagement.Model.DocumentKeyValuesFilter
$filter.Key = "Name"
$filter.Values = "package-name"
Get-SSMDocumentList `
-Filters @($filter)
```
1. Eseguire il comando seguente per eliminare un pacchetto. Sostituire *package-name* con il nome del pacchetto.
```
Remove-SSMDocument `
-Name "package-name"
```
1. Eseguire di nuovo il comando **Get-SSMDocumentList** per verificare che il pacchetto sia stato eliminato. Il pacchetto che hai eliminato non viene incluso nell'elenco.
```
$filter = New-Object Amazon.SimpleSystemsManagement.Model.DocumentKeyValuesFilter
$filter.Key = "Name"
$filter.Values = "package-name"
Get-SSMDocumentList `
-Filters @($filter)
```
------
## Eliminazione di una versione del pacchetto utilizzando la riga di comando
Puoi utilizzare lo strumento a riga di comando preferito per eliminare una versione del pacchetto da Distributor.
------
#### [ Linux & macOS ]
**Per eliminare una versione del pacchetto utilizzando il AWS CLI**
1. Eseguire il comando seguente per elencare le versioni del pacchetto. Nei risultati di questo comando, cercare la versione del pacchetto da eliminare.
```
aws ssm list-document-versions \
--name "package-name"
```
1. Per eliminare la versione del pacchetto, esegui il comando seguente. Sostituire *package-name* con il nome del pacchetto e *version* con il numero di versione.
```
aws ssm delete-document \
--name "package-name" \
--document-version version
```
1. Eseguire il comando **list-document-versions** per verificare che la versione del pacchetto sia stata eliminata. La versione del pacchetto eliminata non è più presente nell'elenco.
```
aws ssm list-document-versions \
--name "package-name"
```
------
#### [ Windows ]
**Per eliminare una versione del pacchetto utilizzando il AWS CLI**
1. Eseguire il comando seguente per elencare le versioni del pacchetto. Nei risultati di questo comando, cercare la versione del pacchetto da eliminare.
```
aws ssm list-document-versions ^
--name "package-name"
```
1. Per eliminare la versione del pacchetto, esegui il comando seguente. Sostituire *package-name* con il nome del pacchetto e *version* con il numero di versione.
```
aws ssm delete-document ^
--name "package-name" ^
--document-version version
```
1. Eseguire il comando **list-document-versions** per verificare che la versione del pacchetto sia stata eliminata. La versione del pacchetto eliminata non è più presente nell'elenco.
```
aws ssm list-document-versions ^
--name "package-name"
```
------
#### [ PowerShell ]
**Per eliminare una versione del pacchetto utilizzando Tools for PowerShell**
1. Eseguire il comando seguente per elencare le versioni del pacchetto. Nei risultati di questo comando, cercare la versione del pacchetto da eliminare.
```
Get-SSMDocumentVersionList `
-Name "package-name"
```
1. Per eliminare la versione del pacchetto, esegui il comando seguente. Sostituire *package-name* con il nome del pacchetto e *version* con il numero di versione.
```
Remove-SSMDocument `
-Name "package-name" `
-DocumentVersion version
```
1. Eseguire il comando **Get-SSMDocumentVersionList** per verificare che la versione del pacchetto sia stata eliminata. La versione del pacchetto eliminata non è più presente nell'elenco.
```
Get-SSMDocumentVersionList `
-Name "package-name"
```
------
Per informazioni sulle altre opzioni utilizzabili con il **list-documents** comando, [https://docs.aws.amazon.com/cli/latest/reference/ssm/list-documents.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/list-documents.html)consultate la AWS Systems Manager sezione del *AWS CLI Command Reference*. Per informazioni sulle altre opzioni che puoi utilizzare con il comando **delete-document** , consulta [https://docs.aws.amazon.com/cli/latest/reference/ssm/delete-document.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/delete-document.html).
# Verifica e registrazione dell'attività Distributor
È possibile utilizzare AWS CloudTrail per controllare le attività relative aDistributor, uno strumento in AWS Systems Manager. Per ulteriori informazioni sulle opzioni di verifica e registrazione per Systems Manager, consulta [Registrazione e monitoraggio AWS Systems Manager](monitoring.md).
## DistributorAttività di audit utilizzando CloudTrail
CloudTrail acquisisce le chiamate API effettuate nella AWS Systems Manager console, AWS Command Line Interface (AWS CLI) e nell'SDK Systems Manager. Le informazioni possono essere visualizzate nella CloudTrail console o archiviate in un bucket Amazon Simple Storage Service (Amazon S3). Un bucket viene utilizzato per tutti i CloudTrail log del tuo account.
I log di Run Command e le azioni di State Manager mostrano l’attività di creazione di documenti, installazione e disinstallazione di pacchetti. Run Command e State Manager sono strumenti di AWS Systems Manager. Per ulteriori informazioni sulla visualizzazione e l'utilizzo dei CloudTrail registri delle attività di Systems Manager, vedere[Registrazione delle chiamate AWS Systems Manager API con AWS CloudTrail](monitoring-cloudtrail-logs.md).
# Risoluzione dei problemi AWS Systems ManagerDistributor
Le informazioni seguenti consentono di risolvere i problemi che potrebbero verificarsi durante l'utilizzo di Distributor, uno strumento di AWS Systems Manager.
**Topics**
+ [È installato un pacchetto errato con lo stesso nome](#distributor-tshoot-1)
+ [Errore: non è stato possibile recuperare il manifesto. Non è stato possibile trovare la versione più recente del pacchetto](#distributor-tshoot-2)
+ [Errore: non è stato possibile recuperare il manifesto. Eccezione per convalida](#distributor-tshoot-3)
+ [Il pacchetto non è supportato (manca l'azione di installazione)](#distributor-tshoot-4)
+ [Errore: impossibile scaricare il manifesto, Il documento con nome non esiste](#distributor-tshoot-5)
+ [Caricamento non riuscito.](#distributor-tshoot-6)
+ [Errore: impossibile trovare la piattaforma. Nessun manifesto trovato per la piattaforma: Oracle, versione 8.9, architettura x86\$164](#distributor-tshoot-7)
## È installato un pacchetto errato con lo stesso nome
**Problema:** hai installato un pacchetto, ma Distributor ha installato un pacchetto diverso.
**Causa:** durante l'installazione, Systems Manager rileva tra i risultati i pacchetti pubblicati da AWS prima dei pacchetti esterni definiti dall'utente. Se il nome del pacchetto definito dall'utente è lo stesso di un nome di pacchetto AWS pubblicato, il AWS pacchetto viene installato al posto del pacchetto.
**Soluzione:** per evitare questo problema, assegnate al pacchetto un nome diverso dal nome di un pacchetto AWS pubblicato.
## Errore: non è stato possibile recuperare il manifesto. Non è stato possibile trovare la versione più recente del pacchetto
**Problema:** hai ricevuto un errore simile al seguente.
```
Failed to retrieve manifest: ResourceNotFoundException: Could not find the latest version of package
arn:aws:ssm:::package/package-name status code: 400, request id: guid
```
**Causa:** stai utilizzando una versione di SSM Agent con Distributor precedente alla versione 2.3.274.0.
**Soluzione:** aggiorna la versione di SSM Agent alla versione 2.3.274.0 o successiva. Per ulteriori informazioni, consulta [Aggiornamento di SSM Agent utilizzando Run Command](run-command-tutorial-update-software.md#rc-console-agentexample) o [Procedura dettagliata: aggiorna SSM Agent automaticamente con AWS CLI](state-manager-update-ssm-agent-cli.md).
## Errore: non è stato possibile recuperare il manifesto. Eccezione per convalida
**Problema:** hai ricevuto un errore simile al seguente.
```
Failed to retrieve manifest: ValidationException: 1 validation error detected: Value 'documentArn'
at 'packageName' failed to satisfy constraint: Member must satisfy regular expression pattern:
arn:aws:ssm:region-id:account-id:package/package-name
```
**Causa:** stai utilizzando una versione di SSM Agent con Distributor precedente alla versione 2.3.274.0.
**Soluzione:** aggiorna la versione di SSM Agent alla versione 2.3.274.0 o successiva. Per ulteriori informazioni, consulta [Aggiornamento di SSM Agent utilizzando Run Command](run-command-tutorial-update-software.md#rc-console-agentexample) o [Procedura dettagliata: aggiorna SSM Agent automaticamente con AWS CLI](state-manager-update-ssm-agent-cli.md).
## Il pacchetto non è supportato (manca l'azione di installazione)
**Problema:** hai ricevuto un errore simile al seguente.
```
Package is not supported (package is missing install action)
```
**Causa:** la struttura della directory del pacchetto non è corretta.
**Soluzione:**non comprimere una directory padre contenente il software e gli script richiesti. Invece, crea un file `.zip` di tutti i contenuti richiesti direttamente nel percorso assoluto. Per verificare che il file `.zip` è stato creato correttamente, decomprimere la directory della piattaforma di destinazione ed esaminare la struttura della directory. Ad esempio, il percorso assoluto dello script di installazione dovrebbe essere `/ExamplePackage_targetPlatform/install.sh`.
## Errore: impossibile scaricare il manifesto, Il documento con nome non esiste
**Problema:** hai ricevuto un errore simile al seguente.
```
Failed to download manifest - failed to retrieve package document description: InvalidDocument: Document with name filename does not exist.
```
**Causa 1:** Distributor non riesce a trovare il pacchetto in base al nome del pacchetto quando si condivide un pacchetto Distributor da un altro account.
**Soluzione 1:** quando viene condiviso un pacchetto da un altro account, utilizzare il nome della risorsa Amazon (ARN) completo per il pacchetto e non solo il nome.
**Causa 2:** quando utilizzi un VPC, non hai fornito al tuo profilo di istanza IAM l'accesso al bucket S3 AWS gestito che contiene il documento `AWS-ConfigureAWSPackage` per il Regione AWS quale ti stai rivolgendo.
**Soluzione 2:** assicurati che il profilo dell'istanza IAM SSM Agent fornisca l'accesso al bucket S3 AWS gestito che contiene il documento relativo al target a cui Regione AWS ti `AWS-ConfigureAWSPackage` rivolgi, come spiegato in. [SSM Agentcomunicazioni con AWS bucket S3 gestiti](ssm-agent-technical-details.md#ssm-agent-minimum-s3-permissions)
## Caricamento non riuscito.
**Problema:** hai ricevuto un errore simile al seguente.
```
Upload failed. At least one of your files was not successfully uploaded to your S3 bucket.
```
**Causa:** il nome del pacchetto software include uno spazio. Ad esempio, `Hello World.msi` non verrebbe caricato.
## Errore: impossibile trovare la piattaforma. Nessun manifesto trovato per la piattaforma: Oracle, versione 8.9, architettura x86\$164
**Problema:** hai ricevuto un errore simile al seguente.
```
Failed to find platform: no manifest found for platform: oracle, version 8.9, architecture x86_64
```
**Causa:** l'errore indica che il manifesto del pacchetto JSON non ha alcuna definizione per quella piattaforma, in questo caso, Oracle Linux.
**Soluzione:** scarica il pacchetto che si desidera distribuire dal sito [Trend Micro Deep Security Software](https://help.deepsecurity.trendmicro.com/software.html). Crea un pacchetto software `.rpm` utilizzando il [Crea un pacchetto utilizzando il flusso di lavoro Semplice](distributor-working-with-packages-create.md#distributor-working-with-packages-create-simple). Imposta i seguenti valori per il pacchetto e completa il pacchetto software di caricamento utilizzando Distributor:
```
Platform version: _any
Target platform: oracle
Architecture: x86_64
```