Step 3: Create an RDS database (optional)

Creating an RDS database to integrate with your DuploCloud Service

Creating an RDS database is not essential to running a DuploCloud Service. However, as most services also incorporate an RDS, this step is included to demonstrate the ease of creating a database in DuploCloud. To skip this step, proceed to the Services section of this tutorial.

An AWS RDS is a managed Relational Database Service that is easy to set up and maintain in DuploCloud for AWS public cloud environments. RDSs support many databases including MySQL, PostgreSQL, MariaDB, Oracle BYOL, or SQL Server.

See the DuploCloud AWS Database documentation for more information.

Estimated time to complete Step 3: 5 minutes.

Prerequisites

Before creating an RDS, verify that you accomplished the tasks in the previous tutorial steps. Using the DuploCloud Portal, confirm that:

• An Infrastructure and Plan exist, both with the name NONPROD.

• The NONPROD infrastructure has Kubernetes (EKS or ECS) Enabled.

• A Tenant with the name dev01 has been created.

Select the Tenant you created

In the Tenant list box, on the upper-left side of the DuploCloud Portal, select the dev01 Tenant that you created.

Creating an RDS database

1. In the DuploCloud Portal, navigate to Cloud Services -> Database. The Database page displays.

2. In the RDS tab, click Add. The Create a RDS page displays.

   

   Create a RDS page

3. From the table below, enter the values that correspond to the fields on the Create a RDS page. Accept all other default values for fields not specified.

4. Click Create. The DUPLODOCS database displays in the RDS tab with a Status of Submitted. Database creation takes approximately ten (10) minutes.

DuploCloud prepends DUPLO to the name of your RDS database instance.

Create a RDS page field	Value
RDS Name	docs
User Name	YOUR_DUPLOCLOUD_ADMIN_USER_NAME
User password	YOUR_DUPLOCLOUD_ADMIN_PASSWORD
Rds Engine	MySQL
Rds Engine Version	LATEST_AVAILABLE_VERSION
Rds Instance Size	db.t3.medium
Storage size in GB	30

Validating RDS database creation

You can monitor the status of database creation using the RDS tab and the Status column.

In the DuploCloud Portal Database page, in the RDS tab, when the database Status is Available, the database's endpoint is ready for connection to a DuploCloud Service, which you create and start in the next step.

Troubleshooting database creation failures

Faults are shown in the DuploCloud Portal by clicking the Fault/Alert ( ) Icon. Common database faults that may cause database creation to fail include:

• Invalid passwords - Passwords cannot have special characters like quotes, @, commas, etc. Use a combination of upper and lower-case letters and numbers.

• Invalid encryption - Encryption is not supported for small database instances (micro, small, or medium).

RDS tab with DUPLODOCS database with Status Available; Fault/Alert Icon highlighted at top

Verifying database endpoints

1. In the RDS tab, select the DUPLODOCS database you created.

2. Note the database Endpoint, the database name, and the database credentials. For security, the database is automatically placed in a private subnet to prevent all access from the internet. Access to the database is automatically set up for all resources (EC2 instances, containers, Lambdas, etc) in the DuploCloud dev01 Tenant. You need the Endpoint to connect to the database from an application running in the EC2 instance.

DUPLODOCS database details with the endpoint highlighted

When you place a DuploCloud Service in a live production environment, consider passing the database endpoint, name, and credentials to a DuploCloud Service using AWS Secrets Manager, or Kubernetes Configs and Secrets.

Checking your work

When your database is available and you have verified the endpoint, choose one of these three paths to create a DuploCloud Service and continue this tutorial.

• Creating an AWS EKS Service in DuploCloud running Docker containers

• Creating an AWS ECS Service in DuploCloud running Docker containers

• Creating a DuploCloud native Docker Service

Not sure what kind of Duplcloud Service you want to create? Consider the following:

• AWS EKS is a managed Kubernetes service. AWS ECS is a fully managed container orchestration service using AWS technology. For a full discussion of the benefits of EKS vs. ECS, consult this AWS blog.

• Docker Containers are ideal for lightweight deployments and run on any platform, using GitHub and other open-source tools.