powsybl/java

镜像概述

该镜像为基于Java的基础镜像，旨在简化基于Powsybl框架的电力系统分析Java应用的部署与运行流程。镜像中预配置了powsybl用户及用户组，默认以非root用户身份运行，既满足Powsybl应用的运行环境需求，又通过权限隔离提升容器运行安全性，减少直接使用root用户带来的风险。

核心功能与特性

• 稳定Java环境：基于官方Java基础镜像构建，提供指定版本的Java运行时环境（JRE/JDK），确保Powsybl应用的兼容性。
• 预配置powsybl用户：内置powsybl用户及同名用户组，具备合理的文件系统权限，支持直接以该用户身份运行应用，无需手动创建用户。
• 安全运行模式：默认禁用root用户直接登录，强制通过powsybl用户运行应用，符合容器安全最佳实践。
• Powsybl框架适配：用户环境变量、目录权限等配置与Powsybl应用运行需求兼容，减少部署时的环境调优步骤。

使用场景与适用范围

• 电力系统分析应用部署：适用于基于Powsybl框架开发的潮流计算、短路电流分析、暂态稳定仿真等电力系统分析工具的容器化部署。
• 开发与测试环境：作为开发或测试环境基础镜像，提供一致的运行环境，避免因本地环境差异导致的应用运行问题。
• CI/CD流水线集成：可集成至持续集成/持续部署流程，用于自动化测试或构建基于Powsybl的应用镜像。

使用方法与配置说明

基本运行命令

通过docker run命令启动容器，默认以powsybl用户身份运行：

bash
docker run --rm -it [镜像名称]:[标签] /bin/bash

进入容器后，可通过whoami命令验证当前用户为powsybl。

运行Powsybl应用示例

将本地Powsybl应用JAR包挂载至容器并运行：

bash
# 假设本地应用JAR路径为./app/powsybl-app.jar，挂载至容器的/app目录
docker run --rm -v $(pwd)/app:/app -w /app [镜像名称]:[标签] java -jar powsybl-app.jar

自定义用户权限（可选）

如需调整powsybl用户的UID/GID（例如匹配宿主机文件权限），可在构建镜像时通过--build-arg参数指定（需基础镜像支持）：

bash
docker build --build-arg POWSYBL_UID=1001 --build-arg POWSYBL_GID=1001 -t [自定义镜像名] .

环境变量配置

支持通过-e参数传递环境变量，用于调整Java运行参数或应用配置：

bash
# 设置Java堆内存大小并运行应用
docker run --rm -e JAVA_OPTS="-Xmx1g" -v $(pwd)/app:/app -w /app [镜像名称]:[标签] java $JAVA_OPTS -jar powsybl-app.jar

注意事项

• 该镜像为基础镜像，不含Powsybl框架本身，需用户自行将Powsybl依赖包或应用JAR包挂载至容器或集成到基于此镜像的自定义镜像中。
• 挂载宿主机目录时，需确保宿主机目录对powsybl用户（UID/GID）有读写权限，避免因权限不足导致应用运行失败。
• 如需使用JDK进行应用编译，建议选择基于JDK的镜像标签（如有提供），或在该镜像基础上安装JDK组件。