Hacksawgaming 构建镜像

镜像概述

Hacksawgaming构建镜像是官方提供的集成开发工具镜像，整合了Haxe、Node.js、NPM、JDK、Yarn和Git等核心开发与构建工具。该镜像旨在为Hacksawgaming相关项目提供标准化、一致性的构建环境，简化多工具依赖项目的构建流程，确保开发、测试与部署环境的统一。

核心功能与特性

• 多工具集成：包含Haxe（编程语言）、Node.js（JavaScript运行时）、NPM（Node包管理器）、JDK（Java开发工具包）、Yarn（包管理器）及Git（版本控制工具），满足多语言项目构建需求
• 环境一致性：标准化工具版本与配置，避免因本地环境差异导致的"在我电脑上能运行"问题
• 容器化部署：支持Docker容器化运行，可快速集成到本地开发或CI/CD流水线中
• 即开即用：无需手动安装配置各工具，拉取镜像后即可直接使用

使用场景与适用范围

• Hacksawgaming内部及合作项目的构建过程
• 持续集成/持续部署（CI/CD）流程中的自动化构建阶段
• 需要同时使用Haxe、JavaScript/TypeScript、Java等多语言开发的项目
• 团队协作中统一开发、构建工具版本的场景
• 临时测试或演示环境的快速搭建

使用方法与配置说明

基础交互式使用

通过以下命令启动容器并进入交互式终端，直接进行构建操作：

docker run -it --rm hacksawgaming/build-image:latest /bin/bash

参数说明：

• -it：启用交互式终端
• --rm：容器退出后自动清理，避免残留
• hacksawgaming/build-image:latest：镜像名称（请根据实际需求指定版本标签）
• /bin/bash：启动后执行的命令，进入bash终端

挂载本地项目目录

如需使用本地项目文件进行构建，通过-v参数挂载目录：

docker run -it --rm -v $(pwd):/workspace hacksawgaming/build-image:latest /bin/bash

• -v $(pwd):/workspace：将当前本地目录挂载到容器内/workspace目录，实现文件共享

Docker Compose 配置示例

创建docker-compose.yml文件，便于管理构建环境：

version: '3.8'
services:
  build-environment:
    image: hacksawgaming/build-image:latest
    volumes:
      - ./project:/workspace  # 挂载本地项目目录到容器内/workspace
      - ~/.ssh:/root/.ssh      # 可选：挂载SSH密钥，用于Git操作
    environment:
      - NODE_ENV=production    # 可选：设置环境变量
    tty: true
    stdin_open: true

启动服务：

docker-compose up -d

进入容器：

docker-compose exec build-environment /bin/bash

工具版本查看

容器内验证工具版本：

# 查看各工具版本
haxe --version
node --version
npm --version
java -version
yarn --version
git --version

注意事项

• 镜像标签：建议指定具体版本标签（如:v1.0.0）而非默认latest，确保构建环境稳定性
• 数据持久化：容器内文件默认非持久化，重要数据需通过挂载卷（volume）或绑定目录（bind mount）保存
• 权限问题：挂载本地目录时可能遇到权限问题，可通过调整本地目录权限或在容器内使用sudo（如已安装）解决