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à. # Lavorare con l' CodeDeploy agente **Stato di implementazione della versione 2.0.x** La versione 2.0.x dell' CodeDeploy agente è in fase di implementazione Regioni AWS e potrebbe non essere ancora disponibile in tutte le regioni. La versione 2.0.0 è un aggiornamento facoltativo. Per effettuare l'aggiornamento alla versione 2.0.x da qualsiasi versione precedente, vedere. [Installa l' CodeDeploy agente](codedeploy-agent-operations-install.md) L' AWS CodeDeploy agente è un pacchetto software che, una volta installato e configurato su un'istanza, ne consente l'utilizzo nelle distribuzioni. CodeDeploy AWS supporta attivamente l'ultima versione secondaria dell' CodeDeploy agente. Per l'ultima versione rilasciata, vedere[Cronologia delle versioni dell'agente CodeDeploy](#codedeploy-agent-version-history). **Nota** L' CodeDeploy agente è richiesto solo se si esegue la distribuzione su una piattaforma di EC2/On-Premises elaborazione. L'agente non è richiesto per le distribuzioni che utilizzano la piattaforma di calcolo Amazon ECS o AWS Lambda. 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 AWS CodeDeploy da utilizzare quando interagisce 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 i 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) + [Gestire il 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 Amazon EC2 AMI supportati L' CodeDeploy agente è stato testato sui seguenti sistemi operativi Amazon EC2 AMI: + Amazon Linux 2023 (x86\_64, aarch64) + Amazon Linux 2 (x86\_64, aarch64) + Red Hat Enterprise Linux (RHEL) 8, 9, 10 (x86\_64, aarch64) + Oracle Linux 8, 9, 10 (x86\_64, aarch64) + Rocky Linux 9, 10 (x86\_64, aarch64) + CentOS Stream 9, 10 (x86\_64, aarch64) + SLES 15 (x86\_64, aarch64) + Debian 11, 12, 13 (x86\_64, aarch64) + Ubuntu Server 16.04 LTS, 18.04 LTS, 20.04 LTS, 22.04 LTS, 24.04 LTS, 25.04, 26.04 LTS (x86\_64, aarch64) + Windows Server 2016, 2019, 2022, 2025 (x86\_64) **Nota** Le seguenti piattaforme sono state testate solo sulla versione dell' CodeDeploy agente 2.0.x e successive: Windows Server 2025, RHEL 10, Oracle Linux 8, 9, 10, Rocky Linux 9, 10, CentOS Stream 9, 10, SLES 15, Debian 11, 12, 13 e Ubuntu Server 24.04, 25.04, 26.04. 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 ](https://github.com/aws/aws-codedeploy-agent) CodeDeploy agenti in. GitHub ### Sistemi operativi locali supportati L' CodeDeploy agente è stato testato sui seguenti sistemi operativi locali: + Windows Server 2016, 2019, 2022, 2025 (x86\_64) + Red Hat Enterprise Linux (RHEL) 8, 9, 10 (x86\_64, aarch64) + Oracle Linux 8, 9, 10 (x86\_64, aarch64) + Rocky Linux 9, 10 (x86\_64, aarch64) + CentOS Stream 9, 10 (x86\_64, aarch64) + SLES 15 (x86\_64, aarch64) + Debian 11, 12, 13 (x86\_64, aarch64) + Ubuntu Server 16.04 LTS, 18.04 LTS, 20.04 LTS, 22.04 LTS, 24.04 LTS, 25.04, 26.04 LTS (x86\_64, aarch64) **Nota** Le seguenti piattaforme sono state testate solo sulla versione dell' CodeDeploy agente 2.0.x e successive: Windows Server 2025, RHEL 10, Oracle Linux 8, 9, 10, Rocky Linux 9, 10, CentOS Stream 9, 10, SLES 15, Debian 11, 12, 13 e Ubuntu Server 24.04, 25.04, 26.04. 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 ](https://github.com/aws/aws-codedeploy-agent) CodeDeploy agenti 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 dei metadati [https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html) EC2 per recuperare 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. In caso di 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). **Stato di implementazione della versione 2.0.x** La versione 2.0.x dell' CodeDeploy agente è in fase di implementazione Regioni AWS e potrebbe non essere ancora disponibile in tutte le regioni. La versione 2.0.0 è un aggiornamento facoltativo. Per effettuare l'aggiornamento alla versione 2.0.x da qualsiasi versione precedente, vedere. [Installa l' CodeDeploy agente](codedeploy-agent-operations-install.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 | | --- | --- | --- | | 2.0.1 | 24 agosto 2026 | **Risolto**: in Windows, i percorsi dei AppSpec file che iniziano con una barra rovesciata (`\`) o con più di un separatore (ad esempio`//my-folder`) vengono ora risolti all'interno della revisione, non nella radice dell'unità.
Per esempi di valori supportati`source`, consulta. [AppSpec sezione 'file' (solo EC2/On-Premises distribuzioni)](reference-appspec-file-structure-files.md) | | 2.0.0 | 15 luglio 2026 | **Modificato**: l' CodeDeploy agente è ora disponibile Rust-based e viene fornito come un singolo file binario nativo autonomo. La dipendenza dal runtime di Ruby è stata eliminata. Ruby non è più necessario per installare o eseguire l'agente. L'agente è compatibile dal punto di vista comportamentale con la versione 1.8.x per impostazione predefinita; i file di configurazione, la AppSpec gestione, la semantica del ciclo di vita, il layout su disco e i risultati di distribuzione esistenti sono invariati se non diversamente indicato di seguito.
**Aggiunto**: supporto esteso per i sistemi operativi, tra cui Windows Server 2025, RHEL 10 e Ubuntu Server 26.04, oltre a distribuzioni Linux aggiuntive e varianti ARM (aarch64). Per l'elenco completo delle piattaforme testate con questa versione, vedi. [Sistemi operativi supportati dall'agente CodeDeploy](#codedeploy-agent-supported-operating-systems)
**Aggiunto**: un `codedeploy-agent update` comando per l'aggiornamento automatico dell'agente su richiesta.
**Aggiunto**: una porta di comando locale. Si tratta di un'interfaccia di gestione TCP opzionale che ascolta solo l'indirizzo di loopback (127.0.0.1) per interrogare lo stato dell'agente e inserire comandi localmente. È disattivata per impostazione predefinita ed è abilitata con. `enable_command_port`
**Modificato**: il comando di distribuzione locale è ora disponibile`codedeploy-agent deploy-local`. Il `codedeploy-local` comando rimane disponibile per la compatibilità con le versioni precedenti. Tutte le opzioni di comando vengono mantenute e i percorsi locali, Amazon S3 (`s3://`) e i sorgenti dei GitHub bundle sono ancora supportati.
**Modificato**: su Linux, l'agente è gestito da un'unità systemd nativa (`codedeploy-agent.service`); lo script SysV init.d non è più installato. Utilizzato per gestire l'agente`systemctl`.
**Modificato (sicurezza)**: la verifica del certificato TLS è sempre abilitata e i core dump sono disabilitati per impostazione predefinita.
**Aggiunte**: impostazioni di rafforzamento opzionali che puoi abilitare per soddisfare i tuoi requisiti di sicurezza. Ogni impostazione è disattivata per impostazione predefinita e puoi abilitare quelle che desideri singolarmente. È possibile rifiutare i pacchetti che contengono collegamenti simbolici, percorsi di attraversamento o autorizzazioni non sicure; limitare l'ambiente degli hook degli eventi del ciclo di vita e limitare le autorizzazioni delle directory degli agenti e dei file di registro. Per l'elenco completo, consulta [CodeDeploy riferimento alla configurazione dell'agente](reference-agent-configuration.md).
**Modificato**: lo script di installazione da riga di comando è ora scritto in Bash (in precedenza Ruby). Richiede uno o. `curl` `wget`
**Modificato**: lo script di installazione per la versione 2.0.x è pubblicato con il `latestv2/` prefisso nei bucket regionali. `aws-codedeploy-{{region-identifier}}` Il `latest/` prefisso continua a servire lo script di installazione della versione 1.8.x.
**Modificato**: AWS ora pubblica la versione 2.0.x come pacchetto Systems Manager Distributor. `AWSCodeDeployAgentV2` Il `AWSCodeDeployAgent` pacchetto continua a funzionare con la versione 1.8.x.
**Rimosso**: l'impostazione `ssl_verify_peer` di configurazione e le chiavi di configurazione di Ruby ProcessManager .
**Importante**: attualmente non esiste alcun percorso di aggiornamento automatico dalla versione 1.8.x alla 2.0.0. Per eseguire l'aggiornamento alla versione 2.0.0, installatela con il pacchetto `AWSCodeDeployAgentV2` Systems Manager Distributor o eseguite manualmente lo script regionale. `latestv2/install` Per istruzioni, consulta l’argomento [Installa l' CodeDeploy agente](codedeploy-agent-operations-install.md). | | 1.8.1 | 3 febbraio 2026 | **Risolto**: bugfix per gli endpoint S3.
**Aggiunto**: certificato CA Sectigo all'elenco delle CA di Windows. | | 1.8.0 | 31 luglio 2025 | **Modificato**: aggiornato il Ruby in bundle 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 | **Aggiunta**: un'impostazione `:disable_imds_v1:` di configurazione al file di configurazione dell' CodeDeploy agente. Utilizzate questa impostazione per disattivare il fallback su IMDSv1 quando si verificano errori IMDSv2. Il valore predefinito è (abilita il fallback). `false` 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 per cui il riavvio dell' CodeDeploy agente subito dopo l'avvio causava il blocco dell'agente.
**Modificato**: l' CodeDeploy agente ora non riesce a eseguire una distribuzione dell'host all'avvio dell'agente se il servizio dell'agente si riavvia in modo imprevisto durante l'esecuzione di uno script di hook. Questa correzione consente di evitare di attendere il periodo di timeout di 70 minuti prima di riprovare una distribuzione.
**Avviso di obsolescenza**: CodeDeploy l'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 correlata 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 della decompressione ](https://linux.die.net/man/1/unzip) che indica un disco pieno, rimuove i file parzialmente estratti e genera un'eccezione per segnalare un errore al server. CodeDeploy Il messaggio di errore è visibile come messaggio di errore relativo all'evento del ciclo di vita e la distribuzione a livello di host si interromperà senza bloccarsi o scadere.
**Risolto**: un problema che causava il fallimento dell'agente.
**Risolto**: un problema che causava il timeout dei ganci durante una situazione limite di gara. Gli hook senza script ora continueranno e non causeranno più errori o timeout.
**Modificato**: lo `update` script dalla `bin` directory dell' CodeDeploy agente è stato rimosso perché non è più utilizzato.
**Modificato**: l' CodeDeploy agente per Windows Server ora include Ruby 2.7.
**Modificato**: sono state aggiunte nuove variabili di ambiente, da utilizzare dagli script hook a seconda della fonte del pacchetto di distribuzione (Amazon S3 o). GitHub
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**: l' CodeDeployagente 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 sulle seguenti AMI Amazon EC2: Amazon Linux 2014.09, 2016.03, 2016.09 e 2017.03. | | 1.3.2 | 06 maggio 2021 | CodeDeploy indirizzi dell'agente 1.3.2 che influiscono sugli host Windows che eseguono l'agente. [ CVE-2018-1000201 ](https://nvd.nist.gov/vuln/detail/CVE-2018-1000201) Il CVE cita ruby-ffi, che è una dipendenza dell'agente. CodeDeploy Se l'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 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 per endpoint VPC [AWS PrivateLink e istanze Windows. ](https://docs.aws.amazon.com/vpc/latest/userguide/endpoint-services-overview.html)
**Aggiunto**: miglioramenti ai AppSpec file, come descritto di seguito.+ È ora possibile specificare un nome di file personalizzato per il AppSpec file durante la creazione di una distribuzione locale. Per ulteriori informazioni, consulta [Crea una distribuzione locale](deployments-local.md#deployments-local-deploy).
+ Il AppSpec file può ora avere un'`.yaml`estensione.
+ È ora possibile sovrascrivere i file distribuiti utilizzando una nuova `file_exists_behavior` impostazione opzionale nel AppSpec file. Per ulteriori informazioni, consulta [AppSpec sezione 'file' (solo EC2/On-Premises distribuzioni)](reference-appspec-file-structure-files.md).
**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 era più utilizzato.
**Risolto**: rimosso il messaggio di richiesta dallo script di disinstallazione dell'agente utilizzato da AWS Systems Manager, semplificando il downgrade di un host o di una flotta a una versione precedente dell'agente. | | 1.2.1 | 23 settembre 2020 | **Modificato**: AWS SDK per Ruby dipendenza aggiornata dalla v2 alla v3.
**Aggiunto**: supporto per IMDSv2. Include un fallback silenzioso su IMDSv1 se le richieste http di IMDSv2 falliscono.
**Modificato**: dipendenze Rake e Rubyzip aggiornate per le patch di sicurezza.
**Risolto**: assicurati che un file PID vuoto restituisca lo stato del file PID `No CodeDeploy Agent Running` e lo pulisca 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 data di fine vita e non è più supportata da Ubuntu o. CodeDeploy
**Aggiunto**: miglioramenti dell'efficienza della memoria per Linux e Ubuntu per rilasciare la memoria riservata in modo più tempestivo.
**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 di Los Angeles (LA).
**Aggiunto**: Estrai AZ dai metadati delle istanze per garantire la compatibilità per le zone AWS locali.
**Aggiunto**: gli utenti possono ora fornire il proprio archivio in sottodirectory e non sono tenuti a memorizzarlo nella directory principale.
**Aggiunto**: è stato rilevato un problema con Rubyzip che potrebbe causare perdite di memoria. È stato aggiornato il comando unzip al primo tentativo 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 decompressione vengono ora 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**: CodeDeploy supporta Ruby 2.5.
**Miglioramento**: CodeDeploy supporta gli endpoint FIPS. 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 [ CodeDeploy Regioni ed endpoint. ](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 richieste di sondaggio.
**Miglioramento**: è stata aggiunta una funzionalità di tracciamento della distribuzione che impedisce la chiusura CodeDeploy dell'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 include 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 EC2/On-Premises distribuzione 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**: reso l' CodeDeploy agente compatibile con la versione 2.9.2 di (aws-sdk-core 2.9.2). AWS SDK per Ruby | | 1.0.1.1095 | 29 marzo 2017 | **Nota**: questa versione non è più supportata. Se usi questa versione, le distribuzioni potrebbero avere esito negativo.
**Miglioramento**: introdotto il supporto per l'agente nella regione Cina (Pechino). CodeDeploy
**Miglioramento**: 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**: reso l' CodeDeploy agente compatibile con la versione 2.6.11 di (aws-sdk-core 2.6.11). AWS SDK per Ruby | | 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 le seguenti modifiche. Per le istanze di Windows Server, la versione più recente rimane 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 Amazon Linux, RHEL e Ubuntu Server è stato aggiornato con le seguenti modifiche. Per le istanze di Windows Server, la versione più recente rimane 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 di inizializzazione systemd.Miglioramento: supporto abilitato per tutte le versioni di Ruby 2.x nell'agente e nell'agent updater. CodeDeploy CodeDeploy CodeDeploy Gli agenti aggiornati non dipendono più solo da Ruby 2.0. (Ruby 2.0 è ancora richiesto 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**: è stato corretto il supporto 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à**: introdotto il supporto per l'esecuzione CodeDeploy dell'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**: reso l' CodeDeploy agente compatibile con la versione 2.3 di AWS SDK per Ruby (aws-sdk-core 2.3).
**Miglioramento**: sono stati risolti i problemi di codifica durante le implementazioni. UTF-8
**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**: reso l' CodeDeploy agente compatibile con la versione 2.2 di AWS SDK per Ruby (aws-sdk-core 2.2). 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 CloudWatch Logs. ](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 il repository [ Release su. GitHub ](https://github.com/aws/aws-codedeploy-agent/releases) ## Gestire il processo CodeDeploy L' CodeDeploy agente utilizza [ systemd ](https://systemd.io/) per gestire il processo dell'agente su tutte le distribuzioni Linux supportate. Per la versione 2.0.x e successive, l'agente fornisce solo un'unità systemd nativa (). `codedeploy-agent.service` Non esiste uno script. `/etc/init.d/codedeploy-agent` `systemctl`Da utilizzare per gestire l'agente o richiamare il binario direttamente con`start`, `stop``restart`, o `status` sottocomandi. Per la versione 1.8.x e precedenti, entrambe le distribuzioni rpm e deb vengono fornite con gli script di avvio all'indirizzo. `/etc/init.d/codedeploy-agent` Sui sistemi che supportano systemd, l'uso del `service` comando può inavvertitamente eseguire gli script init.d invece di consentire a systemd di gestire il processo. Usalo per le operazioni con gli agenti `systemctl` per evitare questo problema. Per gestire l' CodeDeploy agente, usa l'`systemctl`utilità: ``` sudo systemctl start codedeploy-agent sudo systemctl stop codedeploy-agent sudo systemctl restart codedeploy-agent sudo systemctl status codedeploy-agent ``` ## 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\_revisions**: ** 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 mantiene le cinque revisioni più recenti oltre alla revisione attualmente distribuita. **CodeDeploy logs**: 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 registro viene ruotato ogni giorno alle 00:00:00 (ora dell'istanza) o quando il file raggiunge i 64 MB, a seconda dell'evento che si verifica per primo. Se si verifica una seconda rotazione nello stesso giorno, l'agente aggiunge un suffisso numerico (ad esempio,). `codedeploy-agent.20260715.1.log` L'agente elimina i file di registro dopo sette giorni. Il modello di denominazione per i file di log ruotati è `codedeploy-agent.{{YYYYMMDD}}.log`. ## File installati dall'agente CodeDeploy L' CodeDeploy agente memorizza 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 le istanze Amazon Linux, Ubuntu Server e RHEL. `'C:\ProgramData\Amazon\CodeDeploy'`per istanze Windows Server. È possibile utilizzare l'**impostazione ** root\_dir nel file di configurazione CodeDeploy dell'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. È possibile utilizzare il comando [ batch-get-deployments per trovare un ID del gruppo di distribuzione](https://docs.aws.amazon.com/cli/latest/reference/deploy/batch-get-deployments.html). + 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 ne 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 il per trovarli. AWS CLI 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\_revisions nel file di configurazione CodeDeploy dell'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\_revisions** su un valore basso, ad esempio 1 o 2. La distribuzione successiva elimina le distribuzioni archiviate in modo che il numero sia uguale al numero specificato. + **deployment-instructions** contiene quattro file di testo per ogni gruppo di distribuzione: + **[Deployment Group ID] -cleanup**, un file di testo con una versione di 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] \_last\_successful\_install**, un file di testo che elenca la directory di archivio dell'ultima distribuzione riuscita. 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 script eseguire `ApplicationStop` e quali `BeforeInstall` script eseguire. Un esempio di file è `acde1916-9099-7caf-fd21-012345abcdef_last_successful_install`. + **[Deployment Group ID]\_most\_recent\_install**, 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. Il file [ID del gruppo di distribuzione] \_last\_successful\_install viene creato dopo questo file, quando 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 i contenuti dei file `scripts.log` 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 scriverci mentre elimina i vecchi contenuti.