Trabalhar com uma distribuição de preparação e uma política de implantação contínua

Como criar uma distribuição de preparação e uma política de implantação contínua (console)

1. Faça login no AWS Management Console e abra o console do CloudFront em https://console.aws.amazon.com/cloudfront/v4/home.

2. No painel de navegação, escolha Distribuições.

3. Escolha a distribuição que deseja usar como distribuição primária. A distribuição primária é aquela que lida atualmente com o tráfego de produção, aquela a partir da qual você criará a distribuição de preparação.

4. Na seção Continuous deployment (Implantação contínua), escolha Create staging distribution (Criar distribuição de preparação). Isso abre o assistente Create staging distribution (Criar distribuição de preparação).

5. No assistente Create staging distribution (Criar distribuição de preparação), faça o seguinte:

   1. (Opcional) Digite uma descrição para a distribuição de preparação.

   2. Escolha Próximo.

   3. Modifique a configuração da distribuição de preparação. Para obter mais informações sobre as configurações que você pode atualizar, consulte Atualizar distribuições principais e de preparação.

      Quando terminar de modificar a configuração da distribuição de preparação, escolha Next (Avançar).

   4. Use o console para especificar a Traffic configuration (Configuração de tráfego). Isso determina como o CloudFront direciona o tráfego para a distribuição de preparação. (O CloudFront armazena a configuração de tráfego em uma política de implantação contínua.)

      Para obter mais informações sobre as opções para uma Traffic configuration (Configuração de tráfego), consulte Encaminhar solicitações para a distribuição de preparação.

      Quando você concluir a Traffic configuration (Configuração de tráfego), escolha Next (Avançar).

   5. Revise a configuração da distribuição de preparação, incluindo a configuração de tráfego, depois escolha Create staging distribution (Criar distribuição de preparação).

Como criar uma distribuição de preparação (CLI)

1. Use os comandos aws cloudfront get-distribution e grep juntos para obter o valor de ETag da distribuição que você deseja usar como distribuição primária. A distribuição primária é aquela que lida atualmente com o tráfego de produção, da qual você criará a distribuição de preparação.

   O seguinte comando mostra um exemplo. No exemplo a seguir, substitua primary_distribution_ID pelo ID da distribuição primária.

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

   Copie o valor de ETag porque ele será necessário na próxima etapa.

2. Use o comando aws cloudfront copy-distribution para criar uma distribuição de preparação. O exemplo de comando a seguir usa caracteres de escape (\) e quebras de linha para facilitar a leitura, mas você deve omiti-los do comando. No exemplo de comando a seguir:

   • Substitua primary_distribution_ID pelo ID da distribuição primária.

   • Substitua primary_distribution_ETag pelo valor de ETag da distribuição primária (que você obteve na etapa anterior).

   • (Opcional) Substitua CLI_example pelo ID de referência do chamador desejado.

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

   A saída do comando mostra informações sobre a distribuição de preparação e sua configuração. Copie o nome de domínio do CloudFront da distribuição de preparação porque ele será necessário na próxima etapa.

Como criar uma política de implantação contínua (CLI com arquivo de entrada)

1. Use o comando a seguir para criar um arquivo chamado continuous-deployment-policy.yaml que contém todos os parâmetros de entrada para o comando create-continuous-deployment-policy. O comando a seguir usa caracteres de escape (\) e quebras de linha para facilitar a leitura, mas você deve omiti-los do comando.

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

2. Abra o arquivo chamado continuous-deployment-policy.yaml que você acabou de criar. Edite o arquivo para especificar as configurações de política de implantação contínua desejadas e salve o arquivo. Ao editar o arquivo:

   • Na seção StagingDistributionDnsNames, selecione:

     • Altere o valor de Quantity para 1.

     • Em Items, cole o nome de domínio do CloudFront da distribuição de preparação (que você salvou em uma etapa anterior).

   • Na seção TrafficConfig, selecione:

     • Escolha um Type: SingleWeight ou SingleHeader.

     • Remova as configurações do outro tipo. Por exemplo, se você quiser uma configuração de tráfego baseada em peso, defina Type como SingleWeight, depois remova as configurações de SingleHeaderConfig.

     • Para usar uma configuração de tráfego baseada em peso, defina o valor de Weight como um número decimal entre .01 (1%) e .15 (15%).

     Para obter mais informações sobre essas opções em TrafficConfig, consulte Encaminhar solicitações para a distribuição de preparação e Persistência da sessão para configurações baseadas em peso.

3. Use o seguinte comando para criar a política de implantação contínua usando parâmetros de entrada do arquivo continuous-deployment-policy.yaml.

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

   Copie o valor de Id na saída do comando. Esse é o ID da política de implantação contínua, que será necessário na próxima etapa.

Como anexar uma política de implantação contínua a uma distribuição primária (CLI com arquivo de entrada)

1. Use o comando a seguir para salvar a configuração da distribuição primária em um arquivo chamado primary-distribution.yaml. Substitua primary_distribution_ID pelo ID da distribuição primária.

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

2. Abra o arquivo chamado primary-distribution.yaml que você acabou de criar. Edite o arquivo fazendo as seguintes alterações:

   • Cole o ID da política de implantação contínua (que você copiou em uma etapa anterior) no campo ContinuousDeploymentPolicyId.

   • Renomeie o campo ETag para IfMatch, mas não altere o valor do campo.

   Ao concluir, salve o arquivo.

3. Use o comando a seguir para atualizar a distribuição primária para utilizar a política de implantação contínua. Substitua primary_distribution_ID pelo ID da distribuição primária.

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

Como atualizar uma distribuição de preparação (console)

1. Abra o console do CloudFront em https://console.aws.amazon.com/cloudfront/v4/home.

2. No painel de navegação, escolha Distribuições.

3. Escolha a distribuição primária. É a distribuição que lida atualmente com o tráfego de produção, aquela da qual você criou a distribuição de preparação.

4. Escolha View staging distribution (Exibir distribuição de preparação).

5. Use o console para modificar a configuração da distribuição de preparação. Para obter mais informações sobre as configurações que você pode atualizar, consulte Atualizar distribuições principais e de preparação.

Como atualizar uma distribuição de preparação (CLI com arquivo de entrada)

1. Use o comando a seguir para salvar a configuração da distribuição de preparação em um arquivo chamado staging-distribution.yaml. Substitua staging_distribution_ID pelo ID da distribuição de preparação.

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

2. Abra o arquivo chamado staging-distribution.yaml que você acabou de criar. Edite o arquivo fazendo as seguintes alterações:

   • Modifique a configuração da distribuição de preparação. Para obter mais informações sobre as configurações que você pode atualizar, consulte Atualizar distribuições principais e de preparação.

   • Renomeie o campo ETag para IfMatch, mas não altere o valor do campo.

   Ao concluir, salve o arquivo.

3. Use o comando a seguir para atualizar a configuração da distribuição de preparação. Substitua staging_distribution_ID pelo ID da distribuição de preparação.

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

Como atualizar uma política de implantação contínua (console)

1. Abra o console do CloudFront em https://console.aws.amazon.com/cloudfront/v4/home.

2. No painel de navegação, escolha Distribuições.

3. Escolha a distribuição primária. É a distribuição que lida atualmente com o tráfego de produção, aquela a partir da qual você criou a distribuição de preparação.

4. Na seção Continuous deployment (Implantação contínua), escolha Edit policy (Editar política).

5. Modifique a configuração de tráfego em uma política de implantação contínua. Ao concluir, escolha Save changes.

Como atualizar uma política de implantação contínua (CLI com arquivo de entrada)

1. Use o comando a seguir para salvar a configuração da política de implantação contínua em um arquivo chamado continuous-deployment-policy.yaml. Substitua continuous_deployment_policy_ID pelo ID da política de implantação contínua. O comando a seguir usa caracteres de escape (\) e quebras de linha para facilitar a leitura, mas você deve omiti-los do comando.

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

2. Abra o arquivo chamado continuous-deployment-policy.yaml que você acabou de criar. Edite o arquivo fazendo as seguintes alterações:

   • Modifique a configuração da política de implantação contínua como quiser. Por exemplo, você pode deixar de usar uma configuração de tráfego baseada em cabeçalho para passar a usar uma configuração de tráfego baseada em peso, ou você pode alterar a porcentagem de tráfego (peso) para uma configuração com base em peso. Para ter mais informações, consulte Encaminhar solicitações para a distribuição de preparação e Persistência da sessão para configurações baseadas em peso.

   • Renomeie o campo ETag para IfMatch, mas não altere o valor do campo.

   Ao concluir, salve o arquivo.

3. Use o comando a seguir para atualizar a política de implantação contínua. Substitua continuous_deployment_policy_ID pelo ID da política de implantação contínua. O comando a seguir usa caracteres de escape (\) e quebras de linha para facilitar a leitura, mas você deve omiti-los do comando.

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

Como promover a configuração de uma distribuição de preparação (console)

1. Abra o console do CloudFront em https://console.aws.amazon.com/cloudfront/v4/home.

2. No painel de navegação, escolha Distribuições.

3. Escolha a distribuição primária. É a distribuição que lida atualmente com o tráfego de produção, aquela a partir da qual você criou a distribuição de preparação.

4. Na seção Continuous deployment (Implantação contínua), escolha Promote (Promover).

5. Digite confirm, depois escolha Promote (Promover).

Como promover a configuração de uma distribuição de preparação (CLI)

• Use o comando aws cloudfront update-distribution-with-staging-config para promover a configuração da distribuição de preparação para a distribuição primária. O exemplo de comando a seguir usa caracteres de escape (\) e quebras de linha para facilitar a leitura, mas você deve omiti-los do comando. No exemplo de comando a seguir:

  • Substitua primary_distribution_ID pelo ID da distribuição primária.

  • Substitua staging_distribution_ID pelo ID da distribuição de preparação.

  • Substitua primary_distribution_ETag e staging_distribution_ETag pelos valores de ETag das distribuições primária e de preparação. Certifique-se de que o valor da distribuição primária seja o primeiro, conforme mostrado no exemplo.

  
  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'