onesystems/semaphore

镜像概述

本镜像基于 semaphoreui/semaphore 仓库派生，在保留原Semaphore核心功能的基础上，预装了WinRM（Windows Remote Management）工具，支持通过Ansible UI对Windows主机进行远程管理、任务调度及自动化操作。适用于需要通过图形化界面管理跨平台（Linux/Windows）Ansible任务的场景。

核心功能与特性

原Semaphore核心功能

• 开源Ansible UI工具，提供图形化界面管理Ansible Playbook、任务和 inventory
• 支持任务调度、执行历史记录与审计
• 多用户权限管理，支持团队协作
• 集成Ansible Vault，安全存储敏感配置

新增WinRM支持

• 预装WinRM客户端组件，无需额外配置即可支持Ansible通过WinRM协议连接Windows主机
• 兼容Ansible winrm 连接插件，支持Windows远程命令执行、文件传输等操作

使用场景

• Windows环境Ansible管理：需通过Ansible自动化管理Windows主机（如系统配置、软件部署）的团队
• 跨平台任务调度：同时管理Linux和Windows主机的自动化任务，统一通过图形化界面监控
• 简化WinRM配置：无需在宿主机单独安装WinRM依赖，直接通过容器快速部署支持Windows管理的Ansible环境

使用方法

基本部署（Docker Run）

bash
docker run -d \
  --name semaphore-winrm \
  -p 3000:3000 \  # Web UI端口
  -e SEMAPHORE_DB_DIALECT=sqlite \  # 数据库类型（支持sqlite/mysql/postgres）
  -e SEMAPHORE_ADMIN_PASSWORD=your_admin_pass \  # 管理员密码
  -e SEMAPHORE_ADMIN_NAME="Admin User" \  # 管理员名称
  -e SEMAPHORE_ADMIN_EMAIL=admin@example.com \  # 管理员邮箱
  -v /path/to/semaphore/data:/var/lib/semaphore \  # 持久化数据卷（存储配置、任务记录等）
  [镜像名称]:[标签]

环境变量配置

WinRM连接配置（Ansible Inventory）

镜像预装WinRM客户端后，需在Ansible Inventory中配置Windows主机的WinRM连接参数，示例：

ini
[windows_hosts]
win-node1 ansible_host=192.168.1.100 ansible_user=admin ansible_password=Passw0rd!

[windows_hosts:vars]
ansible_connection=winrm
ansible_winrm_transport=ntlm  # 或 'kerberos'/'basic'（根据环境配置）
ansible_winrm_server_cert_validation=ignore  # 开发环境可忽略证书验证

数据持久化

通过 -v 参数挂载数据卷，确保任务记录、配置文件等持久化存储：

bash
-v /host/path/to/data:/var/lib/semaphore  # 核心数据目录
-v /host/path/to/ansible:/etc/ansible     # 挂载本地Ansible配置（可选）

注意事项

• 首次启动需通过Web UI（http://localhost:3000）完成初始化配置（如创建项目、导入Inventory）
• WinRM协议安全性：生产环境建议启用HTTPS（配置ansible_winrm_ca_trust_path）及强认证（如Kerberos）
• 镜像基于原 semaphoreui/semaphore 构建，版本兼容性请参考原仓库文档

参考链接

• https://github.com/semaphoreui/semaphore
• Ansible WinRM连接文档