Ajout d'une instance de base de données Amazon RDS à votre environnement d'application Node.js

Vous pouvez utiliser une instance de base de données Amazon Relational Database Service (Amazon RDS) pour stocker les données collectées et modifiées par votre application. La base de données peut être liée à votre environnement et gérée par Elastic Beanstalk, ou elle peut être créée comme déliée et gérée en externe par un autre service. Cette rubrique fournit des instructions pour créer un Amazon RDS à l'aide de la console Elastic Beanstalk. La base de données sera liée à votre environnement et gérée par Elastic Beanstalk. Pour plus d'informations sur l'intégration d'un Amazon RDS avec Elastic Beanstalk, consultez Ajout d'une base de données à votre environnement Elastic Beanstalk.

Ajout d'une instance de base de données à votre environnement

Pour ajouter une instance DB à votre environnement

1. Ouvrez la console Elastic Beanstalk et, dans la liste Regions (Régions), sélectionnez votre Région AWS.

2. Dans le panneau de navigation, choisissez Environments (Environnements), puis choisissez le nom de votre environnement dans la liste.

   Note

   Si vous avez plusieurs environnements, utilisez la barre de recherche pour filtrer la liste des environnements.

3. Dans le panneau de navigation, choisissez Configuration.

4. Dans la catégorie de configuration Database (Base de données), choisissez Edit (Modifier).

5. Choisissez un moteur de base de données, puis saisissez un nom d'utilisateur et un mot de passe.

6. Pour enregistrer les modifications, cliquez sur Appliquer en bas de la page.

L'ajout d'une instance DB prend environ 10 minutes. Une fois la mise à jour de l'environnement terminée, le nom d'hôte de l'instance DB et les autres informations de connexion sont disponibles dans votre application, via les propriétés d'environnement suivantes :

Nom de la propriété	Description	Valeur de la propriété
RDS_HOSTNAME	Nom d'hôte de l'instance DB.	Sous l'onglet Connectivity & security (Connectivité et sécurité) de la console Amazon RDS : Endpoint (Point de terminaison).
RDS_PORT	Port sur lequel l'instance de base de données accepte des connexions. La valeur par défaut varie selon les moteurs de base de données.	Sous l'onglet Connectivity & security (Connectivité et sécurité) de la console Amazon RDS : Port.
RDS_DB_NAME	Nom de la base de données, ebdb.	Sous l'onglet Configuration de la console Amazon RDS : DB Name (Nom de base de données).
RDS_USERNAME	Nom d'utilisateur que vous avez configuré pour votre base de données.	Sous l'onglet Configuration de la console Amazon RDS : Master username (Identifiant principal).
RDS_PASSWORD	Mot de passe que vous avez configuré pour votre base de données.	Non disponible pour référence dans la console Amazon RDS.

Pour plus d'informations sur la configuration d'une instance de base de données liée à un environnement Elastic Beanstalk, consultez Ajout d'une base de données à votre environnement Elastic Beanstalk.

Téléchargement d'un pilote

Ajoutez le pilote de base de données au fichier package.json de votre projet sous dependencies.

Exemple package.json – Express avec MySQL

{
  "name": "my-app",
  "version": "0.0.1",
  "private": true,
  "dependencies": {
    "ejs": "latest",
    "aws-sdk": "latest",
    "express": "latest",
    "body-parser": "latest",
    "mysql": "latest"
  },
  "scripts": {
    "start": "node app.js"
  }
}

Packages de pilotes courants pour Node.js

• MySQL – mysql

• PostgreSQL – node-postgres

• SQL Server – node-mssql

• Oracle – node-oracledb

Connexion à une base de données

Elastic Beanstalk fournit des informations de connexion pour les instances de base de données attachées dans les propriétés de l'environnement. Utilisez process.env.VARIABLE pour lire les propriétés et configurer une connexion de base de données.

Exemple app.js – Connexion à une base de données MySQL

var mysql = require('mysql');

var connection = mysql.createConnection({
  host     : process.env.RDS_HOSTNAME,
  user     : process.env.RDS_USERNAME,
  password : process.env.RDS_PASSWORD,
  port     : process.env.RDS_PORT
});

connection.connect(function(err) {
  if (err) {
    console.error('Database connection failed: ' + err.stack);
    return;
  }

  console.log('Connected to database.');
});

connection.end();

Pour plus d'informations sur la construction d'une chaîne de connexion à l'aide de node-mysql, consultez npmjs.org/package/mysql.