compucorp/civicrm-buildkit

CiviCRM Buildkit基础镜像

镜像概述

本镜像为基于Ubuntu系统的基础Docker镜像，预安装了CiviCRM Buildkit工具集。CiviCRM Buildkit是CiviCRM官方提供的开发和部署工具包，包含了构建、测试和运行CiviCRM所需的各类依赖和脚本。该镜像旨在为CiviCRM相关应用提供统一、便捷的开发和部署环境，减少手动配置步骤，提高工作效率。

核心功能和特性

• 基于Ubuntu系统：采用稳定的Ubuntu作为基础操作系统，提供广泛的软件兼容性
• 预安装CiviCRM Buildkit：包含完整的CiviCRM Buildkit工具集，无需手动下载和配置
• 简化部署流程：省去繁琐的依赖安装步骤，可直接用于CiviCRM应用的构建和运行
• 统一开发环境：确保不同开发人员和部署环境使用一致的工具版本，减少环境差异导致的问题

使用场景和适用范围

• CiviCRM应用开发人员的本地开发环境
• CiviCRM插件或扩展的测试环境
• 快速部署CiviCRM应用的生产或演示环境
• CI/CD流程中CiviCRM应用的自动化构建和测试环节

使用方法和配置说明

基本使用（Docker Run）

通过以下命令启动容器：

bash
docker run -it --name civicrm-buildkit-base [镜像名称]:[标签]

持久化数据（可选）

如需持久化Buildkit相关数据，可挂载本地目录：

bash
docker run -it --name civicrm-buildkit-base -v /本地目录:/buildkit [镜像名称]:[标签]

进入容器后使用

容器启动后，可直接使用CiviCRM Buildkit提供的命令，例如：

bash
# 查看Buildkit版本
civibuild version

# 创建新的CiviCRM构建
civibuild create my-civicrm

环境变量（如有）

目前该基础镜像未定义额外环境变量，如需自定义配置，可在启动容器时通过-e参数添加，例如：

bash
docker run -it -e CIVIBUILD_DB_USER=myuser -e CIVIBUILD_DB_PASS=mypass [镜像名称]:[标签]

注意事项

• 该镜像为基础镜像，实际生产环境可能需要根据具体需求添加额外配置（如网络设置、安全加固等）
• 使用前请确保已安装Docker引擎（版本1.13.0及以上）
• 如需长期运行，建议结合进程管理工具（如systemd）或使用-d参数以守护进程模式启动容器