Buddy Enterprise 镜像文档

一、镜像概述和主要用途

Buddy Enterprise 是一款企业级自动化平台，主要用于构建即时预览与测试环境、实现 staging 及生产环境的部署自动化。该平台支持在企业自有基础设施上部署，提供从代码构建、测试到部署的全流程自动化能力，需配合专用 CLI 工具使用。其核心价值在于简化开发运维流程，提升交付效率，尤其适用于需要严格控制基础设施的企业级场景。

二、核心功能和特性

2.1 核心功能

自动化管道：构建端到端自动化工作流，支持代码拉取、构建、测试、部署等全流程串联。
任务自动化：通过专用集成工具实现重复性任务（如代码检查、依赖安装、版本管理）的自动化执行。
执行监控：实时跟踪自动化任务的执行状态、日志及结果，便于问题排查和流程优化。
专用集成：提供与主流开发工具、云服务的原生集成，简化第三方系统对接。

2.2 技术特性

原生 Docker 支持
- 在自动化管道中构建 Docker 镜像
- 在沙箱环境中运行 Docker 镜像
- 集成 Docker Swarm 容器编排
- 支持 Kubernetes 及 GKE（Google Kubernetes Engine）环境
多平台部署兼容性
支持在 DigitalOcean、Azure、AWS EC2、Linux、Mac OS X 等自有基础设施上安装部署。

三、使用场景和适用范围

3.1 典型使用场景

企业级 CI/CD 流程自动化：适用于需要标准化代码构建、测试、部署流程的开发团队，尤其适合多环境（开发、测试、生产）协同的场景。
容器化应用管理：针对使用 Docker、Kubernetes 等容器技术的团队，简化镜像构建、容器运行及编排集成。
私有基础设施部署：满足企业对数据隐私和基础设施控制权的需求，支持在自有服务器或私有云上部署自动化平台。

3.2 适用范围

中大型开发团队或企业级项目
需要本地化部署 CI/CD 工具的组织
依赖 Docker、Kubernetes 等容器技术的开发/运维团队
需对接多环境（如 AWS、Azure、Google Cloud）的混合云架构场景

四、详细使用方法和配置说明

4.1 安装要求

操作系统：Linux（推荐 Ubuntu 20.04+、CentOS 7+）、Mac OS X 10.15+
云平台：DigitalOcean、Azure、AWS EC2（需满足对应平台的最低资源要求：至少 2 CPU、4GB 内存、20GB 磁盘空间）
依赖工具：Docker Engine 20.10+、Docker Compose 2.0+（如需容器化部署）、Buddy Enterprise CLI 工具

4.2 安装步骤（按平台）

4.2.1 ***推荐安装方式

可通过***文档指导在以下平台安装：

DigitalOcean
Azure
AWS EC2
Linux
Mac OS X

4.3 Docker 部署示例

4.3.1 基础 Docker 运行命令

bash
# 拉取 Buddy Enterprise 镜像（假设镜像名称为 buddy/enterprise，具体以***为准）
docker pull buddy/enterprise:latest

# 运行容器（需映射必要端口，如 80/443，挂载数据卷持久化配置）
docker run -d \
  --name buddy-enterprise \
  -p 80:80 -p 443:443 \
  -v /path/to/buddy/data:/var/lib/buddy \
  --restart unless-stopped \
  buddy/enterprise:latest

4.3.2 Docker Compose 配置示例

创建 docker-compose.yml 文件：

yaml
version: '3.8'
services:
  buddy-enterprise:
    image: buddy/enterprise:latest
    container_name: buddy-enterprise
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./buddy-data:/var/lib/buddy  # 持久化数据目录
      - /var/run/docker.sock:/var/run/docker.sock  # 如需与主机 Docker 交互
    environment:
      - BUDDY_HOST=your-domain.com  # 访问域名
      - BUDDY_PORT=443  # 服务端口
      - BUDDY_SSL_ENABLED=true  # 启用 SSL
    restart: always

启动服务：

bash
docker-compose up -d

4.4 配置参数说明

参数名	描述	默认值
`BUDDY_HOST`	访问 Buddy Enterprise 的域名	`localhost`
`BUDDY_PORT`	服务监听端口	`80`
`BUDDY_SSL_ENABLED`	是否启用 SSL 加密	`false`
`BUDDY_DATA_DIR`	数据持久化目录	`/var/lib/buddy`
`DOCKER_INTEGRATION`	是否启用 Docker 集成	`true`