Databases

All applications in an environment share a common database cluster.

The database cluster set up for your environment is {Environment}-main, and the default database is {Environment}-main-one.

Step 1: Add and configure the databases package

repo-iac/environments/dev/

ok pkg add databases
cd databases

Update package-config.yml with your preferences.

To use a Serverless database cluster (default):

package-config.yml

Serverless:
  Enable: true

To use a traditional database cluster:

package-config.yml

Serverless:
  Enable: false

Step 2: Install the package

repo-iac/environments/dev/databases/

ok pkg install

Step 3: Initialize and apply the databases stack

repo-iac/environments/dev/databases/

terraform init
terraform apply

Step 4: Verify

AWS CLIAWS console

Run the following command:

aws rds describe-db-instances | jq '.DBInstances[].DBInstanceIdentifier'

The output list should contain the name of the database instance you just created.

Sign in to the AWS console and navigate to RDS. Select Databases in the left-hand menu.

The list should contain the name of the database cluster you just created.

---

Commit your files

At this stage it is a good idea to commit your files.

Next step

Set up certificates.