jordan/rundeck

Rundeck Docker镜像

最新版本的README可查看：https://github.com/jjethwa/rundeck/blob/master/README.md

本仓库包含Rundeck [***]

镜像概述

Rundeck Docker镜像基于debian:bullseye构建，集成了Supervisor、MariaDB和Rundeck服务，适用于快速部署和运行Rundeck自动化作业平台。

核心功能与特性

1. 基于debian:bullseye操作系统
2. 内置Supervisor、MariaDB数据库和Rundeck服务
3. 容器启动时间根据资源情况需30秒至几分钟不等
4. 无SSH服务，需使用docker exec或https://github.com/jpetazzo/nsenter%E8%BF%9B%E8%A1%8C%E5%AE%B9%E5%99%A8%E5%86%85%E6%93%8D%E4%BD%9C
5. 若未提供RUNDECK_PASSWORD，将随机生成并通过标准输出显示
6. 需提供EXTERNAL_SERVER_URL，默认值为https://0.0.0.0:4443
7. 建议更新预装账户的默认密码
8. 从Rundeck下载URL构建镜像时可能出现"connection reset by peer"错误，重试通常可解决

自动构建

bash
docker pull jordan/rundeck

使用方法

基本启动

启动新容器并绑定主机4440端口：

bash
sudo docker run -p 4440:4440 -e EXTERNAL_SERVER_URL=http://MY.HOSTNAME.COM:4440 --name rundeck -t jordan/rundeck:latest

SSL配置

启动容器并绑定主机4443端口以启用SSL。注意：生产环境需更新/etc/rundeck/ssl/keystore和/etc/rundeck/ssl/truststore，默认证书为自签名。设置KEYSTORE_PASS和TRUSTSTORE_PASS为密钥库密码，可通过卷挂载这两个文件：

bash
sudo docker run -p 4443:4443 -e EXTERNAL_SERVER_URL=https://MY.HOSTNAME.COM:4443 -e RUNDECK_WITH_SSL=true --name rundeck -t jordan/rundeck:latest

Rundeck插件

添加外部插件时，将JAR文件放入/opt/rundeck-plugins卷，容器启动时会自动复制到Rundeck的libext目录。

Docker密钥

参考：[***]

入口点运行脚本会检查以下Docker密钥：RUNDECK_ADMIN_PASSWORD、RUNDECK_PASSWORD、DATABASE_ADMIN_PASSWORD、KEYSTORE_PASS和TRUSTSTORE_PASS。优先级为：密钥 > 环境变量 > 随机生成值。

环境变量

SERVER_URL (已弃用 - 使用EXTERNAL_SERVER_URL) - 完整URL格式，如http://MY.HOSTNAME.COM:4440、http://123.456.789.012:4440等

EXTERNAL_SERVER_URL - 当Rundeck运行在代理后时使用，适用于通过外部网关/负载均衡器访问的场景。注意：rd-jobs和rd-projects等工具将无法使用，需使用新版[rd](https://github.com/rundeck/rundeck-cli)命令行工具。

RDECK_JVM_SETTINGS - 传递给Rundeck JVM的额外参数（例如：-Xmx1024m -Xms256m -XX:MaxMetaspaceSize=256m -server -Dfile.encoding=UTF-8 -Dserver.web.context=/rundeck）

DATABASE_DRIVER - 当使用MySQL/MariaDB或Postgres以外的数据库时，指定数据库驱动类名

DATABASE_URL - 用于外部数据库（例如：jdbc:mysql://<HOSTNAME>:<PORT>/rundeckdb）

RUNDECK_UID - Rundeck启动时使用的Unix用户ID，适用于通过卷共享文件时的权限配置，需同时定义RUNDECK_GID。

RUNDECK_GID - Rundeck启动时使用的Unix组ID，适用于通过卷共享文件时的权限配置，需同时定义RUNDECK_UID。

RUNDECK_WITH_SSL - 启用SSL

RUNDECK_USER - MySQL中'rundeck'用户的用户名

RUNDECK_PASSWORD - MySQL中'rundeck'用户的密码

RUNDECK_ADMIN_PASSWORD - Rundeck服务器管理员密码

RUNDECK_SERVER_UUID - 服务器UUID（在framework.properties中设置）

RUNDECK_STORAGE_PASSWORD - 用于项目和密钥加密的密码（在rundeck-config.properties中设置）

RUNDECK_STORAGE_PROVIDER - 存储提供器选项：db（默认）或file。注意：file存储可能在未来版本中弃用

RUNDECK_THREAD_COUNT - 并发执行作业的线程数，详见：http://www.quartz-scheduler.org/documentation/quartz-2.x/configuration/ConfigThreadPool.html

GUI_BRAND_HTML - 应用头部标题HTML，详见：https://rundeck.org/docs/administration/configuration/gui-customization.html。多环境部署时可用于标识环境，例如：GUI_BRAND_HTML='<span class="title">QA环境</span>'

SMTP_HOST - 邮件通知使用的SMTP服务器主机

SMTP_PORT - 邮件通知使用的SMTP服务器端口

SMTP_USERNAME - SMTP认证用户名（如需）

SMTP_PASSWORD - SMTP认证密码（如需）

SMTP_DEFAULT_FROM - 邮件通知的发件人地址

DEBIAN_SYS_MAINT_PASSWORD - Debian Stretch及以上版本不再使用

NO_LOCAL_MYSQL - 默认false。设置为true以使用外部MySQL容器或实例，需同时设置DATABASE_URL和RUNDECK_PASSWORD（用于JDBC连接）。数据库设置详情：http://rundeck.org/docs/administration/setting-up-an-rdb-datasource.html

LOGIN_MODULE - 登录模块：RDpropertyfilelogin（默认）或ldap，详见：http://rundeck.org/docs/administration/authenticating-users.html

JAAS_CONF_FILE - 若使用ldap，指定ldap配置文件名，需将文件挂载到/etc/rundeck/<文件名>，详见：http://rundeck.org/docs/administration/authenticating-users.html

SKIP_DATABASE_SETUP - 设置为true以跳过数据库设置（适用于数据库已配置或未知管理员密码的情况）

卷

/etc/rundeck - Rundeck配置目录

/etc/locale.gen - 语言环境生成文件，列出的语言环境将被生成

/var/rundeck - Rundeck数据目录

/var/lib/rundeck - 不建议作为卷使用（包含webapp），SSH密钥可使用子目录/var/lib/rundeck/.ssh

/var/lib/mysql - MySQL数据目录

/var/log/rundeck - Rundeck日志目录

/opt/rundeck-plugins - 用于添加外部插件

/var/lib/rundeck/logs - Rundeck日志存储

/var/lib/rundeck/var/storage - 存储数据

/var/lib/rundeck/projects - 项目数据

Web代理后使用

若在Web代理后运行Rundeck，使用以下命令：

bash
sudo docker run -p 4440:4440 \
  -e EXTERNAL_SERVER_URL=http://MY.HOSTNAME.COM:4440 \
  -e HTTP_PROXY="http://WEBPROXY:PORT" \
  -e HTTPS_PROXY="http://WEBPROXY:PORT" \
  -e RDECK_JVM_SETTINGS="-Djava.net.useSystemProxies=true" \
  --name rundeck -t jordan/rundeck:latest

外部数据库实例

容器默认启动内置MySQL/MariaDB实例，用于密钥存储和项目定义存储。如需使用外部数据库，配置如下：

选项1：首次设置外部数据库

• 在外部数据库中创建用户'rundeck'
• 设置以下环境变量：

NO_LOCAL_MYSQL=true
RUNDECK_STORAGE_PASSWORD=<存储密码>
DATABASE_URL=<MySQL或Postgres的JDBC URL>
DATABASE_ADMIN_USER=<数据库管理员用户>
DATABASE_ADMIN_PASSWORD=<数据库管理员密码>
RUNDECK_PASSWORD=<rundeck数据库用户密码>

选项2：外部数据库已配置

除选项1的环境变量外，额外设置：

SKIP_DATABASE_SETUP=true

跨重启保留SCM设置

若SCM设置在重启后丢失（详见：https://github.com/rundeck/rundeck/issues/6646 和 https://github.com/rundeck/rundeck/issues/6651%EF%BC%89%EF%BC%8C%E9%80%9A%E8%BF%87%60RUNDECK_SERVER_UUID%60%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E5%9C%A8framework.properties%E4%B8%AD%E8%AE%BE%E7%BD%AE%60rundeck.server.uuid%60%E3%80%82%E5%8F%AF%E4%BB%8E%E7%B3%BB%E7%BB%9F%E6%8A%A5%E5%91%8A%E9%A1%B5%E9%9D%A2%E8%8E%B7%E5%8F%96%E6%9C%8D%E5%8A%A1%E5%99%A8UUID%EF%BC%9A

rundeck.server.uuid = <当前Rundeck UUID>

SSL终止代理

详见：[***]

升级

详见：[***]

默认凭据

admin/admin