crystallang/crystal

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支持可参考https://hub.docker.com/r/84codes/crystal%E4%BB%93%E5%BA%93%E3%80%82

详细使用方法和配置说明

镜像标签选择

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

• 生产环境建议使用特定版本标签（如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源代码仓库的https://github.com/crystal-lang/crystal/blob/master/CONTRIBUTING.md%E3%80%82

镜像构建说明

本镜像基于https://github.com/crystal-lang/distribution-scripts/tree/master/docker%E4%BB%93%E5%BA%93%E4%B8%AD%E7%9A%84%E8%84%9A%E6%9C%AC%E6%9E%84%E5%BB%BA%EF%BC%8C%E7%A1%AE%E4%BF%9D%E6%9E%84%E5%BB%BA%E8%BF%87%E7%A8%8B%E7%9A%84%E9%80%8F%E6%98%8E%E6%80%A7%E5%92%8C%E5%8F%AF%E9%87%8D%E5%A4%8D%E6%80%A7%E3%80%82