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 Amazon Virtual Private Cloud
In genere, AWS CodeBuild non è possibile accedere alle risorse in un VPC. Per abilitare l'accesso, è necessario fornire ulteriori informazioni di configurazione specifiche per VPC CodeBuild nella configurazione del progetto. Ciò include l'ID VPC, la sottorete VPC IDs e il gruppo di sicurezza VPC. IDs Le compilazioni attivate da VPC possono accedere alle risorse all'interno del tuo VPC. [Per ulteriori informazioni sulla configurazione di un VPC in Amazon VPC, consulta la Amazon VPC User Guide.](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Introduction.html)
**Topics**
+ [
## Casi d’uso
](#use-cases)
+ [
## Le migliori pratiche per VPCs
](#best-practices-for-vpcs)
+ [
## Limitazioni di VPCs
](#vpc-limitations)
+ [
# Consenti l'accesso ad Amazon VPC nei tuoi progetti CodeBuild
](enabling-vpc-access-in-projects.md)
+ [
# Risolvi i problemi relativi alla configurazione del VPC
](troubleshooting-vpc.md)
+ [
# Utilizzo degli endpoint VPC
](use-vpc-endpoints-with-codebuild.md)
+ [
# Utilizzo AWS CodeBuild con un server proxy gestito
](run-codebuild-in-managed-proxy-server.md)
+ [
# Utilizzo AWS CodeBuild con un server proxy
](use-proxy-server.md)
+ [
# CloudFormation Modello VPC
](cloudformation-vpc-template.md)
## Casi d’uso
La connettività VPC AWS CodeBuild delle build consente di:
+ Esegui i test di integrazione della tua build rispetto ai dati in un database Amazon RDS isolato su una sottorete privata.
+ Interroga i dati in un ElastiCache cluster Amazon direttamente dai test.
+ Interagisci con servizi Web interni ospitati su Amazon EC2, Amazon ECS o servizi che utilizzano Elastic Load Balancing interno.
+ Recuperare dipendenze da repository di artefatti interni e autogestiti, come PyPI per Python, Maven per Java e npm per Node.js.
+ Accedi agli oggetti in un bucket S3 configurato per consentire l'accesso solo tramite un endpoint Amazon VPC.
+ Eseguire una query dei servizi Web esterni che richiedono indirizzi IP fissi attraverso l'indirizzo IP elastico del gateway NAT o dell'istanza NAT associata alla sottorete.
Le build possono accedere a tutte le risorse ospitate sul tuo VPC.
## Le migliori pratiche per VPCs
Usa questa lista di controllo quando configuri un VPC con cui lavorare. CodeBuild
+ Configura il tuo VPC con sottoreti pubbliche e private e un gateway NAT. Il gateway NAT deve risiedere in una sottorete pubblica. Per ulteriori informazioni, consulta [VPC con sottoreti pubbliche e private (NAT)](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Scenario2.html) in *Guida per l'utente di Amazon VPC*.
**Importante**
È necessario un gateway NAT o un'istanza NAT da utilizzare CodeBuild con il VPC in modo che CodeBuild possa raggiungere gli endpoint pubblici (ad esempio, per eseguire i comandi CLI durante l'esecuzione delle build). Non è possibile utilizzare il gateway Internet anziché un gateway NAT o un'istanza NAT perché CodeBuild non supporta l'assegnazione di indirizzi IP elastici alle interfacce di rete che crea e l'assegnazione automatica di un indirizzo IP pubblico non è supportata da Amazon EC2 per le interfacce di rete create al di fuori del lancio delle istanze Amazon EC2.
+ Includere più zone di disponibilità al VPC.
+ Assicurati che ai tuoi gruppi di sicurezza non sia consentito il traffico in entrata (in ingresso) verso le tue build. CodeBuild non ha requisiti specifici per il traffico in uscita, ma devi consentire l'accesso a tutte le risorse Internet necessarie per la tua build, ad GitHub esempio Amazon S3.
Per ulteriori informazioni, consulta [Regole del gruppo di sicurezza](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_SecurityGroups.html#SecurityGroupRules) nella *Guida per l'utente di Amazon VPC*.
+ Impostare sottoreti separate per le build.
+ Quando configuri i tuoi CodeBuild progetti per accedere al tuo VPC, scegli solo sottoreti private.
[Per ulteriori informazioni sulla configurazione di un VPC in Amazon VPC, consulta la Amazon VPC User Guide.](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Introduction.html)
Per ulteriori informazioni sull'utilizzo della funzionalità VPC CloudFormation per configurare un CodeBuild VPC, consulta la. [CloudFormation Modello VPC](cloudformation-vpc-template.md)
## Limitazioni di VPCs
+ La connettività VPC di non CodeBuild è supportata per la condivisione. VPCs
# Consenti l'accesso ad Amazon VPC nei tuoi progetti CodeBuild
Includi queste impostazioni nella configurazione del VPC:
+ Per **VPC ID, scegli l'ID** VPC che utilizza. CodeBuild
+ Per le **sottoreti**, scegli una sottorete privata con traduzione NAT che includa o disponga di percorsi verso le risorse utilizzate da. CodeBuild
+ Per i **gruppi di sicurezza**, scegliete i gruppi di sicurezza da CodeBuild utilizzare per consentire l'accesso alle risorse in. VPCs
Per utilizzare la console per creare un progetto di compilazione, consulta [Creare un progetto di compilazione (console)](create-project.md#create-project-console). Quando crei o modifichi il tuo CodeBuild progetto, in **VPC, scegli l'ID VPC**, le sottoreti e i gruppi di sicurezza.
Per utilizzare il per creare un AWS CLI progetto di compilazione, vedi. [Creazione di un progetto di compilazione (AWS CLI)](create-project.md#create-project-cli) Se utilizzi AWS CLI with CodeBuild, il ruolo di servizio utilizzato da CodeBuild per interagire con i servizi per conto dell'utente IAM deve avere una policy allegata. Per informazioni, consulta [Consenti CodeBuild l'accesso ai AWS servizi necessari per creare un'interfaccia di rete VPC](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-example-create-vpc-network-interface).
L'*vpcConfig*oggetto dovrebbe includere il tuo *vpcId**securityGroupIds*, e*subnets*.
+ *vpcId*: richiesto. L'ID VPC che CodeBuild utilizza. Esegui questo comando per ottenere un elenco di tutti gli Amazon VPC IDs nella tua regione:
```
aws ec2 describe-vpcs
```
+ *subnets*: richiesto. La sottorete IDs che include le risorse utilizzate da. CodeBuild Esegui questo comando per ottenere questi IDs:
```
aws ec2 describe-subnets --filters "Name=vpc-id,Values=" --region us-east-1
```
**Nota**
Sostituisci `us-east-1` con la tua regione.
+ *securityGroupIds*: richiesto. Il gruppo di sicurezza IDs utilizzato da CodeBuild per consentire l'accesso alle risorse in VPCs. Eseguite questo comando per ottenere quanto segue IDs:
```
aws ec2 describe-security-groups --filters "Name=vpc-id,Values=" --region us-east-1
```
**Nota**
Sostituisci `us-east-1` con la tua regione.
# Risolvi i problemi relativi alla configurazione del VPC
Utilizza le informazioni presenti nel messaggio di errore per identificare, diagnosticare e risolvere i problemi.
Di seguito sono riportate alcune linee guida per la risoluzione di un errore VPC CodeBuild comune: `Build does not have internet connectivity. Please check subnet network configuration`.
1. [Assicurarsi che il gateway Internet sia collegato al VPC](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Internet_Gateway.html#Add_IGW_Attach_Gateway).
1. [Assicurarsi che la tabella di routing della sottorete pubblica punti all'Internet Gateway](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Route_Tables.html#route-tables-internet-gateway).
1. [Assicurati che la tua rete ACLs consenta il flusso del traffico](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_SecurityGroups.html#SecurityGroupRules).
1. [Assicurarsi che i gruppi di sicurezza consentano il traffico sul flusso](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_SecurityGroups.html#SecurityGroupRules).
1. [Risolvere i problemi del gateway NAT](https://docs.aws.amazon.com/vpc/latest/userguide/VPC-nat-gateway.html#nat-gateway-troubleshooting).
1. [Assicurarsi che la tabella di routing delle sottoreti private punti al gateway NAT](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Route_Tables.html#route-tables-nat).
1. Assicurati che il ruolo di servizio utilizzato da CodeBuild per interagire con i servizi per conto dell'utente IAM disponga delle autorizzazioni previste da [questa policy](https://docs.aws.amazon.com/codebuild/latest/userguide/auth-and-access-control-iam-identity-based-access-control.html#customer-managed-policies-example-create-vpc-network-interface). Per ulteriori informazioni, consulta [Consenti CodeBuild di interagire con altri servizi AWS](setting-up-service-role.md).
Se CodeBuild mancano le autorizzazioni, potresti ricevere un errore che dice,. `Unexpected EC2 error: UnauthorizedOperation` Questo errore può verificarsi se CodeBuild non si dispone delle autorizzazioni Amazon EC2 necessarie per lavorare con un VPC.
# Utilizzo degli endpoint VPC
Puoi migliorare la sicurezza delle tue build configurando l'uso di un AWS CodeBuild endpoint VPC di interfaccia. Gli endpoint di interfaccia sono alimentati da PrivateLink, una tecnologia che puoi utilizzare per accedere in modo privato ad Amazon EC2 CodeBuild e utilizzare indirizzi IP privati. PrivateLink limita tutto il traffico di rete tra le istanze gestite e Amazon EC2 alla rete Amazon. CodeBuild Le istanze gestite non hanno accesso a Internet. Inoltre, non hai bisogno di un gateway Internet, di un dispositivo NAT o di un gateway privato virtuale. Non è obbligatorio configurare PrivateLink, ma è consigliato. [Per ulteriori informazioni sugli PrivateLink endpoint VPC, consulta Cos'è? AWS PrivateLink](https://docs.aws.amazon.com/vpc/latest/privatelink/what-is-privatelink.html) .
## Prima di creare endpoint VPC
Prima di configurare gli endpoint VPC per AWS CodeBuild, tieni presente le seguenti restrizioni e limitazioni.
**Nota**
Utilizza un [gateway NAT](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_NAT_Instance.html) se desideri utilizzarlo CodeBuild con AWS servizi che non supportano le connessioni Amazon PrivateLink VPC.
+ Gli endpoint VPC supportano il DNS fornito da Amazon solo tramite Amazon Route 53. Se si desidera utilizzare il proprio DNS, è possibile usare l'inoltro condizionale sul DNS. Per ulteriori informazioni, consulta [Set di opzioni DHCP](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_DHCP_Options.html) nella *Guida per l'utente di Amazon VPC*.
+ Gli endpoint VPC attualmente non supportano le richieste tra regioni. Assicurati di creare il tuo endpoint nella stessa AWS regione di tutti i bucket S3 che memorizzano l'input e l'output della build. Puoi utilizzare la console Amazon S3 o il [get-bucket-location](https://docs.aws.amazon.com/cli/latest/reference/s3api/get-bucket-location.html)comando per trovare la posizione del tuo bucket. Usa un endpoint Amazon S3 specifico della regione per accedere al tuo bucket (ad esempio,). `.s3-us-west-2.amazonaws.com` Per ulteriori informazioni sugli endpoint specifici della regione per Amazon S3, consulta [Amazon Simple](https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region) Storage Service nel. *Riferimenti generali di Amazon Web Services* Se utilizzi il AWS CLI per effettuare richieste ad Amazon S3, imposta la tua regione predefinita sulla stessa regione in cui è stato creato il bucket o utilizza il `--region` parametro nelle tue richieste.
## Crea endpoint VPC per CodeBuild
Segui le istruzioni contenute in [Creazione di un endpoint dell'interfaccia](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html#create-interface-endpoint) per creare l'endpoint `com.amazonaws.region.codebuild`. Questo è un endpoint VPC per. AWS CodeBuild
![\[La configurazione dell'endpoint VPC.\]](http://docs.aws.amazon.com/it_it/codebuild/latest/userguide/images/vpc-endpoint.png)
*region*rappresenta l'identificatore di regione per una AWS regione supportata da CodeBuild, ad esempio `us-east-2` per la regione Stati Uniti orientali (Ohio). Per un elenco delle AWS regioni supportate, consulta la [CodeBuild](https://docs.aws.amazon.com/general/latest/gr/rande.html#codebuild_region)Guida * AWS generale*. L'endpoint è precompilato con la regione specificata al momento dell'accesso. AWS Se modifichi la regione, l'endpoint VPC viene aggiornato di conseguenza.
## Crea una policy per gli endpoint VPC per CodeBuild
Puoi creare una policy per gli endpoint Amazon VPC per la AWS CodeBuild quale puoi specificare:
+ Il principale che può eseguire azioni.
+ Le operazioni che possono essere eseguite.
+ Le risorse su cui è possibile eseguire le operazioni.
L'esempio di policy seguente specifica che tutti i principali possono solo iniziare e visualizzare le build per il progetto `project-name`.
```
{
"Statement": [
{
"Action": [
"codebuild:ListBuildsForProject",
"codebuild:StartBuild",
"codebuild:BatchGetBuilds"
],
"Effect": "Allow",
"Resource": "arn:aws:codebuild:region-ID:account-ID:project/project-name",
"Principal": "*"
}
]
}
```
Per ulteriori informazioni, consulta [Controllo degli accessi ai servizi con endpoint VPC](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-endpoints-access.html) nella *Guida per l’utente di Amazon VPC.*
# Utilizzo AWS CodeBuild con un server proxy gestito
Per eseguire flotte a capacità AWS CodeBuild riservata in un server proxy gestito, è necessario configurare il server proxy in modo da consentire o negare il traffico da e verso siti esterni utilizzando le regole proxy. Tieni presente che l'esecuzione di flotte a capacità riservata in un server proxy gestito non è supportata per VPC, Windows o macOS.
**Importante**
Esistono costi aggiuntivi in base alla durata della presenza di una configurazione proxy nel parco veicoli. Per ulteriori informazioni, consulta [https://aws.amazon.com/codebuild/pricing/](https://aws.amazon.com/codebuild/pricing/).
**Topics**
+ [
## Configurare una configurazione proxy gestita per flotte a capacità riservata
](#run-codebuild-in-managed-proxy-server-configure)
+ [
## Gestisci un parco veicoli con capacità CodeBuild riservata
](#use-managed-server-run-acb-fleet)
## Configurare una configurazione proxy gestita per flotte a capacità riservata
Per configurare un server proxy gestito per il tuo parco veicoli a capacità riservata, devi abilitare questa funzionalità quando crei il tuo parco veicoli nella console o utilizzi il AWS CLI. È necessario definire diverse proprietà:
**Definire le configurazioni del proxy (opzionale)**
Configurazioni proxy che applicano il controllo dell'accesso alla rete alle istanze con capacità riservata.
**Comportamento predefinito**
Definisce il comportamento del traffico in uscita.
**Abilita**
Per impostazione predefinita, consente il traffico in uscita verso tutte le destinazioni.
**Rifiuta**
Per impostazione predefinita, nega il traffico in uscita verso tutte le destinazioni.
**Regole proxy**
Speciifica i domini di destinazione a cui limitare il controllo dell'accesso alla rete.
Per definire le configurazioni del proxy nella console, consulta [Crea un parco veicoli a capacità riservata](fleets.md#fleets.how-to) le istruzioni. Per definire le configurazioni del proxy utilizzando AWS CLI, puoi farlo modificando la seguente sintassi JSON e salvando i risultati:
```
"proxyConfiguration": {
"defaultBehavior": "ALLOW_ALL" | "DENY_ALL",
"orderedProxyRules": [
{
"type": "DOMAIN" | "IP",
"effect": "ALLOW" | "DENY",
"entities": [
"destination"
]
}
]
}
```
Il file JSON potrebbe essere simile al seguente:
```
"proxyConfiguration": {
"defaultBehavior": "DENY_ALL",
"orderedProxyRules": [
{
"type": "DOMAIN",
"effect": "ALLOW",
"entities": [
"github.com"
]
}
]
}
```
## Gestisci un parco veicoli con capacità CodeBuild riservata
Quando gestisci flotte a capacità AWS CodeBuild riservata con il tuo server proxy gestito, CodeBuild imposterà automaticamente le relative variabili `HTTP_PROXY` e di `HTTPS_PROXY` ambiente con gli indirizzi proxy gestiti. Se il tuo software di dipendenza ha una propria configurazione e non rispetta le variabili di ambiente, puoi fare riferimento a questi valori e aggiornare la configurazione del software nei comandi di build per indirizzare correttamente il traffico di build attraverso il proxy gestito. 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).
# 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
```
# CloudFormation Modello VPC
CloudFormation *consente di creare e fornire implementazioni di AWS infrastrutture in modo prevedibile e ripetuto, utilizzando file modello per creare ed eliminare una raccolta di risorse insieme come una singola unità (uno stack).* Per ulteriori informazioni, consulta la [Guida per l'utente CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).
Di seguito è riportato un modello CloudFormation YAML per la configurazione di un VPC da utilizzare. AWS CodeBuild[Questo file è disponibile anche in samples.zip.](./samples/samples.zip)
```
Description: This template deploys a VPC, with a pair of public and private subnets spread
across two Availability Zones. It deploys an internet gateway, with a default
route on the public subnets. It deploys a pair of NAT gateways (one in each AZ),
and default routes for them in the private subnets.
Parameters:
EnvironmentName:
Description: An environment name that is prefixed to resource names
Type: String
VpcCIDR:
Description: Please enter the IP range (CIDR notation) for this VPC
Type: String
Default: 10.192.0.0/16
PublicSubnet1CIDR:
Description: Please enter the IP range (CIDR notation) for the public subnet in the first Availability Zone
Type: String
Default: 10.192.10.0/24
PublicSubnet2CIDR:
Description: Please enter the IP range (CIDR notation) for the public subnet in the second Availability Zone
Type: String
Default: 10.192.11.0/24
PrivateSubnet1CIDR:
Description: Please enter the IP range (CIDR notation) for the private subnet in the first Availability Zone
Type: String
Default: 10.192.20.0/24
PrivateSubnet2CIDR:
Description: Please enter the IP range (CIDR notation) for the private subnet in the second Availability Zone
Type: String
Default: 10.192.21.0/24
Resources:
VPC:
Type: AWS::EC2::VPC
Properties:
CidrBlock: !Ref VpcCIDR
EnableDnsSupport: true
EnableDnsHostnames: true
Tags:
- Key: Name
Value: !Ref EnvironmentName
InternetGateway:
Type: AWS::EC2::InternetGateway
Properties:
Tags:
- Key: Name
Value: !Ref EnvironmentName
InternetGatewayAttachment:
Type: AWS::EC2::VPCGatewayAttachment
Properties:
InternetGatewayId: !Ref InternetGateway
VpcId: !Ref VPC
PublicSubnet1:
Type: AWS::EC2::Subnet
Properties:
VpcId: !Ref VPC
AvailabilityZone: !Select [ 0, !GetAZs '' ]
CidrBlock: !Ref PublicSubnet1CIDR
MapPublicIpOnLaunch: true
Tags:
- Key: Name
Value: !Sub ${EnvironmentName} Public Subnet (AZ1)
PublicSubnet2:
Type: AWS::EC2::Subnet
Properties:
VpcId: !Ref VPC
AvailabilityZone: !Select [ 1, !GetAZs '' ]
CidrBlock: !Ref PublicSubnet2CIDR
MapPublicIpOnLaunch: true
Tags:
- Key: Name
Value: !Sub ${EnvironmentName} Public Subnet (AZ2)
PrivateSubnet1:
Type: AWS::EC2::Subnet
Properties:
VpcId: !Ref VPC
AvailabilityZone: !Select [ 0, !GetAZs '' ]
CidrBlock: !Ref PrivateSubnet1CIDR
MapPublicIpOnLaunch: false
Tags:
- Key: Name
Value: !Sub ${EnvironmentName} Private Subnet (AZ1)
PrivateSubnet2:
Type: AWS::EC2::Subnet
Properties:
VpcId: !Ref VPC
AvailabilityZone: !Select [ 1, !GetAZs '' ]
CidrBlock: !Ref PrivateSubnet2CIDR
MapPublicIpOnLaunch: false
Tags:
- Key: Name
Value: !Sub ${EnvironmentName} Private Subnet (AZ2)
NatGateway1EIP:
Type: AWS::EC2::EIP
DependsOn: InternetGatewayAttachment
Properties:
Domain: vpc
NatGateway2EIP:
Type: AWS::EC2::EIP
DependsOn: InternetGatewayAttachment
Properties:
Domain: vpc
NatGateway1:
Type: AWS::EC2::NatGateway
Properties:
AllocationId: !GetAtt NatGateway1EIP.AllocationId
SubnetId: !Ref PublicSubnet1
NatGateway2:
Type: AWS::EC2::NatGateway
Properties:
AllocationId: !GetAtt NatGateway2EIP.AllocationId
SubnetId: !Ref PublicSubnet2
PublicRouteTable:
Type: AWS::EC2::RouteTable
Properties:
VpcId: !Ref VPC
Tags:
- Key: Name
Value: !Sub ${EnvironmentName} Public Routes
DefaultPublicRoute:
Type: AWS::EC2::Route
DependsOn: InternetGatewayAttachment
Properties:
RouteTableId: !Ref PublicRouteTable
DestinationCidrBlock: 0.0.0.0/0
GatewayId: !Ref InternetGateway
PublicSubnet1RouteTableAssociation:
Type: AWS::EC2::SubnetRouteTableAssociation
Properties:
RouteTableId: !Ref PublicRouteTable
SubnetId: !Ref PublicSubnet1
PublicSubnet2RouteTableAssociation:
Type: AWS::EC2::SubnetRouteTableAssociation
Properties:
RouteTableId: !Ref PublicRouteTable
SubnetId: !Ref PublicSubnet2
PrivateRouteTable1:
Type: AWS::EC2::RouteTable
Properties:
VpcId: !Ref VPC
Tags:
- Key: Name
Value: !Sub ${EnvironmentName} Private Routes (AZ1)
DefaultPrivateRoute1:
Type: AWS::EC2::Route
Properties:
RouteTableId: !Ref PrivateRouteTable1
DestinationCidrBlock: 0.0.0.0/0
NatGatewayId: !Ref NatGateway1
PrivateSubnet1RouteTableAssociation:
Type: AWS::EC2::SubnetRouteTableAssociation
Properties:
RouteTableId: !Ref PrivateRouteTable1
SubnetId: !Ref PrivateSubnet1
PrivateRouteTable2:
Type: AWS::EC2::RouteTable
Properties:
VpcId: !Ref VPC
Tags:
- Key: Name
Value: !Sub ${EnvironmentName} Private Routes (AZ2)
DefaultPrivateRoute2:
Type: AWS::EC2::Route
Properties:
RouteTableId: !Ref PrivateRouteTable2
DestinationCidrBlock: 0.0.0.0/0
NatGatewayId: !Ref NatGateway2
PrivateSubnet2RouteTableAssociation:
Type: AWS::EC2::SubnetRouteTableAssociation
Properties:
RouteTableId: !Ref PrivateRouteTable2
SubnetId: !Ref PrivateSubnet2
NoIngressSecurityGroup:
Type: AWS::EC2::SecurityGroup
Properties:
GroupName: "no-ingress-sg"
GroupDescription: "Security group with no ingress rule"
VpcId: !Ref VPC
Outputs:
VPC:
Description: A reference to the created VPC
Value: !Ref VPC
PublicSubnets:
Description: A list of the public subnets
Value: !Join [ ",", [ !Ref PublicSubnet1, !Ref PublicSubnet2 ]]
PrivateSubnets:
Description: A list of the private subnets
Value: !Join [ ",", [ !Ref PrivateSubnet1, !Ref PrivateSubnet2 ]]
PublicSubnet1:
Description: A reference to the public subnet in the 1st Availability Zone
Value: !Ref PublicSubnet1
PublicSubnet2:
Description: A reference to the public subnet in the 2nd Availability Zone
Value: !Ref PublicSubnet2
PrivateSubnet1:
Description: A reference to the private subnet in the 1st Availability Zone
Value: !Ref PrivateSubnet1
PrivateSubnet2:
Description: A reference to the private subnet in the 2nd Availability Zone
Value: !Ref PrivateSubnet2
NoIngressSecurityGroup:
Description: Security group with no ingress rule
Value: !Ref NoIngressSecurityGroup
```