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à. # Collaborazione con l' CodeDeploy agente L' AWS CodeDeploy agente è un pacchetto software che, una volta installato e configurato su un'istanza, ne consente l'utilizzo nelle CodeDeploy distribuzioni. AWS supporta l'ultima versione secondaria dell' CodeDeploy agente. Attualmente l'ultima versione secondaria è la 1.8.x. **Nota** L' CodeDeploy agente è necessario solo se si esegue la distribuzione su una piattaforma di elaborazione EC2/on-premise. L'agente non è necessario per le distribuzioni che utilizzano la piattaforma di calcolo Amazon ECS o Lambda AWS . Un file di configurazione viene posizionato sull'istanza quando viene installato l'agente. Questo file viene utilizzato per specificare il modo in cui viene utilizzato l'agente. Questo file di configurazione specifica i percorsi delle directory e altre impostazioni da utilizzare durante l'interazione AWS CodeDeploy con l'istanza. Puoi modificare alcune delle opzioni di configurazione nel file. Per informazioni sull'utilizzo del file di configurazione dell' CodeDeploy agente, vedere. [CodeDeploy riferimento alla configurazione dell'agente](reference-agent-configuration.md) Per ulteriori informazioni sull'utilizzo dell' CodeDeploy agente, ad esempio sui passaggi per l'installazione, l'aggiornamento e la verifica delle versioni, vedere[Gestione delle operazioni degli CodeDeploy agenti](codedeploy-agent-operations.md). **Topics** + [ ## Sistemi operativi supportati dall'agente CodeDeploy ](#codedeploy-agent-supported-operating-systems) + [ ## Protocollo di comunicazione e porta per l'agente CodeDeploy ](#codedeploy-agent-outbound-port) + [ ## Cronologia delle versioni dell'agente CodeDeploy ](#codedeploy-agent-version-history) + [ ## Gestione del processo CodeDeploy ](#codedeploy-agent-processes) + [ ## Revisione dell'applicazione e pulizia dei file di registro ](#codedeploy-agent-revisions-logs-cleanup) + [ ## File installati dall'agente CodeDeploy ](#codedeploy-agent-install-files) + [ # Gestione delle operazioni degli CodeDeploy agenti ](codedeploy-agent-operations.md) ## Sistemi operativi supportati dall'agente CodeDeploy ### Sistemi operativi AMI Amazon EC2 supportati L' CodeDeploy agente è stato testato sui seguenti sistemi operativi AMI Amazon EC2: + Amazon Linux 2023 (ARM, x86) + Amazon Linux 2 (ARM, x86) + Microsoft Windows Server 2022, 2019 + Red Hat Enterprise Linux (RHEL) 9.x, 8.x, 7.x + Ubuntu Server 22.04 LTS, 20.04 LTS, 18.04 LTS, 16.04 LTS L' CodeDeploy agente è disponibile come open source per consentirti di adattarlo alle tue esigenze. Può essere utilizzato con altri sistemi operativi AMI Amazon EC2. Per ulteriori informazioni, vai al repository degli [CodeDeploy agenti](https://github.com/aws/aws-codedeploy-agent) in. GitHub ### Sistemi operativi locali supportati L' CodeDeploy agente è stato testato sui seguenti sistemi operativi locali: + Microsoft Windows Server 2022, 2019 + Red Hat Enterprise Linux (RHEL) 9.x, 8.x, 7.x + Ubuntu Server 22.04 LTS, 20.04 LTS L' CodeDeploy agente è disponibile come open source per consentirti di adattarlo alle tue esigenze. Può essere utilizzato con altri sistemi operativi su istanze locali. Per ulteriori informazioni, vai al repository degli [CodeDeploy agenti](https://github.com/aws/aws-codedeploy-agent) in GitHub. ## Protocollo di comunicazione e porta per l'agente CodeDeploy L' CodeDeploy agente comunica in uscita utilizzando HTTPS sulla porta 443. Quando l' CodeDeploy agente viene eseguito su un'istanza EC2, utilizzerà l'endpoint di [metadati EC2 per recuperare](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html) le informazioni relative all'istanza. Ulteriori informazioni su come [limitare e concedere l'accesso al servizio di metadati delle istanze](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html#instance-metadata-limiting-access). ## Cronologia delle versioni dell'agente CodeDeploy Le tue istanze devono eseguire una versione supportata dell' CodeDeploy agente. La versione minima attualmente supportata è la 1.8.x. **Nota** Si consiglia di utilizzare la versione più recente dell' CodeDeploy agente. Se riscontri problemi, esegui l'aggiornamento alla versione più recente prima di contattare l' AWS assistenza. Per informazioni sull'aggiornamento, consulta[Aggiorna l'agente CodeDeploy](codedeploy-agent-operations-update.md). La tabella seguente elenca tutte le versioni dell' CodeDeploy agente e le funzionalità e i miglioramenti inclusi in ciascuna versione. | Versione | Data di rilascio | Informazioni | | --- | --- | --- | | 1.8.1 | 3 febbraio 2026 | **Risolto: bug corretto** dell'endpoint S3. **Aggiunto**: certificato CA Sectigo all'elenco delle CA di Windows. | | 1.8.0 | 31 luglio 2025 | **Modificato: è** stato aggiornato il pacchetto Ruby alla versione 3.2 nell' CodeDeploy agente per Windows. | | 1.7.1 | 14 novembre 2024 | **Modificato**: dipendenze aggiornate per le patch di sicurezza. | | 1.7.0 | 6 marzo 2024 | **Aggiunto**: un'impostazione `:disable_imds_v1:` di configurazione nel file di configurazione dell' CodeDeploy agente. Utilizzate questa impostazione per disabilitare il fallback in IMDSv1 cui si verificano IMDSv2 errori. L'impostazione predefinita è `false` (abilita il fallback). Per ulteriori informazioni, vedere il riferimento alla configurazione [CodeDeploy dell'agente.](https://docs.aws.amazon.com/codedeploy/latest/userguide/reference-agent-configuration.html) **Aggiunto**: Supporto per il sistema operativo Red Hat Enterprise Linux 9 (RHEL 9). **Aggiunto**: Supporto per le versioni 3.1 e 3.2 di Ruby su Ubuntu Server. **Risolto**: l' CodeDeploy agente ora genera un errore intuitivo se il file di configurazione dell' CodeDeploy agente non viene caricato. **Modificato**: Ruby aggiornato alla versione 2.7.8-1 nell'agente per Windows. CodeDeploy | | 1.6.0 | 30 marzo 2023 | **Aggiunto**: Supporto per Ruby 3.1, 3.2. **Aggiunto**: Supporto per Amazon Linux 2023. **Aggiunto**: Supporto per Windows Server 2022. **Modificato**: l'impostazione predefinita di `verbose` è ora `false` per le istanze di Windows Server. Per continuare a stampare i messaggi di debug nei file di registro su Windows, è necessario impostare `verbose` su. `true` **Rimosso**: Supporto per Windows Server 2016 e Windows Server 2012 R2. **Rimosso**: Supporto per Amazon Linux 2018.03.x. | | 1.5.0 | 3 marzo 2023 | **Aggiunto**: Supporto per Ruby 3. **Aggiunto**: Supporto per Ubuntu 22.04. **Risolto**: un problema a causa del quale il riavvio dell' CodeDeploy agente subito dopo l'avvio causava il blocco dell'agente. **Modificato**: l' CodeDeploy agente ora fallisce la distribuzione dell'host all'avvio dell'agente se il servizio dell'agente si riavvia in modo imprevisto durante l'esecuzione di uno script hook. Questa correzione consente di evitare di attendere il periodo di timeout di 70 minuti prima di riprovare una distribuzione. **Avviso di obsolescenza**: l' CodeDeploy agente 1.5.0 è l'ultima versione a supportare Windows Server 2016 e Windows Server 2012 R2. **Rimosso:** Supporto per l' CodeDeployagente su Ubuntu 14.04 LTS, Windows Server 2008 R2 e Windows Server 2008 R2 a 32 bit. | | 1.4.1 | 6 dicembre 2022 | **Risolto**: vulnerabilità di sicurezza relativa alla registrazione. **Miglioramento**: registrazione migliorata durante il polling del comando host. | | 1.4.0 | 31 agosto 2022 | **Aggiunto**: Supporto per Red Hat Enterprise Linux 8. **Aggiunto**: supporto per percorsi di file lunghi sull' CodeDeploy agente per Windows. Per abilitare percorsi di file lunghi, è necessario impostare la chiave di registro di Windows appropriata e quindi riavviare l'agente. Per ulteriori informazioni, consulta [I percorsi di file lunghi causano errori del tipo «Nessun file o directory di questo tipo»](troubleshooting-deployments.md#troubleshooting-long-file-paths). **Risolto**: un problema con l'operazione di decompressione quando il disco era pieno. L' CodeDeploy agente ora rileva il [codice di uscita 50](https://linux.die.net/man/1/unzip) dell'unzip che indica un disco completo, rimuove i file parzialmente estratti e solleva un'eccezione per segnalare un errore al server. CodeDeploy Il messaggio di errore è visibile come messaggio di errore relativo a un evento del ciclo di vita e la distribuzione a livello di host si interromperà senza che si verifichi un blocco o un timeout. **Risolto**: un problema che causava il fallimento dell'agente. **Risolto**: un problema che causava il timeout degli hook durante una gara irregolare. Gli hook senza script ora continueranno e non causeranno più guasti o timeout. **Modificato**: lo `update` script dalla `bin` directory dell' CodeDeploy agente è stato rimosso perché non viene più utilizzato. **Modificato**: l' CodeDeploy agente per Windows Server ora include Ruby 2.7. **Modificato**: sono state aggiunte nuove variabili di ambiente, che possono essere utilizzate dagli script hook a seconda dell'origine del pacchetto di distribuzione (Amazon GitHub S3 o). Per ulteriori informazioni, consulta [Disponibilità delle variabili di ambiente per gli hook](reference-appspec-file-structure-hooks.md#reference-appspec-file-structure-environment-variable-availability). **Avviso di obsolescenza**: CodeDeploy agent 1.4.0 è l'ultima versione che includerà i programmi di installazione per Windows Server a 32 bit. **Avviso di obsolescenza: l'** CodeDeployagente 1.4.0 è l'ultima versione che supporterà Windows Server 2008 R2. **Rimosso**: supporto per l' CodeDeploy agente sui seguenti Amazon EC2: AMIs Amazon Linux 2014.09, 2016.03, 2016.09 e 2017.03. | | 1.3.2 | 06 maggio 2021 | CodeDeploy [l'agente 1.3.2 si rivolge a CVE-2018-1000201 che influisce sugli host Windows che eseguono l'agente.](https://nvd.nist.gov/vuln/detail/CVE-2018-1000201) Il CVE cita ruby-ffi, che è una dipendenza dell'agente. CodeDeploy Se il tuo agente è stato installato con Amazon EC2 Systems Manager (SSM) ed è impostato per l'aggiornamento automatico, non è richiesta alcuna azione. Altrimenti, è necessaria un'azione per aggiornare manualmente l'agente. Per aggiornare l'agente, segui le istruzioni riportate in [Aggiornamento dell' CodeDeploy agente su Windows Server](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-update-windows.html). **Risolto**: un problema durante l'installazione dell' CodeDeploy agente su Ubuntu 20.04 e versioni successive. **Risolto**: un problema intermittente che si verificava durante l'estrazione di file compressi perché i percorsi relativi non venivano gestiti correttamente. **Aggiunto**: supporto [AWS PrivateLink e endpoint VPC](https://docs.aws.amazon.com//vpc/latest/userguide/endpoint-services-overview.html) per istanze Windows. **Aggiunti**: miglioramenti ai AppSpec file, come descritto di seguito. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/codedeploy/latest/userguide/codedeploy-agent.html) **Aggiornato**: CodeDeploy ora utilizza l' AWS SDK per Ruby 3.0. | | 1.3.1 | 22 dicembre 2020 | **Risolto**: problema 1.3.0 che impediva l'avvio delle istanze locali. | | 1.3.0 | 10 novembre 2020 | Questa versione è obsoleta. **Risolto**: rimosso un certificato scaduto che non veniva più utilizzato. **Risolto**: è stato rimosso il messaggio di richiesta dallo script di disinstallazione dell'agente utilizzato da AWS Systems Manager, semplificando il downgrade di un host o di un parco macchine a una versione precedente dell'agente. | | 1.2.1 | 23 settembre 2020 | **Modificato**: AWS SDK per Ruby dipendenza aggiornata dalla v2 alla v3. **Aggiunto**: Support per IMDSv2. Include un fallback silenzioso in IMDSv1 caso di fallimento delle richieste IMDSv2 http. **Modificato: sono** state aggiornate le dipendenze Rake e Rubyzip per le patch di sicurezza. **Risolto**: assicurati che un file PID vuoto restituisca uno stato di `No CodeDeploy Agent Running` e pulisca il file PID all'avvio dell'agente. | | 1.1.2 | 4 agosto 2020 | **Aggiunto**: Supporto per Ubuntu Server 19.10 e 20.04. **Nota**: la versione 19.10 ha raggiunto la sua end-of-life data e non è più supportata da Ubuntu o. CodeDeploy **Aggiunto**: miglioramenti dell'efficienza della memoria per Linux e Ubuntu per rilasciare la memoria riservata più tempestivamente. **Aggiunto**: compatibilità con Windows Server «silent-cleanup», che in alcuni casi causava la mancata risposta dell'agente. **Aggiunto**: ignora le directory non vuote durante la pulizia per evitare errori durante la distribuzione. **Aggiunto**: Supporto per AWS Local Zone a Los Angeles (LA). **Aggiunto**: estrae AZ dai metadati dell'istanza per garantire la compatibilità per AWS Local Zones. **Aggiunto**: gli utenti possono ora fornire il proprio archivio nelle sottodirectory e non sono tenuti a memorizzarlo nella directory principale. **Aggiunto**: rilevato un problema con Rubyzip che potrebbe causare perdite di memoria. È stato aggiornato il comando unzip per tentare innanzitutto di utilizzare un'utilità di decompressione installata dal sistema prima di utilizzare Rubyzip. **Aggiunto**: `:enable_auth_policy:` come impostazione di configurazione dell'agente. **Modificato**: gli avvisi di unzip ora vengono ignorati, quindi le distribuzioni continueranno. | | 1.1.0 | 30 giugno 2020 | **Modificato**: il controllo delle versioni dell' CodeDeployagente ora segue la convenzione di controllo delle versioni standard di Ruby. **Aggiunta**: aggiunto un nuovo parametro per il comando di installazione e aggiornamento per consentire l'installazione di una versione specifica dell'agente dalla riga di comando. **Rimosso**: rimosso l' CodeDeploy agente Auto Updater per Linux e Ubuntu. Per configurare gli aggiornamenti automatici dell' CodeDeploy agente, vedi [Installare l' CodeDeploy agente utilizzando AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html). | | 1.0.1.1597 | 15 novembre 2018 | **Miglioramento**: CodeDeploy supporta Ubuntu 18.04. **Miglioramento: supporta Ruby 2.5.** CodeDeploy **Miglioramento: supporta** gli endpoint FIPS. CodeDeploy Per ulteriori informazioni sugli endpoint FIPS, consulta la [panoramica su FIPS 140-2](https://aws.amazon.com/compliance/fips/). [Per gli endpoint che possono essere utilizzati con CodeBuild, vedi regioni ed endpoint. CodeDeploy](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) | | 1.0.1.1518 | 12 giugno 2018 | **Miglioramento**: è stato risolto un problema che causava un errore quando l' CodeDeploy agente veniva chiuso mentre accettava le richieste di sondaggio. **Miglioramento**: è stata aggiunta una funzionalità di tracciamento della distribuzione che impedisce la chiusura dell' CodeDeploy agente quando è in corso una distribuzione. **Miglioramento**: prestazioni superiori durante l'eliminazione di file. | | 1.0.1.1458 | 6 marzo 2018 | **Nota**: questa versione non è più supportata. Se usi questa versione, le distribuzioni potrebbero avere esito negativo. **Miglioramento**: le convalide dei certificati ora supportano più autorità attendibili. **Miglioramento**: è stato risolto un problema che causava il fallimento della CLI locale durante una distribuzione che includeva un evento del ciclo di vita. BeforeInstall **Miglioramento**: è stato risolto un problema che poteva causare il fallimento di una distribuzione attiva quando l'agente veniva aggiornato. CodeDeploy | | 1.0.1.1352 | 16 novembre 2017 | **Nota**: questa versione non è più supportata. Se usi questa versione, le distribuzioni potrebbero avere esito negativo. **Funzionalità: è** stata introdotta una nuova funzionalità per il test e il debug di una distribuzione EC2/locale su un computer o un'istanza locale in cui è installato l'agente. CodeDeploy | | 1.0.1.1106 | 16 maggio 2017 | **Nota**: questa versione non è più supportata. Se usi questa versione, le distribuzioni potrebbero avere esito negativo. **Funzionalità**: introdotto il supporto per la gestione di contenuti in una posizione di destinazione che non era parte della revisione dell'applicazione della distribuzione riuscita più recente. Le opzioni delle distribuzioni per i contenuti esistenti ora includono la conservazione dei contenuti, la sovrascrittura dei contenuti o l'esito negativo della distribuzione. **Miglioramento**: ha reso l' CodeDeploy agente compatibile con la versione 2.9.2 di (2.9.2). AWS SDK per Ruby aws-sdk-core | | 1.0.1.1095 | 29 marzo 2017 | **Nota**: questa versione non è più supportata. Se usi questa versione, le distribuzioni potrebbero avere esito negativo. **Miglioramento**: è stato introdotto il supporto per l' CodeDeploy agente nella regione Cina (Pechino). **Miglioramento**: ha abilitato l'esecuzione di Puppet su istanze di Windows Server quando richiamato da un hook di eventi del ciclo di vita. **Miglioramento**: migliorata la gestione delle operazioni `untar`. | | 1.0.1.1067 | 6 gennaio 2017 | **Nota**: questa versione non è più supportata. Se usi questa versione, le distribuzioni potrebbero avere esito negativo. **Miglioramento**: rivisti numerosi messaggi di errore per includere cause più specifiche per le distribuzioni con esito negativo. **Miglioramento**: è stato risolto un problema che impediva all' CodeDeploy agente di identificare la revisione corretta dell'applicazione da distribuire durante alcune distribuzioni. **Miglioramento**: ripristinato l'utilizzo di `pushd` e di `popd` prima e dopo l'operazione `untar`. | | 1.0.1.1045 | 21 novembre 2016 | **Nota**: questa versione non è più supportata. Se usi questa versione, le distribuzioni potrebbero avere esito negativo. **Miglioramento: l'** CodeDeploy agente è stato reso compatibile con la versione 2.6.11 di (2.6.11). AWS SDK per Ruby aws-sdk-core | | 1.0.1.1037 | 19 Ottobre 2016 | **Nota**: questa versione non è più supportata. Se usi questa versione, le distribuzioni potrebbero avere esito negativo. L' CodeDeploy agente per le istanze di Amazon Linux, RHEL e Ubuntu Server è stato aggiornato con la seguente modifica. Per le istanze di Windows Server, la versione più recente rimane la 1.0.1.998. **Miglioramento**: l'agente è ora in grado di determinare quale versione di Ruby è installata su un'istanza, per cui può richiamare lo script `codedeploy-agent` che utilizza tale versione. | | 1.0.1.1011.1 | 17 agosto 2016 | **Nota**: questa versione non è più supportata. Se usi questa versione, le distribuzioni potrebbero avere esito negativo. **Miglioramenti**: rimosse le modifiche introdotte dalla versione 1.0.1.1011 a causa di problemi con il supporto di shell. Questa versione dell'agente è equivalente dal punto di vista funzionale alla versione 1.0.1.998 rilasciata l'11 luglio 2016. | | 1.0.1.1011 | 15 agosto 2016 | **Nota**: questa versione non è più supportata. Se usi questa versione, le distribuzioni potrebbero avere esito negativo. L' CodeDeploy agente per le istanze di Amazon Linux, RHEL e Ubuntu Server è stato aggiornato con le seguenti modifiche. Per le istanze di Windows Server, la versione più recente rimane la 1.0.1.998.**Funzionalità: è** stato aggiunto il supporto per richiamare l' CodeDeploy agente utilizzando la shell bash sui sistemi operativi in cui è in uso il sistema init systemd.Miglioramento: è stato abilitato il supporto per tutte le versioni di Ruby 2.x nell'agente e nell'agente di aggiornamento. CodeDeploy CodeDeploy CodeDeploy Gli agenti aggiornati non dipendono più solo da Ruby 2.0. (Ruby 2.0 è ancora necessario per le versioni deb e rpm del programma di installazione dell' CodeDeploy agente.) | | 1.0.1.998 | 11 luglio 2016 | **Nota**: questa versione non è più supportata. Se usi questa versione, le distribuzioni potrebbero avere esito negativo. **Miglioramento***: supporto fisso per l'esecuzione dell' CodeDeploy agente con profili utente diversi da root.* La variabile `USER` è stata sostituita da `CODEDEPLOY_USER` per evitare conflitti con le variabili di ambiente. | | 1.0.1.966 | 16 giugno 2016 | **Nota**: questa versione non è più supportata. Se usi questa versione, le distribuzioni potrebbero avere esito negativo. **Funzionalità: è** *stato introdotto il supporto per l'esecuzione dell' CodeDeploy agente con profili utente diversi da root.* **Miglioramento**: risolto il supporto per specificare il numero di revisioni dell'applicazione che l'agente CodeDeploy può archiviare per un gruppo di distribuzione. **Miglioramento**: l' CodeDeploy agente è stato reso compatibile con la versione 2.3 di AWS SDK per Ruby (aws-sdk-core 2.3). **Miglioramento**: risolti i problemi con la codifica UTF-8 durante le distribuzioni. **Miglioramento**: maggiore precisione durante l'identificazione dei nomi dei processi. | | 1.0.1.950 | 24 marzo 2016 | **Nota**: questa versione non è più supportata. Se usi questa versione, le distribuzioni potrebbero avere esito negativo. **Funzionalità**: aggiunto il supporto proxy durante l'installazione. **Miglioramento**: è stato aggiornato lo script di installazione per non scaricare l' CodeDeploy agente se è già installata la versione più recente. | | 1.0.1.934 | 11 febbraio 2016 | **Nota**: questa versione non è più supportata. Se usi questa versione, le distribuzioni potrebbero avere esito negativo. **Funzionalità**: introdotto il supporto per specificare il numero di revisioni dell'applicazione che l'agente CodeDeploy può archiviare per un gruppo di distribuzione. | | 1.0.1.880 | 11 gennaio 2016 | **Nota**: questa versione non è più supportata e le distribuzioni potrebbero avere esito negativo. **Miglioramento: l'** CodeDeploy agente è stato reso compatibile con la versione 2.2 della AWS SDK per Ruby (2.2). aws-sdk-core La versione 2.1.2 è ancora supportata. | | 1.0.1.854 | 17 Novembre 2015 | **Nota**: questa versione non è più supportata. Se usi questa versione, le distribuzioni potrebbero avere esito negativo. **Funzionalità**: introdotto il supporto per l'algoritmo hash SHA-256. **Funzionalità**: introdotto il supporto del monitoraggio delle versioni nei file `.version`. **Funzionalità**: l'ID del gruppo di distribuzione è ora disponibile mediante l'uso di una variabile di ambiente. **Miglioramento**[: è stato aggiunto il supporto per il monitoraggio dei log degli CodeDeploy agenti tramite Amazon Logs. CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatchLogs.html) | Per informazioni correlate, consulta quanto segue: + [Determina la versione dell' CodeDeploy agente](codedeploy-agent-operations-version.md) + [Installa l' CodeDeploy agente](codedeploy-agent-operations-install.md) [Per una cronologia delle versioni degli CodeDeploy agenti, consulta l'archivio Release su. GitHub](https://github.com/aws/aws-codedeploy-agent/releases) ## Gestione del processo CodeDeploy Tutte le distribuzioni Linux dell' CodeDeploy agente (rpm e deb) utilizzano [systemd](https://systemd.io/) per impostazione predefinita per gestire il processo dell'agente. Tuttavia, entrambe le distribuzioni rpm e deb vengono fornite con script di avvio che risiedono in. `/etc/init.d/codedeploy-agent` A seconda della distribuzione utilizzata, quando si utilizza un comando come`sudo service codedeploy-agent restart`, gli script `/etc/init.d` possono essere eseguiti per avviare il processo agente anziché consentire la gestione del processo. `systemd` L'esecuzione degli script su non `/etc/init.d` è consigliabile. Per evitare questo problema, per i sistemi che supportano si `systemd` consiglia di utilizzare l'`systemctl`utilità per tutte le operazioni dell'agente anziché utilizzare il `service` comando. Ad esempio, per riavviare l' CodeDeploy agente, utilizzare il comando equivalente con l'`service`utilità `sudo systemctl restart codedeploy-agent` anziché il comando equivalente. ## Revisione dell'applicazione e pulizia dei file di registro L' CodeDeploy agente archivia le revisioni e i file di registro sulle istanze. L' CodeDeploy agente pulisce questi artefatti per risparmiare spazio su disco. **Registri di distribuzione delle revisioni delle applicazioni: è** possibile utilizzare l'**opzione:max\$1revisions:** nel file di configurazione dell'agente per specificare il numero di revisioni dell'applicazione da archiviare inserendo un numero intero positivo. CodeDeploy archivia anche i file di registro per tali revisioni. Tutti gli altri vengono eliminati, a eccezione del file di log dell'ultima distribuzione con esito positivo. Quel file di log viene sempre conservato, anche se il numero di distribuzioni con esito negativo supera il numero di revisioni conservate. Se non viene specificato alcun valore, CodeDeploy conserva le cinque revisioni più recenti oltre alla revisione attualmente distribuita. **CodeDeploy log**: per le istanze Amazon Linux, Ubuntu Server e RHEL, l' CodeDeploy agente ruota i file di registro all'interno della cartella. `/var/log/aws/codedeploy-agent` Il file di log viene ruotato alle 00:00:00 (ora istanza) ogni giorno. I file di log vengono eliminati dopo 7 giorni. Il modello di denominazione per i file di log ruotati è `codedeploy-agent.YYYYMMDD.log`. ## File installati dall'agente CodeDeploy L' CodeDeploy agente archivia le revisioni, la cronologia di distribuzione e gli script di distribuzione nella directory principale di un'istanza. Il nome e la posizione predefiniti di questa directory sono: `'/opt/codedeploy-agent/deployment-root'`per Amazon Linux, Ubuntu Server e istanze RHEL. `'C:\ProgramData\Amazon\CodeDeploy'`per istanze di Windows Server. È possibile utilizzare l'impostazione **root\$1dir** nel file di configurazione dell' CodeDeploy agente per configurare il nome e la posizione della directory. Per ulteriori informazioni, consulta [CodeDeploy riferimento alla configurazione dell'agente](reference-agent-configuration.md). Di seguito è riportato un esempio del file e della struttura della directory nella directory principale. La struttura presuppone che vi sia un numero N di gruppi di distribuzione e che ogni gruppo di distribuzione includa un numero N di distribuzioni. ``` |--deployment-root/ |-- deployment group 1 ID | |-- deployment 1 ID | | |-- Contents and logs of the deployment's revision | |-- deployment 2 ID | | |-- Contents and logs of the deployment's revision | |-- deployment N ID | | |-- Contents and logs of the deployment's revision |-- deployment group 2 ID | |-- deployment 1 ID | | |-- bundle.tar | | |-- deployment-archive | | | | -- contents of the deployment's revision | | |-- logs | | | | -- scripts.log | |-- deployment 2 ID | | |-- bundle.tar | | |-- deployment-archive | | | | -- contents of the deployment's revision | | |-- logs | | | | -- scripts.log | |-- deployment N ID | | |-- bundle.tar | | |-- deployment-archive | | | | -- contents of the deployment's revision | | |-- logs | | | | -- scripts.log |-- deployment group N ID | |-- deployment 1 ID | | |-- Contents and logs of the deployment's revision | |-- deployment 2 ID | | |-- Contents and logs of the deployment's revision | |-- deployment N ID | | |-- Contents and logs of the deployment's revision |-- deployment-instructions | |-- [deployment group 1 ID]_cleanup | |-- [deployment group 2 ID]_cleanup | |-- [deployment group N ID]_cleanup | |-- [deployment group 1 ID]_install.json | |-- [deployment group 2 ID]_install.json | |-- [deployment group N ID]_install.json | |-- [deployment group 1 ID]_last_successful_install | |-- [deployment group 2 ID]_last_successful_install | |-- [deployment group N ID]_last_successful_install | |-- [deployment group 1 ID]_most_recent_install | |-- [deployment group 2 ID]_most_recent_install | |-- [deployment group N ID]_most_recent_install |-- deployment-logs | |-- codedeploy-agent-deployments.log ``` + Le cartelle **ID gruppo di distribuzione** rappresentano ognuno dei gruppi di distribuzione. Il nome della directory del gruppo di distribuzione è il relativo ID (ad esempio, `acde1916-9099-7caf-fd21-012345abcdef`). Ciascuna directory del gruppo di distribuzione contiene una sottodirectory per ogni tentativo di distribuzione in quel gruppo di distribuzione. Puoi utilizzare il comando [batch-get-deployments](https://docs.aws.amazon.com/cli/latest/reference/deploy/batch-get-deployments.html) per trovare l'ID di un gruppo di distribuzione. + Le cartelle **ID distribuzione** rappresentano ciascuna distribuzione in un gruppo di distribuzione. Il nome della directory di ciascuna distribuzione è il relativo ID. Ogni cartella contiene: + **bundle.tar**, un file compresso con i contenuti della revisione della distribuzione. Usa un'utilità di decompressione zip se desideri visualizzare la revisione. + **deployment-archive**, una directory che include i contenuti della revisione della distribuzione. + **log**, una directory che contiene un file `scripts.log`. Questo file elenca l'output di tutti gli script specificati nel file di distribuzione. AppSpec Se desideri trovare la cartella per una distribuzione ma non conosci l'ID di distribuzione o l'ID del gruppo di distribuzione, puoi utilizzare la [AWS CodeDeploy console](https://console.aws.amazon.com/codedeploy) o AWS CLI trovarli. Per ulteriori informazioni, consulta [Visualizza i dettagli CodeDeploy della distribuzione](deployments-view-details.md). Per impostazione predefinita, il numero massimo di distribuzioni che possono essere archiviate in un gruppo di distribuzione è cinque. Quando viene raggiunto il numero desiderato, le distribuzioni future vengono archiviate e l'archivio meno recente viene eliminato. È possibile utilizzare l'impostazione **max\$1revisions** nel file di configurazione dell' CodeDeploy agente per modificare l'impostazione predefinita. Per ulteriori informazioni, consulta [CodeDeploy riferimento alla configurazione dell'agente](reference-agent-configuration.md). **Nota** Se desideri recuperare spazio nell'hard disk occupato dalle distribuzioni archiviate, imposta **max\$1revisions** su un valore basso, ad esempio 1 o 2. La distribuzione successiva elimina le distribuzioni archiviate, in modo che il numero sia uguale a quello specificato. + **deployment-instructions** contiene quattro file di testo per ogni gruppo di distribuzione: + **[Deployment Group ID]-cleanup**, un file di testo con una versione per l'annullamento di ogni comando eseguito durante una distribuzione. Un esempio di file è `acde1916-9099-7caf-fd21-012345abcdef-cleanup`. + **[Deployment Group ID]-install.json**, un file JSON creato durante la distribuzione più recente. Contiene i comandi eseguiti durante la distribuzione. Un esempio di file è `acde1916-9099-7caf-fd21-012345abcdef-install.json`. + **[Deployment Group ID]\$1last\$1successfull\$1install**, un file di testo che scrive la directory di archivio dell'ultima distribuzione avvenuta con successo. Questo file viene creato quando l' CodeDeploy agente ha copiato tutti i file dell'applicazione di distribuzione nell'istanza. Viene utilizzato dall' CodeDeploy agente durante la distribuzione successiva per determinare quali `ApplicationStop` `BeforeInstall` script eseguire. Un esempio di file è `acde1916-9099-7caf-fd21-012345abcdef_last_successfull_install`. + **[Deployment Group ID]\$1most\$1recent\$1install**, un file di testo che scrive il nome della directory di archivio della distribuzione più recente. Questo file viene creato quando i file nella distribuzione vengono scaricati con successo. Dopo questo file, viene creato il file [deployment group ID]\$1last\$1successfull\$1install nel momento in cui i file scaricati vengono copiati nella destinazione finale. Un esempio di file è `acde1916-9099-7caf-fd21-012345abcdef_most_recent_install`. + **deployment-logs** contiene i seguenti file di log: + I file **codedeploy-agent.yyyymmdd.log** vengono creati per ogni giorno in cui avviene una distribuzione. Ogni file di log contiene informazioni sulle distribuzioni del giorno. Questi file di log possono essere utilizzati per problemi di debug come quelli relativi alle autorizzazioni. Il file di log viene inizialmente denominato `codedeploy-agent.log`. Il giorno successivo, la data delle distribuzioni viene inserita nel nome del file. Ad esempio, se oggi è il 3 gennaio 2018, è possibile vedere le informazioni su tutte le distribuzioni di oggi in `codedeploy-agent.log`. Domani, 4 gennaio 2018, il file di log verrà rinominato `codedeploy-agent.20180103.log`. + **codedeploy-agent-deployments.log** compila il contenuto dei `scripts.log` file per ogni distribuzione. I file `scripts.log` vengono posizionati nella sottocartella `logs` nella cartella `Deployment ID`. Le voci in questo file sono precedute da un ID di distribuzione. Ad esempio, "`[d-ABCDEF123]LifecycleEvent - BeforeInstall`" potrebbe essere scritto durante una distribuzione con un ID di `d-ABCDEF123`. Quando `codedeploy-agent-deployments.log` raggiunge la dimensione massima, l' CodeDeploy agente continua a scrivervi mentre elimina i vecchi contenuti. # Gestione delle operazioni degli CodeDeploy agenti Le istruzioni in questa sezione mostrano come installare, disinstallare, reinstallare o aggiornare l' CodeDeploy agente e come verificare che l' CodeDeploy agente sia in esecuzione. **Topics** + [ # Verifica che l' CodeDeploy agente sia in esecuzione ](codedeploy-agent-operations-verify.md) + [ # Determina la versione dell' CodeDeploy agente ](codedeploy-agent-operations-version.md) + [ # Installa l' CodeDeploy agente ](codedeploy-agent-operations-install.md) + [ # Aggiorna l'agente CodeDeploy ](codedeploy-agent-operations-update.md) + [ # Disinstalla l'agente CodeDeploy ](codedeploy-agent-operations-uninstall.md) + [ # Invia i log degli CodeDeploy agenti a CloudWatch ](codedeploy-agent-operations-cloudwatch-agent.md) # Verifica che l' CodeDeploy agente sia in esecuzione Questa sezione descrive i comandi da eseguire se sospetti che l' CodeDeploy agente abbia smesso di funzionare su un'istanza. **Topics** + [ ## Verifica che l' CodeDeploy agente per Amazon Linux o RHEL sia in esecuzione ](#codedeploy-agent-operations-verify-linux) + [ ## Verifica che l' CodeDeploy agente per Ubuntu Server sia in esecuzione ](#codedeploy-agent-operations-verify-ubuntu) + [ ## Verifica che l' CodeDeploy agente per Windows Server sia in esecuzione ](#codedeploy-agent-operations-verify-windows) ## Verifica che l' CodeDeploy agente per Amazon Linux o RHEL sia in esecuzione Per verificare se l' CodeDeploy agente è installato e in esecuzione, accedi all'istanza ed esegui il comando seguente: ``` systemctl status codedeploy-agent ``` Se il comando restituisce un errore, l' CodeDeploy agente non viene installato. Installarlo come descritto in [Installa l' CodeDeploy agente per Amazon Linux o RHEL](codedeploy-agent-operations-install-linux.md). Se l' CodeDeploy agente è installato e in esecuzione, dovresti vedere un messaggio simile a`The AWS CodeDeploy agent is running`. Se viene visualizzato un messaggio come `error: No AWS CodeDeploy agent running`, avvia il servizio ed esegui i seguenti due comandi, uno alla volta: ``` systemctl start codedeploy-agent ``` ``` systemctl status codedeploy-agent ``` ## Verifica che l' CodeDeploy agente per Ubuntu Server sia in esecuzione Per verificare se l' CodeDeploy agente è installato e in esecuzione, accedi all'istanza ed esegui il comando seguente: ``` systemctl status codedeploy-agent ``` Se il comando restituisce un errore, l' CodeDeploy agente non viene installato. Installarlo come descritto in [Installa l' CodeDeploy agente per Ubuntu Server](codedeploy-agent-operations-install-ubuntu.md). Se l' CodeDeploy agente è installato e in esecuzione, dovresti vedere un messaggio simile a`The AWS CodeDeploy agent is running`. Se viene visualizzato un messaggio come `error: No AWS CodeDeploy agent running`, avvia il servizio ed esegui i seguenti due comandi, uno alla volta: ``` systemctl start codedeploy-agent ``` ``` systemctl status codedeploy-agent ``` ## Verifica che l' CodeDeploy agente per Windows Server sia in esecuzione Per verificare se l' CodeDeploy agente è installato e in esecuzione, accedi all'istanza ed esegui il comando seguente: ``` powershell.exe -Command Get-Service -Name codedeployagent ``` Verrà visualizzato un output simile al seguente: ``` Status Name DisplayName ------ ---- ----------- Running codedeployagent CodeDeploy Host Agent Service ``` Se il comando restituisce un errore, l' CodeDeploy agente non viene installato. Installarlo come descritto in [Installa l' CodeDeploy agente per Windows Server](codedeploy-agent-operations-install-windows.md). Se `Status` mostra un valore diverso da `Running`, avviare il servizio con il comando seguente: ``` powershell.exe -Command Start-Service -Name codedeployagent ``` È possibile riavviare il servizio con il comando seguente: ``` powershell.exe -Command Restart-Service -Name codedeployagent ``` È possibile arrestare il servizio con il comando seguente: ``` powershell.exe -Command Stop-Service -Name codedeployagent ``` # Determina la versione dell' CodeDeploy agente Puoi determinare la versione dell' CodeDeploy agente in esecuzione sull'istanza in due modi. Innanzitutto, a partire dalla versione 1.0.1.854 dell' CodeDeploy agente, è possibile visualizzare il numero di versione in un `.version` file sull'istanza. La tabella seguente mostra il percorso e la stringa di versione di esempio per ciascuno dei sistemi operativi supportati. | Sistema operativo | Posizione del file | Stringa agent\$1version di esempio | | --- | --- | --- | | Amazon Linux e Red Hat Enterprise Linux (RHEL) | /opt/codedeploy-agent/.version | OFFICIAL\$11.0.1.854\$1rpm | | Ubuntu Server | /opt/codedeploy-agent/.version | OFFICIAL\$11.0.1.854\$1deb | | Windows Server | C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1.version | OFFICIAL\$11.0.1.854\$1msi | In secondo luogo, è possibile eseguire un comando su un'istanza per individuare la versione dell'agente CodeDeploy. **Topics** + [ ## Determina la versione su Amazon Linux o RHEL ](#codedeploy-agent-operations-version-linux) + [ ## Determina la versione su Ubuntu Server ](#codedeploy-agent-operations-version-ubuntu) + [ ## Determina la versione su Windows Server ](#codedeploy-agent-operations-version-windows) ## Determina la versione su Amazon Linux o RHEL Accedere all'istanza ed eseguire il comando seguente: ``` sudo yum info codedeploy-agent ``` ## Determina la versione su Ubuntu Server Accedere all'istanza ed eseguire il comando seguente: ``` sudo dpkg -s codedeploy-agent ``` ## Determina la versione su Windows Server Accedere all'istanza ed eseguire il comando seguente: ``` sc qdescription codedeployagent ``` # Installa l' CodeDeploy agente Per utilizzarlo CodeDeploy su istanze EC2 o server locali, l' CodeDeploy agente deve essere prima installato. Consigliamo di installare e aggiornare l'agente con CodeDeploy . AWS Systems Manager Per ulteriori informazioni su Systems Manager, vedere [What is AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html). È possibile configurare l'installazione e gli aggiornamenti pianificati dell' CodeDeployagente con Systems Manager nella console quando si creano i gruppi di distribuzione. Puoi anche installare l' CodeDeploy agente direttamente da un bucket S3 con la riga di comando. Per la versione consigliata da installare, consulta. [Cronologia delle versioni dell'agente CodeDeploy](codedeploy-agent.md#codedeploy-agent-version-history) **Topics** + [ # Installa l' CodeDeploy agente utilizzando AWS Systems Manager ](codedeploy-agent-operations-install-ssm.md) + [ # Installa l' CodeDeploy agente utilizzando la riga di comando ](codedeploy-agent-operations-install-cli.md) # Installa l' CodeDeploy agente utilizzando AWS Systems Manager Puoi usare Console di gestione AWS o il AWS CLI per installare l' CodeDeploy agente sulle tue istanze Amazon EC2 o locali utilizzando. AWS Systems ManagerÈ possibile scegliere di installare una versione specifica o di installare sempre la versione più recente dell'agente. [Per ulteriori informazioni su AWS Systems Manager, consulta What is. AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html) L'utilizzo AWS Systems Manager è il metodo consigliato per l'installazione e l'aggiornamento dell' CodeDeploy agente. Puoi anche installare l' CodeDeploy agente da un bucket Amazon S3. Per informazioni sull'uso di un collegamento per il download di Amazon S3, consulta [Installa l' CodeDeploy agente utilizzando la riga di comando](codedeploy-agent-operations-install-cli.md). **Topics** + [ ## Prerequisiti ](#install-codedeploy-agent-prereqs) + [ ## Installa l' CodeDeploy agente ](#download-codedeploy-agent-on-EC2-Instance) ## Prerequisiti Segui i passaggi indicati [Guida introduttiva con CodeDeploy](getting-started-codedeploy.md) per configurare le autorizzazioni IAM e il. AWS CLI Se si installa l' CodeDeploy agente su un server locale con Systems Manager, è necessario registrare il server locale con Amazon EC2 Systems Manager. Per ulteriori informazioni, vedere [Configurazione di Systems Manager in ambienti ibridi](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-managedinstances.html) nella *Guida AWS Systems Manager per l'utente*. ## Installa l' CodeDeploy agente Prima di poter utilizzare Systems Manager per installare l' CodeDeploy agente, è necessario assicurarsi che l'istanza sia configurata correttamente per Systems Manager. ### Installazione o aggiornamento dell'agente SSM Su un'istanza Amazon EC2, l' CodeDeploy agente richiede che l'istanza esegua la versione 2.3.274.0 o successiva. Prima di installare l' CodeDeploy agente, aggiorna o installa l'agente SSM sull'istanza, se non l'hai già fatto. L'agente SSM è preinstallato su alcuni Amazon AMIs EC2 forniti da. AWS Per ulteriori informazioni, consulta [Amazon Machine Images (AMIs) con agente SSM preinstallato](https://docs.aws.amazon.com/systems-manager/latest/userguide/ami-preinstalled-agent.html). **Nota** Assicurati che anche il sistema operativo dell'istanza sia supportato dall' CodeDeployagente. Per ulteriori informazioni, consulta [Sistemi operativi supportati dall'agente CodeDeploy](codedeploy-agent.md#codedeploy-agent-supported-operating-systems). *Per informazioni sull'installazione o l'aggiornamento dell'agente SSM su un'istanza che esegue Linux, consulta [Installazione e configurazione dell'agente SSM sulle istanze Linux](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-agent.html) nella Guida per l'utente.AWS Systems Manager * *Per informazioni sull'installazione o l'aggiornamento dell'agente SSM su un'istanza che esegue Windows Server, consulta [Installazione e configurazione dell'agente SSM sulle](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-win.html) istanze Windows nella Guida per l'utente.AWS Systems Manager * ### (Facoltativo) Verifica dei prerequisiti di Systems Manager Prima di utilizzare Systems Manager Run Command per installare l' CodeDeploy agente, verificate che le istanze soddisfino i requisiti minimi di Systems Manager. Per ulteriori informazioni, consulta [Setting up AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up.html) in *AWS Systems Manager User Guide*. ### Installa l'agente CodeDeploy Con SSM, puoi installarlo CodeDeploy una sola volta o impostare una pianificazione per installare nuove versioni. Per installare l' CodeDeploy agente, scegli il `AWSCodeDeployAgent` pacchetto mentre segui i passaggi in [Installare o aggiornare i pacchetti con il AWS Systems Manager distributore](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html). # Installa l' CodeDeploy agente utilizzando la riga di comando **Nota** Si consiglia di installare l' CodeDeploy agente con AWS Systems Manager per poter configurare gli aggiornamenti pianificati dell'agente. Per ulteriori informazioni, consulta [Installa l' CodeDeploy agente utilizzando AWS Systems Manager](codedeploy-agent-operations-install-ssm.md). Utilizza i seguenti argomenti per installare ed eseguire l' CodeDeploy agente tramite la riga di comando. **Topics** + [ # Installa l' CodeDeploy agente per Amazon Linux o RHEL ](codedeploy-agent-operations-install-linux.md) + [ # Installa l' CodeDeploy agente per Ubuntu Server ](codedeploy-agent-operations-install-ubuntu.md) + [ # Installa l' CodeDeploy agente per Windows Server ](codedeploy-agent-operations-install-windows.md) # Installa l' CodeDeploy agente per Amazon Linux o RHEL Accedere all'istanza ed eseguire i comandi seguenti, uno alla volta. L'esecuzione `sudo yum update` iniziale del comando è considerata una procedura consigliata `yum` per l'installazione dei pacchetti, ma è possibile ignorarla se non si desidera aggiornare tutti i pacchetti. ``` sudo yum update ``` ``` sudo yum install ruby ``` ``` sudo yum install wget ``` (Facoltativo) Per pulire l'AMI da tutte le informazioni di memorizzazione nella cache degli agenti precedenti, esegui lo script seguente: ``` #!/bin/bash CODEDEPLOY_BIN="/opt/codedeploy-agent/bin/codedeploy-agent" $CODEDEPLOY_BIN stop yum erase codedeploy-agent -y ``` Passa alla tua home directory: ``` cd /home/ec2-user ``` **Nota** Nel comando precedente, `/home/ec2-user` rappresenta il nome utente predefinito per un'istanza Amazon Linux o RHEL Amazon EC2. Se l'istanza è stata creata utilizzando un'AMI personalizzata, il proprietario dell'AMI potrebbe avere specificato un nome utente predefinito diverso. Scarica il programma di installazione dell' CodeDeploy agente: ``` wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install ``` *bucket-name*è il nome del bucket Amazon S3 che contiene i file CodeDeploy Resource Kit per la tua regione ed *region-identifier* è l'identificatore della tua regione. Esempio: `https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install` Per un elenco dei nomi dei bucket e degli identificatori di regione, consulta. [Nomi dei bucket del Resource Kit per regione](resource-kit.md#resource-kit-bucket-names) Imposta i permessi di esecuzione sul file: `install` ``` chmod +x ./install ``` Per installare la versione più recente dell' CodeDeploy agente: + ``` sudo ./install auto ``` Per installare una versione specifica dell' CodeDeploy agente: + Elenca le versioni disponibili nella tua regione: ``` aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.rpm$' ``` + Installa una delle versioni: ``` sudo ./install auto -v releases/codedeploy-agent-version.noarch.rpm ``` **Nota** AWS supporta l'ultima versione secondaria dell' CodeDeploy agente. Attualmente l'ultima versione secondaria è la 1.7.x. Per verificare che il servizio sia in esecuzione, eseguire il comando seguente: ``` systemctl status codedeploy-agent ``` Se l' CodeDeploy agente è installato e in esecuzione, dovresti vedere un messaggio del tipo. `The AWS CodeDeploy agent is running` Se viene visualizzato un messaggio come `error: No AWS CodeDeploy agent running`, avvia il servizio ed esegui i seguenti due comandi, uno alla volta: ``` systemctl start codedeploy-agent ``` ``` systemctl status codedeploy-agent ``` # Installa l' CodeDeploy agente per Ubuntu Server **Nota** Si consiglia di installare l' CodeDeploy agente con AWS Systems Manager per poter configurare gli aggiornamenti pianificati dell'agente. Per ulteriori informazioni, consulta [Installa l' CodeDeploy agente utilizzando AWS Systems Manager](codedeploy-agent-operations-install-ssm.md). **Per installare l' CodeDeploy agente su Ubuntu Server** 1. Accedi all'istanza. 1. Inserisci i seguenti comandi, uno dopo l'altro: ``` sudo apt update ``` ``` sudo apt install ruby-full ``` ``` sudo apt install wget ``` 1. Immetti il comando seguente: ``` cd /home/ubuntu ``` */home/ubuntu*rappresenta il nome utente predefinito per un'istanza di Ubuntu Server. Se l'istanza è stata creata utilizzando un'AMI personalizzata, il proprietario dell'AMI potrebbe avere specificato un nome utente predefinito diverso. 1. Immetti il comando seguente: ``` wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install ``` *bucket-name*è il nome del bucket Amazon S3 che contiene i file CodeDeploy Resource Kit per la tua regione ed *region-identifier* è l'identificatore della tua regione. Esempio: `https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install` Per un elenco dei nomi dei bucket e degli identificatori di regione, consulta. [Nomi dei bucket del Resource Kit per regione](resource-kit.md#resource-kit-bucket-names) 1. Immetti il comando seguente: ``` chmod +x ./install ``` 1. Esegui una delle seguenti operazioni: + Per installare la versione più recente dell' CodeDeploy agente su qualsiasi versione supportata di Ubuntu Server *tranne* la 20.04: ``` sudo ./install auto ``` + Per installare la versione più recente dell' CodeDeploy agente su Ubuntu Server 20.04: **Nota** La scrittura dell'output in un file di registro temporaneo è una soluzione alternativa che dovrebbe essere utilizzata mentre risolviamo un bug noto con lo `install` script su Ubuntu Server 20.04. ``` sudo ./install auto > /tmp/logfile ``` + Per installare una versione specifica dell' CodeDeploy agente su qualsiasi versione supportata di Ubuntu Server *tranne* la 20.04: + Elenca le versioni disponibili nella tua regione: ``` aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$' ``` + Installa una delle versioni: ``` sudo ./install auto -v releases/codedeploy-agent-###.deb ``` **Nota** AWS supporta l'ultima versione secondaria dell' CodeDeploy agente. Attualmente l'ultima versione secondaria è la 1.7.x. + Per installare una versione specifica dell' CodeDeploy agente su Ubuntu Server 20.04: + Elenca le versioni disponibili nella tua regione: ``` aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$' ``` + Installa una delle versioni: ``` sudo ./install auto -v releases/codedeploy-agent-###.deb > /tmp/logfile ``` **Nota** La scrittura dell'output in un file di registro temporaneo è una soluzione alternativa che dovrebbe essere utilizzata mentre risolviamo un bug noto con lo `install` script su Ubuntu Server 20.04. **Nota** AWS supporta l'ultima versione secondaria dell' CodeDeploy agente. Attualmente l'ultima versione secondaria è la 1.7.x. **Per verificare che il servizio sia in esecuzione** 1. Immetti il comando seguente: ``` systemctl status codedeploy-agent ``` Se l' CodeDeploy agente è installato e in esecuzione, dovresti vedere un messaggio simile a`The AWS CodeDeploy agent is running`. 1. Se viene visualizzato un messaggio come `error: No AWS CodeDeploy agent running`, avvia il servizio ed esegui i seguenti due comandi, uno alla volta: ``` systemctl start codedeploy-agent ``` ``` systemctl status codedeploy-agent ``` # Installa l' CodeDeploy agente per Windows Server Nelle istanze di Windows Server, puoi utilizzare uno di questi metodi per scaricare e installare l' CodeDeploy agente: + Utilizzo AWS Systems Manager (consigliato) + Esegui una serie di PowerShell comandi di Windows. + Selezionare un collegamento diretto per il download. + Esegui un comando di copia Amazon S3. **Nota** La cartella in cui è installato l' CodeDeploy agente è`C:\Program Data\Amazon\CodeDeploy`. Accertatevi che non vi siano giunzioni di directory o collegamenti simbolici su questo percorso. **Topics** + [ ## Utilizzo di Systems Manager ](#codedeploy-agent-operations-install-system-manager) + [ ## Usa Windows PowerShell ](#codedeploy-agent-operations-install-windows-powershell) + [ ## Uso di un collegamento diretto ](#codedeploy-agent-operations-install-windows-direct-link) + [ ## Usa un comando di copia Amazon S3 ](#codedeploy-agent-operations-install-windows-s3-copy) ## Utilizzo di Systems Manager Segui le istruzioni riportate [Installa l' CodeDeploy agente utilizzando AWS Systems Manager](codedeploy-agent-operations-install-ssm.md) per installare l' CodeDeployagente. ## Usa Windows PowerShell Accedi all'istanza ed esegui i seguenti comandi in Windows PowerShell: 1. Richiedere che tutti gli script e i file di configurazione scaricati da Internet siano firmati da un autore attendibile. Se viene richiesto di modificare la policy di esecuzione, digitare "**Y**". ``` Set-ExecutionPolicy RemoteSigned ``` 1. Carica il AWS Tools for Windows PowerShell. ``` Import-Module AWSPowerShell ``` 1. Crea una directory in cui scaricare il file di installazione dell' CodeDeploy agente. ``` New-Item -Path "c:\temp" -ItemType "directory" -Force ``` 1. Configura AWS le credenziali utilizzando i `Initialize-AWSDefaultConfiguration` comandi `Set-AWSCredential` and. Per ulteriori informazioni, vedere [Utilizzo AWS delle credenziali](https://docs.aws.amazon.com/powershell/latest/userguide/specifying-your-aws-credentials.html) negli *AWS strumenti per la guida per PowerShell l'utente*. 1. Scaricate il file di installazione dell' CodeDeploy agente. **Nota** AWS supporta l'ultima versione secondaria dell' CodeDeploy agente. Attualmente l'ultima versione secondaria è la 1.7.x. Per installare la versione più recente dell' CodeDeployagente: + ``` powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent.msi -File c:\temp\codedeploy-agent.msi ``` Per installare una versione specifica dell' CodeDeployagente: + ``` powershell.exe -Command Read-S3Object -BucketName bucket-name -Key releases/codedeploy-agent-###.msi -File c:\temp\codedeploy-agent.msi ``` *bucket-name*è il nome del bucket Amazon S3 che contiene i file CodeDeploy Resource Kit per la tua regione. Ad esempio, per la regione Stati Uniti orientali (Ohio), sostituisci con. *bucket-name* `aws-codedeploy-us-east-2` Per un elenco dei nomi dei bucket, vedi. [Nomi dei bucket del Resource Kit per regione](resource-kit.md#resource-kit-bucket-names) 1. Esegui il file di installazione dell' CodeDeploy agente. ``` c:\temp\codedeploy-agent.msi /quiet /l c:\temp\host-agent-install-log.txt ``` Per verificare che il servizio sia in esecuzione, eseguire il comando seguente: ``` powershell.exe -Command Get-Service -Name codedeployagent ``` Se l' CodeDeploy agente è stato appena installato e non è stato avviato, dopo aver eseguito il **Get-Service** comando, in **Stato**, dovresti vedere**Start...**: ``` Status Name DisplayName ------ ---- ----------- Start... codedeployagent CodeDeploy Host Agent Service ``` Se l' CodeDeploy agente è già in esecuzione, dopo aver eseguito il **Get-Service** comando, in **Status**, dovresti vedere**Running**: ``` Status Name DisplayName ------ ---- ----------- Running codedeployagent CodeDeploy Host Agent Service ``` ## Uso di un collegamento diretto Se le impostazioni di sicurezza del browser sull'istanza di Windows Server forniscono le autorizzazioni (ad esempio, per`https://s3.*.amazonaws.com`), puoi utilizzare un collegamento diretto alla tua regione per scaricare l' CodeDeploy agente ed eseguire il programma di installazione manualmente. Il collegamento è: ``` https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent.msi ``` ... *region* dov'è la AWS regione in cui stai distribuendo la tua applicazione. Esempio: ``` https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent.msi ``` **Importante** Ottieni il `.msi` file dalla stessa regione CodeDeploy dell'applicazione. La scelta di una regione diversa può causare `inconsistent region` errori nel `codedeploy-agent-log` file durante l'esecuzione del `.msi` file. ## Usa un comando di copia Amazon S3 Se AWS CLI è installato sull'istanza, puoi utilizzare il comando Amazon S3 [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) per scaricare l' CodeDeploy agente ed eseguire il programma di installazione manualmente. Per informazioni, consulta [Installare il AWS Command Line Interface su Microsoft Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html). Il comando Amazon S3 è: ``` aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent.msi codedeploy-agent.msi --region region ``` ... *region* dov'è la AWS regione in cui stai distribuendo la tua applicazione. Esempio: ``` aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent.msi codedeploy-agent.msi --region af-south-1 ``` # Aggiorna l'agente CodeDeploy È possibile configurare gli aggiornamenti automatici e pianificati dell' CodeDeploy agente su tutti i sistemi operativi supportati utilizzando AWS Systems Manager. È inoltre possibile forzare gli aggiornamenti su tutti i sistemi operativi supportati mediante l'esecuzione di un comando su un'istanza. **Topics** + [ # Aggiorna l' CodeDeploy agente su Amazon Linux o RHEL ](codedeploy-agent-operations-update-linux.md) + [ # Aggiorna l' CodeDeploy agente su Ubuntu Server ](codedeploy-agent-operations-update-ubuntu.md) + [ # Aggiorna l' CodeDeploy agente su Windows Server ](codedeploy-agent-operations-update-windows.md) # Aggiorna l' CodeDeploy agente su Amazon Linux o RHEL Per configurare gli aggiornamenti automatici e pianificati dell' CodeDeploy agente utilizzando AWS Systems Manager, segui la procedura descritta in [Installare l' CodeDeploy agente con AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html). Se desideri forzare un aggiornamento dell' CodeDeploy agente, accedi all'istanza ed esegui il comando seguente: ``` sudo /opt/codedeploy-agent/bin/install auto ``` # Aggiorna l' CodeDeploy agente su Ubuntu Server Per configurare gli aggiornamenti automatici e pianificati dell' CodeDeploy agente utilizzando AWS Systems Manager, segui la procedura descritta in [Installare l' CodeDeploy agente con AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html). Se desideri forzare un aggiornamento dell' CodeDeploy agente, accedi all'istanza ed esegui il comando seguente: ``` sudo /opt/codedeploy-agent/bin/install auto ``` # Aggiorna l' CodeDeploy agente su Windows Server È possibile abilitare gli aggiornamenti automatici dell' CodeDeploy agente con AWS Systems Manager. Con Systems Manager, puoi configurare una pianificazione di aggiornamento per le tue istanze Amazon EC2 o locali creando un'associazione con Systems Manager State Manager. Puoi anche aggiornare manualmente l' CodeDeploy agente disinstallando la versione corrente e installandone una più recente. **Topics** + [ ## Imposta l'aggiornamento automatico CodeDeploy dell'agente con AWS Systems Manager ](#codedeploy-agent-operations-update-windows-ssm) + [ ## Aggiorna l' CodeDeploy agente manualmente ](#codedeploy-agent-operations-update-windows-manual) + [ ## (Obsoleto) Aggiornate l' CodeDeploy agente con Windows Server Updater ](#codedeploy-agent-operations-update-windows-updater) ## Imposta l'aggiornamento automatico CodeDeploy dell'agente con AWS Systems Manager Per configurare Systems Manager e abilitare gli aggiornamenti automatici dell' CodeDeploy agente, seguire le istruzioni riportate in [Installare l' CodeDeploy agente utilizzando AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html). ## Aggiorna l' CodeDeploy agente manualmente Per aggiornare l' CodeDeploy agente manualmente, è possibile installare la versione più recente dalla CLI o utilizzando Systems Manager. Segui le istruzioni in [ Installare l'agente CodeDeploy.](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install.html) Si consiglia di disinstallare le versioni precedenti dell' CodeDeploy agente seguendo le istruzioni riportate in [Disinstallare l' CodeDeployagente](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-uninstall.html). ## (Obsoleto) Aggiornate l' CodeDeploy agente con Windows Server Updater **Nota** L' CodeDeploy agent updater per Windows Server è obsoleto e non verrà aggiornato a nessuna versione successiva alla 1.0.1.1597. Per abilitare gli aggiornamenti automatici dell' CodeDeploy agente, installa l' CodeDeploy agent updater per Windows Server su istanze nuove o esistenti. La funzione di aggiornamento verifica periodicamente la disponibilità di nuove versioni. Quando rileva una nuova versione, disinstalla la versione corrente dell'agente, se presente, quindi installa la versione più recente. Se quando la funzione di aggiornamento rileva una nuova versione è già in corso una distribuzione, questa continua fino al completamento. Se invece durante il processo di aggiornamento si avvia una distribuzione, questa non riesce. Se desideri forzare l'aggiornamento dell' CodeDeploy agente, segui le istruzioni riportate in. [Installa l' CodeDeploy agente per Windows Server](codedeploy-agent-operations-install-windows.md) Nelle istanze di Windows Server, puoi scaricare e installare l' CodeDeploy agent updater eseguendo PowerShell i comandi di Windows, utilizzando un link per il download diretto o eseguendo un comando di copia Amazon S3. **Topics** + [ ### Usa Windows PowerShell ](#codedeploy-agent-operations-update-windows-powershell) + [ ### Uso di un collegamento diretto ](#codedeploy-agent-operations-update-windows-direct-link) + [ ### Usa un comando di copia Amazon S3 ](#codedeploy-agent-operations-update-windows-s3-copy) ### Usa Windows PowerShell Accedi all'istanza ed esegui i seguenti comandi in Windows PowerShell, uno alla volta: ``` Set-ExecutionPolicy RemoteSigned ``` Se ti viene richiesto di modificare i criteri di esecuzione, scegli in **Y** modo che Windows PowerShell richieda che tutti gli script e i file di configurazione scaricati da Internet siano firmati da un editore attendibile. ``` Import-Module AWSPowerShell ``` ``` New-Item -Path "c:\temp" -ItemType "directory" -Force ``` ``` powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent-updater.msi -File c:\temp\codedeploy-agent-updater.msi ``` ``` c:\temp\codedeploy-agent-updater.msi /quiet /l c:\temp\host-agent-updater-log.txt ``` ``` powershell.exe -Command Get-Service -Name codedeployagent ``` *bucket-name*è il nome del bucket Amazon S3 che contiene i file CodeDeploy Resource Kit per la tua regione. Ad esempio, per la regione Stati Uniti orientali (Ohio), sostituisci con. *bucket-name* `aws-codedeploy-us-east-2` Per un elenco dei nomi dei bucket, vedi. [Nomi dei bucket del Resource Kit per regione](resource-kit.md#resource-kit-bucket-names) Se è necessario risolvere un errore del processo di aggiornamento, digitare il comando seguente per aprire il file di registro dell' CodeDeploy agente di aggiornamento: ``` notepad C:\ProgramData\Amazon\CodeDeployUpdater\log\codedeploy-agent.updater.log ``` ### Uso di un collegamento diretto Se le impostazioni di sicurezza del browser sull'istanza di Windows Server forniscono le autorizzazioni richieste (ad esempio, per ` http://s3.*.amazonaws.com `), è possibile utilizzare un collegamento diretto per scaricare l'agente updater. CodeDeploy Il collegamento è: ``` https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent-updater.msi ``` ... *region* dov'è la AWS regione in cui stai aggiornando la tua applicazione. Esempio: ``` https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent-updater.msi ``` ### Usa un comando di copia Amazon S3 Se AWS CLI è installato sull'istanza, puoi utilizzare il comando Amazon S3 [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) per scaricare l' CodeDeploy agente di aggiornamento e quindi eseguire il programma di installazione manualmente. Per informazioni, consulta [Installare il AWS Command Line Interface su Microsoft Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html). Il comando Amazon S3 è: ``` aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi --region region ``` ... *region* dov'è la AWS regione in cui stai aggiornando la tua applicazione. Esempio: ``` aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi --region af-south-1 ``` # Disinstalla l'agente CodeDeploy Puoi rimuovere l' CodeDeploy agente dalle istanze quando non è più necessario o quando desideri eseguire una nuova installazione. ## Disinstalla l' CodeDeploy agente da Amazon Linux o RHEL Per disinstallare l' CodeDeploy agente, accedi all'istanza ed esegui il seguente comando: ``` sudo yum erase codedeploy-agent ``` ## Disinstalla CodeDeploy l'agente da Ubuntu Server Per disinstallare l' CodeDeploy agente, accedi all'istanza ed esegui il seguente comando: ``` sudo dpkg --purge codedeploy-agent ``` ## Disinstalla CodeDeploy l'agente da Windows Server Per disinstallare l' CodeDeploy agente, accedi all'istanza ed esegui i seguenti tre comandi, uno alla volta: ``` wmic ``` ``` product where name="CodeDeploy Host Agent" call uninstall /nointeractive ``` ``` exit ``` Puoi anche accedere all'istanza e, nel **Pannello di controllo**, aprire **Programmi e funzionalità**, scegliere **CodeDeploy Host Agent** e quindi scegliere **Disinstalla**. # Invia i log degli CodeDeploy agenti a CloudWatch Puoi inviare le metriche e i dati di registro dell' CodeDeploy agente CloudWatch utilizzando l'[ CloudWatch agente unificato](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/UseCloudWatchUnifiedAgent.html) o, più semplicemente, l'agente. CloudWatch Utilizza le seguenti istruzioni per installare l' CloudWatch agente e configurarlo per l'uso con CodeDeploy gli agenti. ## Prerequisiti Prima di iniziare, completa le seguenti attività: + Installa l' CodeDeploy agente e assicurati che sia in esecuzione. Per ulteriori informazioni, consultare [Installa l' CodeDeploy agente](codedeploy-agent-operations-install.md) e [Verifica che l' CodeDeploy agente sia in esecuzione](codedeploy-agent-operations-verify.md). + Installa l' CloudWatch agente. Per ulteriori informazioni, vedere [Installazione dell' CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html). + Aggiungi le seguenti autorizzazioni al profilo dell'istanza CodeDeploy IAM: + CloudWatchLogsFullAccess + CloudWatchAgentServerPolicy Per ulteriori informazioni sul profilo dell' CodeDeploy istanza, consulta [Fase 4: crea un profilo di istanza IAM per le tue istanze Amazon EC2](getting-started-create-iam-instance-profile.md) di[Guida introduttiva con CodeDeploy](getting-started-codedeploy.md). ## Configurare l' CloudWatch agente per raccogliere i CodeDeploy log È possibile configurare l' CloudWatch agente eseguendo una procedura guidata o creando o modificando manualmente un file di configurazione. **Per configurare l' CloudWatch agente utilizzando la procedura guidata (Linux)** 1. Esegui la procedura guidata, come descritto in [Eseguire la procedura guidata di configurazione dell' CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard). 1. Nella procedura guidata, quando richiesto, inserisci. `Do you want to monitor any log files?` **1** 1. Specificate il file di registro CodeDeploy dell'agente, come segue: 1. Per `Log file path` inserire il percorso del file di CodeDeploy registro, ad esempio:**/var/log/aws/codedeploy-agent/codedeploy-agent.log**. 1. Per `Log group name` inserire il nome di un gruppo di log, ad esempio:**codedeploy-agent-log**. 1. Per `Log stream name` inserire il nome di un flusso di log, per esempio:**\$1instance\$1id\$1-codedeploy-agent-log**. 1. Quando richiesto`Do you want to specify any additional log files?`, inserisci**1**. 1. Specificate i registri di distribuzione degli CodeDeploy agenti, come segue: 1. Per `Log file path` inserire il percorso del file di registro di CodeDeploy distribuzione, ad esempio:**/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log**. 1. Per `Log group name` inserire il nome di un gruppo di log, ad esempio:**codedeploy-agent-deployment-log**. 1. Per `Log stream name` inserire il nome di un flusso di log, per esempio:**\$1instance\$1id\$1-codedeploy-agent-deployment-log**. 1. Quando richiesto`Do you want to specify any additional log files?`, inserisci**1**. 1. Specificate i registri CodeDeploy dell'agente di aggiornamento, come segue: 1. Per `Log file path` inserire il percorso del file di registro dell' CodeDeploy aggiornamento, ad esempio:. **/tmp/codedeploy-agent.update.log** 1. Per `Log group name` inserire il nome di un gruppo di log, ad esempio:**codedeploy-agent-updater-log**. 1. Per `Log stream name` inserire il nome di un flusso di log, per esempio:**\$1instance\$1id\$1-codedeploy-agent-updater-log**. **Per configurare l' CloudWatch agente utilizzando la procedura guidata (Windows)** 1. Esegui la procedura guidata, come descritto in [Esecuzione della procedura guidata di configurazione dell' CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard). 1. Nella procedura guidata, quando richiesto, inserisci. `Do you want to monitor any customized log files?` **1** 1. Specificate il file di CodeDeploy registro nel modo seguente: 1. Per `Log file path` inserire il percorso o il file di registro CodeDeploy dell'agente, ad esempio:**C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1log\$1codedeploy-agent-log.txt**. 1. Per `Log group name` inserire il nome di un gruppo di log, ad esempio:**codedeploy-agent-log**. 1. Per `Log stream name` inserire il nome di un flusso di log, per esempio:**\$1instance\$1id\$1-codedeploy-agent-log**. 1. Quando richiesto`Do you want to specify any additional log files?`, inserisci**1**. 1. Specificate i registri di distribuzione degli CodeDeploy agenti, come segue: 1. Per `Log file path` inserire il percorso del file CodeDeploy di registro della distribuzione, ad esempio:**C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1deployment-logs\$1codedeploy-agent-deployments.log**. 1. Per `Log group name` inserire il nome di un gruppo di log, ad esempio:**codedeploy-agent-deployment-log**. 1. Per `Log stream name` inserire il nome di un flusso di log, per esempio:**\$1instance\$1id\$1-codedeploy-agent-deployment-log**. **Per configurare l' CloudWatch agente creando o modificando manualmente un file di configurazione (Linux)** 1. Creare o modificare il file di configurazione dell' CloudWatch agente come descritto in [Creare o modificare manualmente il file di configurazione dell' CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html). 1. Assicuratevi che il file venga chiamato `/opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json` e che contenga il codice seguente: ``` ... "logs": { "logs_collected": { "files": { "collect_list": [ { "file_path": "/var/log/aws/codedeploy-agent/codedeploy-agent.log", "log_group_name": "codedeploy-agent-log", "log_stream_name": "{instance_id}-agent-log" }, { "file_path": "/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log", "log_group_name": "codedeploy-agent-deployment-log", "log_stream_name": "{instance_id}-codedeploy-agent-deployment-log" }, { "file_path": "/tmp/codedeploy-agent.update.log", "log_group_name": "codedeploy-agent-updater-log", "log_stream_name": "{instance_id}-codedeploy-agent-updater-log" } ] } } } ... ``` **Per configurare l' CloudWatch agente creando o modificando manualmente un file di configurazione (Windows)** 1. Creare o modificare il file di configurazione dell' CloudWatch agente come descritto in [Creare o modificare manualmente il file di configurazione dell' CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html). 1. Assicuratevi che il file venga chiamato `C:\ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.json` e che contenga il codice seguente: ``` ... "logs": { "logs_collected": { "files": { "collect_list": [ { "file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\log\\codedeploy-agent-log.txt", "log_group_name": "codedeploy-agent-log", "log_stream_name": "{instance_id}-codedeploy-agent-log" }, { "file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\deployment-logs\\codedeploy-agent-deployments.log", "log_group_name": "codedeploy-agent-deployment-log", "log_stream_name": "{instance_id}-codedeploy-agent-deployment-log" } ] }, ... } }, ... ``` ## Riavviare l' CloudWatch agente Dopo aver apportato le modifiche, riavvia l' CloudWatch agente come descritto in [Avvio dell' CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance-fleet.html#start-CloudWatch-Agent-EC2-fleet).