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à.
# Gestione delle operazioni degli CodeDeploy agenti
Le istruzioni in questa sezione mostrano come installare, disinstallare, reinstallare o aggiornare l' CodeDeploy agente e come verificare che l' CodeDeploy agente sia in esecuzione.
**Topics**
+ [
# Verifica che l' CodeDeploy agente sia in esecuzione
](codedeploy-agent-operations-verify.md)
+ [
# Determina la versione dell' CodeDeploy agente
](codedeploy-agent-operations-version.md)
+ [
# Installa l' CodeDeploy agente
](codedeploy-agent-operations-install.md)
+ [
# Aggiorna l'agente CodeDeploy
](codedeploy-agent-operations-update.md)
+ [
# Disinstalla l'agente CodeDeploy
](codedeploy-agent-operations-uninstall.md)
+ [
# Invia i log degli CodeDeploy agenti a CloudWatch
](codedeploy-agent-operations-cloudwatch-agent.md)
# Verifica che l' CodeDeploy agente sia in esecuzione
Questa sezione descrive i comandi da eseguire se sospetti che l' CodeDeploy agente abbia smesso di funzionare su un'istanza.
**Topics**
+ [
## Verifica che l' CodeDeploy agente per Amazon Linux o RHEL sia in esecuzione
](#codedeploy-agent-operations-verify-linux)
+ [
## Verifica che l' CodeDeploy agente per Ubuntu Server sia in esecuzione
](#codedeploy-agent-operations-verify-ubuntu)
+ [
## Verifica che l' CodeDeploy agente per Windows Server sia in esecuzione
](#codedeploy-agent-operations-verify-windows)
## Verifica che l' CodeDeploy agente per Amazon Linux o RHEL sia in esecuzione
Per verificare se l' CodeDeploy agente è installato e in esecuzione, accedi all'istanza ed esegui il comando seguente:
```
systemctl status codedeploy-agent
```
Se il comando restituisce un errore, l' CodeDeploy agente non viene installato. Installarlo come descritto in [Installa l' CodeDeploy agente per Amazon Linux o RHEL](codedeploy-agent-operations-install-linux.md).
Se l' CodeDeploy agente è installato e in esecuzione, dovresti vedere un messaggio simile a`The AWS CodeDeploy agent is running`.
Se viene visualizzato un messaggio come `error: No AWS CodeDeploy agent running`, avvia il servizio ed esegui i seguenti due comandi, uno alla volta:
```
systemctl start codedeploy-agent
```
```
systemctl status codedeploy-agent
```
## Verifica che l' CodeDeploy agente per Ubuntu Server sia in esecuzione
Per verificare se l' CodeDeploy agente è installato e in esecuzione, accedi all'istanza ed esegui il comando seguente:
```
systemctl status codedeploy-agent
```
Se il comando restituisce un errore, l' CodeDeploy agente non viene installato. Installarlo come descritto in [Installa l' CodeDeploy agente per Ubuntu Server](codedeploy-agent-operations-install-ubuntu.md).
Se l' CodeDeploy agente è installato e in esecuzione, dovresti vedere un messaggio simile a`The AWS CodeDeploy agent is running`.
Se viene visualizzato un messaggio come `error: No AWS CodeDeploy agent running`, avvia il servizio ed esegui i seguenti due comandi, uno alla volta:
```
systemctl start codedeploy-agent
```
```
systemctl status codedeploy-agent
```
## Verifica che l' CodeDeploy agente per Windows Server sia in esecuzione
Per verificare se l' CodeDeploy agente è installato e in esecuzione, accedi all'istanza ed esegui il comando seguente:
```
powershell.exe -Command Get-Service -Name codedeployagent
```
Verrà visualizzato un output simile al seguente:
```
Status Name DisplayName
------ ---- -----------
Running codedeployagent CodeDeploy Host Agent Service
```
Se il comando restituisce un errore, l' CodeDeploy agente non viene installato. Installarlo come descritto in [Installa l' CodeDeploy agente per Windows Server](codedeploy-agent-operations-install-windows.md).
Se `Status` mostra un valore diverso da `Running`, avviare il servizio con il comando seguente:
```
powershell.exe -Command Start-Service -Name codedeployagent
```
È possibile riavviare il servizio con il comando seguente:
```
powershell.exe -Command Restart-Service -Name codedeployagent
```
È possibile arrestare il servizio con il comando seguente:
```
powershell.exe -Command Stop-Service -Name codedeployagent
```
# Determina la versione dell' CodeDeploy agente
Puoi determinare la versione dell' CodeDeploy agente in esecuzione sull'istanza in due modi.
Innanzitutto, a partire dalla versione 1.0.1.854 dell' CodeDeploy agente, è possibile visualizzare il numero di versione in un `.version` file sull'istanza. La tabella seguente mostra il percorso e la stringa di versione di esempio per ciascuno dei sistemi operativi supportati.
| Sistema operativo | Posizione del file | Stringa agent\$1version di esempio |
| --- | --- | --- |
| Amazon Linux e Red Hat Enterprise Linux (RHEL) | /opt/codedeploy-agent/.version | OFFICIAL\$11.0.1.854\$1rpm |
| Ubuntu Server | /opt/codedeploy-agent/.version | OFFICIAL\$11.0.1.854\$1deb |
| Windows Server | C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1.version | OFFICIAL\$11.0.1.854\$1msi |
In secondo luogo, è possibile eseguire un comando su un'istanza per individuare la versione dell'agente CodeDeploy.
**Topics**
+ [
## Determina la versione su Amazon Linux o RHEL
](#codedeploy-agent-operations-version-linux)
+ [
## Determina la versione su Ubuntu Server
](#codedeploy-agent-operations-version-ubuntu)
+ [
## Determina la versione su Windows Server
](#codedeploy-agent-operations-version-windows)
## Determina la versione su Amazon Linux o RHEL
Accedere all'istanza ed eseguire il comando seguente:
```
sudo yum info codedeploy-agent
```
## Determina la versione su Ubuntu Server
Accedere all'istanza ed eseguire il comando seguente:
```
sudo dpkg -s codedeploy-agent
```
## Determina la versione su Windows Server
Accedere all'istanza ed eseguire il comando seguente:
```
sc qdescription codedeployagent
```
# Installa l' CodeDeploy agente
Per utilizzarlo CodeDeploy su istanze EC2 o server locali, l' CodeDeploy agente deve essere prima installato. Consigliamo di installare e aggiornare l'agente con CodeDeploy . AWS Systems Manager Per ulteriori informazioni su Systems Manager, vedere [What is AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html). È possibile configurare l'installazione e gli aggiornamenti pianificati dell' CodeDeployagente con Systems Manager nella console quando si creano i gruppi di distribuzione.
Puoi anche installare l' CodeDeploy agente direttamente da un bucket S3 con la riga di comando.
Per la versione consigliata da installare, consulta. [Cronologia delle versioni dell'agente CodeDeploy](codedeploy-agent.md#codedeploy-agent-version-history)
**Topics**
+ [
# Installa l' CodeDeploy agente utilizzando AWS Systems Manager
](codedeploy-agent-operations-install-ssm.md)
+ [
# Installa l' CodeDeploy agente utilizzando la riga di comando
](codedeploy-agent-operations-install-cli.md)
# Installa l' CodeDeploy agente utilizzando AWS Systems Manager
Puoi usare Console di gestione AWS o il AWS CLI per installare l' CodeDeploy agente sulle tue istanze Amazon EC2 o locali utilizzando. AWS Systems ManagerÈ possibile scegliere di installare una versione specifica o di installare sempre la versione più recente dell'agente. [Per ulteriori informazioni su AWS Systems Manager, consulta What is. AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html)
L'utilizzo AWS Systems Manager è il metodo consigliato per l'installazione e l'aggiornamento dell' CodeDeploy agente. Puoi anche installare l' CodeDeploy agente da un bucket Amazon S3. Per informazioni sull'uso di un collegamento per il download di Amazon S3, consulta [Installa l' CodeDeploy agente utilizzando la riga di comando](codedeploy-agent-operations-install-cli.md).
**Topics**
+ [
## Prerequisiti
](#install-codedeploy-agent-prereqs)
+ [
## Installa l' CodeDeploy agente
](#download-codedeploy-agent-on-EC2-Instance)
## Prerequisiti
Segui i passaggi indicati [Guida introduttiva con CodeDeploy](getting-started-codedeploy.md) per configurare le autorizzazioni IAM e il. AWS CLI
Se si installa l' CodeDeploy agente su un server locale con Systems Manager, è necessario registrare il server locale con Amazon EC2 Systems Manager. Per ulteriori informazioni, vedere [Configurazione di Systems Manager in ambienti ibridi](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-managedinstances.html) nella *Guida AWS Systems Manager per l'utente*.
## Installa l' CodeDeploy agente
Prima di poter utilizzare Systems Manager per installare l' CodeDeploy agente, è necessario assicurarsi che l'istanza sia configurata correttamente per Systems Manager.
### Installazione o aggiornamento dell'agente SSM
Su un'istanza Amazon EC2, l' CodeDeploy agente richiede che l'istanza esegua la versione 2.3.274.0 o successiva. Prima di installare l' CodeDeploy agente, aggiorna o installa l'agente SSM sull'istanza, se non l'hai già fatto.
L'agente SSM è preinstallato su alcuni Amazon AMIs EC2 forniti da. AWS Per ulteriori informazioni, consulta [Amazon Machine Images (AMIs) con agente SSM preinstallato](https://docs.aws.amazon.com/systems-manager/latest/userguide/ami-preinstalled-agent.html).
**Nota**
Assicurati che anche il sistema operativo dell'istanza sia supportato dall' CodeDeployagente. Per ulteriori informazioni, consulta [Sistemi operativi supportati dall'agente CodeDeploy](codedeploy-agent.md#codedeploy-agent-supported-operating-systems).
*Per informazioni sull'installazione o l'aggiornamento dell'agente SSM su un'istanza che esegue Linux, consulta [Installazione e configurazione dell'agente SSM sulle istanze Linux](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-agent.html) nella Guida per l'utente.AWS Systems Manager *
*Per informazioni sull'installazione o l'aggiornamento dell'agente SSM su un'istanza che esegue Windows Server, consulta [Installazione e configurazione dell'agente SSM sulle](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-win.html) istanze Windows nella Guida per l'utente.AWS Systems Manager *
### (Facoltativo) Verifica dei prerequisiti di Systems Manager
Prima di utilizzare Systems Manager Run Command per installare l' CodeDeploy agente, verificate che le istanze soddisfino i requisiti minimi di Systems Manager. Per ulteriori informazioni, consulta [Setting up AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up.html) in *AWS Systems Manager User Guide*.
### Installa l'agente CodeDeploy
Con SSM, puoi installarlo CodeDeploy una sola volta o impostare una pianificazione per installare nuove versioni.
Per installare l' CodeDeploy agente, scegli il `AWSCodeDeployAgent` pacchetto mentre segui i passaggi in [Installare o aggiornare i pacchetti con il AWS Systems Manager distributore](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html).
# Installa l' CodeDeploy agente utilizzando la riga di comando
**Nota**
Si consiglia di installare l' CodeDeploy agente con AWS Systems Manager per poter configurare gli aggiornamenti pianificati dell'agente. Per ulteriori informazioni, consulta [Installa l' CodeDeploy agente utilizzando AWS Systems Manager](codedeploy-agent-operations-install-ssm.md).
Utilizza i seguenti argomenti per installare ed eseguire l' CodeDeploy agente tramite la riga di comando.
**Topics**
+ [
# Installa l' CodeDeploy agente per Amazon Linux o RHEL
](codedeploy-agent-operations-install-linux.md)
+ [
# Installa l' CodeDeploy agente per Ubuntu Server
](codedeploy-agent-operations-install-ubuntu.md)
+ [
# Installa l' CodeDeploy agente per Windows Server
](codedeploy-agent-operations-install-windows.md)
# Installa l' CodeDeploy agente per Amazon Linux o RHEL
Accedere all'istanza ed eseguire i comandi seguenti, uno alla volta. L'esecuzione `sudo yum update` iniziale del comando è considerata una procedura consigliata `yum` per l'installazione dei pacchetti, ma è possibile ignorarla se non si desidera aggiornare tutti i pacchetti.
```
sudo yum update
```
```
sudo yum install ruby
```
```
sudo yum install wget
```
(Facoltativo) Per pulire l'AMI da tutte le informazioni di memorizzazione nella cache degli agenti precedenti, esegui lo script seguente:
```
#!/bin/bash
CODEDEPLOY_BIN="/opt/codedeploy-agent/bin/codedeploy-agent"
$CODEDEPLOY_BIN stop
yum erase codedeploy-agent -y
```
Passa alla tua home directory:
```
cd /home/ec2-user
```
**Nota**
Nel comando precedente, `/home/ec2-user` rappresenta il nome utente predefinito per un'istanza Amazon Linux o RHEL Amazon EC2. Se l'istanza è stata creata utilizzando un'AMI personalizzata, il proprietario dell'AMI potrebbe avere specificato un nome utente predefinito diverso.
Scarica il programma di installazione dell' CodeDeploy agente:
```
wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install
```
*bucket-name*è il nome del bucket Amazon S3 che contiene i file CodeDeploy Resource Kit per la tua regione ed *region-identifier* è l'identificatore della tua regione.
Esempio:
`https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install`
Per un elenco dei nomi dei bucket e degli identificatori di regione, consulta. [Nomi dei bucket del Resource Kit per regione](resource-kit.md#resource-kit-bucket-names)
Imposta i permessi di esecuzione sul file: `install`
```
chmod +x ./install
```
Per installare la versione più recente dell' CodeDeploy agente:
+
```
sudo ./install auto
```
Per installare una versione specifica dell' CodeDeploy agente:
+ Elenca le versioni disponibili nella tua regione:
```
aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.rpm$'
```
+ Installa una delle versioni:
```
sudo ./install auto -v releases/codedeploy-agent-version.noarch.rpm
```
**Nota**
AWS supporta l'ultima versione secondaria dell' CodeDeploy agente. Attualmente l'ultima versione secondaria è la 1.7.x.
Per verificare che il servizio sia in esecuzione, eseguire il comando seguente:
```
systemctl status codedeploy-agent
```
Se l' CodeDeploy agente è installato e in esecuzione, dovresti vedere un messaggio del tipo. `The AWS CodeDeploy agent is running`
Se viene visualizzato un messaggio come `error: No AWS CodeDeploy agent running`, avvia il servizio ed esegui i seguenti due comandi, uno alla volta:
```
systemctl start codedeploy-agent
```
```
systemctl status codedeploy-agent
```
# Installa l' CodeDeploy agente per Ubuntu Server
**Nota**
Si consiglia di installare l' CodeDeploy agente con AWS Systems Manager per poter configurare gli aggiornamenti pianificati dell'agente. Per ulteriori informazioni, consulta [Installa l' CodeDeploy agente utilizzando AWS Systems Manager](codedeploy-agent-operations-install-ssm.md).
**Per installare l' CodeDeploy agente su Ubuntu Server**
1. Accedi all'istanza.
1. Inserisci i seguenti comandi, uno dopo l'altro:
```
sudo apt update
```
```
sudo apt install ruby-full
```
```
sudo apt install wget
```
1. Immetti il comando seguente:
```
cd /home/ubuntu
```
*/home/ubuntu*rappresenta il nome utente predefinito per un'istanza di Ubuntu Server. Se l'istanza è stata creata utilizzando un'AMI personalizzata, il proprietario dell'AMI potrebbe avere specificato un nome utente predefinito diverso.
1. Immetti il comando seguente:
```
wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install
```
*bucket-name*è il nome del bucket Amazon S3 che contiene i file CodeDeploy Resource Kit per la tua regione ed *region-identifier* è l'identificatore della tua regione.
Esempio:
`https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install`
Per un elenco dei nomi dei bucket e degli identificatori di regione, consulta. [Nomi dei bucket del Resource Kit per regione](resource-kit.md#resource-kit-bucket-names)
1. Immetti il comando seguente:
```
chmod +x ./install
```
1. Esegui una delle seguenti operazioni:
+ Per installare la versione più recente dell' CodeDeploy agente su qualsiasi versione supportata di Ubuntu Server *tranne* la 20.04:
```
sudo ./install auto
```
+ Per installare la versione più recente dell' CodeDeploy agente su Ubuntu Server 20.04:
**Nota**
La scrittura dell'output in un file di registro temporaneo è una soluzione alternativa che dovrebbe essere utilizzata mentre risolviamo un bug noto con lo `install` script su Ubuntu Server 20.04.
```
sudo ./install auto > /tmp/logfile
```
+ Per installare una versione specifica dell' CodeDeploy agente su qualsiasi versione supportata di Ubuntu Server *tranne* la 20.04:
+ Elenca le versioni disponibili nella tua regione:
```
aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$'
```
+ Installa una delle versioni:
```
sudo ./install auto -v releases/codedeploy-agent-###.deb
```
**Nota**
AWS supporta l'ultima versione secondaria dell' CodeDeploy agente. Attualmente l'ultima versione secondaria è la 1.7.x.
+ Per installare una versione specifica dell' CodeDeploy agente su Ubuntu Server 20.04:
+ Elenca le versioni disponibili nella tua regione:
```
aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$'
```
+ Installa una delle versioni:
```
sudo ./install auto -v releases/codedeploy-agent-###.deb > /tmp/logfile
```
**Nota**
La scrittura dell'output in un file di registro temporaneo è una soluzione alternativa che dovrebbe essere utilizzata mentre risolviamo un bug noto con lo `install` script su Ubuntu Server 20.04.
**Nota**
AWS supporta l'ultima versione secondaria dell' CodeDeploy agente. Attualmente l'ultima versione secondaria è la 1.7.x.
**Per verificare che il servizio sia in esecuzione**
1. Immetti il comando seguente:
```
systemctl status codedeploy-agent
```
Se l' CodeDeploy agente è installato e in esecuzione, dovresti vedere un messaggio simile a`The AWS CodeDeploy agent is running`.
1. Se viene visualizzato un messaggio come `error: No AWS CodeDeploy agent running`, avvia il servizio ed esegui i seguenti due comandi, uno alla volta:
```
systemctl start codedeploy-agent
```
```
systemctl status codedeploy-agent
```
# Installa l' CodeDeploy agente per Windows Server
Nelle istanze di Windows Server, puoi utilizzare uno di questi metodi per scaricare e installare l' CodeDeploy agente:
+ Utilizzo AWS Systems Manager (consigliato)
+ Esegui una serie di PowerShell comandi di Windows.
+ Selezionare un collegamento diretto per il download.
+ Esegui un comando di copia Amazon S3.
**Nota**
La cartella in cui è installato l' CodeDeploy agente è`C:\Program Data\Amazon\CodeDeploy`. Accertatevi che non vi siano giunzioni di directory o collegamenti simbolici su questo percorso.
**Topics**
+ [
## Utilizzo di Systems Manager
](#codedeploy-agent-operations-install-system-manager)
+ [
## Usa Windows PowerShell
](#codedeploy-agent-operations-install-windows-powershell)
+ [
## Uso di un collegamento diretto
](#codedeploy-agent-operations-install-windows-direct-link)
+ [
## Usa un comando di copia Amazon S3
](#codedeploy-agent-operations-install-windows-s3-copy)
## Utilizzo di Systems Manager
Segui le istruzioni riportate [Installa l' CodeDeploy agente utilizzando AWS Systems Manager](codedeploy-agent-operations-install-ssm.md) per installare l' CodeDeployagente.
## Usa Windows PowerShell
Accedi all'istanza ed esegui i seguenti comandi in Windows PowerShell:
1. Richiedere che tutti gli script e i file di configurazione scaricati da Internet siano firmati da un autore attendibile. Se viene richiesto di modificare la policy di esecuzione, digitare "**Y**".
```
Set-ExecutionPolicy RemoteSigned
```
1. Carica il AWS Tools for Windows PowerShell.
```
Import-Module AWSPowerShell
```
1. Crea una directory in cui scaricare il file di installazione dell' CodeDeploy agente.
```
New-Item -Path "c:\temp" -ItemType "directory" -Force
```
1. Configura AWS le credenziali utilizzando i `Initialize-AWSDefaultConfiguration` comandi `Set-AWSCredential` and. Per ulteriori informazioni, vedere [Utilizzo AWS delle credenziali](https://docs.aws.amazon.com/powershell/latest/userguide/specifying-your-aws-credentials.html) negli *AWS strumenti per la guida per PowerShell l'utente*.
1. Scaricate il file di installazione dell' CodeDeploy agente.
**Nota**
AWS supporta l'ultima versione secondaria dell' CodeDeploy agente. Attualmente l'ultima versione secondaria è la 1.7.x.
Per installare la versione più recente dell' CodeDeployagente:
+
```
powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent.msi -File c:\temp\codedeploy-agent.msi
```
Per installare una versione specifica dell' CodeDeployagente:
+
```
powershell.exe -Command Read-S3Object -BucketName bucket-name -Key releases/codedeploy-agent-###.msi -File c:\temp\codedeploy-agent.msi
```
*bucket-name*è il nome del bucket Amazon S3 che contiene i file CodeDeploy Resource Kit per la tua regione. Ad esempio, per la regione Stati Uniti orientali (Ohio), sostituisci con. *bucket-name* `aws-codedeploy-us-east-2` Per un elenco dei nomi dei bucket, vedi. [Nomi dei bucket del Resource Kit per regione](resource-kit.md#resource-kit-bucket-names)
1. Esegui il file di installazione dell' CodeDeploy agente.
```
c:\temp\codedeploy-agent.msi /quiet /l c:\temp\host-agent-install-log.txt
```
Per verificare che il servizio sia in esecuzione, eseguire il comando seguente:
```
powershell.exe -Command Get-Service -Name codedeployagent
```
Se l' CodeDeploy agente è stato appena installato e non è stato avviato, dopo aver eseguito il **Get-Service** comando, in **Stato**, dovresti vedere**Start...**:
```
Status Name DisplayName
------ ---- -----------
Start... codedeployagent CodeDeploy Host Agent Service
```
Se l' CodeDeploy agente è già in esecuzione, dopo aver eseguito il **Get-Service** comando, in **Status**, dovresti vedere**Running**:
```
Status Name DisplayName
------ ---- -----------
Running codedeployagent CodeDeploy Host Agent Service
```
## Uso di un collegamento diretto
Se le impostazioni di sicurezza del browser sull'istanza di Windows Server forniscono le autorizzazioni (ad esempio, per`https://s3.*.amazonaws.com`), puoi utilizzare un collegamento diretto alla tua regione per scaricare l' CodeDeploy agente ed eseguire il programma di installazione manualmente.
Il collegamento è:
```
https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent.msi
```
... *region* dov'è la AWS regione in cui stai distribuendo la tua applicazione.
Esempio:
```
https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent.msi
```
**Importante**
Ottieni il `.msi` file dalla stessa regione CodeDeploy dell'applicazione. La scelta di una regione diversa può causare `inconsistent region` errori nel `codedeploy-agent-log` file durante l'esecuzione del `.msi` file.
## Usa un comando di copia Amazon S3
Se AWS CLI è installato sull'istanza, puoi utilizzare il comando Amazon S3 [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) per scaricare l' CodeDeploy agente ed eseguire il programma di installazione manualmente. Per informazioni, consulta [Installare il AWS Command Line Interface su Microsoft Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html).
Il comando Amazon S3 è:
```
aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent.msi codedeploy-agent.msi --region region
```
... *region* dov'è la AWS regione in cui stai distribuendo la tua applicazione.
Esempio:
```
aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent.msi codedeploy-agent.msi --region af-south-1
```
# Aggiorna l'agente CodeDeploy
È possibile configurare gli aggiornamenti automatici e pianificati dell' CodeDeploy agente su tutti i sistemi operativi supportati utilizzando AWS Systems Manager. È inoltre possibile forzare gli aggiornamenti su tutti i sistemi operativi supportati mediante l'esecuzione di un comando su un'istanza.
**Topics**
+ [
# Aggiorna l' CodeDeploy agente su Amazon Linux o RHEL
](codedeploy-agent-operations-update-linux.md)
+ [
# Aggiorna l' CodeDeploy agente su Ubuntu Server
](codedeploy-agent-operations-update-ubuntu.md)
+ [
# Aggiorna l' CodeDeploy agente su Windows Server
](codedeploy-agent-operations-update-windows.md)
# Aggiorna l' CodeDeploy agente su Amazon Linux o RHEL
Per configurare gli aggiornamenti automatici e pianificati dell' CodeDeploy agente utilizzando AWS Systems Manager, segui la procedura descritta in [Installare l' CodeDeploy agente con AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html).
Se desideri forzare un aggiornamento dell' CodeDeploy agente, accedi all'istanza ed esegui il comando seguente:
```
sudo /opt/codedeploy-agent/bin/install auto
```
# Aggiorna l' CodeDeploy agente su Ubuntu Server
Per configurare gli aggiornamenti automatici e pianificati dell' CodeDeploy agente utilizzando AWS Systems Manager, segui la procedura descritta in [Installare l' CodeDeploy agente con AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html).
Se desideri forzare un aggiornamento dell' CodeDeploy agente, accedi all'istanza ed esegui il comando seguente:
```
sudo /opt/codedeploy-agent/bin/install auto
```
# Aggiorna l' CodeDeploy agente su Windows Server
È possibile abilitare gli aggiornamenti automatici dell' CodeDeploy agente con AWS Systems Manager. Con Systems Manager, puoi configurare una pianificazione di aggiornamento per le tue istanze Amazon EC2 o locali creando un'associazione con Systems Manager State Manager. Puoi anche aggiornare manualmente l' CodeDeploy agente disinstallando la versione corrente e installandone una più recente.
**Topics**
+ [
## Imposta l'aggiornamento automatico CodeDeploy dell'agente con AWS Systems Manager
](#codedeploy-agent-operations-update-windows-ssm)
+ [
## Aggiorna l' CodeDeploy agente manualmente
](#codedeploy-agent-operations-update-windows-manual)
+ [
## (Obsoleto) Aggiornate l' CodeDeploy agente con Windows Server Updater
](#codedeploy-agent-operations-update-windows-updater)
## Imposta l'aggiornamento automatico CodeDeploy dell'agente con AWS Systems Manager
Per configurare Systems Manager e abilitare gli aggiornamenti automatici dell' CodeDeploy agente, seguire le istruzioni riportate in [Installare l' CodeDeploy agente utilizzando AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html).
## Aggiorna l' CodeDeploy agente manualmente
Per aggiornare l' CodeDeploy agente manualmente, è possibile installare la versione più recente dalla CLI o utilizzando Systems Manager. Segui le istruzioni in [ Installare l'agente CodeDeploy.](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install.html) Si consiglia di disinstallare le versioni precedenti dell' CodeDeploy agente seguendo le istruzioni riportate in [Disinstallare l' CodeDeployagente](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-uninstall.html).
## (Obsoleto) Aggiornate l' CodeDeploy agente con Windows Server Updater
**Nota**
L' CodeDeploy agent updater per Windows Server è obsoleto e non verrà aggiornato a nessuna versione successiva alla 1.0.1.1597.
Per abilitare gli aggiornamenti automatici dell' CodeDeploy agente, installa l' CodeDeploy agent updater per Windows Server su istanze nuove o esistenti. La funzione di aggiornamento verifica periodicamente la disponibilità di nuove versioni. Quando rileva una nuova versione, disinstalla la versione corrente dell'agente, se presente, quindi installa la versione più recente.
Se quando la funzione di aggiornamento rileva una nuova versione è già in corso una distribuzione, questa continua fino al completamento. Se invece durante il processo di aggiornamento si avvia una distribuzione, questa non riesce.
Se desideri forzare l'aggiornamento dell' CodeDeploy agente, segui le istruzioni riportate in. [Installa l' CodeDeploy agente per Windows Server](codedeploy-agent-operations-install-windows.md)
Nelle istanze di Windows Server, puoi scaricare e installare l' CodeDeploy agent updater eseguendo PowerShell i comandi di Windows, utilizzando un link per il download diretto o eseguendo un comando di copia Amazon S3.
**Topics**
+ [
### Usa Windows PowerShell
](#codedeploy-agent-operations-update-windows-powershell)
+ [
### Uso di un collegamento diretto
](#codedeploy-agent-operations-update-windows-direct-link)
+ [
### Usa un comando di copia Amazon S3
](#codedeploy-agent-operations-update-windows-s3-copy)
### Usa Windows PowerShell
Accedi all'istanza ed esegui i seguenti comandi in Windows PowerShell, uno alla volta:
```
Set-ExecutionPolicy RemoteSigned
```
Se ti viene richiesto di modificare i criteri di esecuzione, scegli in **Y** modo che Windows PowerShell richieda che tutti gli script e i file di configurazione scaricati da Internet siano firmati da un editore attendibile.
```
Import-Module AWSPowerShell
```
```
New-Item -Path "c:\temp" -ItemType "directory" -Force
```
```
powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent-updater.msi -File c:\temp\codedeploy-agent-updater.msi
```
```
c:\temp\codedeploy-agent-updater.msi /quiet /l c:\temp\host-agent-updater-log.txt
```
```
powershell.exe -Command Get-Service -Name codedeployagent
```
*bucket-name*è il nome del bucket Amazon S3 che contiene i file CodeDeploy Resource Kit per la tua regione. Ad esempio, per la regione Stati Uniti orientali (Ohio), sostituisci con. *bucket-name* `aws-codedeploy-us-east-2` Per un elenco dei nomi dei bucket, vedi. [Nomi dei bucket del Resource Kit per regione](resource-kit.md#resource-kit-bucket-names)
Se è necessario risolvere un errore del processo di aggiornamento, digitare il comando seguente per aprire il file di registro dell' CodeDeploy agente di aggiornamento:
```
notepad C:\ProgramData\Amazon\CodeDeployUpdater\log\codedeploy-agent.updater.log
```
### Uso di un collegamento diretto
Se le impostazioni di sicurezza del browser sull'istanza di Windows Server forniscono le autorizzazioni richieste (ad esempio, per ` http://s3.*.amazonaws.com `), è possibile utilizzare un collegamento diretto per scaricare l'agente updater. CodeDeploy
Il collegamento è:
```
https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent-updater.msi
```
... *region* dov'è la AWS regione in cui stai aggiornando la tua applicazione.
Esempio:
```
https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent-updater.msi
```
### Usa un comando di copia Amazon S3
Se AWS CLI è installato sull'istanza, puoi utilizzare il comando Amazon S3 [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) per scaricare l' CodeDeploy agente di aggiornamento e quindi eseguire il programma di installazione manualmente. Per informazioni, consulta [Installare il AWS Command Line Interface su Microsoft Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html).
Il comando Amazon S3 è:
```
aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi --region region
```
... *region* dov'è la AWS regione in cui stai aggiornando la tua applicazione.
Esempio:
```
aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi --region af-south-1
```
# Disinstalla l'agente CodeDeploy
Puoi rimuovere l' CodeDeploy agente dalle istanze quando non è più necessario o quando desideri eseguire una nuova installazione.
## Disinstalla l' CodeDeploy agente da Amazon Linux o RHEL
Per disinstallare l' CodeDeploy agente, accedi all'istanza ed esegui il seguente comando:
```
sudo yum erase codedeploy-agent
```
## Disinstalla CodeDeploy l'agente da Ubuntu Server
Per disinstallare l' CodeDeploy agente, accedi all'istanza ed esegui il seguente comando:
```
sudo dpkg --purge codedeploy-agent
```
## Disinstalla CodeDeploy l'agente da Windows Server
Per disinstallare l' CodeDeploy agente, accedi all'istanza ed esegui i seguenti tre comandi, uno alla volta:
```
wmic
```
```
product where name="CodeDeploy Host Agent" call uninstall /nointeractive
```
```
exit
```
Puoi anche accedere all'istanza e, nel **Pannello di controllo**, aprire **Programmi e funzionalità**, scegliere **CodeDeploy Host Agent** e quindi scegliere **Disinstalla**.
# Invia i log degli CodeDeploy agenti a CloudWatch
Puoi inviare le metriche e i dati di registro dell' CodeDeploy agente CloudWatch utilizzando l'[ CloudWatch agente unificato](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/UseCloudWatchUnifiedAgent.html) o, più semplicemente, l'agente. CloudWatch
Utilizza le seguenti istruzioni per installare l' CloudWatch agente e configurarlo per l'uso con CodeDeploy gli agenti.
## Prerequisiti
Prima di iniziare, completa le seguenti attività:
+ Installa l' CodeDeploy agente e assicurati che sia in esecuzione. Per ulteriori informazioni, consultare [Installa l' CodeDeploy agente](codedeploy-agent-operations-install.md) e [Verifica che l' CodeDeploy agente sia in esecuzione](codedeploy-agent-operations-verify.md).
+ Installa l' CloudWatch agente. Per ulteriori informazioni, vedere [Installazione dell' CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html).
+ Aggiungi le seguenti autorizzazioni al profilo dell'istanza CodeDeploy IAM:
+ CloudWatchLogsFullAccess
+ CloudWatchAgentServerPolicy
Per ulteriori informazioni sul profilo dell' CodeDeploy istanza, consulta [Fase 4: crea un profilo di istanza IAM per le tue istanze Amazon EC2](getting-started-create-iam-instance-profile.md) di[Guida introduttiva con CodeDeploy](getting-started-codedeploy.md).
## Configurare l' CloudWatch agente per raccogliere i CodeDeploy log
È possibile configurare l' CloudWatch agente eseguendo una procedura guidata o creando o modificando manualmente un file di configurazione.
**Per configurare l' CloudWatch agente utilizzando la procedura guidata (Linux)**
1. Esegui la procedura guidata, come descritto in [Eseguire la procedura guidata di configurazione dell' CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard).
1. Nella procedura guidata, quando richiesto, inserisci. `Do you want to monitor any log files?` **1**
1. Specificate il file di registro CodeDeploy dell'agente, come segue:
1. Per `Log file path` inserire il percorso del file di CodeDeploy registro, ad esempio:**/var/log/aws/codedeploy-agent/codedeploy-agent.log**.
1. Per `Log group name` inserire il nome di un gruppo di log, ad esempio:**codedeploy-agent-log**.
1. Per `Log stream name` inserire il nome di un flusso di log, per esempio:**\$1instance\$1id\$1-codedeploy-agent-log**.
1. Quando richiesto`Do you want to specify any additional log files?`, inserisci**1**.
1. Specificate i registri di distribuzione degli CodeDeploy agenti, come segue:
1. Per `Log file path` inserire il percorso del file di registro di CodeDeploy distribuzione, ad esempio:**/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log**.
1. Per `Log group name` inserire il nome di un gruppo di log, ad esempio:**codedeploy-agent-deployment-log**.
1. Per `Log stream name` inserire il nome di un flusso di log, per esempio:**\$1instance\$1id\$1-codedeploy-agent-deployment-log**.
1. Quando richiesto`Do you want to specify any additional log files?`, inserisci**1**.
1. Specificate i registri CodeDeploy dell'agente di aggiornamento, come segue:
1. Per `Log file path` inserire il percorso del file di registro dell' CodeDeploy aggiornamento, ad esempio:. **/tmp/codedeploy-agent.update.log**
1. Per `Log group name` inserire il nome di un gruppo di log, ad esempio:**codedeploy-agent-updater-log**.
1. Per `Log stream name` inserire il nome di un flusso di log, per esempio:**\$1instance\$1id\$1-codedeploy-agent-updater-log**.
**Per configurare l' CloudWatch agente utilizzando la procedura guidata (Windows)**
1. Esegui la procedura guidata, come descritto in [Esecuzione della procedura guidata di configurazione dell' CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard).
1. Nella procedura guidata, quando richiesto, inserisci. `Do you want to monitor any customized log files?` **1**
1. Specificate il file di CodeDeploy registro nel modo seguente:
1. Per `Log file path` inserire il percorso o il file di registro CodeDeploy dell'agente, ad esempio:**C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1log\$1codedeploy-agent-log.txt**.
1. Per `Log group name` inserire il nome di un gruppo di log, ad esempio:**codedeploy-agent-log**.
1. Per `Log stream name` inserire il nome di un flusso di log, per esempio:**\$1instance\$1id\$1-codedeploy-agent-log**.
1. Quando richiesto`Do you want to specify any additional log files?`, inserisci**1**.
1. Specificate i registri di distribuzione degli CodeDeploy agenti, come segue:
1. Per `Log file path` inserire il percorso del file CodeDeploy di registro della distribuzione, ad esempio:**C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1deployment-logs\$1codedeploy-agent-deployments.log**.
1. Per `Log group name` inserire il nome di un gruppo di log, ad esempio:**codedeploy-agent-deployment-log**.
1. Per `Log stream name` inserire il nome di un flusso di log, per esempio:**\$1instance\$1id\$1-codedeploy-agent-deployment-log**.
**Per configurare l' CloudWatch agente creando o modificando manualmente un file di configurazione (Linux)**
1. Creare o modificare il file di configurazione dell' CloudWatch agente come descritto in [Creare o modificare manualmente il file di configurazione dell' CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html).
1. Assicuratevi che il file venga chiamato `/opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json` e che contenga il codice seguente:
```
...
"logs": {
"logs_collected": {
"files": {
"collect_list": [
{
"file_path": "/var/log/aws/codedeploy-agent/codedeploy-agent.log",
"log_group_name": "codedeploy-agent-log",
"log_stream_name": "{instance_id}-agent-log"
},
{
"file_path": "/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log",
"log_group_name": "codedeploy-agent-deployment-log",
"log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
},
{
"file_path": "/tmp/codedeploy-agent.update.log",
"log_group_name": "codedeploy-agent-updater-log",
"log_stream_name": "{instance_id}-codedeploy-agent-updater-log"
}
]
}
}
}
...
```
**Per configurare l' CloudWatch agente creando o modificando manualmente un file di configurazione (Windows)**
1. Creare o modificare il file di configurazione dell' CloudWatch agente come descritto in [Creare o modificare manualmente il file di configurazione dell' CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html).
1. Assicuratevi che il file venga chiamato `C:\ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.json` e che contenga il codice seguente:
```
...
"logs": {
"logs_collected": {
"files": {
"collect_list": [
{
"file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\log\\codedeploy-agent-log.txt",
"log_group_name": "codedeploy-agent-log",
"log_stream_name": "{instance_id}-codedeploy-agent-log"
},
{
"file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\deployment-logs\\codedeploy-agent-deployments.log",
"log_group_name": "codedeploy-agent-deployment-log",
"log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
}
]
},
...
}
},
...
```
## Riavviare l' CloudWatch agente
Dopo aver apportato le modifiche, riavvia l' CloudWatch agente come descritto in [Avvio dell' CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance-fleet.html#start-CloudWatch-Agent-EC2-fleet).