GD2开发环境Docker镜像文档

镜像概述和主要用途

概述

本Docker镜像为GlusterD-2.0（GD2）开发提供完整的构建和运行环境，包含GD2开发过程中所需的全部依赖、工具链及运行时组件。

主要用途

• 支持GD2源码的本地构建与调试
• 提供标准化的GD2开发环境，确保开发一致性
• 集成于GD2项目仓库根目录的Vagrantfile中，用于自动化搭建开发环境

核心功能和特性

• 完整开发依赖：预配置GD2构建所需的编译器、库文件及工具链
• 即开即用：无需手动安装依赖，拉取或构建后可直接用于GD2开发
• 环境一致性：统一团队开发环境，避免"本地可运行，其他环境不可用"问题
• 兼容性：支持与Vagrant等工具集成，实现开发环境自动化部署

使用场景和适用范围

适用场景

• GD2开发者本地开发环境搭建
• 自动化测试环境部署
• 团队协作时的标准化开发环境配置

适用范围

• GD2（GlusterD-2.0）源码开发人员
• 需要快速搭建GD2开发环境的场景
• 基于Vagrant的自动化开发环境配置

详细使用方法和配置说明

镜像获取

从Docker Hub拉取

bash
docker pull gluster/glusterd2-dev:latest

本地构建

若需基于源码构建本地镜像，执行以下命令（需在包含Dockerfile的目录中运行）：

bash
docker build -t gluster/glusterd2-dev:latest .

运行容器

作为开发环境，通常需挂载本地GD2源码目录至容器内，以便实时修改和调试。示例命令：

bash
# 假设本地GD2源码路径为/path/to/gd2/source
docker run -it --name gd2-dev-env \
  -v /path/to/gd2/source:/root/gd2 \  # 挂载本地源码目录
  --privileged \  # 可选，如需使用系统级功能（如挂载文件系统）
  gluster/glusterd2-dev:latest \
  /bin/bash

进入容器后，即可在/root/gd2目录下进行GD2源码的构建和运行：

bash
cd /root/gd2
make  # 构建GD2
./glusterd2  # 运行GD2服务

与Vagrant集成

该镜像已集成于GD2项目仓库根目录的Vagrantfile中，通过Vagrant启动时会自动拉取并配置此镜像，简化开发环境搭建流程：

bash
# 克隆GD2仓库后，在仓库根目录执行
vagrant up

配置说明

当前镜像未定义额外环境变量或配置参数，开发者可根据需求通过以下方式自定义：

• 挂载目录：通过-v参数挂载本地配置文件、日志目录等
• 环境变量：通过-e参数传递自定义环境变量（如DEBUG=1开启调试模式）
• 命令覆盖：在docker run命令末尾指定自定义启动命令

历史信息

本镜像最初开发于kshlm/glusterd2-dev-docker仓库，原Docker Hub镜像名为kshlm/glusterd2-dev。后迁移至***维护，当前镜像名为gluster/glusterd2-dev。