

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

# Utilizza la distribuzione CloudFront continua per testare in sicurezza le modifiche alla configurazione CDN
<a name="continuous-deployment"></a>

Con la *distribuzione CloudFront continua* di Amazon puoi implementare in sicurezza le modifiche alla tua configurazione CDN testandola prima con un sottoinsieme di traffico di produzione. È possibile utilizzare una *distribuzione temporanea* e una *policy di implementazione continua* per inviare parte del traffico da visualizzatori reali (di produzione) alla nuova configurazione CDN e convalidare che funzioni come previsto. È possibile monitorare le prestazioni della nuova configurazione in tempo reale e promuovere la nuova configurazione per servire tutto il traffico tramite la *distribuzione principale*, una volta pronti.

Il diagramma seguente mostra i vantaggi dell'utilizzo della distribuzione continua. CloudFront Senza di essa, è necessario testare le modifiche alla configurazione CDN con traffico simulato. Con l'implementazione continua è possibile testare le modifiche con un sottoinsieme del traffico di produzione, quindi promuovere le modifiche alla distribuzione principale quando si è pronti.

![\[Grafico della distribuzione CloudFront continua che invia il traffico di produzione a una distribuzione temporanea.\]](http://docs.aws.amazon.com/it_it/AmazonCloudFront/latest/DeveloperGuide/images/cloudfront-continuous-deployment.png)


Per ulteriori informazioni sull’utilizzo dell’implementazione continua, consulta gli argomenti seguenti.

**Topics**
+ [

# CloudFront flusso di lavoro di distribuzione continuo
](continuous-deployment-workflow.md)
+ [

# Utilizzo di una distribuzione temporanea e di una policy di implementazione continua
](working-with-staging-distribution-continuous-deployment-policy.md)
+ [

# Monitoraggio di una distribuzione temporanea
](monitoring-staging-distribution.md)
+ [

# Ulteriori informazioni sul funzionamento dell’implementazione continua
](understanding-continuous-deployment.md)
+ [

# Quote e altre considerazioni per l'implementazione continua
](continuous-deployment-quotas-considerations.md)

# CloudFront flusso di lavoro di distribuzione continuo
<a name="continuous-deployment-workflow"></a>

Il seguente flusso di lavoro di alto livello spiega come testare e implementare in sicurezza le modifiche alla configurazione con CloudFront una distribuzione continua.

1. Scegliere la distribuzione che si desidera utilizzare come *distribuzione principale*. La distribuzione principale è quella che attualmente serve il traffico di produzione.

1. Dalla distribuzione principale, creare una *distribuzione temporanea*. Una distribuzione temporanea inizia come una copia della distribuzione principale.

1. Creare una *configurazione del traffico* all'interno di una *policy di implementazione continua* e collegarla alla distribuzione principale. Ciò determina il modo in cui CloudFront indirizza il traffico verso la distribuzione temporanea. Per ulteriori informazioni sull'instradamento delle richieste verso una distribuzione temporanea, consulta [Instradamento delle richieste alla distribuzione temporanea](understanding-continuous-deployment.md#understanding-continuous-deployment-routing).

1. Aggiornare 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).

1. Monitorare la distribuzione temporanea per determinare se le modifiche alla configurazione funzionano come previsto. Per ulteriori informazioni sul monitoraggio di una distribuzione temporanea, consulta [Monitoraggio di una distribuzione temporanea](monitoring-staging-distribution.md).

   Mentre si monitora la distribuzione temporanea è possibile:
   + Aggiornare nuovamente la configurazione della distribuzione temporanea per continuare a testare le modifiche alla configurazione.
   + Aggiornare la policy di implementazione continua (configurazione del traffico) per inviare più o meno traffico alla distribuzione temporanea.

1. Una volta soddisfatti delle prestazioni della distribuzione temporanea, *promuovere* la configurazione della distribuzione temporanea alla distribuzione principale, che copia la configurazione della distribuzione temporanea nella distribuzione principale. Ciò disabilita anche la politica di distribuzione continua, che significa che CloudFront indirizza tutto il traffico verso la distribuzione primaria.

È possibile creare un'automazione che monitora le prestazioni della distribuzione temporanea (fase 5) e promuova automaticamente la configurazione (fase 6) quando vengono soddisfatti determinati criteri.

Dopo aver promosso una configurazione, è possibile riutilizzare la stessa distribuzione temporanea la prossima volta che si desidera testare una modifica alla configurazione.

Per ulteriori informazioni sull'utilizzo delle distribuzioni temporanee e delle politiche di distribuzione continua nella CloudFront console, nell'API o nell' CloudFront API AWS CLI, consulta la sezione seguente.

# Utilizzo di una distribuzione temporanea e di una policy di implementazione continua
<a name="working-with-staging-distribution-continuous-deployment-policy"></a>

È 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
<a name="create-staging-distribution-continuous-deployment-policy"></a>

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
<a name="update-staging-distribution"></a>

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
<a name="update-continuous-deployment-policy"></a>

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
<a name="promote-staging-distribution-configuration"></a>

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)

------

# Monitoraggio di una distribuzione temporanea
<a name="monitoring-staging-distribution"></a>

Per monitorare le prestazioni di una distribuzione temporanea, puoi utilizzare le stesse [metriche, log e report](reports-and-monitoring.md) disponibili per tutte le CloudFront distribuzioni. Esempio:
+ Puoi visualizzare le [metriche di CloudFront distribuzione predefinite](viewing-cloudfront-metrics.md#monitoring-console.distributions) (come le richieste totali e il tasso di errore) nella CloudFront console e [attivare metriche aggiuntive](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional) (come la frequenza di accesso alla cache e il tasso di errore per codice di stato) a un costo aggiuntivo. È anche possibile creare degli allarmi in base a tali metriche.
+ È possibile visualizzare [i log standard e i](AccessLogs.md) [log di accesso in tempo reale](real-time-logs.md) per ottenere informazioni dettagliate sulle richieste ricevute dalla distribuzione temporanea. I log standard contengono i due campi seguenti che consentono di identificare la distribuzione principale a cui è stata originariamente inviata la richiesta prima di CloudFront indirizzarla alla distribuzione temporanea: e. `primary-distribution-id` `primary-distribution-dns-name`
+ È possibile visualizzare e scaricare [report](reports.md) nella CloudFront console, ad esempio il rapporto sulle statistiche della cache.

# Ulteriori informazioni sul funzionamento dell’implementazione continua
<a name="understanding-continuous-deployment"></a>

I seguenti argomenti spiegano come funziona la distribuzione CloudFront continua.

**Topics**
+ [

## Instradamento delle richieste alla distribuzione temporanea
](#understanding-continuous-deployment-routing)
+ [

## Persistenza della sessione per configurazioni basate sul peso
](#understanding-continuous-deployment-sessions)
+ [

## Aggiornamento delle distribuzioni principale e temporanea
](#updating-staging-and-primary-distributions)
+ [

## Le distribuzioni principali e temporanee non condividono una cache
](#staging-and-primary-no-shared-cache)

## Instradamento delle richieste alla distribuzione temporanea
<a name="understanding-continuous-deployment-routing"></a>

Quando si utilizza la distribuzione CloudFront continua, non è necessario modificare nulla delle richieste dei visualizzatori. I visualizzatori non possono inviare richieste direttamente a una distribuzione temporanea utilizzando un nome DNS, un indirizzo IP o un CNAME. Al contrario, gli spettatori inviano le richieste alla distribuzione primaria (di produzione) e CloudFront indirizzano alcune di queste richieste alla distribuzione temporanea in base alle impostazioni di configurazione del traffico contenute nella politica di distribuzione continua. Esistono due tipi di configurazioni del traffico:

**Basata sul peso**  
Una configurazione basata sul peso indirizza la percentuale specificata di richieste dei visualizzatori alla distribuzione temporanea. Quando utilizzi una configurazione basata sul peso, puoi anche abilitare la *persistenza della sessione*, il che aiuta a garantire che le richieste dello stesso visualizzatore vengano CloudFront trattate come parte di una singola sessione. Per ulteriori informazioni, consulta [Persistenza della sessione per configurazioni basate sul peso](#understanding-continuous-deployment-sessions).

**Basata sull'intestazione**  
Una configurazione basata sull'intestazione indirizza le richieste alla distribuzione temporanea quando la richiesta del visualizzatore contiene un'intestazione HTTP specifica (si specificano l'intestazione e il valore). Le richieste che non contengono l'intestazione e il valore specificati vengono indirizzate alla distribuzione principale. Questa configurazione è utile per i test locali o quando si ha il controllo sulle richieste dei visualizzatori.  
Le intestazioni indirizzate alla distribuzione temporanea devono contenere il prefisso `aws-cf-cd-`.

## Persistenza della sessione per configurazioni basate sul peso
<a name="understanding-continuous-deployment-sessions"></a>

Quando utilizzi una configurazione basata sul peso per indirizzare il traffico verso una distribuzione temporanea, puoi anche abilitare la *persistenza della sessione*, che aiuta a far sì che le richieste dello stesso visualizzatore vengano CloudFront trattate come un'unica sessione. Quando abiliti la persistenza della sessione, CloudFront imposta un cookie in modo che tutte le richieste dello stesso visualizzatore in una singola sessione vengano servite da un'unica distribuzione, principale o temporanea.

Quando si abilita la persistenza della sessione, è anche possibile specificare la *durata dell'inattività*. Se il visualizzatore è inattivo (non invia richieste) per questo periodo di tempo, la sessione scade e CloudFront considera le richieste future di questo visualizzatore come una nuova sessione. La durata dell'inattività viene specificata in un numero di secondi, da 300 (cinque minuti) a 3.600 (un'ora).

Nei seguenti casi, CloudFront reimposta tutte le sessioni (anche quelle attive) e considera tutte le richieste come una nuova sessione:
+ Si disabilita o si abilita la policy di implementazione continua
+ Si disabilita o si abilita l'impostazione della persistenza della sessione

## Aggiornamento delle distribuzioni principale e temporanea
<a name="updating-staging-and-primary-distributions"></a>

Quando a una distribuzione principale è associata una policy di implementazione continua, sono disponibili le seguenti modifiche alla configurazione sia per la distribuzione principale che per quella temporanea:
+ Tutte le impostazioni del comportamento della cache, incluso il comportamento predefinito della cache
+ Tutte le impostazioni di origine (origini e gruppi di origine)
+ Risposte agli errori personalizzate (pagine di errore)
+ Restrizioni geografiche
+ Default Root Object (Oggetto root di default)
+ Impostazioni di registrazione
+ Descrizione (commento)

Puoi anche aggiornare le risorse esterne a cui si fa riferimento nella configurazione di una distribuzione, come una politica di cache, una politica di intestazioni di risposta, una funzione o una funzione CloudFront Lambda @Edge.

## Le distribuzioni principali e temporanee non condividono una cache
<a name="staging-and-primary-no-shared-cache"></a>

Le distribuzioni principali e temporanee non condividono una cache. Quando CloudFront invia la prima richiesta a una distribuzione temporanea, la relativa cache è vuota. Quando le richieste arrivano alla distribuzione temporanea, inizia a memorizzare le risposte nella cache (se configurata per effettuare questa operazione).

# Quote e altre considerazioni per l'implementazione continua
<a name="continuous-deployment-quotas-considerations"></a>

CloudFront la distribuzione continua è soggetta alle seguenti quote e ad altre considerazioni.

## Quote
<a name="continuous-deployment-quotas"></a>
+ Numero massimo di distribuzioni di staging per: 20 Account AWS
+ Numero massimo di politiche di distribuzione continua per Account AWS: 20
+ Percentuale massima di traffico che è possibile inviare a una distribuzione temporanea in una configurazione basata sul peso: 15%
+ Valori minimi e massimi per la durata di inattività della persistenza della sessione: 300 - 3.600 secondi

Per ulteriori informazioni, consulta [Quote](cloudfront-limits.md).

**Nota**  
Quando si utilizza l’implementazione continua e la distribuzione primaria è impostata con OAC per l’accesso al bucket S3, aggiorna la policy di bucket S3 per consentire l’accesso alla distribuzione temporanea. Per le policy di bucket S3 di esempio, consulta [Concedi l' CloudFront autorizzazione per accedere al bucket S3](private-content-restricting-access-to-s3.md#oac-permission-to-access-s3).

## AWS WAF web ACLs
<a name="waf-web-acl"></a>

Se abiliti l’implementazione continua per la distribuzione, per AWS WAF si applicano le seguenti considerazioni:
+ Non è possibile associare una lista di controllo degli accessi AWS WAF Web (ACL) alla distribuzione se è la prima volta che l'ACL viene associata alla distribuzione.
+ Non è possibile dissociare un ACL AWS WAF Web dalla distribuzione.

Prima di poter eseguire le operazioni precedenti, è necessario eliminare la policy di implementazione continua per la distribuzione di produzione. Ciò elimina anche la distribuzione temporanea. Per ulteriori informazioni, consulta [Utilizzo di protezioni AWS WAF](distribution-web-awswaf.md).

## Casi in cui CloudFront invia tutte le richieste alla distribuzione primaria
<a name="all-requests-to-primary-distribution"></a>

In alcuni casi, ad esempio nei periodi di elevato utilizzo delle risorse, è CloudFront possibile inviare tutte le richieste alla distribuzione primaria indipendentemente da quanto specificato nella politica di distribuzione continua.

CloudFront invia tutte le richieste alla distribuzione principale durante le ore di traffico di punta, indipendentemente da quanto specificato nella politica di distribuzione continua. Il traffico di picco si riferisce al traffico sul *CloudFront servizio* e non al traffico sulla tua distribuzione.

## HTTP/3
<a name="continuous-deployment-http3"></a>

Non è possibile utilizzare l'implementazione continua con una distribuzione che supporta HTTP/3.