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à.
# Utilizzo AWS CodeBuild con un server proxy
È possibile utilizzarlo AWS CodeBuild con un server proxy per regolare il traffico HTTP e HTTPS da e verso Internet. Per funzionare CodeBuild con un server proxy, installi un server proxy in una sottorete pubblica e CodeBuild in una sottorete privata in un VPC.
Esistono due casi d'uso principali per l'esecuzione CodeBuild in un server proxy:
+ Elimina la necessità di utilizzare un gateway NAT o un'istanza NAT nel VPC.
+ Consente di specificare a quali istanze del server proxy possono accedere e URLs a quali il server proxy nega l'accesso. URLs
È possibile utilizzarlo CodeBuild con due tipi di server proxy. Per entrambi, il server proxy viene eseguito in una sottorete pubblica e CodeBuild in una sottorete privata.
+ **Proxy esplicito**: se si utilizza un server proxy esplicito, è necessario configurare `NO_PROXY` e inserire le variabili di `HTTPS_PROXY` ambiente a CodeBuild livello di progetto. `HTTP_PROXY` Per ulteriori informazioni, consultare [Modifica le impostazioni del progetto di compilazione in AWS CodeBuild](change-project.md) e [Crea un progetto di compilazione in AWS CodeBuild](create-project.md).
+ **Proxy trasparente**: se utilizzi un server proxy trasparente, non è richiesta alcuna configurazione speciale.
**Topics**
+ [Configura i componenti necessari per l'esecuzione CodeBuild in un server proxy](use-proxy-server-transparent-components.md)
+ [Esegui CodeBuild in un server proxy esplicito](run-codebuild-in-explicit-proxy-server.md)
+ [Esegui CodeBuild in un server proxy trasparente](run-codebuild-in-transparent-proxy-server.md)
+ [Esegui un programma di gestione dei pacchetti e di altri strumenti in un server proxy](use-proxy-server-tools.md)
# Configura i componenti necessari per l'esecuzione CodeBuild in un server proxy
Sono necessari questi componenti per l'esecuzione AWS CodeBuild in un server proxy trasparente o esplicito:
+ Un VPC.
+ Una sottorete pubblica nel VPC per il server proxy.
+ Una sottorete privata nel VPC per CodeBuild.
+ Un gateway Internet che consente la comunicazione tra il VPC e Internet.
Il diagramma riportato di seguito illustra l'interazione tra i componenti.
![\[Il diagramma mostra come interagiscono i componenti.\]](http://docs.aws.amazon.com/it_it/codebuild/latest/userguide/images/codebuild-proxy-transparent.png)
## Configura un VPC, sottoreti e un gateway di rete
I seguenti passaggi sono necessari per l'esecuzione AWS CodeBuild in un server proxy trasparente o esplicito.
1. Crea un VPC. Per informazioni, consulta [Creazione di un VPC](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html#Create-VPC) nella *Guida per l'utente di Amazon VPC*.
1. Crea due sottoreti nel VPC. Una è una sottorete pubblica denominata `Public Subnet` in cui viene eseguito il server proxy. L'altra è una sottorete privata denominata `Private Subnet` in cui CodeBuild viene eseguito.
Per ulteriori informazioni, consulta [Creazione di una sottorete nel VPC](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html#AddaSubnet).
1. Crea e collega un gateway Internet al VPC. Per ulteriori informazioni, consulta l'argomento relativo alla [creazione e all'associazione di un gateway Internet](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Internet_Gateway.html#Add_IGW_Attach_Gateway).
1. Aggiungi una regola alla tabella di routing predefinita che instrada il traffico in uscita dal VPC (0.0.0.0/0) al gateway Internet. Per ulteriori informazioni, consulta [Aggiunta e rimozione di route da una tabella di routing](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Route_Tables.html#AddRemoveRoutes).
1. Aggiungi una regola al gruppo di sicurezza predefinito del VPC che consente l'ingresso del traffico SSH (TCP 22) proveniente dal VPC (0.0.0.0/0).
1. Segui le istruzioni in [Avvio di un'istanza utilizzando la procedura guidata di avvio dell'istanza](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/launching-instance.html) nella Guida per l'*utente di Amazon EC2* per avviare un'istanza Amazon Linux. Durante la procedura guidata, scegli le seguenti opzioni:
+ In **Scegli un tipo di istanza**, scegli un'Amazon Linux Amazon Machine Image (AMI).
+ In **Subnet (Sottorete)**, scegli la sottorete pubblica precedentemente creata in questo argomento. Se è stato utilizzato il nome suggerito, è **Public Subnet (Sottorete pubblica)**.
+ In **Auto-assign Public IP (Assegna automaticamente IP pubblico)**, scegli **Enable (Abilita)**.
+ Nella pagina **Configure Security Group (Configura il gruppo di sicurezza)**, in **Assign a security group (Assegna un gruppo di sicurezza)**, scegli **Select an existing security group (Seleziona un gruppo di sicurezza esistente)**. A questo punto, seleziona il gruppo di sicurezza predefinito.
+ Dopo aver selezionato **Launch (Avvia)**, scegli una coppia di chiavi esistente o creane una.
Seleziona le impostazioni predefinite per tutte le altre opzioni.
1. Dopo l'esecuzione dell'istanza EC2, disabilita source/destination i controlli. Per informazioni, consulta la sezione [Disabling Source/Destination check](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_NAT_Instance.html#EIP_Disable_SrcDestCheck) nella *Amazon VPC* User Guide.
1. Crea una tabella di routing nel VPC. Aggiungi alla tabella di routing una regola che consente di instradare il traffico destinato a Internet al server proxy. Associa la tabella di routing alla sottorete privata. Ciò è necessario affinché le richieste in uscita dalle istanze della sottorete privata, dove vengono CodeBuild eseguite, vengano sempre instradate attraverso il server proxy.
## Installa e configura un server proxy
Esistono vari server proxy tra cui scegliere. Qui viene utilizzato un server proxy open source, Squid, per dimostrare come funziona AWS CodeBuild in un server proxy. Gli stessi concetti sono applicabili ad altri server proxy.
Per installare Squid, utilizza un repository yum eseguendo i seguenti comandi:
```
sudo yum update -y
sudo yum install -y squid
```
Dopo aver installato Squid, modifica il `squid.conf` utilizzando le istruzioni riportate più avanti in questo argomento.
## Configura Squid per il traffico HTTPS
Per HTTPS, il traffico HTTP viene incapsulato in una connessione Transport Layer Security (TLS). Squid utilizza una funzionalità chiamata [SslPeekAndSplice](https://wiki.squid-cache.org/Features/SslPeekAndSplice)a recuperare l'indicazione del nome del server (SNI) dall'iniziazione TLS che contiene l'host Internet richiesto. In questo modo, Squid non è obbligato a decrittografare il traffico HTTPS. Per abilitarlo SslPeekAndSplice, Squid richiede un certificato. Crea il certificato utilizzando OpenSSL:
```
sudo mkdir /etc/squid/ssl
cd /etc/squid/ssl
sudo openssl genrsa -out squid.key 2048
sudo openssl req -new -key squid.key -out squid.csr -subj "/C=XX/ST=XX/L=squid/O=squid/CN=squid"
sudo openssl x509 -req -days 3650 -in squid.csr -signkey squid.key -out squid.crt
sudo cat squid.key squid.crt | sudo tee squid.pem
```
**Nota**
Per HTTP, la configurazione di Squid non è richiesta. Da tutti i messaggi di richiesta HTTP/1.1 è possibile recuperare il campo dell'intestazione dell'host, che indica l'host Internet richiesto.
# Esegui CodeBuild in un server proxy esplicito
Per l'esecuzione AWS CodeBuild in un server proxy esplicito, è necessario configurare il server proxy per consentire o negare il traffico da e verso siti esterni, quindi configurare le `HTTP_PROXY` variabili e di ambiente. `HTTPS_PROXY`
**Topics**
+ [Configura Squid come server proxy esplicito](#use-proxy-server-explicit-squid-configure)
+ [Crea un progetto CodeBuild](#use-proxy-server-explicit-create-acb-project)
+ [Esempio di file `squid.conf` del server proxy esplicito](#use-proxy-server-explicit-sample-squid-conf)
## Configura Squid come server proxy esplicito
Per configurare il server proxy Squid in modo che sia esplicito, devi apportare al file `/etc/squid/squid.conf` le seguenti modifiche:
+ Rimuovi le seguenti regole della lista di controllo accessi (ACL) predefinita.
```
acl localnet src 10.0.0.0/8
acl localnet src 172.16.0.0/12
acl localnet src 192.168.0.0/16
acl localnet src fc00::/7
acl localnet src fe80::/10
```
Sostituisci le regole ACL predefinite rimosse con quelle riportate di seguito. La prima riga consente le richieste dal VPC. Le due righe successive garantiscono al server proxy l'accesso alla destinazione URLs che potrebbe essere utilizzata da. AWS CodeBuild Modifica l'espressione regolare nell'ultima riga per specificare i bucket S3 o un CodeCommit repository in una regione. AWS Esempio:
+ Se la tua fonte è Amazon S3, usa il comando **acl download\$1src dstdom\$1regex .\$1s3\$1.us-west-1\$1.amazonaws\$1.com** per concedere l'accesso ai bucket S3 nella regione. `us-west-1`
+ Se la tua fonte è AWS CodeCommit, usa `git-codecommit..amazonaws.com` per aggiungere una AWS regione a un elenco consentito.
```
acl localnet src 10.1.0.0/16 #Only allow requests from within the VPC
acl allowed_sites dstdomain .github.com #Allows to download source from GitHub
acl allowed_sites dstdomain .bitbucket.com #Allows to download source from Bitbucket
acl download_src dstdom_regex .*\.amazonaws\.com #Allows to download source from Amazon S3 or CodeCommit
```
+ Sostituisci `http_access allow localnet` con i seguenti:
```
http_access allow localnet allowed_sites
http_access allow localnet download_src
```
+ Se desideri che la compilazione carichi log e artefatti, esegui una delle operazioni seguenti:
1. Prima dell'istruzione `http_access deny all`, inserisci le istruzioni riportate di seguito, Consentono l' CodeBuild accesso CloudWatch e l'accesso ad Amazon S3. L'accesso a CloudWatch è necessario per CodeBuild poter creare CloudWatch registri. L'accesso ad Amazon S3 è necessario per il caricamento di artefatti e la memorizzazione nella cache di Amazon S3.
+
```
https_port 3130 cert=/etc/squid/ssl/squid.pem ssl-bump intercept
acl SSL_port port 443
http_access allow SSL_port
acl allowed_https_sites ssl::server_name .amazonaws.com
acl step1 at_step SslBump1
acl step2 at_step SslBump2
acl step3 at_step SslBump3
ssl_bump peek step1 all
ssl_bump peek step2 allowed_https_sites
ssl_bump splice step3 allowed_https_sites
ssl_bump terminate step2 all
```
+ Dopo il salvataggio, esegui il comando seguente`squid.conf`:
```
sudo iptables -t nat -A PREROUTING -p tcp --dport 443 -j REDIRECT --to-port 3130
sudo service squid restart
```
1. Aggiungi `proxy` al file di specifiche di compilazione. Per ulteriori informazioni, consulta [Sintassi buildspec](build-spec-ref.md#build-spec-ref-syntax).
```
version: 0.2
proxy:
upload-artifacts: yes
logs: yes
phases:
build:
commands:
- command
```
**Nota**
Se ricevi un errore di RequestError timeout, consulta[RequestError errore di timeout durante l'esecuzione CodeBuild in un server proxy](troubleshooting.md#code-request-timeout-error).
Per ulteriori informazioni, consulta [Esempio di file `squid.conf` del server proxy esplicito](#use-proxy-server-explicit-sample-squid-conf) più avanti in questo argomento.
## Crea un progetto CodeBuild
Per eseguirlo AWS CodeBuild con il tuo server proxy esplicito, imposta le sue variabili `HTTP_PROXY` e di `HTTPS_PROXY` ambiente con l'indirizzo IP privato dell'istanza EC2 che hai creato per il tuo server proxy e la porta 3128 a livello di progetto. L'indirizzo IP privato è simile a questo `http://your-ec2-private-ip-address:3128`. Per ulteriori informazioni, consultare [Crea un progetto di compilazione in AWS CodeBuild](create-project.md) e [Modifica le impostazioni del progetto di compilazione in AWS CodeBuild](change-project.md).
Per visualizzare il log degli accessi del proxy Squid, utilizza il comando seguente:
```
sudo tail -f /var/log/squid/access.log
```
## Esempio di file `squid.conf` del server proxy esplicito
Di seguito è riportato un esempio di file `squid.conf` configurato per un server proxy esplicito.
```
acl localnet src 10.0.0.0/16 #Only allow requests from within the VPC
# add all URLS to be whitelisted for download source and commands to be run in build environment
acl allowed_sites dstdomain .github.com #Allows to download source from github
acl allowed_sites dstdomain .bitbucket.com #Allows to download source from bitbucket
acl allowed_sites dstdomain ppa.launchpad.net #Allows to run apt-get in build environment
acl download_src dstdom_regex .*\.amazonaws\.com #Allows to download source from S3 or CodeCommit
acl SSL_ports port 443
acl Safe_ports port 80 # http
acl Safe_ports port 21 # ftp
acl Safe_ports port 443 # https
acl Safe_ports port 70 # gopher
acl Safe_ports port 210 # wais
acl Safe_ports port 1025-65535 # unregistered ports
acl Safe_ports port 280 # http-mgmt
acl Safe_ports port 488 # gss-http
acl Safe_ports port 591 # filemaker
acl Safe_ports port 777 # multiling http
acl CONNECT method CONNECT
#
# Recommended minimum Access Permission configuration:
#
# Deny requests to certain unsafe ports
http_access deny !Safe_ports
# Deny CONNECT to other than secure SSL ports
http_access deny CONNECT !SSL_ports
# Only allow cachemgr access from localhost
http_access allow localhost manager
http_access deny manager
# We strongly recommend the following be uncommented to protect innocent
# web applications running on the proxy server who think the only
# one who can access services on "localhost" is a local user
#http_access deny to_localhost
#
# INSERT YOUR OWN RULE(S) HERE TO ALLOW ACCESS FROM YOUR CLIENTS
#
# Example rule allowing access from your local networks.
# Adapt localnet in the ACL section to list your (internal) IP networks
# from where browsing should be allowed
http_access allow localnet allowed_sites
http_access allow localnet download_src
http_access allow localhost
# Add this for CodeBuild to access CWL end point, caching and upload artifacts S3 bucket end point
https_port 3130 cert=/etc/squid/ssl/squid.pem ssl-bump intercept
acl SSL_port port 443
http_access allow SSL_port
acl allowed_https_sites ssl::server_name .amazonaws.com
acl step1 at_step SslBump1
acl step2 at_step SslBump2
acl step3 at_step SslBump3
ssl_bump peek step1 all
ssl_bump peek step2 allowed_https_sites
ssl_bump splice step3 allowed_https_sites
ssl_bump terminate step2 all
# And finally deny all other access to this proxy
http_access deny all
# Squid normally listens to port 3128
http_port 3128
# Uncomment and adjust the following to add a disk cache directory.
#cache_dir ufs /var/spool/squid 100 16 256
# Leave coredumps in the first cache dir
coredump_dir /var/spool/squid
#
# Add any of your own refresh_pattern entries above these.
#
refresh_pattern ^ftp: 1440 20% 10080
refresh_pattern ^gopher: 1440 0% 1440
refresh_pattern -i (/cgi-bin/|\?) 0 0% 0
refresh_pattern . 0 20% 4320
```
# Esegui CodeBuild in un server proxy trasparente
Per funzionare AWS CodeBuild in un server proxy trasparente, è necessario configurare il server proxy con l'accesso ai siti Web e ai domini con cui interagisce.
**Topics**
+ [Configura di Squid come server proxy trasparente](#use-proxy-server-transparent-squid-configure)
+ [Crea un progetto CodeBuild](#use-proxy-server-transparent-create-acb-project)
## Configura di Squid come server proxy trasparente
Per configurare un server proxy in modo che sia trasparente, deve poter accedere ai domini e ai siti web a cui desideri accedere. Per funzionare AWS CodeBuild con un server proxy trasparente, è necessario concedergli l'accesso. `amazonaws.com` È inoltre necessario concedere l'accesso agli CodeBuild usi di altri siti Web. Questi variano a seconda di come crei i tuoi CodeBuild progetti. I siti Web di esempio sono quelli per repository come Bitbucket GitHub, Yum e Maven. Per concedere a Squid l'accesso a domini e siti Web specifici, aggiorna il file `squid.conf` utilizzando un comando simile a quello riportato di seguito. Questo comando di esempio consente l'accesso a `amazonaws.com`, `github.com` e `bitbucket.com` e può essere modificato in modo da garantire l'accesso ad altri siti Web.
```
cat | sudo tee /etc/squid/squid.conf ≪EOF
visible_hostname squid
#Handling HTTP requests
http_port 3129 intercept
acl allowed_http_sites dstdomain .amazonaws.com
#acl allowed_http_sites dstdomain domain_name [uncomment this line to add another domain]
http_access allow allowed_http_sites
#Handling HTTPS requests
https_port 3130 cert=/etc/squid/ssl/squid.pem ssl-bump intercept
acl SSL_port port 443
http_access allow SSL_port
acl allowed_https_sites ssl::server_name .amazonaws.com
acl allowed_https_sites ssl::server_name .github.com
acl allowed_https_sites ssl::server_name .bitbucket.com
#acl allowed_https_sites ssl::server_name [uncomment this line to add another website]
acl step1 at_step SslBump1
acl step2 at_step SslBump2
acl step3 at_step SslBump3
ssl_bump peek step1 all
ssl_bump peek step2 allowed_https_sites
ssl_bump splice step3 allowed_https_sites
ssl_bump terminate step2 all
http_access deny all
EOF
```
Le richieste in entrata da istanze nella sottorete privata devono essere reindirizzate alle porte di Squid. Squid è in ascolto sulla porta 3129 per il traffico HTTP (anziché 80) e 3130 per il traffico HTTPS (anziché 443). Utilizza il comando **iptables** per instradare il traffico:
```
sudo iptables -t nat -A PREROUTING -p tcp --dport 80 -j REDIRECT --to-port 3129
sudo iptables -t nat -A PREROUTING -p tcp --dport 443 -j REDIRECT --to-port 3130
sudo service iptables save
sudo service squid start
```
## Crea un progetto CodeBuild
Dopo aver configurato il server proxy, puoi utilizzarlo AWS CodeBuild in una sottorete privata senza ulteriori configurazioni. Ogni richiesta HTTP e HTTPS passa attraverso il server proxy pubblico. Per visualizzare il log degli accessi del proxy Squid, utilizza il comando seguente:
```
sudo tail -f /var/log/squid/access.log
```
# Esegui un programma di gestione dei pacchetti e di altri strumenti in un server proxy
Utilizzare le seguenti procedure per eseguire un gestore di pacchetti e altri strumenti in un server proxy.
**Per eseguire uno strumento, ad esempio un gestore di pacchetti, in un server proxy**
1. Aggiungi lo strumento all'elenco di elementi consentiti nel server proxy inserendo le istruzioni nel file `squid.conf`.
1. Aggiungi una riga al file di specifiche di compilazione in modo che punti all'endpoint privato del server proxy.
Gli esempi riportati di seguito spiegano come eseguire questa operazione per `apt-get`, `curl` e `maven`. Se utilizzi uno strumento diverso, si applicano gli stessi principi. Aggiungilo a un elenco di autorizzazioni nel `squid.conf` file e aggiungi un comando al tuo file buildspec per identificare l' CodeBuild endpoint del tuo server proxy.
**Per eseguire `apt-get` in un server proxy**
1. Aggiungi le seguenti istruzioni al file `squid.conf` per inserire `apt-get` nell'elenco di elementi consentiti nel server proxy. Le prime tre righe consentono l'esecuzione nell'`apt-get`ambiente di compilazione.
```
acl allowed_sites dstdomain ppa.launchpad.net # Required for apt-get to run in the build environment
acl apt_get dstdom_regex .*\.launchpad.net # Required for CodeBuild to run apt-get in the build environment
acl apt_get dstdom_regex .*\.ubuntu.com # Required for CodeBuild to run apt-get in the build environment
http_access allow localnet allowed_sites
http_access allow localnet apt_get
```
1. Aggiungi l'istruzione riportata di seguito al file di specifiche di compilazione, in modo che i comandi `apt-get` cerchino la configurazione proxy in `/etc/apt/apt.conf.d/00proxy`.
```
echo 'Acquire::http::Proxy "http://:3128"; Acquire::https::Proxy "http://:3128"; Acquire::ftp::Proxy "http://:3128";' > /etc/apt/apt.conf.d/00proxy
```
**Per eseguire `curl` in un server proxy**
1. Aggiungi quanto segue al file `squid.conf` per inserire `curl` in un elenco di elementi consentiti nell'ambiente di compilazione.
```
acl allowed_sites dstdomain ppa.launchpad.net # Required to run apt-get in the build environment
acl allowed_sites dstdomain google.com # Required for access to a webiste. This example uses www.google.com.
http_access allow localnet allowed_sites
http_access allow localnet apt_get
```
1. Aggiungi l'istruzione riportata di seguito al file di specifiche di compilazione, in modo che `curl` acceda al sito Web aggiunto a `squid.conf` utilizzando il server proxy privato. In questo esempio, il sito Web è `google.com`.
```
curl -x :3128 https://www.google.com
```
**Per eseguire `maven` in un server proxy**
1. Aggiungi quanto segue al file `squid.conf` per inserire `maven` in un elenco di elementi consentiti nell'ambiente di compilazione.
```
acl allowed_sites dstdomain ppa.launchpad.net # Required to run apt-get in the build environment
acl maven dstdom_regex .*\.maven.org # Allows access to the maven repository in the build environment
http_access allow localnet allowed_sites
http_access allow localnet maven
```
1. Aggiungi al file di specifiche di compilazione l'istruzione seguente.
```
maven clean install -DproxySet=true -DproxyHost= -DproxyPort=3128
```