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à.
# 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
```