placeos/crystal

镜像概述

Crystal编译器的Docker镜像，基于Alpine Linux构建，包含release版本编译器、解释器及静态构建工具链。旨在提供轻量级、高效的Crystal语言开发和运行环境，支持从源码编译到静态二进制生成的全流程。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小（通常<100MB），启动快速，适合资源受限环境
• 完整工具链：包含Crystal release版本编译器、解释器（支持交互式执行）及标准库
• 静态构建支持：内置静态链接工具链，可直接编译生成独立静态二进制文件（无系统依赖）
• 版本稳定性：采用官方release版本编译器，确保编译结果的兼容性和稳定性
• 多场景适配：支持交互式开发、批量编译及CI/CD流程集成

使用场景

• 本地开发环境：快速搭建隔离的Crystal开发环境，无需在主机安装依赖
• 静态二进制构建：生成可在任意Linux系统运行的静态二进制文件，简化部署流程
• CI/CD集成：作为自动化流程中的编译节点，完成源码检查、测试和构建
• 教学演示：提供一致的Crystal运行环境，用于语言学习或示例展示

使用方法

基本交互式使用

启动容器并进入交互式终端，直接使用crystal命令：

bash
docker run --rm -it docker.xuanyuan.run/crystal-alpine sh
# 在容器内执行Crystal代码
crystal eval 'puts "Hello, Crystal!"'

编译本地源码

挂载本地源码目录并编译：

bash
# 将当前目录作为工作区挂载到容器/app目录
docker run --rm -v $(pwd):/app -w /app docker.xuanyuan.run/crystal-alpine crystal build main.cr -o myapp

静态二进制构建示例

生成无依赖的静态二进制文件：

bash
# 使用--static标志启用静态链接
docker run --rm -v $(pwd):/app -w /app docker.xuanyuan.run/crystal-alpine crystal build main.cr -o myapp --static
# 生成的myapp可直接在任意Linux系统运行

docker-compose配置示例

创建docker-compose.yml配置开发环境：

yaml
version: '3'
services:
  crystal-builder:
    image: docker.xuanyuan.run/crystal-alpine
    volumes:
      - ./src:/app
    working_dir: /app
    command: sh -c "crystal build main.cr -o app --static && ./app"

注意事项

• 静态构建需确保项目无动态依赖（如特定系统库），建议优先使用纯Crystal标准库
• 挂载本地目录时可添加--user $(id -u):$(id -g)参数避免权限冲突：

  bash
  docker run --rm -u $(id -u):$(id -g) -v $(pwd):/app -w /app docker.xuanyuan.run/crystal-alpine crystal build main.cr
  

• 如需扩展工具链，可基于此镜像构建自定义Dockerfile：

  dockerfile
  FROM crystal-alpine
  RUN apk add --no-cache some-dependency