openiamdocker/groovy-manager

Groovy Manager Docker镜像

镜像概述

本镜像基于Docker构建，集成了Groovy管理应用（Groovy Manager Application）及运行所需的JVM环境。Groovy是一种基于JVM的敏捷开发语言，兼具Python、Ruby和Java的特性，适用于脚本编写、自动化任务及快速应用开发。本镜像旨在提供一个开箱即用的Groovy管理工具环境，简化Groovy应用的部署与运行流程。

主要用途

• 提供Groovy脚本的执行环境
• 支持自动化任务调度与管理
• 集成基础的Groovy应用生命周期管理功能
• 作为轻量级JVM应用管理工具的部署载体

核心功能和特性

功能亮点

• Groovy环境集成：内置Groovy运行时及标准库，支持直接执行.groovy脚本
• 任务调度机制：内置轻量级任务调度器，支持定时执行Groovy脚本
• 日志管理：提供标准化日志输出，支持日志级别配置
• 文件系统集成：支持外部脚本文件挂载与执行
• JVM参数自定义：允许通过环境变量调整JVM运行参数（如内存配置）

技术特性

• 基于Alpine Linux构建，镜像体积小
• 内置OpenJDK（版本默认11，可通过标签指定其他版本）
• 支持多平台架构（amd64/arm64）
• 非root用户运行，安全性增强

使用场景和适用范围

目标用户

• 开发人员：需要快速测试Groovy脚本的环境
• 运维工程师：自动化服务器管理任务（如日志清理、服务监控）
• CI/CD流程：作为流水线中的任务执行节点（如数据处理、报告生成）
• 系统管理员：轻量级JVM应用的部署与管理

典型场景

• 开发环境中的Groovy脚本自动化测试
• 定时执行数据备份、日志分析等运维脚本
• CI/CD pipeline中集成Groovy编写的构建或部署逻辑
• 边缘设备上的轻量级JVM应用部署

使用方法和配置说明

获取镜像

默认从Docker Hub拉取最新版本：

bash
docker pull groovy-manager:latest

如需指定版本（如JDK 17）：

bash
docker pull groovy-manager:jdk17

基本运行命令

启动容器并进入交互式终端（默认执行groovy -v显示版本信息）：

bash
docker run -it --rm groovy-manager:latest

环境变量配置

容器支持通过环境变量自定义行为，常用变量如下：

卷挂载

为持久化数据或执行自定义脚本，建议挂载以下目录：

示例

docker run示例

1. 执行自定义脚本（挂载宿主机脚本目录）：

bash
docker run -d \
  --name groovy-task \
  -e GROOVY_SCRIPT_PATH="/app/scripts/backup.groovy" \
  -e SCHEDULE_INTERVAL="300" \
  -v /host/scripts:/app/scripts \
  -v /host/logs:/app/logs \
  groovy-manager:latest

2. 调整JVM参数（增加内存限制）：

bash
docker run -it --rm \
  -e JVM_OPTS="-Xms1g -Xmx2g" \
  groovy-manager:latest

docker-compose示例

创建docker-compose.yml：

yaml
version: '3.8'
services:
  groovy-manager:
    image: groovy-manager:latest
    container_name: groovy-manager
    restart: unless-stopped
    environment:
      - GROOVY_SCRIPT_PATH=/app/scripts/main.groovy
      - LOG_LEVEL=DEBUG
      - SCHEDULE_INTERVAL=600
      - JVM_OPTS=-Xms512m -Xmx1g
    volumes:
      - ./scripts:/app/scripts:ro  # 只读挂载脚本目录
      - ./logs:/app/logs:rw        # 读写挂载日志目录
    networks:
      - groovy-net

networks:
  groovy-net:
    driver: bridge

启动服务：

bash
docker-compose up -d

注意事项

1. 脚本权限：挂载的宿主机脚本文件需确保容器内用户（默认groovy，UID 1000）有读取权限
2. JVM版本兼容性：使用特定JDK版本时，需确保Groovy脚本兼容对应Java版本
3. 资源限制：根据脚本复杂度调整JVM内存参数（JVM_OPTS），避免OOM错误
4. 持久化数据：日志和配置文件建议通过卷挂载持久化，避免容器重启后数据丢失