idalko/atlassian-jira-servicedesk

Atlassian JIRA Service Desk 镜像

概述和主要用途

本镜像用于运行Atlassian JIRA Service Desk，基于https://hub.docker.com/r/anapsix/alpine-java/%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%97%A8%E5%9C%A8%E6%8F%90%E4%BE%9B%E5%B0%BD%E5%8F%AF%E8%83%BD%E5%B0%8F%E7%9A%84%E9%95%9C%E5%83%8F%E4%BD%93%E7%A7%AF%EF%BC%8C%E4%BE%BF%E4%BA%8E%E5%BF%AB%E9%80%9F%E9%83%A8%E7%BD%B2%E5%92%8C%E8%BF%90%E8%A1%8CJIRA%E6%9C%8D%E5%8A%A1%E5%8F%B0%E5%BA%94%E7%94%A8%E3%80%82

核心功能和特性

• 轻量级基础：基于alpine-java，镜像体积小，资源占用低
• 自动更新：Atlassian官网发布新版本后自动生成镜像（可能存在不稳定风险，建议先在staging环境测试）
• 灵活配置：支持多种环境变量，可配置运行用户、代理设置、JVM参数等
• 证书管理：自动导入指定目录下的自签名证书，简化HTTPS配置
• 数据持久化：支持挂载外部卷存储应用数据，确保数据持久化

版本标签

提供多种版本标签：latest（最新版）、最新主版本、最新次版本及具体版本号。例如，如需运行最新3.8版本，可使用标签idalko/atlassian-jira-servicedesk:3.8。

镜像生成

镜像通过脚本自动生成，当Atlassian官网发布新版本时触发。生成脚本位于https://github.com/draca-be/atlassian-generator%E4%BB%93%E5%BA%93%EF%BC%8C%E6%AC%A2%E8%BF%8E%E6%8F%90%E4%BA%A4%E6%8B%89%E5%8F%96%E8%AF%B7%E6%B1%82%E6%94%B9%E8%BF%9B%E8%84%9A%E6%9C%AC%E6%88%96Dockerfile%E6%A8%A1%E6%9D%BF%E3%80%82

环境变量

以非root用户运行

默认以非root用户运行应用，可通过以下变量指定用户和组（注意容器内用户名需存在，修改时可能导致意外结果）：

• RUN_USER：运行用户
• RUN_GROUP：运行组

注意：修改用户名时，Java要求该用户的HOME目录存在，本镜像会自动将数据文件夹设为家目录。

运行在代理后

若应用运行在反向代理后，需设置以下变量以确保请求重定向正确：

• JIRA_PROXY_NAME：主机名（例如 jira.mycompany.com）
• JIRA_PROXY_PORT：端口（例如 80 或 443）
• JIRA_PROXY_SCHEME：协议（http 或 https）
• JIRA_CONTEXT_PATH：上下文路径（如应用部署在非根路径，例如设为 jira 对应 mycompany.com/jira）

禁用邮件通知

如需在staging服务器等环境禁用入站和出站邮件，设置：

• DISABLE_NOTIFICATIONS=TRUE

JVM内存配置

修改默认JVM内存大小：

• JVM_MINIMUM_MEMORY：最小内存
• JVM_MAXIMUM_MEMORY：最大内存

额外JVM参数

通过JIRA_ARGS变量传递额外JVM参数，例如：JIRA_ARGS=-Datlassian.plugins.enable.wait=300

时区设置

设置容器默认时区，Jira会继承系统默认时区：

• CONTAINER_TZ：时区（例如 Asia/Shanghai）

访问日志

默认禁用Tomcat访问日志（避免容器日志过大），如需启用：

• KEEP_ACCESS_LOGS=TRUE，建议同时挂载日志卷到/opt/atlassian/jira/install/logs

自签名证书

镜像会自动导入/opt/atlassian/jira/certs目录下所有.crt文件到密钥库。获取证书的示例命令：

bash
openssl s_client -connect google.com:443 < /dev/null | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > google-public.crt

将生成的证书文件放入挂载到/opt/atlassian/jira/certs的卷中即可自动导入。

数据卷

为将数据存储在容器外部，需将卷挂载到：

• /opt/atlassian/jira/data：应用数据目录

使用方法

快速启动

bash
docker run -it --rm -p 8080:8080 idalko/atlassian-jira-servicedesk

Docker Compose配置示例

yaml
version: '3'
services:
  jira:
    image: idalko/atlassian-jira-servicedesk
    environment:
      - DISABLE_NOTIFICATIONS=TRUE  # 禁用邮件通知
      - JIRA_ARGS=-Datlassian.plugins.enable.wait=300  # 额外JVM参数
    volumes:
      - ./data:/opt/atlassian/jira/data  # 挂载数据卷
    ports:
      - 8080:8080  # 端口映射
    restart: always  # 自动重启

  jiradb:
    image: postgres:9.6  # PostgreSQL数据库
    environment:
      - POSTGRES_PASSWORD=secret  # 数据库密码
      - POSTGRES_USER=jira  # 数据库用户
      - POSTGRES_DB=jira  # 数据库名
    volumes:
      - ./db:/var/lib/postgresql/data  # 数据库数据卷
    restart: always

免责声明

创建这些镜像时已尽力确保质量，但运行风险由用户自行承担，数据丢失不承担责任。使用本镜像即表示您同意遵守所有包含的第三方软件的许可协议。