jackfirth/racket

Racket Docker镜像文档

镜像概述

本镜像为Racket编程语言提供容器化运行环境，包含完整的Racket运行时、标准库及工具链，支持在隔离容器中快速搭建Racket开发环境、运行Racket脚本、启动交互式REPL或部署Racket应用，简化环境配置流程并确保跨平台一致性。

核心功能和特性

• 完整运行时环境：包含Racket解释器、编译器及全部标准库，支持Racket语言所有核心特性
• 多版本支持：提供不同Racket版本标签（如latest、8.17、8.16等），满足版本兼容性需求
• 轻量级基础：基于Debian或Alpine等精简基础镜像，平衡功能完整性与镜像体积
• 即开即用：可直接启动交互式REPL或运行Racket脚本，无需额外配置
• 可扩展性：支持通过raco工具安装第三方包，或基于本镜像构建包含自定义依赖的镜像

使用场景

• 开发环境快速搭建：无需本地安装Racket，通过容器快速启动开发环境，避免系统环境冲突
• CI/CD集成：在自动化测试或构建流程中作为执行环境，验证Racket应用正确性
• 生产部署：作为Racket服务应用的运行容器，确保部署环境一致性
• 教学与演示：便捷展示Racket语言特性，或供学习者快速上手而不影响本地系统

使用方法和配置说明

前提条件

• 已安装Docker引擎（20.10+推荐）
• 网络环境可访问Docker Hub（获取官方镜像）

获取镜像

从Docker Hub拉取最新版本镜像：

bash
docker pull docker.xuanyuan.run/racket:latest

指定特定版本（如8.17）：

bash
docker pull docker.xuanyuan.run/racket:8.17

基础使用示例

1. 启动交互式REPL

运行临时容器并启动Racket交互式解释器：

bash
docker run -it --rm docker.xuanyuan.run/racket:latest racket

参数说明：-it 启用交互终端，--rm 容器退出后自动删除

2. 运行本地Racket脚本

挂载当前目录至容器并执行脚本（假设本地脚本为app.rkt）：

bash
docker run --rm -v $(pwd):/app docker.xuanyuan.run/racket:latest racket /app/app.rkt

参数说明：-v $(pwd):/app 将当前目录挂载到容器内/app路径，racket /app/app.rkt 执行目标脚本

3. 后台运行Racket服务

若脚本为长期运行的服务（如Web应用），可后台运行并映射端口：

bash
docker run -d --name racket-service -p 8080:8080 -v $(pwd):/app docker.xuanyuan.run/racket:latest racket /app/server.rkt

参数说明：-d 后台运行，--name 指定容器名称，-p 8080:8080 映射容器端口到主机

构建自定义镜像

如需包含项目依赖，可创建Dockerfile构建自定义镜像：

dockerfile
# 基础镜像选择指定Racket版本
FROM docker.xuanyuan.run/racket:8.17

# 设置工作目录
WORKDIR /app

# 复制项目文件
COPY . /app

# 安装依赖（如通过raco安装第三方包）
RUN raco pkg install --auto /app/deps/my-package

# 暴露服务端口
EXPOSE 8080

# 启动命令
CMD ["racket", "server.rkt"]

构建并运行自定义镜像：

bash
docker build -t my-racket-app .
docker run -p 8080:8080 docker.xuanyuan.run/my-racket-app

docker-compose配置示例

使用docker-compose.yml管理Racket服务：

yaml
version: '3'
services:
  racket-app:
    image: docker.xuanyuan.run/racket:8.17
    container_name: racket-service
    volumes:
      - ./src:/app
    ports:
      - "8080:8080"
    command: racket /app/server.rkt
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

注意事项

• 版本选择：生产环境建议使用具体版本标签（如racket:8.17）而非latest，避免版本变更导致兼容性问题
• 依赖管理：本地开发依赖建议通过raco pkg install或info.rkt声明，在容器内安装
• 数据持久化：需持久化的数据（如日志、配置文件）应通过-v挂载宿主机目录或使用Docker卷
• 资源限制：生产环境部署时建议通过--memory、--cpus限制容器资源，避免过度占用主机资源