

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Connect une instance WordPress Lightsail à une base de données Amazon Aurora
<a name="amazon-lightsail-connect-wordpress-to-aurora"></a>

Les données du site Web relatives aux publications, aux pages et aux utilisateurs sont stockées dans une base de données exécutée sur votre WordPress instance dans Amazon Lightsail. Si l'instance échoue, vos données peuvent devenir irrécupérables. Pour éviter ce scénario, vous devez transférer les données de votre site Web vers une base de données Amazon Aurora dans Amazon Relational Database Service (Amazon RDS).

Amazon Aurora est une base de données MySQL et PostgreSQL-compatible relationnelle conçue pour le cloud. Elle associe les performances et la disponibilité des bases de données d'entreprise traditionnelles à la simplicité et à la rentabilité des bases de données open source. Aurora est proposé dans le cadre d'Amazon RDS. Amazon RDS est un service de base de données géré qui facilite la configuration, l'exploitation et la mise à l'échelle d'une base de données relationnelle dans le cloud. Pour plus d'informations, veuillez consulter le [Guide de l'utilisateur Amazon Relational Database Service](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/) et le [Guide de l'utilisateur Amazon Aurora pour Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/).

Dans ce didacticiel, nous vous expliquons comment connecter la base de données de votre site Web depuis une WordPress instance de Lightsail à une base de données gérée par Aurora dans Amazon RDS.

**Table des matières**
+ [Étape 1 : Exécuter les prérequis](#connect-wordpress-aurora-prerequisites)
+ [Étape 2 : configurer le groupe de sécurité pour votre base de données Aurora](#configure-wordpress-aurora-security-group)
+ [Étape 3 : Connectez-vous à votre base de données Aurora depuis votre instance Lightsail](#connect-to-aurora-from-wordpress-instance)
+ [Étape 4 : transférer la base de données MySQL de votre WordPress instance vers votre base de données Aurora](#transfer-wordpress-database-to-aurora)
+ [Étape 5 : Configuration WordPress pour vous connecter à votre base de données gérée par Aurora](#configure-wordpress-to-aurora)

## Étape 1 : Exécuter les prérequis
<a name="connect-wordpress-aurora-prerequisites"></a>

Avant de commencer, effectuez les opérations obligatoires suivantes :

1. Créez une WordPress instance dans Lightsail et configurez votre application dessus. Avant de continuer, assurez-vous que l'instance est en cours d'exécution. Pour plus d'informations, consultez [Lancer et configurer une WordPress instance](amazon-lightsail-launch-and-configure-wordpress.md).

1. Activez le peering VPC dans votre compte Lightsail. Pour plus d'informations, voir [Configurer le peering pour qu'il fonctionne avec AWS des ressources extérieures à Lightsail](lightsail-how-to-set-up-vpc-peering-with-aws-resources.md).

1. Créez une base de données gérée Aurora dans Amazon RDS. La base de données doit être située au même Région AWS endroit que votre WordPress instance. Elle doit également être en cours d'exécution avant de continuer. Pour plus d'informations, veuillez consulter [Mise en route avec Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.html) dans le Guide de l'utilisateur Amazon Aurora.

## Étape 2 : configurer le groupe de sécurité pour votre base de données Aurora
<a name="configure-wordpress-aurora-security-group"></a>

Un groupe AWS de sécurité agit comme un pare-feu virtuel pour vos AWS ressources. Il contrôle le trafic entrant et sortant pouvant se connecter à votre base de données Aurora dans Amazon RDS. Pour plus d'informations sur les groupes de sécurité, veuillez consulter [Contrôler le trafic vers les ressources à l'aide de groupes de sécurité dans le Guide de l'utilisateur Amazon Virtual Private Cloud](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_SecurityGroups.html).

Procédez comme suit pour configurer le groupe de sécurité afin que votre WordPress instance puisse établir une connexion à votre base de données Aurora.

1. Connectez-vous à la [console Amazon RDS](https://console.aws.amazon.com/rds/).

1. Sélectionnez **Databases** (Bases de données) dans le panneau de navigation.

1. Choisissez l'**instance Writer** de la base de données Aurora à laquelle votre WordPress instance doit se connecter.

1. Choisissez l’onglet **Connectivity & security (Connectivité et sécurité)**.

1. Dans la section **Endpoint & port** (Point de terminaison et port), prenez note du **Endpoint name** (Nom du point de terminaison) et du **Port** de la **Writer instance** (Instance d'enregistreur). Vous en aurez besoin ultérieurement lors de la configuration de votre instance Lightsail pour vous connecter à la base de données.

1. Dans la section **Security** (Sécurité), choisissez le lien du groupe de sécurité du VPC actif. Vous serez redirigé vers le groupe de sécurité de votre base de données.

1. Assurez-vous que le groupe de sécurité de votre base de données Aurora est sélectionné.

1. Choisissez l'onglet **Inbound rules** (Règles entrantes).

1. Choisissez **Edit inbound rules** (Modifier les règles entrantes).

1. Sur la page **Edit inbound rules** (Modifier les règles entrantes), cliquez sur **Add rule** (Ajouter une règle).

1. Effectuez l'une des étapes suivantes :
   + Si vous utilisez le port MySQL 3306 par défaut, sélectionnez-le **MySQL/Aurora**dans le menu déroulant **Type**.
   + Si vous utilisez un port personnalisé pour votre base de données, sélectionnez **Custom TCP** (TCP personnalisé) dans le menu déroulant **Type** et saisissez le numéro de port dans la zone de texte **Port Range** (Plage de ports).

1. Dans la zone de texte **Source**, ajoutez l'adresse IP privée de votre WordPress instance. Vous devez saisir les adresses IP en notation CIDR, ce qui signifie que vous devez ajouter `/32`. Par exemple, pour autoriser `192.0.2.0`, saisissez `192.0.2.0/32`.

1. Sélectionnez **Enregistrer les règles**.

## Étape 3 : Connectez-vous à votre base de données Aurora depuis votre instance Lightsail
<a name="connect-to-aurora-from-wordpress-instance"></a>

Effectuez la procédure suivante pour vérifier que vous pouvez vous connecter à votre base de données Aurora depuis votre instance Lightsail.

1. Connectez-vous à la console [Lightsail](https://lightsail.aws.amazon.com/).

1. Dans le panneau de navigation de gauche, sélectionnez **Instances**.

1. Choisissez l'icône du client SSH basé sur le navigateur pour que votre WordPress instance s'y connecte via SSH.

1. Une fois connecté à votre instance, saisissez la commande suivante pour vous connecter à votre base de données Aurora. Dans la commande, remplacez {{DatabaseEndpoint}} par l'adresse du point de terminaison de votre base de données Aurora et remplacez {{Port}} par le port de votre base de données. {{MyUserName}}Remplacez-le par le nom de l'utilisateur que vous avez saisi lors de la création de la base de données.

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

   Vous devriez voir une réponse confirmant que votre instance peut accéder à votre base de données Aurora et s'y connecter.

   Si cette réponse ne s'affiche pas ou si vous recevez un message d'erreur, vous devrez peut-être configurer le groupe de sécurité de votre base de données Aurora pour autoriser l'adresse IP privée de votre instance Lightsail à s'y connecter. Pour plus d'informations, veuillez consulter [Configurer le groupe de sécurité de votre base de données Aurora](#configure-wordpress-aurora-security-group) de ce guide.

## Étape 4 : transférer la base de données de votre WordPress instance vers votre base de données Aurora
<a name="transfer-wordpress-database-to-aurora"></a>

Maintenant que vous avez confirmé que vous pouvez vous connecter à votre base de données depuis votre instance, vous devez transférer les données de votre WordPress site Web vers votre base de données Aurora.

1. Connectez-vous à la console [Lightsail](https://lightsail.aws.amazon.com/).

1. Dans l'onglet **Instances**, choisissez le client SSH basé sur un navigateur pour votre instance. WordPress 

1. Une fois que le client SSH basé sur un navigateur est connecté à votre WordPress instance, entrez la commande suivante. La commande transfère les données de la base de données `wordpress` de votre instance, puis les déplace vers votre base de données Aurora. Dans la commande, remplacez {{DatabaseUserName}} par le nom de l'utilisateur principal que vous avez saisi lors de la création de la base de données Aurora. Remplacez {{DatabaseEndpoint}} par l'adresse du point de terminaison de votre base de données Aurora.

   ```
   sudo mysqldump -u root --databases wordpress --single-transaction --compress --order-by-primary | sudo mysql -u {{DatabaseUserName}} --host {{DatabaseEndpoint}} --password
   ```

   **Exemple**

   ```
   sudo mysqldump -u root --databases wordpress --single-transaction --compress --order-by-primary | sudo mysql -u {{DBuser}} --host {{abc123exampleE67890.czowadgeezqi.us-west-2.rds.amazonaws.com}} --password
   ```

1. À l'invite `Enter password`, saisissez le mot de passe de votre base de données Aurora, puis appuyez sur **Entrée**.

   Vous ne pourrez pas voir le mot de passe lors de la saisie.

   En cas d'erreur, vérifiez que vous utilisez le nom d'utilisateur, le mot de passe et le point de terminaison de base de données corrects, puis réessayez.

## Étape 5 : Configuration WordPress pour vous connecter à votre base de données Aurora
<a name="configure-wordpress-to-aurora"></a>

Après avoir transféré les données de votre application vers votre base de données Aurora, vous devez configurer WordPress pour vous y connecter. Procédez comme suit pour modifier le fichier WordPress de configuration (`wp-config.php`) afin que votre site Web se connecte à votre base de données Aurora.

1. Dans le client SSH basé sur un navigateur connecté à votre WordPress instance, entrez la commande suivante pour créer une sauvegarde du fichier : `wp-config.php`

   ```
   sudo cp /var/www/wp-config.php /var/www/wp-config.php-backup
   ```

1. Saisissez la commande suivante pour rendre le fichier `wp-config.php` accessible en écriture :

   ```
   sudo chmod 664 /var/www/wp-config.php
   ```

1. Remplacez le nom d'utilisateur de base de données dans le fichier `config` par le nom de l'utilisateur principal que vous avez saisi lors de la création de la base de données Aurora.

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

1. Remplacez l'hôte de base de données du fichier `config` par l'adresse du point de terminaison et le numéro de port de votre base de données Aurora. Par exemple, `abc123exampleE67890.czowadgeezqi.us-west-2.rds.amazonaws.com:3306`.

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

1. Remplacez le mot de passe de base de données du fichier `config` par le mot de passe de votre base de données Aurora.

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

1. Saisissez la commande `wp config list` afin de vérifier que les informations saisies dans le fichier `wp-config.php` sont correctes.

   ```
   sudo wp config list
   ```

1. Saisissez la commande suivante pour redémarrer les services web sur votre instance :

   ```
   sudo systemctl restart apache2
   ```

   Votre WordPress site est désormais configuré pour utiliser votre base de données Aurora.
**Note**  
Si vous devez restaurer le fichier `wp-config.php` d'origine, saisissez la commande suivante pour le restaurer à l'aide de la sauvegarde précédemment créée dans ce didacticiel.  

   ```
   sudo cp /var/www/wp-config.php-backup /var/www/wp-config.php
   ```