萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Linux 下安裝 Jira (含 JDK、MySQL、Tomcat) 生產級部署全記錄

架構規劃

  • JDK: Oracle JDK 11 / 17 (LTS) 或 OpenJDK,Jira 9.x 需 JDK 11/17
  • 數據庫: MySQL 8.0 / PostgreSQL 13+ (官方推薦 PostgreSQL),字符集 utf8mb4、排序規則 utf8mb4_bin
  • 應用服務器: Jira 內嵌 Tomcat (Standalone 版),無需單獨安裝 Tomcat
  • 反向代理: Nginx 終結 SSL、靜態資源緩存、限流
  • 專用用戶: `jira` 用戶運行服務,最小權限原則

步驟 1:創建專用用戶與目錄

groupadd -r jira
useradd -r -g jira -d /opt/jira -s /bin/bash -m jira
mkdir -p /opt/jira/data  # Jira Home 目錄 (數據、索引、附件、日誌)
chown -R jira:jira /opt/jira

步驟 2:安裝 JDK 17 (以 OpenJDK 為例)

# RHEL 系
dnf install -y java-17-openjdk java-17-openjdk-devel

# Debian 系
apt-get update && apt-get install -y openjdk-17-jdk

# 驗證
java -version
# 設置 JAVA_HOME (全局)
cat > /etc/profile.d/java.sh <<'EOF'
export JAVA_HOME=$(dirname $(dirname $(readlink -f $(which java))))
export PATH=$JAVA_HOME/bin:$PATH
EOF
source /etc/profile.d/java.sh

步驟 3:安裝並配置 MySQL 8.0

# 安裝 (RHEL 9 示例)
dnf install -y @mysql:8.0/server
systemctl enable --now mysqld

# 安全初始化
mysql_secure_installation
# 設置 root 密碼、移除匿名用戶、禁止 root 遠程登錄、移除 test 库

# 創建 Jira 數據庫與用戶
mysql -u root -p
CREATE DATABASE jiradb CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
CREATE USER 'jira'@'localhost' IDENTIFIED BY 'StrongPassword123!';
GRANT ALL PRIVILEGES ON jiradb.* TO 'jira'@'localhost';
FLUSH PRIVILEGES;
EXIT;

步驟 4:安裝 Jira (Standalone 版)

# 1. 下載 (官網需登錄,此處示例鏈接)
cd /tmp
wget -O jira.bin "https://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-software-9.12.0-x64.bin"
chmod +x jira.bin

# 2. 以 jira 用戶運行安裝向導 (圖形/控制台模式)
su - jira
./jira.bin
# 選擇: Custom Install
# 安裝目錄: /opt/jira/app (默認)
# 數據目錄: /opt/jira/data (預創建)
# 端口: HTTP 8080, Control 8005 (避開衝突)
# 作為服務安裝: Yes (生成 systemd unit)

# 3. 安裝完成後,修改 server.xml 配置數據庫 (若向導未完成)
# /opt/jira/app/conf/server.xml
# 在   內添加 :
# 
#   
# 

# 4. 複製 MySQL 驅動到 lib
cp /usr/share/java/mysql-connector-java.jar /opt/jira/app/lib/
# 或下載: wget -P /opt/jira/app/lib/ https://repo1.maven.org/maven2/com/mysql/mysql-connector-j/8.0.33/mysql-connector-j-8.0.33.jar

步驟 5:配置 JVM 參數 (關鍵性能調優)

# /opt/jira/app/bin/setenv.sh (或 setenv.bat)
# 根據物理內存設置 (建議 Heap 不超過物理內存 50%,留給 OS、Lucene 索引、緩存)
# 示例 8GB 內存服務器:
JVM_MINIMUM_MEMORY=2g
JVM_MAXIMUM_MEMORY=4g
JVM_RESERVED_CODE_CACHE_SIZE=512m

# GC 策略 (JDK 11+ 推薦 G1)
JVM_SUPPORT_RECOMMENDED_ARGS="
  -XX:+UseG1GC
  -XX:MaxGCPauseMillis=200
  -XX:+ParallelRefProcEnabled
  -XX:+UnlockExperimentalVMOptions
  -XX:-OmitStackTraceInFastThrow
  -Djava.awt.headless=true
  -Datlassian.plugins.enable.wait=300
"
# 關鍵:設置 Jira Home
export JIRA_HOME="/opt/jira/data"

步驟 6:Systemd 服務管理

# 安裝向導已生成 /etc/systemd/system/jira.service
# 內容示例:
[Unit]
Description=Atlassian Jira
After=network.target mysqld.service
Requires=mysqld.service

[Service]
Type=forking
User=jira
Group=jira
Environment=JIRA_HOME=/opt/jira/data
PIDFile=/opt/jira/app/work/catalina.pid
ExecStart=/opt/jira/app/bin/start-jira.sh
ExecStop=/opt/jira/app/bin/stop-jira.sh
TimeoutStartSec=300
TimeoutStopSec=60
LimitNOFILE=65536
LimitNPROC=32768

[Install]
WantedBy=multi-user.target

# 重載並啟動
systemctl daemon-reload
systemctl enable --now jira
systemctl status jira -l

步驟 7:Nginx 反向代理 + SSL (Let's Encrypt)

# /etc/nginx/conf.d/jira.conf
upstream jira {
    server 127.0.0.1:8080;
    keepalive 32;
}

server {
    listen 80;
    server_name jira.example.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name jira.example.com;

    ssl_certificate /etc/letsencrypt/live/jira.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/jira.example.com/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;

    client_max_body_size 100M;  # 附件上傳大小
    proxy_read_timeout 300s;
    proxy_send_timeout 300s;

    location / {
        proxy_pass https://jira;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_set_header Connection "";
    }

    # 靜態資源緩存
    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2)$ {
        proxy_pass https://jira;
        expires 30d;
        add_header Cache-Control "public, immutable";
    }
}

步驟 8:許可證導入與首次啟動向導

  1. 瀏覽器訪問 `https://jira.example.com`
  2. 選擇 "I'll set it up myself" → Database: MySQL → 填寫 JDBC 連接信息 (若 server.xml 已配置則自動檢測)
  3. 導入許可證 (License Key) 或生成評估許可證
  4. 設置管理員賬號、郵件服務器、語言、時區
  5. 完成安裝

常見故障排查

故障排查方向
啟動卡在 "Starting Jira" / 端口佔用`netstat -tlnp | grep 8080`、`lsof -i:8005`、`kill -9 PID`、修改 server.xml 端口
數據庫連接失敗驅動 jar 是否在 lib/、URL 參數 (useSSL, serverTimezone)、用戶權限、防火牆 3306
JIRA has been locked (.jira-home.lock)`find /opt/jira/data -name '.jira-home.lock' -delete` 後重啟
內存溢出 (OOM) / GC 頻繁調大 Heap、啟用 G1GC、檢查大附件/索引重建、升級實例規格
附件上傳失敗Nginx client_max_body_size、Jira 附件大小限制 (管理 → 系統 → 附件)、磁盤空間
中文亂碼數據庫 utf8mb4_bin、JVM -Dfile.encoding=UTF-8、URL characterEncoding=utf8mb4

備份與升級策略

  • 每日備份: 數據庫 `mysqldump --single-transaction jiradb > backup.sql` + Jira Home 目錄 `/opt/jira/data` (排除 `log/`, `export/`, `caches/`)。
  • 升級前: 閱讀 Release Notes、測試環境驗證、完整備份、關閉應用、運行升級安裝包 (覆蓋安裝目錄)、啟動驗證。
  • 零停機升級: Jira Data Center 版支援滾動升級,Server 版需停機。
copyright © 萬盛學電腦網 all rights reserved