Groovy Docker 镜像文档

镜像概述

本镜像为 Apache Groovy 官方 Docker 镜像的 amd64 架构版本，基于 Java 平台提供 Apache Groovy 运行环境。Apache Groovy 是一种功能强大的多范式语言，支持动态类型与静态类型、静态编译，旨在通过简洁、熟悉且易于学***的语法提升开发者 productivity。该镜像可用于 Groovy 脚本执行、应用开发及运行环境搭建。

• 维护者：Apache Groovy 项目
• 支持架构：amd64、arm32v7、arm64v8、ppc64le、riscv64、s390x（更多架构信息）

核心功能与特性

• 多范式编程支持：融合面向对象、函数式编程特性，支持动态类型与静态类型。
• Java 无缝集成：可直接调用 Java 类库，与现有 Java 程序平滑协作。
• 脚本能力：提供强大的脚本编写与执行环境，支持快速原型开发。
• DSL 开发：便于创建领域特定语言（Domain-Specific Language）。
• 元编程支持：提供运行时与编译时元编程能力，增强代码灵活性。
• 跨版本兼容：支持多种 JDK 版本（JDK 8/11/17/21）及基础系统（Ubuntu、Alpine）。

支持的标签及 Dockerfile 链接

核心功能与特性

• 多范式支持：融合面向对象编程与函数式编程特性，支持动态类型与静态类型。
• Java 无缝集成：可直接调用 Java 类库、框架及工具，现有 Java 程序可平滑迁移。
• 脚本能力：提供交互式 shell（Groovysh），支持快速脚本编写与执行。
• DSL 开发：简化领域特定语言（DSL）创建，适用于配置文件、测试脚本等场景。
• 元编程：支持运行时与编译时元编程，增强代码灵活性与可扩展性。
• 静态编译：可通过静态编译生成 Java 字节码，提升性能并支持类型检查。

使用场景

• Groovy 脚本执行：快速运行 Groovy 脚本文件，适用于自动化任务、数据处理等。
• 交互式开发：通过 Groovysh 进行代码调试与原型验证。
• 应用部署：作为 Groovy 应用的基础运行环境，部署至容器化平台。
• CI/CD 集成：在 CI/CD 流程中集成 Groovy 脚本执行步骤。
• 轻量级开发环境：快速搭建隔离的 Groovy 开发环境，避免系统依赖冲突。

使用方法

注意事项

若挂载卷时运行 Docker 的用户 UID 非 1000，需以 root 用户身份运行容器（添加 -u root 参数）。

启动 Groovysh 交互式 shell

通过以下命令启动 Groovysh，进入交互式 Groovy 环境：

docker run -it --rm groovy

运行 Groovy 脚本

将本地脚本目录挂载至容器，执行指定 Groovy 脚本：

docker run --rm -v "$PWD":/home/groovy/scripts -w /home/groovy/scripts amd64/groovy groovy <脚本文件名> <脚本参数>

• -v "$PWD":/home/groovy/scripts：挂载当前目录至容器内 /home/groovy/scripts
• -w /home/groovy/scripts：设置工作目录为挂载目录
• <脚本文件名>：需执行的 Groovy 脚本（如 test.groovy）
• <脚本参数>：传递给脚本的参数（可选）

重用 Grapes 缓存

Grapes 是 Groovy 的依赖管理工具，可通过创建卷并挂载至 /home/groovy/.groovy/grapes 实现缓存重用：

# 创建缓存卷
docker volume create --name grapes-cache

# 挂载缓存卷运行容器
docker run --rm -it -v grapes-cache:/home/groovy/.groovy/grapes amd64/groovy

镜像变体

amd64/groovy:<version>（默认变体）

基于 Ubuntu 系统（标签中含 noble/jammy 等 Ubuntu 版本代号），为默认推荐变体。适用于大多数场景，可直接作为临时容器（挂载源码运行）或基础镜像构建其他镜像。

• 特点：包含 Ubuntu 系统基础依赖，兼容性好，支持额外工具安装（如 git、bash）。
• 适用场景：生产环境部署、需要系统工具的开发环境。

amd64/groovy:<version>-alpine（Alpine 变体）

基于 Alpine Linux，镜像体积显著减小（约 5MB 基础镜像），适用于对镜像大小敏感的场景。

• 特点：体积小、启动快；使用 musl libc 替代 glibc，部分依赖 glibc 的软件可能存在兼容性问题。
• 注意事项：默认不含额外工具（如 git、bash），需在 Dockerfile 中手动安装。
• 适用场景：资源受限环境、轻量级部署、CI/CD 临时任务。

支持与维护

• 提交 Issue：[***]
• 获取帮助：Docker Community Slack、Server Fault、Unix & Linux、Stack Overflow
• 镜像更新：通过 official-images repo 的 library/groovy 标签 跟踪更新
• 镜像元数据：repo-info 仓库 repos/groovy/ 目录（包含镜像元数据、传输大小等）

许可证

镜像中包含的 Apache Groovy 软件遵循 Apache 许可证 2.0。
镜像可能包含其他软件（如基础系统的 Bash 等），其许可证需由用户自行确认合规性。
更多许可证信息可参考 repo-info 仓库 groovy/ 目录。

用户责任：使用前需确保符合所有包含软件的许可证要求。