← Back to Guides
Profile image for Will Stewart

By Will Stewart

Published 30th May 2022

Deploy Dragonfly on Northflank with Docker

Dragonfly is a fast in-memory store with backends for Redis and Memcached. We will learn how to deploy Dragonfly, with Docker on Northflank in minutes.

Service creation and configuration

  1. Create a new service.

  2. Select Deployment as the Service type.

    dragonfly-deployment-service.PNG

  3. Select external image and docker.dragonflydb.io/dragonflydb/dragonfly:latest as image path.

    dragonfly-docker-image-external.PNG

  4. Port 6379 TCP is automatically detected and exposed to your projects private network.

    • Dragonfly will be only available internally. In case you need to connect to it from your machine, Northflank forward proxy will be required.

    dragonfly-networking-6379-tcp.PNG

  5. Select Plan (vertical scaling) - starting from $2.21 per month with plan sizes to suit your workload. You can even use Northflank's free developer tier.

    dragonfly-resources-selection.PNG

  6. Create and wait for a sandboxed container to deploy in seconds.

    dragonfly-northflank-dashboard.PNG

Observability

  1. Logs with live tailing, search and filter by accessing the container.

    dragonfly-logs-northflank.PNG

  2. Metrics with real-time compute, network and TCP charts.

    dragonfly-metrics-northflank.PNG

Use Northflank forwarding and connect the service

  1. Start the forwarding of the service through the Northflank CLI.

    dragonfly-forward-proxy.jpg

  2. Using the redis-cli, for a service called dragonfly, connect to it using the following string:
    redis-cli -h dragonfly

  3. Once connected you can start running commands. For example:
    set hello bye
    get hello

Configure authentication

In order to enable authentication you can rely on the requirepass parameter when starting the server.

  1. First let’s create a proper password string. Jump to the Environment tab in the Service Dashboard and create a new one through the Generate secret values. Name the new environment variable DRAGONFLY_PASSWORD. Commit the changes.

    dragonfly-auth-secret.png

  2. Now go to the CMD Override tab.

    1. Once there, edit the command through the Edit commands button.

    2. Enable the Use override option. Then, replace the CMD Override text field with the following command:

      /bin/sh -c “./dragonfly --requirepass $DRAGONFLY_PASSWORD”

      • The `/bin/sh` is required for the DRAGONFLY_PASSWORD environment variable to be correctly processed as the `requirepass` argument value.

    3. Commit the changes through the Save & restart button.

      dragonfly-cmd-override.PNG

    4. Wait for the container to start up again.

Connect to Dragonfly using password

  1. You may have to restart the forwarder given that the container was restarted. Once the forwarder is running and using the redis-cli, use the following arguments to connect to it:

    $DRAGONFLY_PASSWORD=<copy value from northflank ui> redis-cli -h dragonfly -a $DRAGONFLY_PASSWORD

  2. Check that you’re able to run commands as shown previously.

    • You may notice that when querying the keys created previously they no longer exist. This is because persistence for this container is not enabled.

Configure persistence for Dragonfly

Service persistence

In order to avoid data loss between restarts or outages, we first need to provision persistence storage to our service.

  1. Head over to the Volumes tab and add a new volume.

  2. Select proper storage space according to your requirements. In this case we’re going to use 5GB.

  3. The Dragonfly container uses the /data path to store all of its data. Make sure to put /data as the Container mount path.

  4. Confirm the changes through Create & attach volume.

    keydb_volumes

Dragonfly durable persistence through appendonly mode

Dragonfly by default will use snapshot persistence, which stores changes on a file after a certain number of commands or a certain amount of time has elapsed.

This is not very durable as the latest changes written to Dragonfly may not get written to the snapshot file. To have a more durable persistence, in KeyDB and Redis append only mode is used, which appends changes on a file each time the data set has been changed. We await for Dragonfly appendonly mode.

Benchmarks

Dragonfly has kindly provided performance benchmarks which we've enriched with compute and cost values from AWS.

dragonfly-benchmark-qps-vs-redis-keydb.png

opr6g.16xlargec7g.16xlargec6gn.16xlarge
set0.8ms1ms1ms
get0.9ms0.9ms0.8ms
setex0.9ms1.1ms1.3ms
Compute64 vCPU, 512GB, 25Gbps64 vCPU, 128GB, 30Gbps64 vCPU, 128GB, 100Gbps
Cost on AWS$3.22/ph, $2,318.40/pm$2.32/ph, $1,670.40/pm$2.76/ph, $1 987.20/pm

Using Northflank to deploy Dragonfly

Northflank allows you to deploy your code and databases within minutes. Sign up for a Northflank account and create a free project to get started.

  • Deployment of Docker containers
  • Create your own stateful workloads
  • Persistent volumes
  • Observe & monitor with real-time metrics & logs
  • Low latency and high performance
  • Multiple read and write replicas
  • Backup, restore and fork databases

Share this article with your network