ServicePulse

本文档描述了ServicePulse镜像的基本使用方法和相关信息。ServicePulse应用程序的完整文档可在Particular Software文档网站上找到。

使用方法

以下是使用Docker创建ServicePulse容器的最基本方式：

shell
docker run -p 9090:9090 particular/servicepulse:latest

环境变量

• SERVICECONTROL_URL: 默认值: http://localhost:33333。ServiceControl实例的URL
• MONITORING_URL: 默认值: http://localhost:33633。Monitoring实例的URL
• DEFAULT_ROUTE: 默认值: /dashboard。访问网站时应显示的默认页面
• SHOW_PENDING_RETRY: 默认值: false。设为true可显示待重试的详细信息
• ENABLE_REVERSE_PROXY: 默认值: true。设为false可禁用将请求转发到ServiceControl和Monitoring实例的代理

可能希望在隔离网络中运行ServiceControl服务。此时，必须通过环境变量配置ServicePulse以连接到这些服务：

shell
docker run -p 9090:9090 -e SERVICECONTROL_URL="[***]" -e MONITORING_URL="[***]" particular/servicepulse:latest

或者作为Docker Compose服务规范的一部分：

yaml
services:
    servicepulse:
        ports:
            - 9090:9090
        environment:
            - SERVICECONTROL_URL=[***]
            - MONITORING_URL=[***]
        image: particular/servicepulse:latest

镜像标签

latest 标签

此标签主要供希望使用最新版本的开发者使用，例如 docker-compose up -d --build --force-recreate --renew-anon-volumes。

如果某个版本针对当前最新主版本或在之前的最新主版本之后是新的主版本，则会将:latest标签应用于推送到Docker Hub的镜像。

如果该版本是对之前主版本的补丁版本，则不会将:latest标签添加到推送到Docker Hub的镜像。

:latest标签从不添加到推送到GitHub Container Registry的镜像。

版本标签

我们使用语义化版本（SemVer）进行版本控制。推送到Docker Hub的发布镜像将使用发布版本进行标记。推送到GitHub Container Registry的预发布镜像不会有版本标签。

拉取请求标签

从GitHub拉取请求生成的预发布镜像版本仅在GitHub Container Registry中可用，并使用拉取请求编号进行标记，遵循以下约定：pr-1234。拉取请求标签仅添加到推送到GitHub Container Registry的镜像，不会添加到推送到Docker Hub的镜像。

主版本标签

主版本内的最新发布将在推送到Docker Hub的镜像上仅使用主版本号进行标记。这允许用户针对特定主版本，以帮助避免主版本之间发生破坏性变更的风险。例如，在生产环境中自动升级容器时很有用：

如果particular/servicepulse:1.30.1是1.x主版本中的最新发布，该镜像也会被标记为particular/servicepulse:1。

主版本标签从不添加到推送到GitHub Container Registry的镜像。

次版本标签

次版本内的最新发布将在推送到Docker Hub的镜像上使用{major}.{minor}进行标记。这允许用户针对特定次版本内的最新补丁版本。

镜像架构

此镜像是基于mcr.microsoft.com/dotnet/aspnet:8.0-noble-***ed-composite基础镜像的多架构镜像，支持linux/arm64和linux/amd64。

贡献

请阅读我们的文档了解如何为Particular Software项目做出贡献。

作者

此软件（包括此容器镜像）由Particular Software团队构建和维护。另请参阅参与此项目的贡献者列表。

许可证

本项目采用互惠公共许可证1.5（RPL1.5）授权，商业许可证也可供使用 - 详见LICENSE.md文件。