1f42926b7b
docs(docker-compose): Explain `NAT` overhead in docker-compose overlay vs host networks Signed-off-by: Ryan Russell <git@ryanrussell.org> |
||
---|---|---|
.. | ||
docker-compose.yml | ||
README.md |
Dragonfly DB with Docker Compose
This guide will have you up running DragonflyDB with docker-compose
in just a few minutes.
| This guide assumes you have docker
and docker-compose
installed on your machine. If not, Install Docker and Install Docker Compose before continuing.
Step 1
# Download Official Dragonfly DB Docker Compose File
wget https://raw.githubusercontent.com/dragonflydb/dragonfly/main/contrib/docker/docker-compose.yml
# Launch the Dragonfly DB Instance
docker-compose up -d
# Confirm image is up
docker ps | grep dragonfly
# ac94b5ba30a0 docker.dragonflydb.io/dragonflydb/dragonfly "entrypoint.sh drago…" 45 seconds ago Up 31 seconds 0.0.0.0:6379->6379/tcp, :::6379->6379/tcp docker_dragonfly_1
# Log follow the dragonfly container
docker logs -f docker_dragonfly_1
Dragonfly DB will answer to both http
and redis
requests out of the box!
You can use redis-cli
to connect to localhost:6379
or open a browser and visit http://localhost:6379
Step 2
Connect with a redis client.
From a new terminal:
redis-cli
127.0.0.1:6379> set hello world
OK
127.0.0.1:6379> keys *
1) "hello"
127.0.0.1:6379> get hello
"world"
127.0.0.1:6379>
Step 3
Continue being great and build your app with the power of DragonflyDB!
Tuning Dragonfly DB
If you are attempting to tune Dragonfly DB for performance, consider NAT
performance costs associated with containerization.
Performance Tuning
In
docker-compose
, there is a meaningful difference between anoverlay
network(which relies on dockerNAT
traversal on every request) and using thehost
network(seedocker-compose.yml
).
Fore more information, see the official docker-compose network_mode Docs