文档教程技术博客【免费下载链接】Linux-Tutorial《Java 程序员眼中的 Linux》项目地址https://gitcode.com/gh_mirrors/li/Linux-Tutorial点击查看免费下载本文是《Java 程序员眼中的 Linux》仓库Linux-Tutorial中 Jira 安装和配置 文档的完整实战化展开。内容以 Jira 7.13.3 为例覆盖从 Docker 部署 MySQL 5.7 数据库、下载解压 Jira、配置JIRA_HOME与 MySQL 驱动、启动停止与端口修改到首次初始化、授权与中文化的全过程。读完本文你将能够在 CentOS/Linux 服务器上独立完成一套可运行的 Jira 项目管理平台的安装与配置并掌握 Jira 要求 utf8mb4 编码、server.xml端口调整等关键细节。Jira 是 Atlassian 出品的项目跟踪与软件开发管理平台也是 Java 技术栈团队中非常常见的协作工具。本文采用「Docker 装 MySQL 官方 tar.gz 包部署 Jira」的方式这也是仓库作者在本篇及配套 MySQL 安装和配置 文档中推荐的组合。以下步骤均以 CentOS 类系统、Jira 7.13.3 与 MySQL 5.7 为例说明。Jira 7.13.3 版本说明本文对应版本Jira 7.13.3该版本时间点为2019-04属于 7.x 系列。7.x 系列在官方 tar.gz 包中已内置中文本地化支持安装后无需额外汉化首次进入配置向导时可直接选择中文这是 7.x 相对旧版本6.x 及更早需要手动打汉化包的一个重要变化。下载方式从 Atlassian 官网下载tar.gz 类型的分发包atlassian-jira-software-7.13.3.tar.gz该包是「standalone」独立版自带 Tomcat 与 Jira 应用无需再单独安装应用服务器。第一步用 Docker 部署 MySQL 5.7 数据库Jira 需要一个外部数据库来存储项目、问题、工作流等数据。官方对生产环境推荐使用 MySQL 5.7Jira 7.x 对 MySQL 5.7 支持良好。使用 Docker 一条命令即可拉起docker run \ --name mysql-jira \ --restart always \ -p 3306:3306 \ -e MYSQL_ROOT_PASSWORDadg123456 \ -e MYSQL_DATABASEjira_db \ -e MYSQL_USERjira_user \ -e MYSQL_PASSWORDjira_123456 \ -d \ mysql:5.7参数说明参数作用--name mysql-jira容器名称后续docker exec进入容器时使用--restart always容器随 Docker 守护进程自动重启保证服务可用性-p 3306:3306将宿主机 3306 端口映射到容器 3306 端口-e MYSQL_ROOT_PASSWORDadg123456root 用户密码-e MYSQL_DATABASEjira_db启动时自动创建的数据库名即 Jira 要用的库-e MYSQL_USERjira_user/-e MYSQL_PASSWORDjira_123456自动创建的普通用户及其密码供 Jira 连接使用-d后台运行mysql:5.7使用 MySQL 5.7 官方镜像小贴士该 Docker 部署方式在仓库的 MySQL 安装和配置 文档中有完全一致的示例如需将数据挂载到宿主机持久化可参考该文档中「创建/data/docker/mysql/{datadir,conf,log}目录 -v挂载 自定义utf8mb4配置」的进阶写法。进入容器并设置 utf8mb4 编码必须做Jira 的数据库要求使用utf8mb4字符集否则后续初始化配置过程中会报错例如字符集相关的连接错误或乱码问题。这一步必须执行不要跳过。# 连上容器 docker exec -it mysql-jira /bin/bash # 容器内连上 MySQL mysql -u root -p进入 MySQL 命令行后执行SET NAMES utf8mb4; alter database jira_db character set utf8mb4;SET NAMES utf8mb4设置当前会话的字符集避免客户端与服务器字符集不一致alter database jira_db character set utf8mb4;将jira_db库的默认字符集改为 utf8mb4确保后续 Jira 建表时继承该字符集。在仓库的 MySQL 安装和配置 文档中同样的两步操作也被明确标注为安装 Jira 的前置步骤且该文档进一步提供了character-set-server utf8mb4、collation-server utf8mb4_unicode_ci、init_connect SET NAMES utf8mb4等服务端配置写法可作为生产环境彻底固化字符集方案的参考。第二步下载、解压并配置 Jira下载与解压从 Atlassian 官网atlassian.com/software/jira/download下载tar.gz 类型的安装包上传到服务器后解压tar zxvf atlassian-jira-software-7.13.3.tar.gz解压后得到目录atlassian-jira-software-7.13.3-standalone其中bin/存放启动停止脚本conf/server.xml为内嵌 Tomcat 的配置atlassian-jira/WEB-INF/lib用于放置数据库驱动 jar 包。创建 JIRA_HOME 目录Jira 是「安装目录 home数据目录」双目录结构安装目录放程序home 目录放索引、附件、配置等运行数据两者必须分开。mkdir /usr/local/atlassian-jira-software-7.13.3-standalone/data配置 JIRA_HOME 环境变量编辑~/.zshrc若使用 bash 则编辑~/.bashrc在文件尾部追加JIRA_HOME/usr/local/atlassian-jira-software-7.13.3-standalone/data export JIRA_HOME刷新配置source ~/.zshrc说明仓库作者默认使用 zsh见仓库 Zsh.md 等文档因此原文档以~/.zshrc为例使用 bash 的读者把上述两行写入~/.bashrc并source ~/.bashrc即可原理相同。放置 MySQL 连接驱动Jira 自带的 lib 中不含 MySQL 驱动Oracle/PostgreSQL 驱动通常内置MySQL 需要手动放置需要把mysql-connector-java-5.1.47.jar放入/usr/local/atlassian-jira-software-7.13.3-standalone/atlassian-jira/WEB-INF/lib放好后重启 JiraWeb 界面「数据库配置」步骤的驱动列表里才会出现可用的 MySQL 选项。注意 5.1.x 系列驱动与 MySQL 5.7 兼容良好是 Jira 7.x 官方推荐使用的驱动版本系列。第三步License授权码过程首次访问 Jira 时会要求输入授权码License授权码与当前实例的「服务器 IDServer ID」绑定需要在授权页面上复制实例的服务器 ID到 Atlassian 账户中申请对应规模的授权试用版、团队版、数据中心版等后将 License 粘贴回配置页在授权之前初始化向导会要求先完成「数据库连接」与「应用属性」等步骤授权页面位于其后的「添加你的授权码Add a license」环节部署在测试/内网环境时若仅用于学习验证可申请 Atlassian 官方的试用授权完成流程。第四步启动、停止与日志查看启动与停止# 启动 sh /usr/local/atlassian-jira-software-7.13.3-standalone/bin/start-jira.sh # 停止 sh /usr/local/atlassian-jira-software-7.13.3-standalone/bin/stop-jira.sh停止后确认进程已退出ps -ef | grep java若仍有残留的 java 进程说明 Jira 内嵌的 Tomcat 尚未完全退出需等待或检查是否有未释放的端口。查看日志Jira 的日志默认输出到安装目录下的logs/catalina.out内嵌 Tomcat 的标准输出排错时跟踪最新日志tail -300f /usr/local/atlassian-jira-software-7.13.3-standalone/logs/catalina.out数据库连接失败、端口占用、License 校验失败等典型问题都会在这里留下堆栈信息。访问与防火墙启动完成后浏览器访问http://服务器ip:8080注意防火墙配置8080 端口需要在防火墙firewalld / iptables或云厂商安全组中放行否则外部无法访问。仓库 Iptables.md、centos-settings/CentOS-Network-Settings.md 中有防火墙与网络配置的完整说明可参考处理。更换端口号如果 8080 端口被占用或希望换端口修改内嵌 Tomcat 的配置/usr/local/atlassian-jira-software-7.13.3-standalone/conf/server.xml找到 Connector 节点中的port8080改为目标端口后重启 Jira 生效。这与仓库中 Tomcat-Install-And-Settings.md 对 Tomcatserver.xml端口的处理思路一致——Jira standalone 包内部就是一个定制过的 Tomcat。第五步中文化7.x 版本默认已内置中文支持不需要再手动汉化在安装后首次进入向导时即可选择中文选择后整个初始化流程将以中文界面呈现后续也可在「系统管理 → 语言」中调整。这一点相比老版本需替换 JAR 汉化包大幅简化也是选择 7.x 系列部署的一个重要理由。第六步首次配置初始化向导首次访问http://服务器ip:8080后会进入初始化向导核心步骤依次为自定义安装 → 数据库配置 → 应用属性 → License 授权 → 管理员账户 → 邮件通知 → 完成。仓库 images/Jira-Install-And-Settings-a-1.jpg 展示了其中的数据库配置环节——语言可选英文/中文「数据库连接」处选择「其他数据库推荐用于正式生产环境」类型选 MySQL依次填写主机 IP、端口 3306、数据库名如jira、用户名与密码然后点击「测试连接」测试通过后继续。各环节要点说明Customize Your Installation自定义安装选择使用场景如「Project tracking项目跟踪」「Software development软件开发Jira Jira Agile」「IT service desksIT 服务台Jira Jira Service Desk」按团队需求勾选即可。数据库配置按上文选择 MySQL 并填写连接信息务必确保已执行 utf8mb4 设置否则此步「测试连接」或后续建表阶段会报字符集错误。Set up application properties应用属性填写程序标题如judasnJIRA、实例模式开放注册或受限并设置 Jira 根网址http://服务器ip:8090端口以实际配置为准若修改过 server.xml 则填写新端口。License 授权见上文第三步选择「I have a JIRA key」并粘贴授权码页面会显示本实例的 Server ID如图 images/Jira-Install-And-Settings-a-4.jpg 所示。设置管理员账户填写管理员全名、Email、账号、密码并确认密码见 images/Jira-Install-And-Settings-a-5.jpg此账号即系统初始超级管理员。设置邮件通知可「现在」配置邮件外发服务器SMTP也可选「以后再说」跳过点击「完成」后初始化流程结束进入 Jira 主界面。初始化完成后即可创建项目、配置工作流并开始日常的缺陷跟踪与项目协作。常见问题与排错要点字符集报错 / 中文乱码几乎都源于未执行alter database jira_db character set utf8mb4;。请回到数据库容器重做编码设置后再继续初始化。数据库连接测试失败检查 MySQL 容器是否正常运行docker ps、3306 端口映射、jira_user用户密码是否正确、MySQL 是否允许远程连接容器内用户默认允许但需确认授权。访问不了 8080优先排查宿主机防火墙与安全组参考 Iptables.md 放行端口。更换端口后 License 失效Jira 的 License 与实例 ID 相关而实例 ID 会在server.xml端口调整等情况下可能变化若授权校验失败需用新的 Server ID 重新生成授权码。日志定位问题所有启动期错误优先看logs/catalina.out。结语至此你已经走通了「Docker MySQL 5.7 Jira 7.13.3 tar.gz」的完整安装链路数据库 utf8mb4 前置设置、JIRA_HOME与环境变量、MySQL 驱动放置、启动停止与端口/防火墙处理以及首次初始化向导数据库连接、License、管理员与邮件通知。这套流程在仓库 Jira 安装和配置 原始笔记的基础上补全了每一步的原理说明与排错方向后续若需在更大规模团队中使用还可进一步研究 LDAP 用户同步参考仓库 LDAP-Install-And-Settings.md与外部反向代理接入参考 Nginx-Install-And-Settings.md将 Jira 更好地融入既有运维体系。赞分享文档教程技术博客【免费下载链接】Linux-Tutorial《Java 程序员眼中的 Linux》项目地址https://gitcode.com/gh_mirrors/li/Linux-Tutorial点击查看免费下载相关推荐DVWA 部署与配置实战指南从 XAMPP/Linux/Docker 安装到数据库初始化与故障排查DVWA 部署与配置实战指南从 XAMPP/Linux/Docker 安装到数据库初始化与故障排查 导读 本文基于 DVWA 官方 README 的法语版本应用安全渗透测试教育Prisma 1.13 MySQL 数据库连接器docker-compose 配置、服务初始化与故障排查实战Prisma 1.13 MySQL 数据库连接器docker compose 配置、服务初始化与故障排查实战 导读 本文围绕 Prisma 1.13 自托管服后端数据库GraphQLmall4j 数据库初始化实战yami_shop.sql 导入与 MySQL 连接配置全解析mall4j 数据库初始化实战yami_shop.sql 导入与 MySQL 连接配置全解析 本文围绕 mall4j 电商商城项目的数据库初始化环节展开完整电商后端前端移动开发上一篇Terraform AWS Provider 设计决策日志全解关系资源标准、独占管理资源与 Changie 迁移的完整演进下一篇schedule 库日志指南开启 DEBUG 日志与自定义作业日志的完整实战创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考