docksal/ci-agent

Docksal Sandbox 代理镜像

镜像概述

该镜像为轻量级代理工具，专门用于在远程Docker主机上配置和管理Docksal沙箱环境。作为Docksal生态系统的一部分，它提供了远程部署和管理沙箱的核心能力，简化了跨主机的开发环境配置流程。

核心功能和特性

• 轻量级架构：资源占用低，适合在各类服务器环境中部署
• 远程配置支持：支持连接并管理远程Docker主机上的沙箱环境
• 沙箱自动化：自动化Docksal沙箱的创建、配置和维护流程
• Docksal生态集成：与Docksal工具链无缝协作，确保沙箱环境一致性
• 跨平台兼容：适配主流Linux发行版及Docker环境

使用场景和适用范围

• 开发团队需要在远程服务器上快速部署隔离的Docksal开发沙箱
• 多环境管理（开发、测试、预发布）中的沙箱统一配置
• 远程Docker主机资源的集中利用与沙箱生命周期管理
• CI/CD流程中集成远程沙箱部署步骤

使用方法和配置说明

基本部署

通过以下命令在本地启动代理，连接远程Docker主机：

bash
docker run -d \
  --name docksal-agent \
  -e DOCKER_HOST=ssh://user@remote-docker-host \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docksal/agent

核心配置参数

环境变量

数据卷挂载

• /var/run/docker.sock：本地Docker socket（用于代理与Docker引擎通信）
• /root/.ssh：SSH密钥目录（用于远程主机认证，当使用SSH连接时）

典型使用示例

使用SSH密钥认证连接远程主机

bash
docker run -d \
  --name docksal-agent \
  -e DOCKER_HOST=ssh://user@remote-host \
  -v /path/to/local/ssh/keys:/root/.ssh \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docksal/agent

配置TLS加密连接

bash
docker run -d \
  --name docksal-agent \
  -e DOCKER_HOST=tcp://remote-host:2376 \
  -e DOCKER_CERT_PATH=/etc/docker/certs \
  -v /local/path/to/certs:/etc/docker/certs \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docksal/agent

注意事项

• 确保远程Docker主机已启用API访问（2375/tcp未加密或2376/tcp TLS加密端口）
• SSH连接时需提前配置免密登录或提供密钥文件
• 代理容器需要适当的权限以管理远程Docker主机上的资源
• 生产环境建议使用TLS加密连接以保障通信安全