Lavorare con l' CodeDeploy agente

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 supportatisource, consulta. AppSpec sezione 'file' (solo EC2/On-Premises distribuzioni)

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

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 disponibilecodedeploy-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'agentesystemctl.

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.

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.

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.

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».

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 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.

1.3.2

06 maggio 2021

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.

Aggiunto: miglioramenti ai AppSpec file, come descritto di seguito.

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

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

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. Per gli endpoint che possono essere utilizzati con CodeBuild, vedi CodeDeploy Regioni ed endpoint.

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.

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.

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

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.

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.

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.

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.

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.

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.

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.

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.

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.