Collaborazione con l' CodeDeploy agente - AWS CodeDeploy
Sistemi operativi supportati dall'agente CodeDeploy Protocollo di comunicazione e porta per l'agente CodeDeploy Cronologia delle versioni dell'agente CodeDeployGestione del processo CodeDeploy Revisione dell'applicazione e pulizia dei file di registroFile installati dall'agente CodeDeploy

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

Nota

L' CodeDeploy agente è necessario solo se si esegue la distribuzione su una piattaforma di calcolo EC2 /On-Premises. L'agente non è necessario per le distribuzioni che utilizzano la piattaforma di calcolo Amazon o ECS 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 durante l'interazione 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

Per ulteriori informazioni sull'utilizzo dell' CodeDeploy agente, ad esempio sui passaggi per l'installazione, l'aggiornamento e la verifica delle versioni, vedereGestione delle operazioni degli CodeDeploy agenti.

Argomenti

Sistemi operativi supportati dall'agente CodeDeploy

Sistemi EC2 AMI operativi Amazon supportati

L' CodeDeploy agente è stato testato sui seguenti sistemi EC2 AMI operativi Amazon:

  • Amazon Linux 2023 (ARM, x86)

  • Amazon Linux 2 (ARMx86)

  • Microsoft Windows Server 2022, 2019

  • Red Hat Enterprise Linux (RHEL) 9.x, 8.x, 7.x

  • Ubuntu Server 22.04LTS, 20.04, 18.04, LTS 16.04 LTS LTS

L' CodeDeploy agente è disponibile come open source per consentirti di adattarlo alle tue esigenze. Può essere utilizzato con altri sistemi EC2 AMI operativi Amazon. Per ulteriori informazioni, vai al repository degli CodeDeploy agenti 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, 20.04 LTS 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 in GitHub.

Protocollo di comunicazione e porta per l'agente CodeDeploy

L' CodeDeploy agente comunica in uscita utilizzando la porta HTTPS 443.

Quando l' CodeDeploy agente viene eseguito su un'EC2istanza, utilizzerà l'endpoint di EC2metadati per recuperare le informazioni relative all'istanza. Ulteriori informazioni su come limitare e concedere l'accesso al servizio di metadati delle istanze.

Cronologia delle versioni dell'agente CodeDeploy

Le istanze devono eseguire una versione supportata dell' CodeDeploy agente. La versione minima attualmente supportata è la 1.7.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, consultaAggiorna l'agente CodeDeploy .

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

6 marzo 2024

Aggiunto: un'impostazione :disable_imds_v1: di configurazione al 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.

Aggiunto: Supporto per il sistema operativo Red Hat Enterprise Linux RHEL 9 (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.04LTS, 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».

Risolto: un problema con l'operazione di decompressione quando il disco era pieno. L' CodeDeploy agente ora rileva il codice di uscita 50 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 verrà interrotta 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.

Importante

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 EC2AMIs: Amazon Linux 2014.09, 2016.03, 2016.09 e 2017.03.

1.3.2

6 maggio 2021
Importante

CodeDeploy l'agente 1.3.2 indirizzi CVE -2018-1000201 che influisce sugli host Windows che eseguono l'agente. CVECita 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.

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 ed VPC endpoint per istanze Windows.

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

  • È ora possibile specificare un nome file personalizzato per il AppSpec file durante la creazione di una distribuzione locale. Per ulteriori informazioni, consulta Crea una distribuzione locale.

  • Il AppSpec file può ora avere un'.yamlestensione.

  • È 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 distribuzioni EC2 /On-Premises).

Aggiornato: CodeDeploy ora utilizza la versione 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
Importante

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 for Ruby dipendenza aggiornata dalla v2 alla v3.

Aggiunto: Support perIMDSv2. 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 PID file vuoto restituisca lo stato di No CodeDeploy Agent Running e pulisca il PID file 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 la zona AWS locale a Los Angeles (LA).

Aggiunto: estrai AZ dai metadati dell'istanza per fornire 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.

1.0.1.1597

15 novembre 2018

Miglioramento: CodeDeploy supporta Ubuntu 18.04.

Miglioramento: supporta Ruby 2.5. CodeDeploy

Miglioramento: supporta gli endpoint. CodeDeploy FIPS Per ulteriori informazioni sugli FIPS endpoint, vedere la panoramica 140-2. FIPS Per gli endpoint che possono essere utilizzati con CodeBuild, consulta CodeDeployregioni 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 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 del sistema locale CLI 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 /On-Premises 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: l' CodeDeploy agente è stato reso compatibile con la versione 2.9.2 di (2.9.2). AWS SDK for 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: 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 for 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 e Ubuntu Server è stato aggiornato con la seguente modifica. RHEL 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 e Ubuntu Server è stato aggiornato con le seguenti modifiche. RHEL 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: supporto fisso per specificare il numero di revisioni dell'applicazione che l' CodeDeployagente deve archiviare per un gruppo di distribuzione.

Miglioramento: l' CodeDeploy agente è stato reso compatibile con la versione 2.3 della (2.3). AWS SDK for Ruby aws-sdk-core

Miglioramento: sono stati risolti i problemi relativi alla 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à: è stato introdotto il supporto per specificare il numero di revisioni dell'applicazione che l' CodeDeployagente deve 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 for 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à: è stato introdotto il supporto per l'algoritmo SHA hash -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

Per informazioni correlate, consulta quanto segue:

Per una cronologia delle versioni degli CodeDeploy agenti, consulta l'archivio Release su. GitHub

Gestione del processo CodeDeploy

Tutte le distribuzioni Linux dell' CodeDeploy agente (rpm e deb) utilizzano systemd 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 comesudo 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'systemctlutilità per tutte le operazioni dell'agente anziché utilizzare il service comando.

Ad esempio, per riavviare l' CodeDeploy agente, utilizzare il comando equivalente con l'serviceutilità 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_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 conserva le cinque revisioni più recenti oltre alla revisione attualmente distribuita.

CodeDeploy log: per Amazon Linux, Ubuntu Server e RHEL le istanze, 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 RHEL istanze.

'C:\ProgramData\Amazon\CodeDeploy'per istanze di Windows Server.

È possibile utilizzare l'impostazione root_dir 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.

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 batch-get-deploymentscomando per trovare un ID del 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 AppSpec file di distribuzione.

    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 o AWS CLI trovarli. Per ulteriori informazioni, consulta Visualizza i dettagli CodeDeploy della distribuzione .

    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 dell' CodeDeploy agente per modificare l'impostazione predefinita. Per ulteriori informazioni, consulta CodeDeploy riferimento alla configurazione dell'agente.

    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 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 JSON file 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_successfull_install, 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]_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. Dopo questo file, viene creato il file [deployment group ID]_last_successfull_install 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.