Adición de una instancia de base de datos de Amazon RDS a su entorno de Node.js Elastic Beanstalk

En este tema se proporcionan instrucciones para crear un Amazon RDS mediante la consola de Elastic Beanstalk. Puede utilizar una instancia de base de datos de Amazon Relational Database Service (Amazon RDS) para almacenar datos recopilados y modificados por su aplicación. La base de datos se puede adjuntar al entorno y administrarse con Elastic Beanstalk, o bien, crearse como desacoplada y administrarse de forma externa a través de otro servicio. En estas instrucciones, la base de datos se acoplará al entorno y se administrará con Elastic Beanstalk. Para obtener más información sobre el uso de Elastic Beanstalk con Amazon RDS, consulte Añadir una base de datos al entorno de Elastic Beanstalk.

Añadir una instancia de base de datos al entorno

Para agregar una instancia de base de datos al entorno

1. Abra la consola de Elastic Beanstalk y, en la lista Regions (Regiones), seleccione su Región de AWS.

2. En el panel de navegación, elija Environments (Entornos) y, a continuación, elija el nombre del entorno en la lista.

   nota

   Si tiene muchos entornos, utilice la barra de búsqueda para filtrar la lista de entornos.

3. En el panel de navegación, elija Configuration (Configuración).

4. En la categoría de configuración Database (Base de datos), seleccione Edit (Editar).

5. Seleccione un motor de base de datos y escriba el nombre de usuario y la contraseña.

6. Para guardar los cambios, elija Aplicar en la parte inferior de la página.

Se tarda alrededor de 10 minutos en añadir una instancia de base de datos. Cuando se haya completado la actualización del entorno, el nombre de host de la instancia de base de datos y otra información de conexión estarán disponibles para su aplicación mediante las siguientes propiedades de entorno

Nombre de la propiedad	Descripción	Valor de la propiedad
RDS_HOSTNAME	El nombre de host de la instancia de base de datos.	En la pestaña Connectivity & security (Conectividad y seguridad) de la consola de Amazon RDS: Endpoint (Punto de enlace).
RDS_PORT	El puerto en donde la instancia de base de datos acepta las conexiones. El valor predeterminado varía dependiendo del motor de base de datos.	En la pestaña Connectivity & security (Conectividad y seguridad) de la consola de Amazon RDS: Port (Puerto).
RDS_DB_NAME	El nombre de la base de dato, ebdb.	En la pestaña Configuration (Configuración) de la consola de Amazon RDS: DB Name (Nombre de la base de datos).
RDS_USERNAME	El nombre de usuario que ha configurado para la base de datos.	En la pestaña Configuration (Configuración) de la consola de Amazon RDS: Master username (Nombre de usuario maestro).
RDS_PASSWORD	La contraseña que ha configurado para la base de datos.	No está disponible como referencia en la consola de Amazon RDS.

Para obtener más información sobre la configuración de una instancia de bases de datos acopladas a un entorno de Elastic Beanstalk, consulte Añadir una base de datos al entorno de Elastic Beanstalk.

Descargar un controlador

Añada el controlador de base de datos al archivo package.json del proyecto bajo dependencies.

ejemplo package.json: Express con 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"
  }
}

Paquetes de controladores comunes para Node.js

• MySQL — mysql

• PostgreSQL — node-postgres

• SQL Server — node-mssql

• Oracle — node-oracledb

Conexión a una base de datos

Elastic Beanstalk proporciona información de conexión para instancias de base de datos asociadas en propiedades de entorno. Use process.env.VARIABLE para leer las propiedades y configurar una conexión con la base de datos.

ejemplo app.js: conexión con una base de datos 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();

Para obtener más información sobre cómo crear cadena de conexión a través de node-mysql, consulte npmjs.org/package/mysql.