valkey-bundle镜像用于安装valkey服务器并加载所有valkey模块,提供集成了服务器与完整模块的一站式运行环境。
This file is auto-generated by the Valkey Bundle Update workflow
Quick reference
-
Maintained by:
https://github.com/valkey-io/valkey-bundle -
Where to get help:
Please open an issue stating your question at https://github.com/valkey-io/valkey-bundle/issues.
Supported tags and respective Dockerfile links
Official releases
- https://github.com/valkey-io/valkey-bundle/blob/mainline/9.1/debian/Dockerfile
- https://github.com/valkey-io/valkey-bundle/blob/mainline/9.1/alpine/Dockerfile
- https://github.com/valkey-io/valkey-bundle/blob/mainline/9.0/debian/Dockerfile
- https://github.com/valkey-io/valkey-bundle/blob/mainline/9.0/alpine/Dockerfile
- https://github.com/valkey-io/valkey-bundle/blob/mainline/8.1/debian/Dockerfile
- https://github.com/valkey-io/valkey-bundle/blob/mainline/8.1/alpine/Dockerfile
Release candidates
- https://github.com/valkey-io/valkey-bundle/blob/mainline/9.2/debian/Dockerfile
- https://github.com/valkey-io/valkey-bundle/blob/mainline/9.2/alpine/Dockerfile
Latest unstable
- https://github.com/valkey-io/valkey-bundle/blob/mainline/unstable/debian/Dockerfile
- https://github.com/valkey-io/valkey-bundle/blob/mainline/unstable/alpine/Dockerfile
What is https://github.com/valkey-io/valkey-bundle?
Valkey Bundle is a containerized version of Valkey, enhanced with popular modules like https://github.com/valkey-io/valkey-json, https://github.com/valkey-io/valkey-bloom, https://github.com/valkey-io/valkey-search, and https://github.com/valkey-io/valkey-ldap, allowing you to utilize advanced data structures and additional search capabilities alongside standard Valkey functionality.
This image is built on top of the official Valkey base image and simplifies deployment of Valkey with these powerful modules included.
Versions
| valkey-bundle | valkey | valkey-json | valkey-bloom | valkey-search | valkey-ldap |
|---|---|---|---|---|---|
| unstable | unstable | https://github.com/valkey-io/valkey-json/tree/unstable | https://github.com/valkey-io/valkey-bloom/tree/unstable | https://github.com/valkey-io/valkey-search/tree/main | https://github.com/valkey-io/valkey-ldap/tree/main |
| 9.2.0-rc2 | https://github.com/valkey-io/valkey/releases/tag/9.2.0-rc1 | https://github.com/valkey-io/valkey-json/releases/tag/1.0.3 | https://github.com/valkey-io/valkey-bloom/releases/tag/1.0.1 | https://github.com/valkey-io/valkey-search/releases/tag/1.3.0-rc1 | https://github.com/valkey-io/valkey-ldap/releases/tag/1.1.1 |
| 9.1.3 | https://github.com/valkey-io/valkey/releases/tag/9.1.2 | https://github.com/valkey-io/valkey-json/releases/tag/1.0.3 | https://github.com/valkey-io/valkey-bloom/releases/tag/1.0.1 | https://github.com/valkey-io/valkey-search/releases/tag/1.2.1 | https://github.com/valkey-io/valkey-ldap/releases/tag/1.1.1 |
| 9.0.6 | https://github.com/valkey-io/valkey/releases/tag/9.0.6 | https://github.com/valkey-io/valkey-json/releases/tag/1.0.3 | https://github.com/valkey-io/valkey-bloom/releases/tag/1.0.1 | https://github.com/valkey-io/valkey-search/releases/tag/1.0.3 | https://github.com/valkey-io/valkey-ldap/releases/tag/1.0.1 |
| 8.1.10 | https://github.com/valkey-io/valkey/releases/tag/8.1.10 | https://github.com/valkey-io/valkey-json/releases/tag/1.0.3 | https://github.com/valkey-io/valkey-bloom/releases/tag/1.0.1 | https://github.com/valkey-io/valkey-search/releases/tag/1.0.3 | https://github.com/valkey-io/valkey-ldap/releases/tag/1.0.1 |
Security
For ease of accessing Valkey Bundle from other containers via Docker networking, the "Protected mode" is turned off by default. This means if you expose the port externally (e.g., via -p), it will be open without authentication. It is strongly recommended to set a password or authentication method if exposing your instance to the internet.
See the following resources for securing Valkey:
- https://valkey.io/topics/security/
- https://valkey.io/topics/security/#protected-mode
How to use this image
Start a valkey-bundle instance
console$ docker run --name my-valkey-bundle -d valkey/valkey-bundle
Start with persistent storage
console$ docker run --name my-valkey-bundle -d valkey/valkey-bundle valkey-server --save 60 1 --loglevel warning
This example saves a snapshot every 60 seconds if at least one write occurred. Data is stored at VOLUME /data.
Connecting via valkey-cli
console$ docker run -it --network some-network --rm valkey/valkey-bundle valkey-cli -h my-valkey-bundle
Pass additional start arguments with environment variable
You can configure startup arguments with the environment variable VALKEY_EXTRA_FLAGS:
console$ docker run --env VALKEY_EXTRA_FLAGS='--save 60 1 --loglevel warning' valkey/valkey-bundle
Custom valkey.conf usage
Create a custom configuration file valkey.conf and use it in your container:
Dockerfile approach:
dockerfileFROM valkey/valkey-bundle:latest COPY valkey.conf /usr/local/etc/valkey/valkey.conf CMD [ "valkey-server", "/usr/local/etc/valkey/valkey.conf" ]
Docker run approach:
console$ docker run -v /myvalkey/conf:/usr/local/etc/valkey --name my-valkey-bundle valkey/valkey-bundle valkey-server /usr/local/etc/valkey/valkey.conf
Image Variants
valkey/valkey-bundle:<version>
This is the primary image, which includes Valkey along with common modules like valkey-json, valkey-bloom, valkey-search, and valkey-ldap preloaded. It is suitable for development, testing, and production environments where these modules are needed out of the box.
Some of the tags may include names like bookworm, which refer to https://wiki.debian.org/DebianReleases. These indicate the base image used and help ensure compatibility if your container needs additional packages. Specifying these explicitly is recommended to avoid unexpected changes when base image versions update.
If you want a minimal yet functional Valkey container with built-in modules, this image is a great place to start.
valkey/valkey-bundle:<version>-alpine
This image is based on the popular [***] available in https://hub.docker.com/_/alpine. Alpine Linux is much smaller than most distribution base images (~5MB), and thus leads to much slimmer images in general.
This variant is useful when final image size being as small as possible is your primary concern. The main caveat to note is that it does use https://musl.libc.org instead of https://www.etalabs.net/compare_libcs.html, so software will often run into issues depending on the depth of their libc requirements/assumptions. See this Hacker News comment thread for more discussion of the issues that might arise and some pro/con comparisons of using Alpine-based images.
To minimize image size, it's uncommon for additional related tools (such as git or bash) to be included in Alpine-based images. Using this image as a base, add the things you need in your own Dockerfile (see the https://hub.docker.com/_/alpine/ for examples of how to install packages if you are unfamiliar).
License
View the https://github.com/valkey-io/valkey-bundle/blob/mainline/LICENSE for software included in this image.
Users of this image are responsible for ensuring compliance with all licenses of software contained within.
valkey 命名空间的其他可用镜像:
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 valkey-bundle 镜像标签
DockerHub 原生拉取命令
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务