View a markdown version of this page

CodeDeploy riferimento alla configurazione dell'agente - AWS 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à.

CodeDeploy riferimento alla configurazione dell'agente

Quando l' CodeDeploy agente è installato, sull'istanza viene inserito un file di configurazione. Questo file di configurazione specifica i percorsi delle directory e altre impostazioni CodeDeploy da utilizzare quando interagisce con l'istanza. Puoi modificare alcune delle opzioni di configurazione nel file.

Per le istanze Amazon Linux, Ubuntu Server e Red Hat Enterprise Linux (RHEL), il file di configurazione è denominato. codedeployagent.yml È collocato nella directory /etc/codedeploy-agent/conf.

Per le istanze di Windows Server, il file di configurazione è denominato. conf.yml È collocato nella directory C:\ProgramData\Amazon\CodeDeploy.

Le impostazioni di configurazione includono:

:log_aws_wire:

Impostato su true affinché l' CodeDeploy agente acquisisca i wire log da Amazon S3 e li scriva in un file di registro nella posizione indicata dall'impostazione:log_dir:.

Per la versione 2.0.x e successive, il nome del file è (creato con le autorizzazioni 0640). codedeploy-agent.aws_wire.log

Per la versione 1.8.x e precedenti, il nome del file è. codedeploy-agent.wire.log

avvertimento

È necessario impostare :log_aws_wire: a true solo per la quantità di tempo necessaria per acquisire log in rete. Il file di registro del cavo può crescere rapidamente fino a dimensioni molto grandi. L'output del wire log potrebbe contenere informazioni riservate, incluso il contenuto in testo normale dei file trasferiti da o verso Amazon S3 mentre questa impostazione era impostata su. true I wire log contengono informazioni su tutte le attività di Amazon S3 associate all' AWS account mentre questa impostazione era impostatatrue, non solo sulle attività relative alle distribuzioni. CodeDeploy

L'impostazione predefinita è false.

Questa impostazione vale per tutti i tipi di istanza. È necessario aggiungere questa impostazione di configurazione alle istanze di Windows Server per poterla utilizzare.

:log_dir:

La cartella sull'istanza in cui sono archiviati i file di registro relativi alle operazioni CodeDeploy dell'agente.

L'impostazione predefinita è '/var/log/aws/codedeploy-agent' per le istanze Amazon Linux, Ubuntu Server e RHEL e C:\ProgramData\Amazon\CodeDeploy\log per le istanze Windows Server.

:pid_dir:

La cartella in cui viene archiviato codedeploy-agent.pid.

Questo file contiene l'ID di processo (PID) dell'agente. CodeDeploy L'impostazione predefinita è '/opt/codedeploy-agent/state/.pid'.

Questa impostazione si applica solo alle istanze Amazon Linux, Ubuntu Server e RHEL.

:program_name:

Il nome del programma CodeDeploy agente.

L'impostazione predefinita è codedeploy-agent.

Questa impostazione si applica solo alle istanze Amazon Linux, Ubuntu Server e RHEL.

:root_dir:

La cartella in cui vengono archiviate le revisioni correlate, la cronologia di distribuzione e gli script di distribuzione sull'istanza.

L'impostazione predefinita è /opt/codedeploy-agent/deployment-root per le istanze Amazon Linux, Ubuntu Server e RHEL e C:\ProgramData\Amazon\CodeDeploy per le istanze Windows Server.

:verbose:

Impostata su true per consentire all' CodeDeploy agente di stampare i file di registro dei messaggi di debug sull'istanza.

L'impostazione predefinita è false.

:wait_between_runs:

L'intervallo, in secondi, tra il polling da parte CodeDeploy dell'agente CodeDeploy per le distribuzioni in sospeso.

Per la versione 2.0.x e successive, l'impostazione predefinita è. 30

Per la versione 1.8.x e precedenti, l'impostazione predefinita è. 1

:on_premises_config_file:

Per le istanze locali, il percorso di una posizione alternativa per il file di configurazione denominato codedeploy.onpremises.yml (per Ubuntu Server e RHEL) o conf.onpremises.yml (per Windows Server).

Per impostazione predefinita, questi file sono archiviati in/etc/codedeploy-agent/conf/codedeploy.onpremises.ymlper Ubuntu Server e RHEL eC:\ProgramData\Amazon\CodeDeploy\ per Windows Server. conf.onpremises.yml

Polling dell'agente disponibile nella versione 1.0.1.686 e versioni successive dell'agente CodeDeploy.

:proxy_uri:

(Facoltativo) Il proxy HTTP tramite il quale desideri che l' CodeDeploy agente si connetta AWS per CodeDeploy le tue operazioni. Utilizza un formato simile a https://user:password@my.proxy:443/path?query.

Polling dell'agente disponibile nella versione 1.0.1.824 e versioni successive dell'agente CodeDeploy.

:max_revisions:

(Facoltativo) Il numero di revisioni dell'applicazione per un gruppo di distribuzione che si desidera archiviare dall' CodeDeploy agente. Qualsiasi revisione che supera il numero specificato viene eliminata.

Inserire qualsiasi numero intero positivo. Se non viene specificato alcun valore, CodeDeploy conserverà le cinque revisioni più recenti oltre alla revisione attualmente distribuita.

Supportate nella versione 1.0.1.966 e versioni successive dell'agente CodeDeploy.

Se non viene specificato alcun valore, conserverà le cinque revisioni più recenti oltre alla revisione attualmente distribuita. ----sep----:enable_auth_policy:

(Facoltativo) Impostato su true se si desidera utilizzare l'autorizzazione IAM per configurare il controllo degli accessi e limitare le autorizzazioni del ruolo o dell'utente IAM utilizzato dall'agente. CodeDeploy PerUtilizzo CodeDeploy con Amazon Virtual Private Cloud, questo valore deve esseretrue.

L'impostazione predefinita è false.

Per, questo valore deve essere. ----sep----:disable_imds_v1:

Questa impostazione è disponibile con l'agente 1.7.0 e versioni successive. CodeDeploy

Impostata per true disabilitare il fallback su IMDSv1 quando si verificano errori IMDSv2. Il valore predefinito è (abilita il fallback). false

Il valore predefinito è (abilita il fallback). ----sep----:disable_core_dumps:

Per la versione 2.0.x e successive.

Impostato su per eliminare true i core dump. Impostato false per le indagini sugli incidenti.

L'impostazione predefinita è true.

Impostato su per l'indagine sugli arresti anomali. ----sep----:enable_command_port:

Per la versione 2.0.x e successive.

Impostato su per true abilitare l'interfaccia di gestione locale solo per il loopback (127.0.0.1) per interrogare lo stato dell'agente e inserire comandi localmente.

L'impostazione predefinita è false.

Impostato su per abilitare l'interfaccia di gestione locale solo loopback (127.0.0.1) per interrogare lo stato dell'agente e inserire comandi localmente. ----sep----:enable_archive_reuse:

Per la versione 2.1.0 e successive.

Impostato su false per scaricare sempre la revisione dell'applicazione, anche in una RESTART distribuzione in cui la revisione è già presente nell'istanza. Se questa impostazione è impostatatrue, l'agente installa dalla copia già presente sull'istanza e scarica la revisione se tale copia è mancante o incompleta.

L'impostazione predefinita è true.

Per ulteriori informazioni su questo comportamento, vedere. Cronologia delle versioni dell'agente CodeDeploy

Per ulteriori informazioni su questo comportamento, vedere. ----sep----:reject_symlinks_in_bundle:

Per la versione 2.0.x e successive.

Impostato su per true rifiutare i pacchetti che contengono collegamenti simbolici o hardlink.

L'impostazione predefinita è false.

Impostato su per rifiutare i pacchetti che contengono collegamenti simbolici o hardlink. ----sep----:reject_path_traversal_in_bundle:

Per la versione 2.0.x e successive.

Impostato su per true rifiutare le voci di archivio che contengono percorsi di attraversamento del ../ percorso o percorsi assoluti e i campi di AppSpec origine che sfuggono alla radice del pacchetto.

L'impostazione predefinita è false.

Impostato su per rifiutare le voci di archivio che contengono percorsi di attraversamento del percorso o percorsi assoluti e i campi di origine che sfuggono alla radice del bundle. ----sep----:reject_unsafe_permissions_in_bundle:

Per la versione 2.0.x e successive.

Impostato su true per rifiutare i pacchetti che contengono SUID/SGID file o modalità di AppSpec autorizzazione impostate. SUID/SGID

L'impostazione predefinita è false.

Impostato su per rifiutare i bundle che contengono file o modalità di autorizzazione impostate. ----sep----:reject_unconfined_selinux_in_bundle:

Per la versione 2.0.x e successive.

Impostato su per true rifiutare i pacchetti che contengono file con tipi SELinux. MAC-disabling

L'impostazione predefinita è false.

Impostato per rifiutare i pacchetti che contengono file con tipi SELinux. ----sep----:reject_symlink_permission_targets:

Per la versione 2.0.x e successive.

Impostato su true per rifiutare una permissions voce di AppSpec file la cui destinazione è un collegamento simbolico. Per impostazione predefinita, l'agente segue il collegamento quando applica le modifiche alla proprietà, alla modalità, all'ACL e a SELinux.

L'impostazione predefinita è false.

Per impostazione predefinita, l'agente segue il collegamento quando applica le modifiche alla proprietà, alla modalità, all'ACL e a SELinux. ----sep----:ignore_ownership_in_bundle:

Per la versione 2.0.x e successive.

Imposta su true per reimpostare la proprietà dei file estratti tar e dei tgz pacchetti root invece di applicare l'ID utente e l'ID di gruppo registrati nell'archivio. I file nei zip pacchetti sono di proprietà di root indipendentemente da questa impostazione.

L'impostazione predefinita è false.

I file nei pacchetti sono di proprietà di indipendentemente da questa impostazione. ----sep----:restrict_agent_dir_permissions:

Per la versione 2.0.x e successive. Solo istanze Linux.

Impostato su true per limitare l'accesso solo a root alle directory e ai file contenuti nella directory root di installazione dell'agente anziché alle modalità leggibili da tutti utilizzate per impostazione predefinita.

L'impostazione predefinita è false.

Impostato su per limitare le directory e i file nella directory root di installazione dell'agente all'accesso solo root anziché alle modalità leggibili da tutto il mondo utilizzate per impostazione predefinita. ----sep----:restrict_log_dir_permissions:

Per la versione 2.0.x e successive. Solo istanze Linux.

Impostato su true per limitare la directory del log dell'agente, che contiene il log dell'agente e il log dell'updater, all'accesso solo come root anziché alle modalità leggibili a livello mondiale utilizzate per impostazione predefinita.

L'impostazione predefinita è false.

Impostato su per limitare la directory del registro dell'agente, che contiene il log dell'agente e il registro di aggiornamento, all'accesso solo root anziché alle modalità leggibili da tutto il mondo utilizzate per impostazione predefinita. ----sep----:restrict_hook_env_to_allowlist:

Per la versione 2.0.x e successive.

Impostato per true eseguire gli hook degli eventi del ciclo di vita con un ambiente minimo che contenga solo le variabili di shell di base e le variabili di distribuzione. CodeDeploy Per impostazione predefinita, gli hook ereditano l'intero ambiente del processo agente.

L'impostazione predefinita è false.

Per impostazione predefinita, gli hook ereditano l'ambiente completo del processo agente. ----sep----:strip_loader_env_in_hooks:

Per la versione 2.0.x e successive. Solo istanze Linux.

Impostato su true per rimuovere le LD_AUDIT variabili LD_PRELOADLD_LIBRARY_PATH, e dall'ambiente degli hook degli eventi del ciclo di vita.

L'impostazione predefinita è false.

Impostare su per rimuovere le variabili, e dall'ambiente degli hook degli eventi del ciclo di vita. ----sep----:disable_powershell_profile_in_hooks:

Per la versione 2.0.x e successive. Solo istanze di Windows Server.

Impostato per true eseguire gli hook degli eventi .ps1 del ciclo di vita con le opzioni and. -NoProfile -NonInteractive Per impostazione predefinita, questi hook caricano il PowerShell profilo dell'utente con cui viene eseguito l'agente.

L'impostazione predefinita è false.

Per impostazione predefinita, questi hook caricano il profilo dell'utente con cui viene eseguito l'agente. ----sep----:archive_max_extraction_size:

Per la versione 2.0.x e successive.

Imposta un limite alla dimensione dichiarata del pacchetto non compresso. Se il contenuto estratto supera questo valore, la distribuzione ha esito negativo.

L'impostazione predefinita è no cap (unlimited).

L'impostazione predefinita è no cap (unlimited). ----sep----:wait_after_error:

Il numero di secondi in cui l'agente attende dopo aver riscontrato un errore prima di riprendere il normale funzionamento.

L'impostazione predefinita è 30.

Il numero di secondi di attesa dell'agente dopo aver riscontrato un errore prima di riprendere il normale funzionamento. ----sep----:http_read_timeout:

Il timeout di lettura HTTP in secondi per le chiamate all'API del servizio.

L'impostazione predefinita è 80.

Il timeout di lettura HTTP in secondi per le chiamate all'API del servizio. ----sep----:kill_agent_max_wait_time_seconds:

Il numero massimo di secondi in cui l'agente attende un arresto regolare prima di procedere all'interruzione forzata. Per la versione 2.0.x e successive, questo valore è limitato a 24 ore (86400 secondi).

L'impostazione predefinita è 7200 (2 ore).

L'impostazione predefinita è (2 ore). ----sep----:enable_deployments_log:

Impostato su per scrivere il log aggregato delle distribuzioni ()true. codedeploy-agent-deployments.log

L'impostazione predefinita è true.

Impostare su per scrivere il log aggregato delle distribuzioni (). ----sep----:use_fips_mode:

Impostato per utilizzare gli endpoint. true FIPS-compliant Si applica solo alle regioni degli Stati Uniti.

L'impostazione predefinita è false.

Si applica solo alle regioni degli Stati Uniti. ----sep----:deploy_control_endpoint:

(Facoltativo) Un URL endpoint del piano di controllo personalizzato per il servizio. CodeDeploy

L'impostazione predefinita è nessuna sostituzione (l'agente risolve l'endpoint dalla regione).

L'impostazione predefinita è nessun override (l'agente risolve l'endpoint dalla regione). ----sep----:s3_endpoint_override:

(Facoltativo) Un URL endpoint Amazon S3 personalizzato per il download dei pacchetti.

L'impostazione predefinita è nessun override (l'agente risolve l'endpoint Amazon S3 dalla regione).

L'impostazione predefinita è no override (l'agente risolve l'endpoint Amazon S3 dalla regione). ----sep----:ongoing_deployment_tracking:

Il nome della sottodirectory utilizzata per lo stato di tracciamento della distribuzione.

L'impostazione predefinita è ongoing-deployment.

Lavorare con l' CodeDeploy agente

Gestione delle operazioni degli CodeDeploy agenti