Crea una distribuzione temporanea con una politica di distribuzione continua Aggiornare una distribuzione temporanea Aggiorna una politica di distribuzione continua Promuovi una configurazione di distribuzione temporanea

Utilizza una politica di distribuzione temporanea e di distribuzione 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.

Crea una distribuzione temporanea con una politica di distribuzione continua

Le seguenti procedure mostrano come creare una distribuzione temporanea con una politica di distribuzione continua.

Console

È possibile creare una distribuzione temporanea con una politica di distribuzione continua utilizzando. AWS Management Console

Creazione di una distribuzione temporanea e di una policy di implementazione continua (console)

Accedi a AWS Management Console e apri la CloudFront console all'indirizzohttps://console.aws.amazon.com/cloudfront/v4/home.
Nel riquadro di navigazione seleziona Distributions (Distribuzioni).
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.
Nella sezione Continuous deployment (Implementazione continua), scegliere Create staging distribution (Crea distribuzione temporanea). Si apre la procedura guidata Create staging distribution (Crea distribuzione temporanea).
Nella procedura guidata Create staging distribution (Crea distribuzione temporanea), effettuare le seguenti operazioni:
1. (Facoltativo) Digitare una descrizione per la distribuzione temporanea.
2. Seleziona Successivo.
3. Modificare la configurazione della distribuzione temporanea. Per ulteriori informazioni sulle impostazioni che è possibile aggiornare, consulta Aggiorna le distribuzioni primarie e staging.
  
  Una volta terminato di modificare la configurazione della distribuzione temporanea, scegliere Next (Avanti).
4. 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 Indirizza le richieste alla distribuzione temporanea.
  
  Una volta terminato con Traffic configuration (Configurazione del traffico), scegliere Next (Avanti).
5. 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)

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, sostituire primary_distribution_ID con l'ID della distribuzione principale.
```
aws cloudfront get-distribution --id primary_distribution_ID | grep 'ETag'
```
Copiare il valore ETag (servirà nella fase successiva).
Utilizzare il comando aws cloudfront copy-distribution per creare una distribuzione temporanea. Il seguente comando di esempio utilizza caratteri di escape (\) e interruzioni di riga per la leggibilità, ma è necessario ometterli dal comando. Nel seguente è un comando di esempio:
- Sostituire primary_distribution_ID con l'ID della distribuzione principale.
- Sostituire primary_distribution_ETag con il valore ETag della distribuzione principale (che hai copiato nella fase precedente).
- (Facoltativo) Sostituire CLI_example 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)

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 (\) 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
```
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.
  - PerItems, 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 Indirizza le richieste alla distribuzione temporanea e Persistenza della sessione per configurazioni basate sul peso.
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)

Utilizzare il comando seguente per salvare la configurazione della distribuzione principale in un file denominato primary-distribution.yaml. Sostituire primary_distribution_ID con l'ID della distribuzione principale.
```
aws cloudfront get-distribution-config --id primary_distribution_ID --output yaml > primary-distribution.yaml
```
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.
Utilizzare il comando seguente per aggiornare la distribuzione principale e utilizzare la policy di implementazione continua. Sostituire primary_distribution_ID 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 distribuita 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:

Per ulteriori informazioni sui campi specificati in queste chiamate API, consulta quanto segue:

Indirizza le richieste alla distribuzione temporanea
Persistenza della sessione per configurazioni basate sul peso
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(sulla distribuzione principale) per allegare la politica di distribuzione continua alla distribuzione primaria.

Aggiornare una distribuzione temporanea

Le seguenti procedure mostrano come aggiornare una distribuzione temporanea con una politica di distribuzione continua.

Console

È possibile aggiornare determinate configurazioni sia per la distribuzione primaria che per quella temporanea. Per ulteriori informazioni, consulta Aggiorna le distribuzioni primarie e staging.

Aggiornamento di una distribuzione temporanea (console)

Apri la console all' CloudFront indirizzo. https://console.aws.amazon.com/cloudfront/v4/home
Nel riquadro di navigazione seleziona Distributions (Distribuzioni).
Scegliere la distribuzione principale. Questa è la distribuzione che attualmente serve il traffico di produzione, quella da cui verrà creata la distribuzione temporanea.
Scegliere View staging distribution (Visualizza distribuzione temporanea).
Utilizzare la console per modificare la configurazione della distribuzione temporanea. Per ulteriori informazioni sulle impostazioni che è possibile aggiornare, consulta Aggiorna le distribuzioni primarie e staging.

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)

Utilizzare il comando seguente per salvare la configurazione della distribuzione temporanea in un file denominato staging-distribution.yaml. Sostituire staging_distribution_ID con l'ID della distribuzione temporanea.
```
aws cloudfront get-distribution-config --id staging_distribution_ID --output yaml > staging-distribution.yaml
```
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 Aggiorna le distribuzioni primarie e staging.
- Rinominare il campo ETag in IfMatch, ma non modificare il valore del campo.
Salvare il file al termine.
Utilizzare il seguente comando per aggiornare la configurazione della distribuzione temporanea. Sostituire staging_distribution_ID 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 per il traffico in entrata instradato alla distribuzione temporanea.

API

Per aggiornare la configurazione di una distribuzione temporanea, usa UpdateDistribution(sulla distribuzione temporanea) per modificare la configurazione della distribuzione temporanea. Per ulteriori informazioni sulle impostazioni che è possibile aggiornare, consulta Aggiorna le distribuzioni primarie e staging.

Aggiorna una politica di distribuzione continua

Le seguenti procedure mostrano come aggiornare una politica di distribuzione continua.

Console

È possibile aggiornare la configurazione del traffico della distribuzione aggiornando la politica di distribuzione continua.

Aggiornamento di una policy di implementazione continua (console)

Apri la CloudFront console all'indirizzohttps://console.aws.amazon.com/cloudfront/v4/home.
Nel riquadro di navigazione seleziona Distributions (Distribuzioni).
Scegliere la distribuzione principale. Questa è la distribuzione che attualmente serve il traffico di produzione, quella da cui verrà creata la distribuzione temporanea.
Nella sezione Continuous deployment (Implementazione continua), scegliere Edit policy (Modifica policy).
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)

Utilizzare il seguente comando per salvare la configurazione della policy di implementazione continua in un file denominato continuous-deployment-policy.yaml. Sostituire continuous_deployment_policy_ID con l'ID della policy di implementazione continua. Il seguente comando utilizza caratteri di escape (\) 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
```
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, consulta Indirizza le richieste alla distribuzione temporanea e Persistenza della sessione per configurazioni basate sul peso.
- Rinominare il campo ETag in IfMatch, ma non modificare il valore del campo.
Salvare il file al termine.
Utilizzare il comando seguente per aggiornare policy di implementazione continua. Sostituire continuous_deployment_policy_ID con l'ID della policy di implementazione continua. Il seguente comando utilizza caratteri di escape (\) 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 sulle edge location, 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

Promuovi una configurazione di distribuzione temporanea

Le seguenti procedure mostrano 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)

Apri la CloudFront console all'indirizzohttps://console.aws.amazon.com/cloudfront/v4/home.
Nel riquadro di navigazione seleziona Distributions (Distribuzioni).
Scegliere la distribuzione principale. Questa è la distribuzione che attualmente serve il traffico di produzione, quella da cui verrà creata la distribuzione temporanea.
Nella sezione Continuous deployment (Implementazione continua), scegliere Promote (Promuovi).
Digitare confirm e scegliere Promote (Promuovi).

CLI

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 (\) e interruzioni di riga per la leggibilità, ma è necessario ometterli dal comando. Nel seguente è un comando di esempio:
- Sostituire primary_distribution_ID con l'ID della distribuzione principale.
- Sostituire staging_distribution_ID con l'ID della distribuzione temporanea.
- Sostituire primary_distribution_ETag e staging_distribution_ETag con i valori ETag delle distribuzioni principali e temporanee. 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

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

CloudFront flusso di lavoro di distribuzione continua

Monitora una distribuzione temporanea