eventstore/eventstore

Event Store现已更名为Kurrent

我们已将Dockerhub仓库从eventstore重新命名为kurrentplatform。您可以在https://hub.docker.com/r/kurrentplatform/kurrentdb%E6%89%BE%E5%88%B0KurrentDB%E7%9A%84%E6%9C%80%E6%96%B0%E9%95%9C%E5%83%8F%E3%80%82

EventStoreDB的Docker镜像仍保留在https://hub.docker.com/r/eventstore/eventstore%E4%BB%93%E5%BA%93%E4%B8%AD%E3%80%82%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%EF%BC%8C%E8%AF%B7%E6%9F%A5%E7%9C%8B%E5%93%81%E7%89%8C%E5%8F%98%E6%9B%B4FAQ%E3%80%82

EventStoreDB

EventStoreDB是事件原生数据库，业务事件在此以不可变方式存储和流式传输。专为事件溯源、事件驱动和微服务架构设计。EventStoreDB的Docker镜像现可在Cloudsmith获取。

支持的标签和Dockerfile链接

v24.10

• https://hub.docker.com/r/eventstore/eventstore/tags?page=1&name=lts
• https://hub.docker.com/r/eventstore/eventstore/tags?page=1&name=latest
• https://hub.docker.com/r/eventstore/eventstore/tags?page=1&name=24.10
• https://hub.docker.com/r/eventstore/eventstore/tags?page=1&name=24.10.7
• https://hub.docker.com/r/eventstore/eventstore/tags?page=1&name=24.10.7-bookworm-slim
• https://hub.docker.com/r/eventstore/eventstore/tags?page=1&name=24.10.7-jammy
• https://hub.docker.com/r/eventstore/eventstore/tags?page=1&name=24.10.7-alpha-arm64v8

v23.10

https://github.com/EventStore/EventStore/blob/oss-v23.10.7/Dockerfile

• https://hub.docker.com/r/eventstore/eventstore/tags?page=1&name=23.10.7-bookworm-slim
• https://hub.docker.com/r/eventstore/eventstore/tags?page=1&name=23.10.7-jammy
• https://hub.docker.com/r/eventstore/eventstore/tags?page=1&name=23.10.7-alpha-arm64v8

所有旧版本的标签均不受支持且不推荐使用。

如何使用此镜像

启动单个EventStoreDB实例

以下命令将使用默认HTTP端口启动EventStoreDB节点，不启用安全功能。然后您可以使用客户端通过esdb://localhost:2113?tls=false连接字符串连接到它。您也可以在浏览器中打开http://localhost:2113访问管理UI。

bash
docker run --name esdb-node -it -p 2113:2113 \
    eventstore/eventstore:latest --insecure --run-projections=All \
    --enable-atom-pub-over-http

之后，您可以使用gRPC客户端连接到EventStoreDB。管理UI中的流浏览器也将正常工作。

为了持久化数据，我们还建议映射数据库和索引卷。

启动三节点集群

在生产环境中，我们建议运行三节点集群。您可以使用Docker Compose在本地测试此设置。完整示例请参见我们的开发者文档。

安全

所有支持版本的EventStoreDB默认是安全的。这意味着您必须提供有效的证书和配置，数据库节点才能正常工作。

我们了解许多用户希望在现有应用中试用最新版本，或在内部网络中无安全设置测试EventStoreDB。

为此，您可以使用上述命令中的--insecure选项。

请注意，在不安全模式下运行时，数据库不使用任何身份验证和授权（包括ACL）。

发布包

当您准备创建生产环境时，可以在Cloudsmith找到Linux和Windows的最新发布包。

有关在Linux或Windows上安装EventStoreDB的说明，请参见安装指南。

EventStoreDB客户端

使用客户端与EventStoreDB实例交互。客户端库位于各自的仓库中，您可以参考其特定说明。

当前客户端

客户端协议基于开放标准，并被多种编程语言广泛支持。EventStoreDB使用gRPC在集群节点之间以及客户端-服务器之间进行通信。

开发使用EventStoreDB的软件时，我们建议使用官方SDK之一。

EventStoreDB支持的客户端

• Python: pyeventsourcing/esdbclient
• Node.js（JavaScript/TypeScript）: https://github.com/EventStore/EventStore-Client-NodeJS
• Java: https://github.com/EventStore/EventStoreDB-Client-Java
• .NET: https://github.com/EventStore/EventStore-Client-Dotnet
• Go: https://github.com/EventStore/EventStore-Client-Go
• Rust: https://github.com/EventStore/EventStoreDB-Client-Rust

更多信息请参见gRPC客户端文档。

社区开发的客户端

• https://github.com/yousty/event_store_client
• https://github.com/NFIBrokerage/spear

快速参考

• 有关Kurrent平台和Kurrent Cloud的更多信息，请访问官方网站。
• 下载Kurrent Navigator，KurrentDB的新用户界面。
• 文档发布在Kurrent文档站点。
• 在https://github.com/kurrent-io/KurrentDB%E4%B8%AD%E4%B8%BA%E9%A1%B9%E7%9B%AE%E8%B4%A1%E7%8C%AE%E4%BB%A3%E7%A0%81%E3%80%82%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%E8%AF%B7%E5%8F%82%E8%A7%81https://github.com/kurrent-io/KurrentDB/blob/master/CONTRIBUTING.md%E3%80%82
• 在https://github.com/kurrent-io/KurrentDB/issues%E6%8F%90%E4%BA%A4%E9%97%AE%E9%A2%98%E3%80%82
• KurrentDB用户可以使用社区论坛提问、讨论并从社区成员获取帮助。

许可证

查看https://github.com/kurrent-io/KurrentDB/blob/master/LICENSE.md%E3%80%82

与所有Docker镜像一样，ESDB镜像可能包含其他具有单独许可证的软件（如基础发行版中的Bash，以及ESDB软件的任何直接或间接依赖项）。

镜像用户有责任确保对本镜像的任何使用均符合其中包含的所有软件的相关许可证。