stackstorm/st2 Docker 镜像 - 轩辕镜像

StackStorm HA基础镜像

镜像概述和主要用途

StackStorm HA基础镜像是用于构建StackStorm高可用（High Availability, HA）集群组件镜像的底层基础镜像。该镜像基于stackstorm/st2-dockerfiles项目构建，提供标准化的运行环境和核心依赖，作为构建StackStorm高可用集群中各类组件（如API服务、认证服务、动作调度器等）镜像的统一基础。

主要用途：作为构建StackStorm高可用部署所需各类功能组件镜像的底层依赖，确保集群中所有组件运行环境的一致性、兼容性和稳定性。

核心功能和特性

核心功能

• 提供StackStorm HA集群组件运行所需的标准化基础环境
• 预装StackStorm核心依赖库及系统工具
• 支持基于此镜像扩展构建高可用集群中的各类功能组件

特性

• 标准化环境：基于稳定的Linux发行版（如Ubuntu/Debian）构建，环境配置统一
• 精简基础：仅包含必要的系统依赖和运行时组件，减少镜像体积
• 兼容性保障：与StackStorm官方版本及高可用部署架构兼容
• 可扩展性：支持通过Dockerfile指令扩展，添加组件特定依赖和配置
• 最佳实践：遵循Docker镜像构建最佳实践，确保镜像安全性和可维护性

使用场景和适用范围

适用场景

• StackStorm高可用集群组件镜像的开发与构建
• 企业级StackStorm自动化平台的高可用部署场景
• 需要定制化StackStorm组件（如添加企业内部依赖、安全加固）的场景

适用范围

• StackStorm运维工程师：构建高可用集群的自定义组件镜像
• 开发人员：基于标准化基础镜像开发StackStorm扩展组件
• 企业IT团队：部署具备高可用性的StackStorm自动化平台

使用方法和配置说明

基本使用方式

该镜像主要作为基础镜像，通过Dockerfile的FROM指令引用，用于构建StackStorm高可用集群的功能组件镜像。

Dockerfile示例

以下示例展示如何基于此基础镜像构建StackStorm高可用API服务镜像：

dockerfile
# 基于StackStorm HA基础镜像构建
FROM stackstorm/st2-ha-base:latest

# 安装API服务特定依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
    python3-st2api \
    && rm -rf /var/lib/apt/lists/*

# 复制API服务配置文件
COPY ./st2api.conf /etc/st2/st2api.conf

# 暴露API服务端口
EXPOSE 9101

# 启动命令（根据StackStorm官方规范）
CMD ["/usr/bin/st2api", "--config-file", "/etc/st2/st2api.conf"]

构建自定义镜像

使用docker build命令构建基于该基础镜像的自定义组件镜像：

bash
# 构建st2api高可用组件镜像
docker build -t my-st2-ha-api:1.0 -f Dockerfile.st2api .

部署方案示例

docker-compose配置示例

以下docker-compose.yml片段展示如何在高可用集群部署中引用基于该基础镜像构建的组件：

yaml
version: '3.8'

services:
  st2api:
    image: my-st2-ha-api:1.0  # 基于st2-ha-base构建的自定义API镜像
    container_name: st2api-ha
    restart: always
    ports:
      - "9101:9101"
    environment:
      - ST2_AUTH_URL=[***]
      - ST2_API_URL=http://localhost:9101
    volumes:
      - st2-config:/etc/st2
      - st2-logs:/var/log/st2
    depends_on:
      - st2auth-ha
      - mongodb
      - rabbitmq

volumes:
  st2-config:
  st2-logs:

配置参数与环境变量

构建参数

在构建基于此基础镜像的自定义镜像时，可通过ARG指定以下参数：

环境变量

运行基于此基础镜像构建的组件时，可通过环境变量调整配置：

相关资源

• 官方仓库：stackstorm/st2-dockerfiles
• StackStorm官方文档：StackStorm Documentation
• StackStorm高可用部署指南：HA Deployment Guide