ubuntu/redis

Redis™ software | Ubuntu

Current Redis™ software Docker Image https://ubuntu.com/security/docker-images, based on Ubuntu. Receives security updates and tracks the newest combination of Redis™ software and Ubuntu. This repository is free to use and exempted from per-user rate limits.

About Redis™ software

Redis is an open source (BSD licensed), in-memory data structure store, used as a database, cache and message broker. It supports data structures such as strings, hashes, lists, sets, sorted sets with range queries, bitmaps, hyperloglogs, geospatial indexes with radius queries and streams. Redis has built-in replication, Lua scripting, LRU eviction, transactions and different levels of on-disk persistence, and provides high availability via Redis Sentinel and automatic partitioning with Redis Cluster. Read more on the https://redis.io/topics/introduction.

Tags and Architectures

!https://assets.ubuntu.com/v1/0a5ff561-LTS%402x.png?h=17 Up to 5 years free security maintenance on LTS channels.

!https://assets.ubuntu.com/v1/572f3fbd-ESM%402x.png?h=17 Up to 10 years customer security maintenance from canonical/redis. https://ubuntu.com/security/docker-images#get-in-touch.

Tags in italics are not available in ubuntu/redis but are shown here for completeness.

Channel Tag shows the most stable channel for that track. A track is a combination of both the application version and the underlying Ubuntu series, eg 1.0-22.04. Channels are ordered from the most stable to the least stable, candidate, beta, edge. More risky channels are always implicitly available. So if beta is listed, you can also pull edge. If candidate is listed, you can pull beta and edge. When stable is listed, all four are available. Images are guaranteed to progress through the sequence edge, beta, candidate before stable.

Commercial use and Extended Security Maintenance channels

If your usage includes commercial redistribution or requires unavailable channels/versions, please https://ubuntu.com/security/docker-images#get-in-touch (or using ***).

Usage

Launch this image locally:

sh
docker run -d --name redis-container -e TZ=UTC -p 30073:6379 -e REDIS_PASSWORD=mypassword ubuntu/redis:6.2-22.04_beta

Access your Redis server at localhost:30073.

Parameters

Testing/Debugging

To debug the container:

sh
docker logs -f redis-container

To get an interactive shell:

sh
docker exec -it redis-container /bin/bash

This image also includes the redis-cli client for interactive container use:

sh
$ docker network create redis-network
$ docker network connect redis-network redis-container
$ docker run -it --rm --network redis-network ubuntu/redis:6.2-22.04_beta redis-cli -h redis-container

Now you can:

redis:6379> AUTH mypassword
OK
redis:6379> PING
PONG
redis:6379>

Deploy with Kubernetes

Works with any Kubernetes; if you don't have one, we recommend you https://microk8s.io/ and microk8s.enable dns storage then snap alias microk8s.kubectl kubectl.

Download https://git.launchpad.net/~ubuntu-docker-images/ubuntu-docker-images/+git/redis/plain/examples/config/redis.conf?h=6.2-22.04 and https://git.launchpad.net/~ubuntu-docker-images/ubuntu-docker-images/+git/redis/plain/examples/redis-deployment.yml?h=6.2-22.04 and set containers.redis.image in redis-deployment.yml to your chosen channel tag (e.g. ubuntu/redis:6.2-22.04_beta), then:

sh
kubectl create configmap redis-config --from-file=redis=redis.conf
kubectl apply -f redis-deployment.yml

You will now be able to connect to the Redis server on localhost:30073.

Bugs and feature requests

If you find a bug in our image or want to request a specific feature, please file a bug here:

https://bugs.launchpad.net/ubuntu-docker-images/+filebug

Please title the bug "redis: <issue summary>". Make sure to include the digest of the image you are using, from:

sh
docker images --no-trunc --quiet ubuntu/redis:<tag>

Deprecated channels & tags

These channels (tags) are not updated anymore. Please upgrade to newer channels, or https://ubuntu.com/security/docker-images#get-in-touch if you can't upgrade.