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 di una distribuzione temporanea e di una policy di implementazione continua
È possibile creare, aggiornare e modificare le distribuzioni temporanee e le politiche di distribuzione continua nella CloudFront console, con AWS Command Line Interface (AWS CLI) o con l' CloudFront API.
## Creazione di una distribuzione temporanea con una policy di implementazione continua
Nelle procedure seguenti viene illustrato come creare una distribuzione temporanea con una policy di implementazione continua.
------
#### [ Console ]
Puoi creare una distribuzione temporanea con una policy di implementazione continua utilizzando la Console di gestione AWS.
**Creazione di una distribuzione temporanea e di una policy di implementazione continua (console)**
1. Accedi Console di gestione AWS e apri la CloudFront console all'indirizzo. [https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home)
1. Nel riquadro di navigazione seleziona **Distributions (Distribuzioni)**.
1. Scegliere la distribuzione che si desidera utilizzare come *distribuzione principale*. La distribuzione principale è quella che attualmente serve il traffico di produzione, quella da cui verrà creata la distribuzione temporanea.
1. Nella sezione **Continuous deployment** (Implementazione continua), scegliere **Create staging distribution** (Crea distribuzione temporanea). Si apre la procedura guidata **Create staging distribution** (Crea distribuzione temporanea).
1. Nella procedura guidata **Create staging distribution** (Crea distribuzione temporanea), effettuare le seguenti operazioni:
1. (Facoltativo) Digitare una descrizione per la distribuzione temporanea.
1. Scegli **Next (Successivo)**.
1. Modificare la configurazione della distribuzione temporanea. Per ulteriori informazioni sulle impostazioni che è possibile aggiornare, consulta [Aggiornamento delle distribuzioni principale e temporanea](understanding-continuous-deployment.md#updating-staging-and-primary-distributions).
Una volta terminato di modificare la configurazione della distribuzione temporanea, scegliere **Next** (Avanti).
1. Utilizzare la console per specificare **Traffic configuration** (Configurazione del traffico). Ciò determina il modo in cui CloudFront indirizza il traffico verso la distribuzione temporanea. (CloudFront memorizza la configurazione del traffico in una *politica di distribuzione continua*.)
Per ulteriori informazioni sulle opzioni in **Traffic configuration** (Configurazione del traffico) consulta [Instradamento delle richieste alla distribuzione temporanea](understanding-continuous-deployment.md#understanding-continuous-deployment-routing).
Una volta terminato con **Traffic configuration** (Configurazione del traffico), scegliere **Next** (Avanti).
1. Esaminare la configurazione per la distribuzione temporanea, inclusa la configurazione del traffico, quindi scegliere **Create staging distribution** (Crea distribuzione temporanea).
Al termine della procedura guidata di **creazione della distribuzione temporanea** nella CloudFront console, CloudFront effettua le seguenti operazioni:
+ Crea una distribuzione temporanea con le impostazioni specificate (nella fase 5c)
+ Crea una policy di implementazione continua con la configurazione del traffico specificata (nella fase 5d)
+ Collega la policy di implementazione continua alla distribuzione principale da cui è stata creata la distribuzione temporanea
Quando la configurazione della distribuzione primaria, con la politica di distribuzione continua allegata, viene distribuita su postazioni periferiche, CloudFront inizia a inviare la parte di traffico specificata alla distribuzione temporanea in base alla configurazione del traffico.
------
#### [ CLI ]
Per creare una politica di distribuzione temporanea e una politica di distribuzione continua con AWS CLI, utilizza le seguenti procedure.
**Creazione di una distribuzione temporanea (CLI)**
1. Utilizzare i comandi **aws cloudfront get-distribution** e **grep** insieme per ottenere il valore `ETag` della distribuzione che si desidera utilizzare come *distribuzione principale*. La distribuzione principale è quella che attualmente serve il traffico di produzione, da cui verrà creata la distribuzione temporanea.
Il comando seguente mostra un esempio. Nell'esempio seguente, sostituiscilo *primary\$1distribution\$1ID* con l'ID della distribuzione principale.
```
aws cloudfront get-distribution --id primary_distribution_ID | grep 'ETag'
```
Copiare il valore `ETag` (servirà nella fase successiva).
1. Utilizzare il comando **aws cloudfront copy-distribution** per creare una distribuzione temporanea. Il seguente comando di esempio utilizza caratteri di escape (\$1) e interruzioni di riga per la leggibilità, ma è necessario ometterli dal comando. Nel seguente è un comando di esempio:
+ Sostituisci *primary\$1distribution\$1ID* con l'ID della distribuzione principale.
+ Sostituisci *primary\$1distribution\$1ETag* con il `ETag` valore della distribuzione primaria (che hai ottenuto nel passaggio precedente).
+ (Facoltativo) *CLI\$1example* Sostituiscilo con l'ID di riferimento del chiamante desiderato.
```
aws cloudfront copy-distribution --primary-distribution-id primary_distribution_ID \
--if-match primary_distribution_ETag \
--staging \
--caller-reference 'CLI_example'
```
L'output del comando mostra informazioni sulla distribuzione temporanea e sulla sua configurazione. Copia il nome di CloudFront dominio della distribuzione temporanea perché ti serve per il passaggio successivo.
**Creazione di una policy di implementazione continua (CLI con file di input)**
1. Utilizzare il comando seguente per creare un file denominato `continuous-deployment-policy.yaml` che contiene tutti i parametri di input per il comando **create-continuous-deployment-policy**. Il seguente comando utilizza caratteri di escape (\$1) e interruzioni di riga per la leggibilità, ma è necessario ometterli dal comando.
```
aws cloudfront create-continuous-deployment-policy --generate-cli-skeleton yaml-input \
> continuous-deployment-policy.yaml
```
1. Aprire il file `continuous-deployment-policy.yaml` appena creato. Modificare il file per specificare le impostazioni delle policy di implementazione continua desiderate, quindi salvare il file. Quando si modifica il file:
+ Nella sezione `StagingDistributionDnsNames`:
+ Modificare il valore di `Quantity` in `1`.
+ Per`Items`, incolla il nome di CloudFront dominio della distribuzione temporanea (che hai salvato in un passaggio precedente).
+ Nella sezione `TrafficConfig`:
+ Scegliere un `Type`, `SingleWeight` o `SingleHeader`.
+ Rimuovere le impostazioni per l'altro tipo. Ad esempio, se si desidera una configurazione del traffico basata sul peso, impostare `Type` su `SingleWeight` e rimuovere le impostazioni `SingleHeaderConfig`.
+ Per utilizzare una configurazione del traffico basata sul peso, impostare il valore di `Weight` su un numero decimale compreso tra `.01` (uno percento) e `.15` (quindici percento).
Per ulteriori informazioni su queste opzioni in `TrafficConfig`, consulta [Instradamento delle richieste alla distribuzione temporanea](understanding-continuous-deployment.md#understanding-continuous-deployment-routing) e [Persistenza della sessione per configurazioni basate sul peso](understanding-continuous-deployment.md#understanding-continuous-deployment-sessions).
1. Utilizzare il comando seguente per creare la policy dell'implementazione continua utilizzando i parametri di input dal file `continuous-deployment-policy.yaml`.
```
aws cloudfront create-continuous-deployment-policy --cli-input-yaml file://continuous-deployment-policy.yaml
```
Copiare il valore `Id` nell'output del comando. Questo è l'ID della policy di implementazione continua e serve nella fase successiva.
**Collegamento di una policy di implementazione continua a una distribuzione principale (CLI con file di input)**
1. Utilizzare il comando seguente per salvare la configurazione della distribuzione principale in un file denominato `primary-distribution.yaml`. Sostituiscilo *primary\$1distribution\$1ID* con l'ID della distribuzione principale.
```
aws cloudfront get-distribution-config --id primary_distribution_ID --output yaml > primary-distribution.yaml
```
1. Aprire il file `primary-distribution.yaml` appena creato. Modifica il file apportando le seguenti modifiche:
+ Incollare l'ID della policy di implementazione continua (copiata in una fase precedente) nel campo `ContinuousDeploymentPolicyId`.
+ Rinominare il campo `ETag` in `IfMatch`, ma non modificare il valore del campo.
Salvare il file al termine.
1. Utilizzare il comando seguente per aggiornare la distribuzione principale e utilizzare la policy di implementazione continua. Sostituisci *primary\$1distribution\$1ID* con l'ID della distribuzione principale.
```
aws cloudfront update-distribution --id primary_distribution_ID --cli-input-yaml file://primary-distribution.yaml
```
Quando la configurazione della distribuzione primaria, con la politica di distribuzione continua allegata, viene implementata su postazioni periferiche, CloudFront inizia a inviare la porzione di traffico specificata alla distribuzione temporanea in base alla configurazione del traffico.
------
#### [ API ]
Per creare una politica di distribuzione temporanea e di distribuzione continua con l' CloudFront API, utilizza le seguenti operazioni API:
+ [CopyDistribution](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CopyDistribution.html)
+ [CreateContinuousDeploymentPolicy](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CreateContinuousDeploymentPolicy.html)
Per ulteriori informazioni sui campi specificati in queste chiamate API, consulta quanto segue:
+ [Instradamento delle richieste alla distribuzione temporanea](understanding-continuous-deployment.md#understanding-continuous-deployment-routing)
+ [Persistenza della sessione per configurazioni basate sul peso](understanding-continuous-deployment.md#understanding-continuous-deployment-sessions)
+ La documentazione di riferimento sull'API per il tuo AWS SDK o altro client API
Dopo aver creato una distribuzione temporanea e una politica di distribuzione continua, utilizza [UpdateDistribution](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html)(sulla distribuzione principale) per allegare la politica di distribuzione continua alla distribuzione primaria.
------
## Aggiornamento di una distribuzione temporanea
Nelle procedure seguenti viene illustrato come aggiornare una distribuzione temporanea con una policy di implementazione continua.
------
#### [ Console ]
Puoi aggiornare determinate configurazioni per le distribuzioni primaria e temporanea. Per ulteriori informazioni, consulta [Aggiornamento delle distribuzioni principale e temporanea](understanding-continuous-deployment.md#updating-staging-and-primary-distributions).
**Aggiornamento di una distribuzione temporanea (console)**
1. Apri la CloudFront console all'indirizzo[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. Nel riquadro di navigazione seleziona **Distributions (Distribuzioni)**.
1. Scegliere la distribuzione principale. Questa è la distribuzione che attualmente serve il traffico di produzione, quella da cui verrà creata la distribuzione temporanea.
1. Scegliere **View staging distribution** (Visualizza distribuzione temporanea).
1. Utilizzare la console per modificare la configurazione della distribuzione temporanea. Per ulteriori informazioni sulle impostazioni che è possibile aggiornare, consulta [Aggiornamento delle distribuzioni principale e temporanea](understanding-continuous-deployment.md#updating-staging-and-primary-distributions).
Non appena la configurazione della distribuzione temporanea viene implementata nelle posizioni edge, ha effetto sul traffico in entrata indirizzato verso la distribuzione temporanea.
------
#### [ CLI ]
**Aggiornamento di una distribuzione temporanea (CLI con file di input)**
1. Utilizzare il comando seguente per salvare la configurazione della distribuzione temporanea in un file denominato `staging-distribution.yaml`. Sostituisci *staging\$1distribution\$1ID* con l'ID della distribuzione temporanea.
```
aws cloudfront get-distribution-config --id staging_distribution_ID --output yaml > staging-distribution.yaml
```
1. Aprire il file `staging-distribution.yaml` appena creato. Modifica il file apportando le seguenti modifiche:
+ Modificare la configurazione della distribuzione temporanea. Per ulteriori informazioni sulle impostazioni che è possibile aggiornare, consulta [Aggiornamento delle distribuzioni principale e temporanea](understanding-continuous-deployment.md#updating-staging-and-primary-distributions).
+ Rinominare il campo `ETag` in `IfMatch`, ma non modificare il valore del campo.
Salvare il file al termine.
1. Utilizzare il seguente comando per aggiornare la configurazione della distribuzione temporanea. Sostituisci *staging\$1distribution\$1ID* con l'ID della distribuzione temporanea.
```
aws cloudfront update-distribution --id staging_distribution_ID --cli-input-yaml file://staging-distribution.yaml
```
Non appena la configurazione della distribuzione temporanea viene implementata nelle posizioni edge, ha effetto sul traffico in entrata indirizzato verso la distribuzione temporanea.
------
#### [ API ]
Per aggiornare la configurazione di una distribuzione temporanea, utilizza [UpdateDistribution](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html)(sulla distribuzione temporanea) per modificare la configurazione della distribuzione temporanea. Per ulteriori informazioni sulle impostazioni che è possibile aggiornare, consulta [Aggiornamento delle distribuzioni principale e temporanea](understanding-continuous-deployment.md#updating-staging-and-primary-distributions).
------
## Aggiornamento di una policy di implementazione continua
Nelle procedure seguenti viene illustrato come aggiornare una policy di implementazione continua.
------
#### [ Console ]
Puoi aggiornare la configurazione del traffico della distribuzione aggiornando la policy di implementazione continua.
**Aggiornamento di una policy di implementazione continua (console)**
1. Apri la console all' CloudFront indirizzo. [https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home)
1. Nel riquadro di navigazione seleziona **Distributions (Distribuzioni)**.
1. Scegliere la distribuzione principale. Questa è la distribuzione che attualmente serve il traffico di produzione, quella da cui verrà creata la distribuzione temporanea.
1. Nella sezione **Continuous deployment** (Implementazione continua), scegliere **Edit policy** (Modifica policy).
1. Modifica della configurazione del traffico in una policy di implementazione continua. Al termine, scegliere **Save changes (Salva le modifiche)**.
Quando la configurazione della distribuzione primaria con la politica di distribuzione continua aggiornata viene distribuita nelle edge location, CloudFront inizia a inviare traffico alla distribuzione temporanea in base alla configurazione del traffico aggiornata.
------
#### [ CLI ]
**Aggiornamento di una policy di implementazione continua (CLI con file di input)**
1. Utilizzare il seguente comando per salvare la configurazione della policy di implementazione continua in un file denominato `continuous-deployment-policy.yaml`. Sostituisci *continuous\$1deployment\$1policy\$1ID* con l'ID della politica di distribuzione continua. Il seguente comando utilizza caratteri di escape (\$1) e interruzioni di riga per la leggibilità, ma è necessario ometterli dal comando.
```
aws cloudfront get-continuous-deployment-policy-config --id continuous_deployment_policy_ID \
--output yaml > continuous-deployment-policy.yaml
```
1. Aprire il file `continuous-deployment-policy.yaml` appena creato. Modifica il file apportando le seguenti modifiche:
+ Modificare la configurazione del traffico della policy di implementazione continua come desiderato. Ad esempio, è possibile passare dall'utilizzo di una configurazione di traffico basata sull'intestazione a una basata sul peso oppure puoi modificare la percentuale di traffico (peso) per una configurazione basata sul peso. Per ulteriori informazioni, consultare [Instradamento delle richieste alla distribuzione temporanea](understanding-continuous-deployment.md#understanding-continuous-deployment-routing) e [Persistenza della sessione per configurazioni basate sul peso](understanding-continuous-deployment.md#understanding-continuous-deployment-sessions).
+ Rinominare il campo `ETag` in `IfMatch`, ma non modificare il valore del campo.
Salvare il file al termine.
1. Utilizzare il comando seguente per aggiornare policy di implementazione continua. Sostituisci *continuous\$1deployment\$1policy\$1ID* con l'ID della politica di distribuzione continua. Il seguente comando utilizza caratteri di escape (\$1) e interruzioni di riga per la leggibilità, ma è necessario ometterli dal comando.
```
aws cloudfront update-continuous-deployment-policy --id continuous_deployment_policy_ID \
--cli-input-yaml file://continuous-deployment-policy.yaml
```
Quando la configurazione della distribuzione primaria con la politica di distribuzione continua aggiornata viene distribuita su postazioni periferiche, CloudFront inizia a inviare il traffico alla distribuzione temporanea in base alla configurazione del traffico aggiornata.
------
#### [ API ]
Per aggiornare una politica di distribuzione continua, usa. [UpdateContinuousDeploymentPolicy](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateContinuousDeploymentPolicy.html)
------
## Promozione di una configurazione di distribuzione temporanea
Nelle procedure seguenti viene illustrato come promuovere una configurazione di distribuzione temporanea.
------
#### [ Console ]
Quando *promuovi* una distribuzione temporanea, CloudFront copia la configurazione dalla distribuzione temporanea alla distribuzione principale. CloudFront disabilita inoltre la politica di distribuzione continua e indirizza tutto il traffico verso la distribuzione primaria.
Dopo aver promosso una configurazione, è possibile riutilizzare la stessa distribuzione temporanea la prossima volta che si desidera testare una modifica alla configurazione.
**Promozione della configurazione di una distribuzione temporanea (console)**
1. Apri la CloudFront console all'indirizzo[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. Nel riquadro di navigazione seleziona **Distributions (Distribuzioni)**.
1. Scegliere la distribuzione principale. Questa è la distribuzione che attualmente serve il traffico di produzione, quella da cui verrà creata la distribuzione temporanea.
1. Nella sezione **Continuous deployment** (Implementazione continua), scegliere **Promote** (Promuovi).
1. Digitare **confirm** e scegliere **Promote** (Promuovi).
------
#### [ CLI ]
Quando *promuovi* una distribuzione temporanea, CloudFront copia la configurazione dalla distribuzione temporanea alla distribuzione principale. CloudFront disabilita inoltre la politica di distribuzione continua e indirizza tutto il traffico verso la distribuzione primaria.
Dopo aver promosso una configurazione, è possibile riutilizzare la stessa distribuzione temporanea la prossima volta che si desidera testare una modifica alla configurazione.
**Promozione di una configurazione di una distribuzione temporanea (CLI)**
+ Utilizzare il comando **aws cloudfront update-distribution-with-staging-config** per promuovere la configurazione della distribuzione temporanea alla distribuzione principale. Il seguente comando di esempio utilizza caratteri di escape (\$1) e interruzioni di riga per la leggibilità, ma è necessario ometterli dal comando. Nel seguente è un comando di esempio:
+ Sostituisci *primary\$1distribution\$1ID* con l'ID della distribuzione principale.
+ Sostituisci *staging\$1distribution\$1ID* con l'ID della distribuzione temporanea.
+ Sostituisci *primary\$1distribution\$1ETag* e *staging\$1distribution\$1ETag* con i `ETag` valori della distribuzione primaria e della distribuzione temporanea. Assicurarsi che il valore della distribuzione principale sia il primo, come mostrato nell'esempio.
```
aws cloudfront update-distribution-with-staging-config --id primary_distribution_ID \
--staging-distribution-id staging_distribution_ID \
--if-match 'primary_distribution_ETag,staging_distribution_ETag'
```
------
#### [ API ]
Per promuovere la configurazione di una distribuzione temporanea alla distribuzione primaria, usa. [UpdateDistributionWithStagingConfig](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistributionWithStagingConfig.html)
------