

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Connect uma instância do WordPress Lightsail a um banco de dados Amazon Aurora
<a name="amazon-lightsail-connect-wordpress-to-aurora-bitnami"></a>

**Este blueprint empacotado pela Bitnami está sendo descontinuado**  
Os blueprints empacotados pela Bitnami não receberão mais atualizações após 19 de maio de 2026. A partir de 19 de novembro de 2026, você não poderá mais criar novas instâncias com esse esquema. Ao criar novas instâncias, recomendamos usar o blueprint equivalente do Lightsail, se disponível. As instâncias existentes usando blueprints empacotados pela Bitnami continuarão sendo executadas sem qualquer interrupção. [Saiba mais](amazon-lightsail-faq-bitnami-blueprints.md)  
[Se você tem uma instância existente que usa um blueprint empacotado pela Bitnami e quer migrar para um blueprint Lightsail-packaged , consulte Migrar para blueprints do Lightsail.](migrate-from-bitnami-to-lightsail-blueprints.md)

**Este tutorial se aplica somente a instâncias que usam WordPress pacotes da Bitnami.**  
Se sua instância usa o WordPress blueprint fornecido pelo Lightsail, consulte em vez disso. [WordPress](amazon-lightsail-wordpress.md)

Os dados do site para publicações, páginas e usuários são armazenados em um banco de dados que está sendo executado na sua WordPress instância no Amazon Lightsail. Se sua instância falhar, seus dados poderão ficar irrecuperáveis. Para evitar esse cenário, transfira os dados de seu site para um banco de dados do Amazon Aurora no Amazon Relational Database Service (Amazon RDS).

O Amazon Aurora é um banco de dados MySQL e PostgreSQL-compatible relacional criado para a nuvem. Ele combina a performance e a disponibilidade de bancos de dados corporativos tradicionais com a simplicidade e o custo-benefício de bancos de dados de código aberto. O Aurora é oferecido como parte do Amazon RDS. O Amazon RDS é um serviço de banco de dados gerenciado que facilita a configuração, operação e escala de um banco de dados relacional na nuvem. Para obter mais informações, consulte o [Guia do usuário do Amazon Relational Database Service](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/) e o [Guia do usuário do Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/).

Neste tutorial, mostramos como conectar o banco de dados do seu site de uma WordPress instância no Lightsail a um banco de dados gerenciado do Aurora no Amazon RDS.

**Índice**
+ [Etapa 1: Concluir os pré-requisitos](#connect-mysql-to-aurora-prerequisites-bitnami)
+ [Etapa 2: configurar o grupo de segurança para seu banco de dados Aurora](#configure-aurora-security-group-bitnami)
+ [Etapa 3: Conecte-se ao seu banco de dados Aurora usando sua instância do Lightsail](#connect-to-aurora-database-from-lightsail-instance-bitnami)
+ [Etapa 4: Transferir o banco de dados MySQL da sua WordPress instância para o banco de dados Aurora](#transfer-database-from-wordpress-to-aurora-bitnami)
+ [Etapa 5: Configurar WordPress para se conectar ao seu banco de dados gerenciado Aurora](#connect-wordpress-to-aurora-bitnami)

## Etapa 1: Concluir os pré-requisitos
<a name="connect-mysql-to-aurora-prerequisites-bitnami"></a>

Antes de começar, conclua os seguintes pré-requisitos:

1. Certifique-se de que sua WordPress instância esteja em execução. Para obter mais informações, consulte [Iniciar, interromper ou reiniciar sua instância](lightsail-how-to-start-stop-or-restart-your-instance-virtual-private-server.md).

1. Ative o peering de VPC na sua conta do Lightsail. Para obter mais informações, consulte [Configurar o peering para trabalhar com AWS recursos fora do Lightsail](lightsail-how-to-set-up-vpc-peering-with-aws-resources.md).

1. Crie um banco de dados gerenciado do Aurora no Amazon RDS. O banco de dados deve estar localizado no Região da AWS mesmo local da sua WordPress instância. Antes de continuar, ela também deve estar em estado em execução. Para obter mais informações, consulte [Conceitos básicos do Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.html) no Guia do usuário do Amazon Aurora.

## Etapa 2: configurar o grupo de segurança para seu banco de dados Aurora
<a name="configure-aurora-security-group-bitnami"></a>

Um grupo AWS de segurança atua como um firewall virtual para seus AWS recursos. Ele controla o tráfego de entrada e de saída que pode se conectar ao seu banco de dados Aurora no Amazon RDS. Para obter mais informações sobre grupos de segurança, consulte [Controle o tráfego para seus recursos usando grupos de segurança](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_SecurityGroups.html) no Guia do usuário da Amazon Virtual Private Cloud.

Conclua o procedimento a seguir para configurar o grupo de segurança para que sua WordPress instância possa estabelecer uma conexão com seu banco de dados Aurora.

1. Faça login no [console do Amazon RDS](https://console.aws.amazon.com/rds/).

1. Escolha **Databases** no painel de navegação.

1. Escolha a **instância do Writer** do banco de dados Aurora à qual sua WordPress instância se conectará.

1. Escolha a guia **Connectivity & security (Conectividade e segurança)**.

1. Na seção **Endpoint & port** (Endpoint e porta), anote o **Endpoint name** (Nome do endpoint) e a **Port** (Porta) da **Writer instance** (Instância do gravador). Você precisará deles posteriormente ao configurar sua instância do Lightsail para se conectar ao banco de dados.

1. Na seção **Security** (Segurança), escolha o link do grupo de segurança da VPC ativa. Você será redirecionado para o grupo de segurança do seu banco de dados.  
![Captura de tela da guia Conectividade e segurança do console do Amazon RDS.](http://docs.aws.amazon.com/pt_br/lightsail/latest/userguide/images/wp-aurora-db-select-writer-instance.png)

1. Certifique-se de que o grupo de segurança para seu banco de dados Aurora esteja selecionado.

1. Escolha a guia **Regras de entrada**.

1. Escolha **Editar regras de entrada**.  
![Captura de tela da guia Regras de entrada do console do Amazon RDS.](http://docs.aws.amazon.com/pt_br/lightsail/latest/userguide/images/wp-aurora-select-security-group.png)

1. Na página **Edit inbound rules** (Editar regras de entrada), escolha **Add Rule** (Adicionar regra).

1. Conclua uma das seguintes etapas:
   + **Se você estiver usando a porta 3306 padrão do MySQL, selecione **MySQL/Aurora**no menu suspenso Tipo.**
   + Se estiver usando uma porta personalizada para seu banco de dados, selecione **Custom TCP** (TCP personalizado) no menu suspenso **Type** (Tipo) e insira o número da porta na caixa de texto **Port Range** (Intervalo de portas).

1. Na caixa **de texto Fonte**, adicione o endereço IP privado da sua WordPress instância. Você deve inserir os endereços IP usando notação CIDR, o que significa que é necessário acrescentar `/32`. Por exemplo, para permitir `192.0.2.0`, insira `192.0.2.0/32`.

1. Selecione **Salvar regras**.  
![Captura de tela da guia Detalhes das regras de entrada do console do Amazon RDS.](http://docs.aws.amazon.com/pt_br/lightsail/latest/userguide/images/wp-aurora-add-security-group-rule.png)

## Etapa 3: Conecte-se ao seu banco de dados Aurora usando sua instância do Lightsail
<a name="connect-to-aurora-database-from-lightsail-instance-bitnami"></a>

Conclua o procedimento a seguir para confirmar que você pode se conectar ao seu banco de dados Aurora a partir da sua instância do Lightsail.

1. Faça login no console do [Lightsail](https://lightsail.aws.amazon.com/).

1. No painel de navegação à esquerda, selecione **Instâncias**.  
![Página inicial do Lightsail.](http://docs.aws.amazon.com/pt_br/lightsail/latest/userguide/images/wp-aurora-homepage-select-instances-tab.png)

1. Escolha o ícone do cliente SSH baseado em navegador para que sua WordPress instância se conecte a ela usando SSH.  
![Browser-based Ícone do cliente SSH.](http://docs.aws.amazon.com/pt_br/lightsail/latest/userguide/images/wp-aurora-browser-based-ssh-client.png)

1. Após se conectar à instância, insira o seguinte comando para estabelecer conexão com seu banco de dados Aurora. No comando, {{DatabaseEndpoint}} substitua pelo endereço do endpoint do seu banco de dados Aurora e {{Port}} substitua pela porta do seu banco de dados. {{MyUserName}}Substitua pelo nome do usuário que você inseriu ao criar o banco de dados.

   ```
   mysql -h {{DatabaseEndpoint}} -P {{Port}} -u {{MyUserName}} -p
   ```

   Você deverá receber uma resposta semelhante ao exemplo a seguir, confirmando que sua instância pode acessar e se conectar ao seu banco de dados Aurora.  
![Resposta de conexão bem-sucedida com MySQL.](http://docs.aws.amazon.com/pt_br/lightsail/latest/userguide/images/wp-aurora-mysql-connect-message.png)

   Se você não receber essa resposta ou receber uma mensagem de erro, talvez seja necessário configurar o grupo de segurança do seu banco de dados Aurora para permitir que o endereço IP privado da sua instância do Lightsail se conecte a ele. Para mais informações, consulte a seção [Configurar o grupo de segurança para seu banco de dados Aurora](#configure-aurora-security-group-bitnami) neste guia.

## Etapa 4: Transferir o banco de dados da sua WordPress instância para o banco de dados Aurora
<a name="transfer-database-from-wordpress-to-aurora-bitnami"></a>

Agora que você confirmou que pode se conectar ao seu banco de dados a partir da sua instância, você deve transferir os dados WordPress do seu site para o banco de dados do Aurora.

1. Faça login no console do [Lightsail](https://lightsail.aws.amazon.com/).

1. Na guia **Instâncias**, escolha o cliente SSH baseado em navegador para sua instância. WordPress   
![Browser-based Ícone do cliente SSH.](http://docs.aws.amazon.com/pt_br/lightsail/latest/userguide/images/wp-aurora-browser-based-ssh-client.png)

1. Depois que o cliente SSH baseado em navegador estiver conectado à sua WordPress instância, insira o comando a seguir. O comando transfere os dados do banco de dados `bitnami_wordpress` que está em sua instância e os move para o banco de dados Aurora. No comando, {{DatabaseUserName}} substitua pelo nome do usuário principal que você inseriu ao criar o banco de dados Aurora. {{DatabaseEndpoint}}Substitua pelo endereço do endpoint do seu banco de dados Aurora.

   ```
   sudo mysqldump -u root --databases bitnami_wordpress --single-transaction --compress --order-by-primary -p$(cat /home/bitnami/bitnami_application_password) | sudo mysql -u {{DatabaseUserName}} --host  {{DatabaseEndpoint}} --password
   ```

   **Exemplo**

   ```
   sudo mysqldump -u root --databases bitnami_wordpress --single-transaction --compress --order-by-primary -p$(cat /home/bitnami/bitnami_application_password) | sudo mysql -u {{DBuser}} --host  {{abc123exampleE67890.czowadgeezqi.us-west-2.rds.amazonaws.com}} --password
   ```

1. No prompt `Enter password`, digite a senha do banco de dados Aurora e pressione **Enter**.

   Não será possível ver a senha enquanto a digita.  
![Captura de tela da solicitação de senha.](http://docs.aws.amazon.com/pt_br/lightsail/latest/userguide/images/wp-aurora-mysql-dump-1.png)

   Se os dados foram transferidos com êxito, você verá uma resposta semelhante ao exemplo a seguir:  
![Resposta de transferência bem-sucedida.](http://docs.aws.amazon.com/pt_br/lightsail/latest/userguide/images/wp-aurora-mysql-dump-2.png)

   Se você receber um erro, confirme se está usando o nome de usuário, a senha e o endpoint corretos do banco de dados e tente novamente.

## Etapa 5: Configurar WordPress para se conectar ao seu banco de dados Aurora
<a name="connect-wordpress-to-aurora-bitnami"></a>

Depois de transferir os dados do aplicativo para o banco de dados do Aurora, você deve configurar WordPress para se conectar a ele. Conclua o procedimento a seguir para editar o arquivo de WordPress configuração (`wp-config.php`) para que seu site se conecte ao banco de dados do Aurora.

1. No cliente SSH baseado em navegador que está conectado à sua WordPress instância, insira o comando a seguir para criar um backup do arquivo: `wp-config.php`

   ```
   cp /opt/bitnami/wordpress/wp-config.php /opt/bitnami/wordpress/wp-config.php-backup
   ```

1. Insira o seguinte comando para tornar o arquivo `wp-config.php` gravável:

   ```
   sudo chmod 664 /opt/bitnami/wordpress/wp-config.php
   ```

1. No arquivo `config`, edite o nome do usuário do banco de dados com o nome do usuário primário que você inseriu ao criar o banco de dados Aurora.

   ```
   sudo wp config set DB_USER {{DatabaseUserName}}
   ```

1. Edite o host do banco de dados no arquivo `config` com o endereço e o número da porta do endpoint do seu banco de dados Aurora. Por exemplo, .`abc123exampleE67890.czowadgeezqi.us-west-2.rds.amazonaws.com:3306`

   ```
   sudo wp config set DB_HOST {{DatabaseEndpoint}}:{{Port}}
   ```

1. Edite a senha do banco de dados no arquivo `config` com a senha do banco de dados Aurora.

   ```
   sudo wp config set DB_PASSWORD {{DatabasePassword}}
   ```

1. Digite o comando `wp config list` para verificar se as informações que você inseriu no arquivo `wp-config.php` estão corretas.

   ```
   sudo wp config list
   ```

   Um resultado semelhante ao exemplo a seguir será exibido, exibindo os detalhes da configuração:  
![WordPress arquivo de configuração.](http://docs.aws.amazon.com/pt_br/lightsail/latest/userguide/images/wp-aurora-wpconfig.png)

1. Digite o comando a seguir para reiniciar os serviços da Web em sua instância:

   ```
   sudo /opt/bitnami/ctlscript.sh restart
   ```

   Você verá um resultado semelhante ao seguinte exemplo quando os serviços tiverem sido reiniciados:  
![WordPress confirmação de reinicialização das instâncias.](http://docs.aws.amazon.com/pt_br/lightsail/latest/userguide/images/wp-aurora-service-restart.png)

   Parabéns\! Seu WordPress site agora está configurado para usar seu banco de dados Aurora.
**nota**  
Se precisar restaurar o arquivo `wp-config.php` original, digite o comando a seguir para restaurá-lo usando o backup criado anteriormente neste tutorial.  

   ```
   cp /opt/bitnami/wordpress/wp-config.php-backup /opt/bitnami/wordpress/wp-config.php
   ```