Crystal Docker镜像文档

镜像概述和主要用途

Crystal是一种通用目的、面向对象的编程语言，其语法受Ruby启发，同时具备编译型语言的性能和静态类型检查的安全性。本Docker镜像提供了Crystal编译器、依赖管理工具shards及标准库所需的各类库，方便开发者快速搭建Crystal开发和运行环境。

核心功能和特性

基础镜像类型

• Ubuntu基础镜像：标签格式为nightly、x、x.y、x.y.z（如1、1.10、1.10.1），基于Ubuntu系统构建。
• Alpine Linux基础镜像：标签格式为nightly-alpine、x-alpine、x.y-alpine、x.y.z-alpine（如1-alpine、1.10-alpine），基于轻量级Alpine Linux构建。

特殊标签说明

• nightly标签：每日从Crystal的master分支构建，包含最新开发特性。
• -build后缀：额外包含LLVM及其他编译Crystal编译器所需的工具。
• ci-前缀或-dev后缀：用于内部开发和持续集成，非生产环境使用。

使用场景和适用范围

• 开发环境：快速搭建标准化的Crystal开发环境，支持不同版本的Crystal语言。
• 生产部署：已有多家公司成功将Crystal应用部署于生产环境（详见生产使用案例）。
• 限制说明：暂不提供ARM架构设备的Docker镜像，如需ARM支持可参考84codes/crystal仓库。

详细使用方法和配置说明

镜像标签选择

根据项目需求选择合适的标签：

• 生产环境建议使用特定版本标签（如1.10.1或1.10.1-alpine）以确保稳定性。
• 需体验最新特性可使用nightly或nightly-alpine标签。
• 如需构建Crystal编译器本身，选择带-build后缀的标签（如1.10.1-build）。

示例：拉取并运行Crystal镜像

bash
# 拉取最新稳定版Ubuntu基础镜像
docker pull crystal:latest

# 拉取Alpine基础镜像（轻量级）
docker pull crystal:latest-alpine

# 运行交互式终端，挂载当前目录作为工作区
docker run -it --rm -v $(pwd):/app -w /app crystal:latest crystal --version

项目状态

Crystal语言目前处于1.X系列，可通过Docker标签查看最新版本。项目已在生产环境得到成功应用，但暂未提供ARM架构设备的Docker镜像。

贡献指南

如需贡献代码或改进镜像，可参考Crystal源代码仓库的贡献指南。

镜像构建说明

本镜像基于distribution-scripts仓库中的脚本构建，确保构建过程的透明性和可重复性。