Ruk-Com PaaS Documentation

Build, deploy and operate applications on the platform.

RUK-COM PAAS / DATABASES

Node.js Connection

This guide is maintained for Ruk-Com PaaS. Screens and options may vary by platform version and account permissions.

Confirm the environment, region and account permissions, and back up current settings before changing a production system.

MySQL, MariaDB, and Percona are among of the most popular open source SQL databases, used by world’s largest organizations. In this guide we’ll overview a simple example of Node.js application connection to MySQL or MariaDB server.

  1. Log into your PaaS account and create an environment with MySQL (or MariaDB) database server, we’ll also add a NodeJS compute node for this tutorial.

Image 31: create NodeJS MySQL environment 2. Access your NodeJS server via SSH, e.g., with embedded Web SSH client.

Image 32: NodeJS Web SSH button 3. Once connected, get an official MySQL driver for Node.js (compatible with MariaDB) by executing the following command:

bash Copy

npm install mysql

Note: MySQL driver for NodeJS 10 is currently in testing, so if the deprecation warnings are shown while operating this server version, you may need to install the testing version:

bash Copy

npm install mysqljs/mysql

Image 33: NodeJS install MySQL connector Installation will be finished in a moment.

  1. Prepare a simple Node.js script to verify connection. Create a file with the .js extension, using any text editor of your choice (e.g., vim script.js).

js Copy

var mysql = require('mysql');
var con = mysql.createConnection({
  host: "{host}",
  user: "{user}",
  password: "{password}",
  database: "{database}"
});

con.connect(function(err) {
  if (err) throw err;
  console.log("You are connected!");
});
con.end();

The placeholders in the code above should be adjusted using the appropriate connection information (is provided within email for your MySQL / MariaDB container):

  • {user} - username to log into database with
  • {password} - password for the appropriate user
  • {host} - link to your MySQL / MariaDB container
  • {database} - database to be accessed (e.g., the default one - mysql)

Image 34: NodeJS MySQL connection code Using this script, you can check connection to the database from your application server and, if it fails, get an error description.

  1. Run code with the appropriate command:

bash Copy

node script.js

Image 35: nodejs successful connection For successful connection a “You are connected!” phrase will be displayed in terminal, otherwise error description will be provided. Now, when you are sure your database container is accessible, expand the code to execute some real actions on your DB server.