axoniq/axonserver

Axon Server## 支持的标签*基于Eclipse Temurin的多平台镜像：

Axon Server安装在"/axonserver"目录下，导出的卷包括"/axonserver/data"（控制数据库和PID文件）、"/axonserver/events"（事件和快照）、"/axonserver/log"（复制日志）、"/axonserver/config"（用于可选的额外"axonserver.properties"文件）和"/axonserver/plugins"（插件缓存）。

• 2025.1.5、2025.1.5-jdk-17、latest、latest-jdk-17

  这些标签以"root"用户身份运行Axon Server，使用Java 17运行时。

• 2025.1.5-nonroot、2025.1.5-jdk-17-nonroot、latest-nonroot、latest-jdk-17-nonroot

  这些标签以"axonserver"用户身份运行Axon Server，使用Java 17运行时。

旧版本可在标签部分找到。

快速参考* 许可证：

• Axon Server根据AxonIQ软件订阅协议提供。安装和/或使用Axon Server即表示您同意AxonIQ软件订阅协议条款。如不同意这些条款，您不得使用本软件。

• 信息获取：

  • Axon参考指南是关于Axon Framework和Axon Server的权威指南。
  • 所有版本的发行说明
  • 访问[***] Framework和Server背后的团队。
  • 订阅AxonIQ ***频道获取最新网络研讨会、公告和客户案例。
  • Giftcard App的最新版本可在https://github.com/AxonIQ/giftcard-demo%E4%B8%8A%E6%89%BE%E5%88%B0%E3%80%82
  • Axon Server的Docker镜像推送到https://hub.docker.com/u/axoniq%E3%80%82

• 维护者： AxonIQ团队

2025.1.0版本发行说明Axon Server 2025.1引入了对动态一致性边界（DCB）的支持。更多信息，请参见[***] Framework 5.0或更高版本。

错误修复和改进：

• 将配置数据库中的CLOB/BLOB字段替换为varchar/varbinary字段，以避免数据库大小增加
• 修复事件转换时关闭索引的时序问题
• 防止UI向Axon Server发送过多请求
• 修复读取复制项的term时，最新段正在关闭的并发问题
• 将Spring-Boot升级到3.3.13以解决CVE-2025-48988

2025.0.0版本发行说明Axon Server 2025.0支持通过HTTP(s)和RSocket与非Axon Framework应用程序无缝集成。此方法消除了单独安装Axon Synapse的需求。

Axon Server可执行以下操作：

• 将命令和查询路由到HTTP(s)和RSocket端点
• 将事件发布到HTTP(s)和RSocket端点（由持久化流支持）

客户端现在可以：

• 通过新的HTTP(s)操作在Axon Server中存储事件和快照
• 通过新的HTTP(s)操作调用命令和查询
• 通过新的HTTP(s)操作读取聚合事件和快照

更多信息，请查看集成。

2024.2.0版本发行说明错误修复和改进：

• 改进集群拓扑变更的稳定性。更改集群拓扑时（例如，向复制组添加或删除节点），通过修订配置变更的实现，修复了先前出现的不稳定性。
• 改进具有大量客户端时的消息路由性能。如果环境中包含许多客户端应用程序（超过500个），以前会有明显的性能影响。这些问题已修复，并提供了明确的配置选项。
• 全新的AxonServer grafana仪表板。我们提供的Grafana仪表板从头开始完全重新设计，以简化解释，同时提高准确性。新仪表板反映了先前版本中引入的新指标。
• 修复搜索屏幕中的错误，该错误导致先前搜索的结果与当前搜索的结果混合。
• 更好地集成到Axoniq控制台
• 升级依赖项。AxonServer尽可能升级到可用的最新依赖项。
• 添加具有已存在节点名称的节点现在会优雅失败
• 改进诊断包的内容
• 临时上下文现在从全局索引中删除条目

2024.1.0版本发行说明### 持久化流持久化流提供了从客户端打开事件流并让Axon Server跟踪进度的选项。这在2024.0中已作为预览版本提供，但现在默认可用。Axon Framework 4.10支持持久化流，作为跟踪或池化流事件处理器的替代方案。

更多信息，请参见Axon Framework部分中的订阅事件处理器。

错误修复和改进- 防止Axon Server节点关闭与另一个节点的连接时出现stale线程

• 清理断开连接客户端的指标
• 防止从意外客户端收到查询完成消息时出现WARN日志消息
• 允许没有许可证的临时事件上下文
• 修复当事件处理器超过512个时列出事件处理器的问题

Docker镜像变更Docker镜像的默认Java版本从Java 11更改为Java 17。这意味着标签为"latest"、"latest-nonroot"、"2024.1.0"和"2024.1.0-nonroot"的docker镜像使用Java 17。基于Java 11的镜像仍然可用，标签名称中带有"-jdk-11"扩展名。

依赖项更新- gRPC版本更新到1.65.1

2024.0.0版本发行说明### 数据库更新更新H2数据库以存储控制数据库，解决了先前H2版本的一些问题（请参见[***]

新功能和改进重新设计的用户界面：UI已完全改版，采用现代外观和感觉，以提供更好的用户体验。变更包括：

• 简化的概览页面：轻松访问节点信息，带有过滤和扩展选项。
• 专用许可证页面：跟踪许可证到期日期，并为非企业用户查看可用功能。
• 监控页面：查看重要健康信息，显示日志，并下载诊断包。
• 系统任务：列出和取消正在运行的系统任务。
• 搜索事件存储页面：改进可用性，带有可移除列、格式化代码样式和自动组合查询。
• 命令和查询页面：重新设计，以更好地概览系统中的消息。
• 长时间运行命令组件：查看和取消运行超过1秒的命令。
• 计划事件页面：查看和取消计划事件。
• 流页面（实验性）：如果启用开发模式，可访问持久化流。
• API令牌（以前称为应用程序）：重命名以提高清晰度，具有改进的令牌管理。
• 支持宽屏和深色/浅色主题：增强查看体验。
• 连接、健康和早期事件处理器问题检测：改进问题检测和解决。
• 嵌入式文档片段：直接在UI中访问文档。

新的持久化流功能预览，Axon Server管理向客户端发布事件并跟踪进度的事件流。当启用开发模式或设置axoniq.axonserver.preview.persistent-streams属性为true时，此功能启用。

2023.2.0版本发行说明### 运行时TLS证书和密钥替换Axon Server现在支持运行时热替换TLS使用的证书和密钥，无需服务器重启。

增强的指标暴露我们重新设计了Axon Server公开的指标，以提高清晰度和可理解性。遵循4个黄金信号术语，指标现在系统地组织。此版本中用户可以访问旧样式和新样式指标。但是，可以选择禁用旧样式指标。

升级的诊断包为帮助解决问题，Axon Server现在提供更全面的诊断包。该包现在包含有关raft状态的更多详细信息。提供指标和健康信息的快照。列出复制组中的文件。包括多层存储的信息。还包括日志。

其他改进- 我们通过依赖项更新解决了各种安全问题。此外，已识别并纠正了几个错误。

• 角色“MONITOR”现在被授予访问“internal/raft/status”端点的权限。
• 我们已过渡到Axon Server中使用的一些外部库的新版本。

2023.1.0版本发行说明### 新功能和增强#### 事件转换新的事件转换功能允许用户利用事件转换API在事件存储中执行特定的事件转换（如更新和删除）。此功能变更旨在促进在不可避免的修改情况下更灵活的事件管理。

强制客户端重新连接在应用程序视图中，现在为用户提供了强制客户端重新连接的选项。此添加旨在提供解决客户端连接问题的实用工具。

从集群中删除节点现在可以通过用户界面（UI）从集群中删除节点。此功能以前仅通过命令行界面（CLI）和REST API访问，现在已扩展到UI以提高可访问性。

开发模式的临时调整在此版本中，我们暂时禁用了“开发模式/事件清除”功能。用户现在应使用“删除/创建上下文”操作作为替代方案。此变更将一直有效，直到实施更有效的解决方案。

增强的内存管理为了优化性能，我们更新了Axon Server对文件资源的内存管理方法。在此版本之前，Axon Server主要依赖Java垃圾收集器回收内存映射文件使用的内存。通过此更新，内存管理现在由Axon Server直接承担，提高了文件资源使用的效率。

错误修复此版本还包含以下问题的修复：

• 复制组创建不能与HTTPS（-s）选项一起使用
• 取消注册节点时的竞争条件导致节点部分留在集群中

产品更新#### 统一的Axon Server制品Axon Server制品已更新，以简化部署过程。从现在开始，我们不再为Axon Server标准版和企业版提供单独的制品，而是发布单个制品。Axon Server功能将根据提供的许可证自动调整。请注意，Axon Server标准版仍然是开源的，但将不再单独发布。

旧版本的发行说明可以在参考指南的发行说明部分找到。

运行Axon Server要在Docker中运行Axon Server，可以使用Docker Hub上提供的镜像：

$ docker run -d --name my-axon-server -p 8024:8024 -p 8124:8124 docker.axoniq.io/axoniq/axonserver
...some container id...

有关如何在Docker/Kubernetes环境中运行Axon Server的更多信息，请查看参考指南。

配置Axon ServerAxon Server的所有设置都使用合理的默认值，因此无需进一步配置即可正常运行。但是，如果您想进行一些更改，以下是最常见的选项。

用于自定义Axon Server Docker镜像的环境变量* JAVA_TOOL_OPTIONS

用于传递JVM选项。默认用于堆大小设置，值为“`-Xmx512m`”。

• AXONIQ_AXONSERVER_NAME

  Axon Server用于自身的名称。

• AXONIQ_AXONSERVER_HOSTNAME

  Axon Server向客户端通信的主机名，作为其联系点。默认为“localhost”，因为Docker生成的随机名称在容器外部无法解析。

• AXONIQ_AXONSERVER_DOMAIN

  Axon Server可以附加到主机名的域名。

• SERVER_PORT

  Axon Server用于其Web GUI和REST API的端口。

• AXONIQ_AXONSERVER_PORT

  客户端用于与服务器交换数据的gRPC端口。

• AXONIQ_AXONSERVER_ACCESSCONTROL_ENABLED

  设置为true将启用访问控制。