stackstorm/st2

StackStorm HA基础镜像

镜像概述和主要用途

StackStorm HA基础镜像是用于构建StackStorm高可用（High Availability, HA）集群组件镜像的底层基础镜像。该镜像基于https://github.com/stackstorm/st2-dockerfiles%E9%A1%B9%E7%9B%AE%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%8F%90%E4%BE%9B%E6%A0%87%E5%87%86%E5%8C%96%E7%9A%84%E8%BF%90%E8%A1%8C%E7%8E%AF%E5%A2%83%E5%92%8C%E6%A0%B8%E5%BF%83%E4%BE%9D%E8%B5%96%EF%BC%8C%E4%BD%9C%E4%B8%BA%E6%9E%84%E5%BB%BAStackStorm%E9%AB%98%E5%8F%AF%E7%94%A8%E9%9B%86%E7%BE%A4%E4%B8%AD%E5%90%84%E7%B1%BB%E7%BB%84%E4%BB%B6%EF%BC%88%E5%A6%82API%E6%9C%8D%E5%8A%A1%E3%80%81%E8%AE%A4%E8%AF%81%E6%9C%8D%E5%8A%A1%E3%80%81%E5%8A%A8%E4%BD%9C%E8%B0%83%E5%BA%A6%E5%99%A8%E7%AD%89%EF%BC%89%E9%95%9C%E5%83%8F%E7%9A%84%E7%BB%9F%E4%B8%80%E5%9F%BA%E7%A1%80%E3%80%82

主要用途：作为构建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=http://st2auth-ha:9100
      - 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指定以下参数：

环境变量

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

相关资源

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