Trabajo con una distribución provisional y una política de implementación continua

Para crear una distribución provisional y una política de implementación continua (consola)

1. Inicie sesión en la AWS Management Console y abra la consola de CloudFront en https://console.aws.amazon.com/cloudfront/v4/home.

2. En el panel de navegación, elija Distribuciones.

3. Elija la distribución que desea utilizar como distribución principal. La distribución principal es la que actualmente proporciona el tráfico de producción, desde la que se creará la distribución provisional.

4. En la sección Continuous deployment (Implementación continua), elija Create staging distribution (Crear distribución provisional). Esto abre el asistente Create staging distribution (Crear distribución provisional).

5. En el asistente Create staging distribution (Crear distribución provisional), haga lo siguiente:

   1. (Opcional) Escriba una descripción de la distribución provisional.

   2. Elija Siguiente.

   3. Modifique la configuración de la distribución provisional. Para obtener más información acerca de la configuración que puede actualizar, consulte Actualización de las distribuciones principales y provisionales.

      Cuando haya terminado de modificar la configuración de la distribución provisional, elija Next (Siguiente).

   4. Utilice la consola para especificar la Traffic configuration (Configuración del tráfico). Esto determina cómo CloudFront dirige el tráfico a la distribución provisional. (CloudFront almacena la configuración del tráfico en una política de implementación continua).

      Para obtener más información acerca de las opciones de una configuración de tráfico, consulte Enrutamiento de solicitudes a la distribución provisional.

      Cuando haya terminado con la Traffic configuration (Configuración del tráfico), elija Next (Siguiente).

   5. Revise la configuración de la distribución provisional, incluida la configuración del tráfico, y seleccione Create staging distribution (Crear distribución provisional).

Para crear una distribución provisional (CLI)

1. Utilice los comandos aws cloudfront get-distribution y grep juntos para obtener el valor ETag de la distribución que desea usar como distribución principal. La distribución principal es la que actualmente proporciona el tráfico de producción, desde la que se creará la distribución provisional.

   A continuación, se muestra un ejemplo del comando: En el siguiente ejemplo, sustituya primary_distribution_ID por el ID de la distribución principal.

   
   aws cloudfront get-distribution --id primary_distribution_ID | grep 'ETag'

   Copie el valor de ETag porque lo necesita para el siguiente paso.

2. Utilice el comando aws cloudfront copy-distribution para crear una distribución provisional. En el siguiente comando de ejemplo, se usan caracteres de escape (\) y saltos de línea para facilitar la lectura, pero debe omitirlos en el comando. En el siguiente comando de ejemplo:

   • Sustituya primary_distribution_ID por el ID de la distribución principal.

   • Sustituya primary_distribution_ETag por el valor de ETag de la distribución principal (que obtuvo en el paso anterior).

   • (Opcional) Sustituya CLI_example por el identificador de referencia de intermediario deseado.

   
   aws cloudfront copy-distribution --primary-distribution-id primary_distribution_ID \
                                    --if-match primary_distribution_ETag \
                                    --staging \
                                    --caller-reference 'CLI_example'

   El resultado del comando muestra información sobre la distribución provisional y su configuración. Copie el nombre de dominio de CloudFront de la distribución provisional porque lo necesita para el siguiente paso.

Para crear una política de implementación continua (CLI con archivo de entrada)

1. Utilice el siguiente comando para crear un archivo denominado continuous-deployment-policy.yaml que contenga todos los parámetros de entrada del comando create-continuous-deployment-policy. En el siguiente comando, se usan caracteres de escape (\) y saltos de línea para facilitar la lectura, pero debe omitirlos en el comando.

   
   aws cloudfront create-continuous-deployment-policy --generate-cli-skeleton yaml-input \
                                                      > continuous-deployment-policy.yaml

2. Abra el archivo llamado continuous-deployment-policy.yaml que acaba de crear. Edite el archivo para especificar la configuración de política de implementación continua que desee y, a continuación, guarde el archivo. Al editar el archivo:

   • En la sección StagingDistributionDnsNames:

     • Cambie el valor de Quantity a 1.

     • Para Items, pegue el nombre de dominio de CloudFront de la distribución provisional (que guardó en el paso anterior).

   • En la sección TrafficConfig:

     • Elija un Type o un SingleWeight o SingleHeader.

     • Elimine la configuración para el otro tipo. Por ejemplo, si desea una configuración de tráfico basada en ponderación, defina la configuración de Type en SingleWeight y, a continuación, elimine la configuración de SingleHeaderConfig.

     • Para utilizar una configuración de tráfico basada en ponderación, defina el valor de Weight en un número decimal comprendido entre .01 (uno por ciento) y .15 (quince por ciento).

     Para obtener más información sobre estas opciones en TrafficConfig, consulte Enrutamiento de solicitudes a la distribución provisional y Persistencia de sesión para configuraciones basadas en ponderaciones.

3. Utilice el siguiente comando para crear la política de implementación continua utilizando parámetros de entrada del archivo de continuous-deployment-policy.yaml.

   
   aws cloudfront create-continuous-deployment-policy --cli-input-yaml file://continuous-deployment-policy.yaml

   Copia el valor de Id de la salida del comando. Este es el identificador de la política de implementación continua y lo necesitará en el paso siguiente.

Para asociar una política de implementación continua a una distribución principal (CLI con archivo de entrada)

1. Utilice el siguiente comando para guardar la configuración de la distribución principal en un archivo con el nombre primary-distribution.yaml. Sustituya primary_distribution_ID por el ID de la distribución principal.

   
   aws cloudfront get-distribution-config --id primary_distribution_ID --output yaml > primary-distribution.yaml

2. Abra el archivo llamado primary-distribution.yaml que acaba de crear. Edite el archivo y realice los siguientes cambios:

   • Pegue el ID de la política de implementación continua (que copió del paso anterior) en el campo ContinuousDeploymentPolicyId.

   • Cambie el nombre del campo ETag a IfMatch, pero no cambie el valor del campo.

   Guarde el archivo cuando haya terminado.

3. Utilice el siguiente comando para actualizar la distribución principal y utilizar la política de implementación continua. Sustituya primary_distribution_ID por el ID de la distribución principal.

   
   aws cloudfront update-distribution --id primary_distribution_ID --cli-input-yaml file://primary-distribution.yaml

Para actualizar una distribución provisional (consola)

1. Abra la consola de CloudFront en https://console.aws.amazon.com/cloudfront/v4/home.

2. En el panel de navegación, elija Distribuciones.

3. Elija la distribución principal. Esta es la distribución principal que actualmente proporciona el tráfico de producción, desde la que ha creado la distribución provisional.

4. Elija View staging distribution (Ver distribución provisional).

5. Utilice la consola para modificar la configuración de la distribución provisional. Para obtener más información acerca de la configuración que puede actualizar, consulte Actualización de las distribuciones principales y provisionales.

Para actualizar una distribución provisional (CLI con archivo de entrada)

1. Utilice el siguiente comando para guardar la configuración de la distribución provisional en un archivo con el nombre staging-distribution.yaml. Reemplace staging_distribution_ID por el ID de la distribución provisional.

   
   aws cloudfront get-distribution-config --id staging_distribution_ID --output yaml > staging-distribution.yaml

2. Abra el archivo llamado staging-distribution.yaml que acaba de crear. Edite el archivo y realice los siguientes cambios:

   • Modifique la configuración de la distribución provisional. Para obtener más información acerca de la configuración que puede actualizar, consulte Actualización de las distribuciones principales y provisionales.

   • Cambie el nombre del campo ETag a IfMatch, pero no cambie el valor del campo.

   Guarde el archivo cuando haya terminado.

3. Utilice el siguiente comando para actualizar la configuración de la distribución provisional. Reemplace staging_distribution_ID por el ID de la distribución provisional.

   
   aws cloudfront update-distribution --id staging_distribution_ID --cli-input-yaml file://staging-distribution.yaml

Para actualizar una política de implementación continua (consola)

1. Abra la consola de CloudFront en https://console.aws.amazon.com/cloudfront/v4/home.

2. En el panel de navegación, elija Distribuciones.

3. Elija la distribución principal. Esta es la distribución principal que actualmente proporciona el tráfico de producción, desde la que ha creado la distribución provisional.

4. En la sección Continuous deployment (Implementación continua), elija Edit policy (Editar política).

5. Modifique la configuración del tráfico en la política de implementación continua. Cuando haya finalizado, elija Guardar cambios.

Para actualizar una política de implementación continua (CLI con archivo de entrada)

1. Utilice el siguiente comando para guardar la configuración de la política de implementación continua en un archivo con el nombre continuous-deployment-policy.yaml. Sustituya continuous_deployment_policy_ID por el ID de la política de implementación continua. En el siguiente comando, se usan caracteres de escape (\) y saltos de línea para facilitar la lectura, pero debe omitirlos en el comando.

   
   aws cloudfront get-continuous-deployment-policy-config --id continuous_deployment_policy_ID \
                                                          --output yaml > continuous-deployment-policy.yaml

2. Abra el archivo llamado continuous-deployment-policy.yaml que acaba de crear. Edite el archivo y realice los siguientes cambios:

   • Modifique la configuración de la política de implementación continua como desee. Por ejemplo, puede pasar de utilizar una configuración de tráfico basada en encabezados a una configuración basada en ponderaciones, o puede cambiar el porcentaje de tráfico (ponderación) para una configuración basada en ponderaciones. Para obtener más información, consulte Enrutamiento de solicitudes a la distribución provisional y Persistencia de sesión para configuraciones basadas en ponderaciones.

   • Cambie el nombre del campo ETag a IfMatch, pero no cambie el valor del campo.

   Guarde el archivo cuando haya terminado.

3. Utilice el siguiente comando para actualizar la política de implementación continua. Sustituya continuous_deployment_policy_ID por el ID de la política de implementación continua. En el siguiente comando, se usan caracteres de escape (\) y saltos de línea para facilitar la lectura, pero debe omitirlos en el comando.

   
   aws cloudfront update-continuous-deployment-policy --id continuous_deployment_policy_ID \
                                                      --cli-input-yaml file://continuous-deployment-policy.yaml

Para promover la configuración de una distribución provisional (consola)

1. Abra la consola de CloudFront en https://console.aws.amazon.com/cloudfront/v4/home.

2. En el panel de navegación, elija Distribuciones.

3. Elija la distribución principal. Esta es la distribución principal que actualmente proporciona el tráfico de producción, desde la que ha creado la distribución provisional.

4. En la sección Continuous deployment (Implementación continua), elija Promote (Promover).

5. Escriba confirm y, a continuación, seleccione Promote (Promover).

Para promover la configuración de una distribución provisional (CLI)

• Utilice el comando aws cloudfront update-distribution-with-staging-config para promover la configuración de la distribución provisional a la distribución principal. En el siguiente comando de ejemplo, se usan caracteres de escape (\) y saltos de línea para facilitar la lectura, pero debe omitirlos en el comando. En el siguiente comando de ejemplo:

  • Sustituya primary_distribution_ID por el ID de la distribución principal.

  • Sustituya staging_distribution_ID por el ID de la distribución provisional.

  • Sustituya primary_distribution_ETag y staging_distribution_ETag por los valores de ETag de las distribuciones principal y provisional. Asegúrese de que el valor de la distribución principal sea el primero, como se muestra en el ejemplo.

  
  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'