danysk/kotlin

Kotlin-JDK 镜像文档

镜像概述与主要用途

本镜像提供轻量级且持续更新的Kotlin和JDK集成环境，通过完全自动化构建流程确保Kotlin和JDK版本始终保持最新。其核心目标是简化Kotlin脚本（.kts）的开发、测试与运行过程，为用户提供即开即用的标准化环境，无需手动配置Kotlin编译器和JDK依赖。

核心功能与特性

• 轻量级设计：基于精简基础镜像（如Alpine Linux）构建，显著减少镜像体积，降低存储和网络传输成本。
• 版本自动更新：通过自动化构建 pipeline 实时追踪Kotlin和JDK官方发布版本，确保镜像包含最新稳定版运行时。
• 完全自动化构建：构建流程全程自动化，消除人工干预导致的版本不一致问题，保障环境一致性和可靠性。
• 原生支持Kotlin脚本：内置Kotlin脚本执行环境，可直接运行 .kts 文件，无需额外配置编译器路径或依赖。

使用场景与适用范围

• Kotlin脚本开发与测试：快速搭建本地开发环境，验证 .kts 脚本逻辑，支持即时运行和调试。
• CI/CD流程集成：作为自动化流水线中的执行环境，运行Kotlin脚本实现构建、部署、数据处理等任务。
• 自动化任务执行：用于定时任务、数据清洗、日志分析等场景，通过Kotlin脚本实现业务逻辑，利用镜像隔离环境依赖。
• 学习与教学环境：为Kotlin初学者提供零配置的运行环境，专注于语法学习而非环境搭建。

使用方法

1. 拉取镜像

通过Docker Hub或私有仓库拉取镜像，默认标签为 latest（最新稳定版）：

bash
docker pull [镜像仓库地址]/kotlin-jdk:latest

如需指定版本，可使用标签格式 kotlin-<KOTLIN_VERSION>-jdk<JDK_VERSION>，例如：

bash
docker pull [镜像仓库地址]/kotlin-jdk:kotlin-1.9.20-jdk17

2. 基本运行命令

运行Kotlin脚本文件

将本地 .kts 文件挂载至容器并执行：

bash
docker run --rm -v $(pwd)/script.kts:/app/script.kts [镜像仓库地址]/kotlin-jdk:latest kotlin /app/script.kts

• --rm：脚本执行完成后自动删除容器，避免残留。
• -v $(pwd)/script.kts:/app/script.kts：将当前目录下的 script.kts 文件挂载到容器内 /app 目录。
• kotlin /app/script.kts：调用容器内的Kotlin解释器执行挂载的脚本。

交互式运行环境

启动交互式Shell，手动输入和执行Kotlin代码：

bash
docker run -it --rm [镜像仓库地址]/kotlin-jdk:latest kotlin -i

• -it：分配交互式终端，支持输入输出交互。
• -i：启动Kotlin交互式解释器（REPL）。

3. 示例：执行简单Kotlin脚本

1. 创建本地脚本文件 hello.kts：

kotlin
println("Hello, Kotlin Script!")
val sum = 1 + 2
println("1 + 2 = $sum")

2. 通过镜像运行脚本：

bash
docker run --rm -v $(pwd)/hello.kts:/app/hello.kts [镜像仓库地址]/kotlin-jdk:latest kotlin /app/hello.kts

预期输出：

Hello, Kotlin Script!
1 + 2 = 3

配置参数说明

镜像标签格式

镜像通过标签区分Kotlin和JDK版本，格式为：

• latest：默认标签，指向最新稳定版Kotlin和对应兼容JDK版本。
• kotlin-<KOTLIN_VERSION>-jdk<JDK_VERSION>：指定Kotlin版本和JDK版本，例如 kotlin-1.9.20-jdk17 表示Kotlin 1.9.20 + JDK 17。

环境变量（可选）

如需自定义运行时行为，可通过 -e 参数传递环境变量：

• KOTLIN_OPTS：设置Kotlin编译器/解释器参数，例如 -J-Xmx512m（指定JVM最大堆内存）。

  bash
  docker run --rm -e KOTLIN_OPTS="-J-Xmx512m" -v $(pwd)/script.kts:/app/script.kts [镜像仓库地址]/kotlin-jdk:latest kotlin /app/script.kts
  

注意事项

• 脚本文件权限：挂载本地脚本时，确保文件具有可读权限，避免容器内因权限不足无法访问。
• JDK版本兼容性：Kotlin版本与JDK版本需匹配（参考Kotlin官方兼容性文档），建议通过版本标签明确指定兼容组合。
• 持久化数据：如需保存脚本输出或中间文件，可通过 -v 参数挂载数据卷或本地目录。