# Criar uma implantação azul/verde no Amazon Aurora
<a name="blue-green-deployments-creating"></a>

O RDS copia a topologia e os recursos do ambiente azul para uma área de preparação. Se uma instância de banco de dados azul tiver réplicas de leitura, elas serão copiadas como réplicas da instância verde. O armazenamento alocado de todas as réplicas verdes corresponde à instância primária verde, enquanto outros parâmetros de armazenamento são herdados das réplicas azuis.

Ao criar uma implantação azul/verde, você especifica o cluster de banco de dados a ser copiado na implantação. O cluster de banco de dados selecionado é o cluster de banco de dados de produção e torna-se o cluster de banco de dados no ambiente azul. O RDS copia a topologia do ambiente azul para uma área de teste, junto com seus recursos configurados. O cluster de banco de dados é copiado no ambiente verde, e o RDS configura a replicação do cluster de banco de dados no ambiente azul para o cluster de banco de dados no ambiente verde. O RDS também copia todas as instâncias de banco de dados no cluster de banco de dados.

**Topics**
+ [Preparação para uma implantação azul/verde](#blue-green-deployments-creating-preparing)
+ [Especificar as alterações ao criar uma implantação azul/verde](#blue-green-deployments-creating-changes)
+ [Criar uma implantação azul/verde](#blue-green-deployments-creating-create)
+ [Configurações para criar implantações azuis/verdes](#create-blue-green-settings)

## Preparação para uma implantação azul/verde
<a name="blue-green-deployments-creating-preparing"></a>

Há algumas etapas que você deve seguir antes de criar uma implantação azul/verde, dependendo do mecanismo que o cluster de banco de dados do Aurora está executando.

**Topics**
+ [Preparar um cluster de banco de dados do Aurora MySQL para uma implantação azul/verde](#blue-green-deployments-creating-preparing-mysql)
+ [Preparar um cluster de banco de dados do Aurora PostgreSQL para uma implantação azul/verde](#blue-green-deployments-creating-preparing-postgres)
+ [Preparar um cluster de banco de dados do Aurora Global Databases para uma implantação azul/verde](#blue-green-deployments-creating-preparing-agd)

### Preparar um cluster de banco de dados do Aurora MySQL para uma implantação azul/verde
<a name="blue-green-deployments-creating-preparing-mysql"></a>

Antes de criar uma implantação azul/verde para um cluster de banco de dados do Aurora MySQL, o cluster de banco de dados deve estar associado a um grupo de parâmetros de cluster de banco de dados personalizado com o [registro em log binário](USER_LogAccess.MySQL.BinaryFormat.md) (`binlog_format`) ativado. O registro em log binário é necessário para a replicação do ambiente azul para o ambiente verde. Embora qualquer formato de log binário funcione, recomendamos `ROW` para reduzir o risco de inconsistências de replicação. Para obter informações sobre como criar um grupo de parâmetros de cluster de banco de dados personalizado e definir parâmetros, consulte [Grupos de parâmetros do cluster de banco de dados para clusters de banco de dados do Amazon Aurora](USER_WorkingWithDBClusterParamGroups.md).

**nota**  
Habilitar o registro em log binário aumenta o número de operações de E/S de disco de gravação no cluster de banco de dados. Você pode monitorar o uso de IOPS com a métrica `VolumeWriteIOPs` do CloudWatch.

Depois de habilitar o registro em log binário, reinicialize o cluster de banco de dados para que as alterações tenham efeito. As implantações azul/verde *exigem* que a instância do gravador esteja sincronizada com o grupo de parâmetros do cluster de banco de dados, caso contrário a criação falhará. Para obter mais informações, consulte [Reinicializar uma instância de banco de dados em um cluster do Aurora](aurora-reboot-db-instance.md).

Além disso, recomendamos alterar o período de retenção de logs binários para um valor diferente de `NULL` a fim de evitar que os arquivos de log binários sejam eliminados. Para obter mais informações, consulte [Definir e mostrar a configuração de logs binários](mysql-stored-proc-configuring.md).

### Preparar um cluster de banco de dados do Aurora PostgreSQL para uma implantação azul/verde
<a name="blue-green-deployments-creating-preparing-postgres"></a>

Antes de criar uma implantação azul/verde para um cluster de banco de dados do Aurora PostgreSQL, faça o seguinte. 
+ Associe o cluster a um grupo de parâmetros de cluster de banco de dados personalizado com a replicação lógica (`rds.logical_replication`) ativada. A replicação lógica é necessária para a replicação do ambiente azul no ambiente verde. 

  Ao habilitar a replicação lógica, é necessário também ajustar determinados parâmetros do cluster, como `max_replication_slots`, `max_logical_replication_workers` e `max_worker_processes`. Para ter instruções sobre como habilitar a replicação lógica e ajustar esses parâmetros, consulte [Configurar a replicação lógica para seu cluster de banco de dados do Aurora PostgreSQL](AuroraPostgreSQL.Replication.Logical.Configure.md).

  Além disso, verifique se o parâmetro `synchronous_commit` está definido como `on`.

  Depois de configurar os parâmetros necessários, reinicialize o cluster de banco de dados para que as alterações tenham efeito. As implantações azul/verde *exigem* que a instância do gravador esteja sincronizada com o grupo de parâmetros do cluster de banco de dados, caso contrário a criação falhará. Para obter mais informações, consulte [Reinicializar uma instância de banco de dados em um cluster do Aurora](aurora-reboot-db-instance.md).
+ Confirme se o cluster de banco de dados está executando uma versão do Aurora PostgreSQL compatível com implantações azuis/verdes. Para conferir uma lista de versões compatíveis, consulte [Implantações azul/verde com o Aurora PostgreSQL](Concepts.Aurora_Fea_Regions_DB-eng.Feature.BlueGreenDeployments.md#Concepts.Aurora_Fea_Regions_DB-eng.Feature.BlueGreenDeployments.apg).
+ Certifique-se de que todas as tabelas no cluster de banco de dados tenham uma chave primária. A replicação lógica do PostgreSQL não permite operações UPDATE ou DELETE em tabelas que não têm uma chave primária.

### Preparar um cluster de banco de dados do Aurora Global Databases para uma implantação azul/verde
<a name="blue-green-deployments-creating-preparing-agd"></a>

Antes de criar uma implantação azul/verde para seu cluster de banco de dados do Aurora Global Database, observe os seguintes pontos:
+ Todas as operações devem ser iniciadas na mesma região que o cluster de gravador do banco de dados global.
+ Configuração do grupo de parâmetros:
  + O ambiente verde usa um novo grupo de parâmetros que você especifica ou o mesmo grupo de parâmetros que do cluster azul (padrão).
  + Os grupos de parâmetros personalizados são copiados no ambiente verde.
  + Se um grupo de parâmetros especificado não existir na região secundária, o grupo de parâmetros padrão na região secundária será usado para o ambiente verde.

## Especificar as alterações ao criar uma implantação azul/verde
<a name="blue-green-deployments-creating-changes"></a>

Você pode fazer as seguintes alterações no cluster de banco de dados no ambiente verde ao criar a implantação azul/verde:

Você pode fazer outras modificações de banco de dados no cluster e em suas instâncias de banco de dados no ambiente verde após sua implantação. Por exemplo, você pode especificar uma versão posterior do mecanismo ou um grupo de parâmetros diferente.

Para ter informações sobre como modificar um cluster de banco de dados, consulte [Modificar um cluster de bancos de dados Amazon Aurora](Aurora.Modifying.md).

**Topics**
+ [Especifique uma versão de mecanismo superior](#blue-green-deployments-engine-version)
+ [Especificar outro grupo de parâmetros de banco de dados](#blue-green-deployments-parameters)

### Especifique uma versão de mecanismo superior
<a name="blue-green-deployments-engine-version"></a>

Você poderá especificar uma versão superior do mecanismo se quiser testar uma atualização do mecanismo de banco de dados. Após a transição, o banco de dados é atualizado para a versão principal ou secundária do mecanismo de banco de dados que você especificar.

### Especificar outro grupo de parâmetros de banco de dados
<a name="blue-green-deployments-parameters"></a>

Você pode especificar um grupo de parâmetros de cluster de banco de dados diferente do usado pelo cluster de banco de dados. É possível testar como as alterações de parâmetros afetam o cluster de banco de dados no ambiente verde ou especificar um grupo de parâmetros para uma nova versão principal do mecanismo de banco de dados no caso de uma atualização.

Se você especificar um grupo de parâmetros de cluster de banco de dados diferente, o grupo de parâmetros especificado será associado ao cluster de banco de dados no ambiente verde. Se você não especificar um grupo de parâmetros de cluster de banco de dados diferente, o cluster de banco de dados no ambiente verde será associado ao mesmo grupo de parâmetros que o cluster de banco de dados azul.

## Criar uma implantação azul/verde
<a name="blue-green-deployments-creating-create"></a>

Você pode criar a implantação azul/verde usando o Console de gerenciamento da AWS, a AWS CLI ou a API do RDS.

### Console
<a name="blue-green-deployments-creating-console"></a>

**Como criar uma implantação azul/verde**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. No painel de navegação, selecione **Databases** (Bancos de dados) e, depois, o cluster de banco de dados que você deseja copiar em um ambiente verde.

1. Selecione **Ações**, **Criar implantação azul/verde**.

   A página **Criar implantação azul/verde** é exibida.   
![\[Criar uma implantação azul/verde\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/blue-green-deployment-create-aurora.png)

1. Analise os identificadores azuis do banco de dados. Eles devem corresponder às instâncias de banco de dados que você espera no ambiente azul. Caso contrário, selecione **Cancel** (Cancelar).

1. Em **Nome da implantação azul/verde**, insira um nome para sua implantação azul/verde.

1. Nas seções restantes, especifique as configurações do ambiente verde. Para obter informações sobre cada configuração, consulte [Configurações para criar implantações azuis/verdes](#create-blue-green-settings).

   Você pode fazer outras modificações nos bancos de dados no ambiente verde após sua implantação.

1. Escolha **Criar**.

### AWS CLI
<a name="blue-green-deployments-creating-cli"></a>

Para criar uma implantação azul/verde usando a AWS CLI, utilize o comando [create-blue-green-deployment](https://docs.aws.amazon.com/cli/latest/reference/rds/create-blue-green-deployment.html). Para obter informações sobre todas as opções disponíveis, consulte [Configurações para criar implantações azuis/verdes](#create-blue-green-settings).

**Example**  
Para Linux, macOS ou Unix:  

```
aws rds create-blue-green-deployment \
    --blue-green-deployment-name aurora-blue-green-deployment \
    --source arn:aws:rds:us-east-2:123456789012:cluster:auroradb \
    --target-engine-version 8.0 \
    --target-db-cluster-parameter-group-name mydbclusterparametergroup
```
Para Windows:  

```
aws rds create-blue-green-deployment ^
    --blue-green-deployment-name aurora-blue-green-deployment ^
    --source arn:aws:rds:us-east-2:123456789012:cluster:auroradb ^
    --target-engine-version 8.0 ^
    --target-db-cluster-parameter-group-name mydbclusterparametergroup
```

### API do RDS
<a name="blue-green-deployments-creating-api"></a>

Para criar uma implantação azul/verde usando a API do Amazon RDS, use a operação [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateBlueGreenDeployment.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateBlueGreenDeployment.html). Para ter mais informações sobre cada opção, consulte [Configurações para criar implantações azuis/verdes](#create-blue-green-settings).

## Configurações para criar implantações azuis/verdes
<a name="create-blue-green-settings"></a>

A tabela a seguir explica as configurações que você pode escolher ao criar uma implantação azul/verde. Consulte mais informações sobre as opções da AWS CLI em [create-blue-green-deployment](https://docs.aws.amazon.com/cli/latest/reference/rds/create-blue-green-deployment.html). Consulte mais informações sobre os parâmetros da API do RDS em [CreateBlueGreenDeployment](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateBlueGreenDeployment.html).


| Configuração do console | Descrição da configuração | Opção da CLI e parâmetro da API do RDS | 
| --- | --- | --- | 
|  **Identificador de implantação azul/verde**  |  Um nome para a implantação azul/verde.  |  **Opção da CLI:** `--blue-green-deployment-name` **Parâmetro da API:**  `BlueGreenDeploymentName`  | 
| Identificador de banco de dados azul |  O identificador do cluster que você deseja copiar no ambiente verde. Ao usar a CLI ou a API, especifique o nome do recurso da Amazon (ARN) do cluster.  |  **Opção da CLI:** `--source` **Parâmetro da API:** `Source`  | 
|  Grupo de parâmetros do cluster de banco de dados para bancos de dados verdes  | Um grupo de parâmetros para associar aos bancos de dados no ambiente verde. |  **Opção da CLI:**  `--target-db-cluster-parameter-group-name` **Parâmetro da API:**  `TargetDBClusterParameterGroupName`  | 
|  **Versão do mecanismo para bancos de dados verdes**  |  Faça upgrade do cluster no ambiente verde para a versão especificada do mecanismo de banco de dados. Se você escolher um cluster de banco de dados Aurora PostgreSQL, analise e reconheça as limitações da replicação lógica. Para obter mais informações, consulte [Limitações específicas de replicação lógica para implantações azuis/verdes](blue-green-deployments-considerations.md#blue-green-deployments-limitations-postgres).  |  **Opção da CLI:** `--target-engine-version` **Parâmetro da API do RDS:** `TargetEngineVersion`  |