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.

La versione minima supportata dell' CodeDeploy agente è la 1.6.0.

Nota

L' CodeDeploy agente è necessario solo se si esegue la distribuzione su una piattaforma di elaborazione EC2/locale. 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

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
• Protocollo di comunicazione e porta per l'agente CodeDeploy
• Cronologia delle versioni dell'agente CodeDeploy
• Gestione del processo CodeDeploy
• Revisione dell'applicazione e pulizia dei file di registro
• File installati dall'agente CodeDeploy
• Gestione delle operazioni degli CodeDeploy agenti

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 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 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 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 tue istanze devono eseguire una versione supportata dell' CodeDeploy agente. La versione minima attualmente supportata è la 1.6.0.

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. Usa questa impostazione per disabilitare il fallback su IMDSv1 quando si verificano errori IMDSv2. L'impostazione predefinita è (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 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». 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 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. 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 sulle seguenti AMI Amazon EC2: Amazon Linux 2014.09, 2016.03, 2016.09 e 2017.03.
1.3.2	6 maggio 2021	Importante CodeDeploy l'agente 1.3.2 si rivolge a CVE-2018-1000201 che influisce sugli host Windows che eseguono l'agente. 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. In caso contrario, è 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 e endpoint VPC 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/locali). 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	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 per IMDSv2. Include un fallback silenzioso su IMDSv1 se le richieste http IMDSv2 falliscono. 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: è stato 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 FIPS. CodeDeploy Per ulteriori informazioni sugli endpoint FIPS, consulta la panoramica su FIPS 140-2. Per gli endpoint che possono essere utilizzati con CodeBuild, vedi regioni ed endpoint. CodeDeploy
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 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: è 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 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, 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 for 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 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à: 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

Per informazioni correlate, consulta quanto segue:

• Determina la versione dell' CodeDeployagente

• Installa l' CodeDeploy agente

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

  Puoi utilizzare il comando batch-get-deployments 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 o AWS CLI trovarli. Per ulteriori informazioni, consulta Visualizza i dettagliCodeDeploy di 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 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_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.