Skip to main content

​
What is this integration?

Provision and manage DigitalOcean managed databases.

​
Supported Engines

EngineSlugVersions
PostgreSQLpg11, 12, 13, 14, 15, 16
MySQLmysql5.7, 8.0
Valkeyvalkey7, 8
MongoDBmongodb4.4, 5.0, 6.0, 7.0
Apache Kafkakafka3.5
OpenSearchopensearch1.x, 2.x
Note: Redis has been replaced by Valkey on DigitalOcean. If you want to use Redis, use valkey as the engine instead. For backwards compatibility, specifying engine: redis will automatically be mapped to valkey.

​
What Monk manages

  • Database clusters and configuration

​
Getting Started

  1. Add DO provider (PAT configured in provider)
  2. Define a PostgreSQL cluster (save as do-db.yaml): 
namespace: digitalocean-database-example

my-postgres-db:
  defines: digitalocean-database/database
  name: my-postgres-cluster
  engine: pg
  version: "16"
  num_nodes: 1
  region: nyc1
  size: db-s-1vcpu-1gb
  1. Create/update:
monk update digitalocean-database-example/my-postgres-db

​
Backup & Restore Actions

DigitalOcean managed databases include automatic daily backups with 7-day retention.
ActionDescriptionKey Parameters
get-backup-infoShow backup config and PITR status-
list-backupsList available backup points-
describe-backupGet backup detailsbackup_created_at
restoreFork new cluster from backupnew_cluster_name, backup_created_at
get-restore-statusCheck fork progresscluster_id

​
Restore Example

# List available backups
monk do digitalocean-database-example/my-postgres-db/list-backups

# Restore to new cluster
monk do digitalocean-database-example/my-postgres-db/restore \
  --new_cluster_name=restored-db \
  --backup_created_at=2024-01-15T00:00:00Z
Note: Restore creates a NEW independent cluster (no in-place restore). PITR is supported for PostgreSQL and MySQL only.