Crea una configurazione di distribuzione con CodeDeploy

Se non desideri utilizzare una delle configurazioni di distribuzione predefinite fornite CodeDeploy, puoi crearne una personalizzata utilizzando le seguenti istruzioni.

Puoi utilizzare la CodeDeploy console AWS CLI, le CodeDeploy API o un AWS CloudFormation modello per creare configurazioni di distribuzione personalizzate.

Per informazioni sull'utilizzo di un AWS CloudFormation modello per creare una configurazione di distribuzione, consulta. AWS CloudFormation modelli di CodeDeploy riferimento

Creazione di una configurazione di distribuzione (console)

Utilizza le seguenti istruzioni per creare una configurazione di distribuzione utilizzando la AWS console.

Per creare una configurazione di distribuzione CodeDeploy utilizzando la console

1. Accedi AWS Management Console e apri la CodeDeploy console all'indirizzo https://console.aws.amazon.com/codedeploy.

   Nota

   Accedi con lo stesso utente che hai configuratoGuida introduttiva con CodeDeploy.

2. Nel riquadro di navigazione, scegli Configurazioni di distribuzione.

   Viene visualizzato un elenco di configurazioni di distribuzione integrate.

3. Selezionare Create deployment configuration (Crea configurazione della distribuzione).

4. In Nome di configurazione di distribuzione, immettere un nome per la configurazione di distribuzione. Ad esempio, my-deployment-config.

5. In Piattaforma Compute, scegli una delle seguenti opzioni:

   • EC2/On-premise

   • AWS Lambda

   • Amazon ECS

6. Esegui una di queste operazioni:

   • Se hai scelto EC2/On-premises:

     1. In Minimo numero di host integri, specifica il numero o la percentuale di istanze che devono rimanere disponibili in qualsiasi momento durante una distribuzione. Per ulteriori informazioni su come CodeDeploy monitora e valuta lo stato delle istanze durante una distribuzione, consulta. Instance Health

     2. (Facoltativo) In Configurazione zonale, seleziona Abilita configurazione zonale per CodeDeploy distribuire l'applicazione in una zona di disponibilità alla volta, all'interno di una regione. AWS Effettuando l'implementazione in una zona di disponibilità alla volta, è possibile esporre l'implementazione a un pubblico sempre più vasto man mano che aumenta la fiducia nelle prestazioni e nella fattibilità dell'implementazione. Se non abiliti una configurazione zonale, CodeDeploy distribuisce l'applicazione su una selezione casuale di host in una regione.

        Se abiliti la funzionalità di configurazione zonale, tieni presente quanto segue:

        • La funzionalità di configurazione zonale è supportata solo con distribuzioni in loco su istanze Amazon EC2. (Le distribuzioni blu/verdi e le istanze locali non sono supportate.) Per ulteriori informazioni sulle distribuzioni sul posto, consulta. Il tipo di distribuzione

        • La funzionalità di configurazione zonale non è supportata con configurazioni di distribuzione predefinite. Per utilizzare una configurazione zonale, è necessario creare una configurazione di distribuzione personalizzata, come descritto qui.

        • Se è CodeDeploy necessario ripristinare una distribuzione, CodeDeploy eseguirà le operazioni di rollback su host casuali. (non CodeDeploy eseguirà il rollback di una zona alla volta, come ci si potrebbe aspettare.) Questo comportamento di rollback è stato scelto per motivi di prestazioni. Per ulteriori informazioni sui rollback, vedere. Ridistribuisci e ripristina una distribuzione con CodeDeploy

     3. Se avete selezionato la casella di controllo Abilita configurazione zonale, specificate facoltativamente le seguenti opzioni:

        • (Facoltativo) In Durata del monitoraggio, specificare il periodo di tempo, in secondi, che CodeDeploy deve trascorrere dopo il completamento di una distribuzione in una zona di disponibilità. CodeDeploy aspetterà questo periodo di tempo prima di iniziare una distribuzione nella successiva zona di disponibilità. Prendi in considerazione l'aggiunta di una durata del monitoraggio per dare alla distribuzione un po' di tempo per mettersi alla prova (o «funzionare») in una zona di disponibilità prima di essere rilasciata nella zona successiva. Se non specifichi la durata del monitoraggio, CodeDeploy inizia immediatamente la distribuzione nella zona di disponibilità successiva. Per ulteriori informazioni su come funziona l'impostazione della durata del monitoraggio, consultaCirca il numero minimo di istanze integre per zona di disponibilità.

        • (Facoltativo) Seleziona Aggiungi una durata del monitoraggio per la prima zona per impostare una durata del monitoraggio che si applica solo alla prima zona di disponibilità. È possibile impostare questa opzione se si desidera consentire tempi di cottura aggiuntivi per la prima zona di disponibilità. Se non specifichi un valore in Aggiungi la durata del monitoraggio della prima zona, CodeDeploy utilizza il valore della durata del monitoraggio per la prima zona di disponibilità.

        • (Facoltativo) In Numero minimo di host integri per zona, specifica il numero o la percentuale di istanze che devono rimanere disponibili per zona di disponibilità durante una distribuzione. Scegliete FLEET_PERCENT per specificare una percentuale o HOST_COUNT per specificare un numero. Questo campo funziona in combinazione con il campo Minimum healthy hosts. Per ulteriori informazioni, consulta Circa il numero minimo di istanze integre per zona di disponibilità.

          Se non si specifica un valore in Numero minimo di host sani per zona, CodeDeploy utilizza il valore predefinito 0 percentuale.

   • Se hai scelto AWS LambdaAmazon ECS:

     1. Per Tipo, scegli Linear o Canary.

     2. Nei campi Fase e Intervallo, effettuate una delle seguenti operazioni:

        • Se hai scelto Canary, per Step, inserisci una percentuale di traffico, compresa tra 1 e 99, da spostare. Questa è la percentuale di traffico che viene spostata nel primo incremento. Il traffico rimanente viene reinstradato con il secondo blocco incrementale dopo l'intervallo di tempo selezionato.

          Per Intervallo, inserisci il numero di minuti tra il primo e il secondo cambio di traffico.

        • Se hai scelto Linear, per Step, inserisci una percentuale di traffico, compresa tra 1 e 99, da spostare. Questa è la percentuale di traffico che viene spostata all'inizio di ogni intervallo.

          Per Intervallo, inserisci il numero di minuti tra ogni spostamento incrementale.

7. Selezionare Create deployment configuration (Crea configurazione della distribuzione).

   Ora hai una configurazione di distribuzione che puoi associare a un gruppo di distribuzione.

Creazione di una configurazione di distribuzione con CodeDeploy (AWS CLI)

Per utilizzare il AWS CLI per creare una configurazione di distribuzione, chiama il create-deployment-configcomando.

L'esempio seguente crea una configurazione di distribuzione EC2/on-premise denominata ThreeQuartersHealthy che richiede che il 75% delle istanze di destinazione rimanga integro durante una distribuzione:

aws deploy create-deployment-config --deployment-config-name ThreeQuartersHealthy --minimum-healthy-hosts type=FLEET_PERCENT,value=75

L'esempio seguente crea una configurazione di distribuzione EC2/locale denominata 300Total50PerAZ che richiede che 300 istanze di destinazione rimangano integre in totale per implementazione e 50 per zona di disponibilità. Imposta inoltre una durata del monitoraggio di 1 ora.

aws deploy create-deployment-config --deployment-config-name 300Total50PerAZ --minimum-healthy-hosts type=HOST_COUNT,value=300 --zonal-config '{"monitorDurationInSeconds":3600,"minimumHealthyHostsPerZone":{"type":"HOST_COUNT","value":50}}'

L'esempio seguente crea una configurazione di distribuzione AWS Lambda denominata. Canary25Percent45Minutes Usa lo spostamento del traffico Canary per spostare il 25% del traffico nel primo incremento. Il restante 75% viene spostato 45 minuti più tardi.

aws deploy create-deployment-config --deployment-config-name Canary25Percent45Minutes --traffic-routing-config "type="TimeBasedCanary",timeBasedCanary={canaryPercentage=25,canaryInterval=45}" --compute-platform Lambda

L'esempio seguente crea una configurazione di distribuzione Amazon ECS denominataCanary25Percent45Minutes. Usa lo spostamento del traffico Canary per spostare il 25% del traffico nel primo incremento. Il restante 75% viene spostato 45 minuti più tardi.

aws deploy create-deployment-config --deployment-config-name Canary25Percent45Minutes --traffic-routing-config "type="TimeBasedCanary",timeBasedCanary={canaryPercentage=25,canaryInterval=45}" --compute-platform ECS