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

Puede crear, actualizar y modificar las distribuciones provisionales y las políticas de implementación continua en la consola de CloudFront, con la AWS Command Line Interface (AWS CLI) o con la API de CloudFront.

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

Los siguientes procedimientos muestran cómo crear una distribución provisional con una política de implementación continua.

Console

Puede crear una distribución provisional con una política de implementación continua mediante la AWS Management Console.

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 Distributions (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).

Cuando termine el asistente Create staging distribution (Crear distribución provisional) en la consola de CloudFront, CloudFront hace lo siguiente:

• Crea una distribución provisional con la configuración que especificó (en el paso 5c)

• Crea una política de implementación continua con la configuración de tráfico que especificó (en el paso 5d)

• Asocia la política de implementación continua a la distribución principal desde la que creó la distribución provisional.

Cuando la configuración de la distribución principal, con la política de implementación continua asociada, se implementa en ubicaciones periféricas, CloudFront comienza a enviar la parte especificada del tráfico a la distribución provisional en función de la configuración del tráfico.

CLI

Para crear una distribución provisional y una política de implementación continua con la AWS CLI, utilice los siguientes procedimientos.

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

Cuando la configuración de la distribución principal, con la política de implementación continua asociada, se implementa en ubicaciones periféricas, CloudFront comienza a enviar la parte especificada del tráfico a la distribución provisional en función de la configuración del tráfico.

API

Para crear una distribución provisional y una política de implementación continua con la API de CloudFront, utilice las siguientes operaciones de la API:

• CopyDistribution

• CreateContinuousDeploymentPolicy

Para obtener más información acerca de los campos que especifique en estas llamadas a la API, consulte lo siguiente:

• Enrutamiento de solicitudes a la distribución provisional

• Persistencia de sesión para configuraciones basadas en ponderaciones

• La documentación de referencia de la API para el SDK de AWS u otro cliente de la API

Tras crear una distribución provisional y una política de implementación continua, utilice UpdateDistribution (en la distribución principal) para asociar la política de implementación continua a la distribución principal.

Actualización de una distribución provisional

Los siguientes procedimientos muestran cómo actualizar una distribución provisional con una política de implementación continua.

Console

Puede actualizar determinadas configuraciones tanto para la distribución principal como para la provisional. Para obtener más información, consulte Actualización de las distribuciones principales y provisionales.

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 Distributions (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.

En cuanto la configuración de la distribución provisional se implemente en las ubicaciones periféricas, se aplica al tráfico entrante que se dirige a la distribución provisional.

CLI

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

En cuanto la configuración de la distribución provisional se implemente en las ubicaciones periféricas, se aplica al tráfico entrante que se dirige a la distribución provisional.

API

Para actualizar la configuración de una distribución provisional, utilice UpdateDistribution (en la distribución provisional) 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.

Actualización de una política de implementación continua

Los siguientes procedimientos muestran cómo actualizar una política de implementación continua.

Console

Puede actualizar la configuración de tráfico de su distribución actualizando la política de implementación continua.

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 Distributions (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.

Cuando la configuración de la distribución principal, con la política de implementación continua actualizada, se implementa en ubicaciones periféricas, CloudFront comienza a enviar el tráfico a la distribución provisional en función de la configuración del tráfico.

CLI

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

Cuando la configuración de la distribución principal, con la política de implementación continua actualizada, se implementa en ubicaciones periféricas, CloudFront comienza a enviar el tráfico a la distribución provisional en función de la configuración del tráfico.

API

Para actualizar una política de implementación continua, utilice UpdateContinuousDeploymentPolicy.

Promoción de una configuración de distribución provisional

Los siguientes procedimientos muestran cómo promocionar una configuración de distribución provisional.

Console

Al promover una distribución provisional, CloudFront copia la configuración de la distribución provisional a la distribución principal. Esto también deshabilita la política de implementación continua y enruta todo el tráfico a la distribución principal.

Después de promover una configuración, puede volver a utilizar la misma distribución provisional la próxima vez que quiera probar un cambio de configuración.

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 Distributions (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).

CLI

Al promover una distribución provisional, CloudFront copia la configuración de la distribución provisional a la distribución principal. Esto también deshabilita la política de implementación continua y enruta todo el tráfico a la distribución principal.

Después de promover una configuración, puede volver a utilizar la misma distribución provisional la próxima vez que quiera probar un cambio de configuración.

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'

API

Para promover la configuración de una distribución provisional a la distribución principal, utilice UpdateDistributionWithStagingConfig.