AWS Elastic Beanstalk
Guia do desenvolvedor

Adicionar uma instância de banco de dados do Amazon RDS ao ambiente de aplicativo Node.js

Você pode usar uma instância de banco de dados do Amazon Relational Database Service (Amazon RDS) para armazenar dados coletados e modificados pela aplicação. O banco de dados pode ser anexado ao seu ambiente e gerenciado pelo Elastic Beanstalk ou criado e gerenciado externamente.

Se você estiver usando o Amazon RDS pela primeira vez, adicione uma instância de banco de dados a um ambiente de teste usando o Management Console do Elastic Beanstalk e verifique se o aplicativo pode se conectar a ele.

Para conectar-se a um banco de dados, adicione o driver ao aplicativo, carregue o driver em seu código e crie um objeto de conexão com as propriedades de ambiente fornecidas pelo Elastic Beanstalk. A configuração e o código de conexão variam de acordo com o mecanismo de banco de dados e a estrutura que você usa.

nota

Para fins de aprendizado ou de ambientes de teste, é possível usar o Elastic Beanstalk para adicionar uma instância de banco de dados.

Para ambientes de produção, você pode criar uma instância de banco de dados fora do ambiente do Elastic Beanstalk para desacoplar os recursos do ambiente dos recursos do banco de dados. Dessa forma, quando você encerrar o ambiente, a instância de banco de dados não será excluída. Uma instância de banco de dados externa permite conectar-se ao mesmo banco de dados em vários ambientes e executar implantações azul/verde. Para obter instruções, consulte Uso do Elastic Beanstalk com o Amazon Relational Database Service.

Adição de uma instância de banco de dados ao seu ambiente

Para adicionar uma instância de banco de dados ao ambiente

  1. Abra o Console do Elastic Beanstalk.

  2. Navegue até a página de gerenciamento do ambiente.

  3. Escolher configuração.

  4. Na categoria de configuração Database (Banco de dados), selecione Modify (Modificar).

  5. Escolha um mecanismo de banco de dados e insira um nome de usuário e senha.

  6. Escolha Aplicar.

A adição de uma instância de banco de dados leva cerca de 10 minutos. Quando a atualização do ambiente for concluída, o nome de host da instância de banco de dados e outras informações de conexão estarão disponíveis para o seu aplicativo por meio das seguintes propriedades de ambiente:

  • RDS_HOSTNAME – O nome de host da instância de banco de dados.

    Rótulo do console do Amazon RDS – Endpoint (este é o nome do host)

  • RDS_PORT – A porta na qual a instância de banco de dados aceita conexões. O valor padrão varia entre os mecanismos de banco de dados.

    Rótulo do console do Amazon RDS – Porta

  • RDS_DB_NAME – O nome do banco de dados, ebdb.

    Rótulo do console do Amazon RDS – Nome do banco de dados

  • RDS_USERNAME – O nome de usuário que você configurou para seu banco de dados.

    Rótulo do console do Amazon RDS – Username

  • RDS_PASSWORD – A senha que você configurou para seu banco de dados.

Para obter mais informações sobre como configurar uma instância de banco de dados interna, consulte Adição de um banco de dados ao seu ambiente Elastic Beanstalk.

Download de um driver

Adicione o driver de banco de dados ao arquivo package.json do projeto em dependencies.

exemplo package.json – Express with 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" } }

Pacotes de drivers comuns para Node.js

  • MySQLmysql

  • PostgreSQLpg

  • SQL Servermssql

  • Oracleoracle ou oracledb

    A versão e o pacote da Oracle dependem da versão do Node.js que você está usando:

    • Node.js 6.x 8.x – Use a versão mais recente do oracledb.

    • Node.js 4.x – Usa a versão 2.2.0 do oracledb.

    • Node.js 5.x 7.x – Use a versão mais recente do oracle. O pacote oracledb não é compatível com estas versões do Node.js.

Conectar-se a um banco de dados

O Elastic Beanstalk fornece informações de conexão referentes às instâncias de banco de dados associadas nas propriedades de ambiente. Use os.environ['VARIABLE'] para ler as propriedades e configurar uma conexão de banco de dados.

exemplo app.js – conexão de banco de dados 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 obter mais informações sobre a criação de uma string de conexão usando node-mysql, consulte npmjs.org/package/mysql.