Python调用Jira接口：实战教程

jira集群部署搭建

• 一、原始环境
• 二、集群架构
• 三、数据迁移

• 1、备份
• 1.1阻止用户更新JIRA数据
• 1.2备份数据库
• 1.3备份JIRA主目录
• 1.4备份附件和索引目录（如果位于JIRA主目录之外）
• 1.5备份JIRA安装目录
• 2、迁移

• 四、环境搭建
• 五、还原实例

• 5.1安装新节点的JIRA应用程序
• 5.2将JIRA应用程序的新版本连接到新的数据库
• 5.3 （可选）自定义配置文件
• 5.4 启动实例

• 六、配置集群

• 1.安装或升级您的Jira实例
• 2.设置共享目录
• 3.配置您的Jira实例以在集群中工作
• 4.将第一个节点添加到负载均衡器

• 4.1 负载均衡器的选择

• 5.将其余节点添加到集群

• 监控数据中心的运行状况

由于jira布置为单点，为了高可用现扩展为集群模式，除了需要注意数据备份迁移之外，还要注意数据恢复、集群搭建、前端代理的负载均衡。

一、原始环境

jira版本：8.7.1

容器数据目录挂载/var/atlassian/application-data/jira 挂载到本地目录/opt/atlassian/application-data/jira/

数据库：172.17.0.166:3306

二、集群架构

官方推荐安装目录和主目录区分开。

三、数据迁移

1、备份

官方推荐使用专业的DB工具进行备份，而不使用jira自带的xml数据导出导入，原因如下：

使用本机数据库备份工具
所有重要的数据库都附带有用于备份和还原数据库的工具（RDBMS中的“ MS”）。我们强烈建议您优先使用以下这些工具来代替下面描述的XML备份选项，因为它们：

1. 通过在单个时间点进行备份来确保数据库的完整性
2. 与Jira的XML备份相比，速度更快且资源占用更少。
3. 与现有备份策略集成（例如，允许对所有使用数据库的应用程序运行一次备份）。
4. 可能允许增量（而不是“完整”）备份，从而节省了磁盘空间。
5. 避免与Jira使用XML作为备用格式有关的字符编码和格式问题。

有关如何设置定期备份的信息，请参见数据库的文档。这通常涉及cron作业或Windows计划的任务，这些任务调用诸如mysqldump或pg_dump之类的命令行工具。

因此，这里使用物理备份，既对数据进行mysqldump逻辑备份*(数据量大可考虑其他方式)，对jira安装目录和主目录进行物理拷贝。

1.1阻止用户更新JIRA数据

在升级过程中，您将从现有的JIRA安装中导出JIRA的数据库（通过XML备份），然后将该备份还原到新的JIRA安装中。为了确保XML备份中的数据与系统中的最新数据一致，您必须临时限制对JIRA的访问，以便用户无法更新数据。 有关更多信息，请参考在备份期间阻止用户访问JIRA应用程序。

(警告) 注意！不一致的XML备份无法恢复！

1.2备份数据库

对现有JIRA安装的外部数据库执行XML备份。对于大型JIRA安装，此过程可能需要几个小时才能完成。

我们用mysqldump！

#数据库备份 
mysqldump -uroot -p --max-allowed-packet=419430400 --opt -R -E --allow-keywords jiradb > jiradb.sql
1.
2.

1.3备份JIRA主目录

1. 关闭JIRA。
2. 找到JIRA主目录。通过导航到JIRA应用程序安装目录中的<jira-application-dir>/WEB-INF/classes/jira-application.properties文件，可以找到有关目录位置的信息 。或者，您可以打开JIRA配置工具 以查看设置为JIRA Home的目录。
3. 导航到配置文件中指定的目录，然后在另一个目录中创建它的备份。
4. 备份完成后，立即从原始文件夹中删除文件 /dbconfig.xml。（目的是防止还原后链接旧的数据库，写入脏数据）

1.4备份附件和索引目录（如果位于JIRA主目录之外）

如果附件和索引目录位于JIRA主目录之外，则必须单独备份它们。这些页面描述了如何查找这些目录在实现中的位置：

您的附件目录- 有关您的JIRA版本，请参阅文档中的“ 配置文件附件”页面。
您的索引目录- 有关您的JIRA版本，请参阅文档中的“ 搜索索引”页面。
另请参阅备份数据 ，以获取有关在JIRA中备份附件的更多信息。默认是在jira-home data \data\attachments

1.5备份JIRA安装目录

“ JIRA安装目录”是安装JIRA时将JIRA应用程序文件和库提取到的目录。

2、迁移

将数据库备份还原到新建的mysql中。

将安装目录和数据目录rsync传送到node1，node2并放置到规划好的位置。

四、环境搭建

4.1 jdk
推荐1.8以上
略

4.2 tengine

略

4.3 mysql
版本5.7
略

1、mysql配置
以下参数为关键参数，其他参数可以根据实际情况进行优化

[mysqld]
default-storage-engine=INNODB
character_set_server=utf8mb4
innodb_default_row_format=DYNAMIC
innodb_large_prefix=ON
innodb_file_format=Barracuda
innodb_log_file_size=2G
sql_mode = NO_AUTO_VALUE_ON_ZERO
 
CREATE DATABASE jiradb CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,REFERENCES,ALTER,INDEX on jiradb.* TO jira@'172.17.0.166' IDENTIFIED BY '******';
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.

4.3 nfs

yum install nfs-utils -y
systemctl enabled nfs
systemctl start nfs
 
# 添加账户
useradd -u 1000 jira
# 配置nfs文件
cat /etc/exports
/opt/case/nfs_data/jirasoftware-sharedhome 172.17.210.17(rw,all_squash,anonuid=1000,anongid=1000) 172.17.210.18(rw,all_squash,anonuid=1000,anongid=1000)
# 挂载
mount 172.17.210.14:/opt/case/nfs_data/jirasoftware-sharedhome /opt/case/jirasoftware-sharedhome/
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.

五、还原实例

5.1安装新节点的JIRA应用程序

分别解压主目录和安装目录的压缩包，放置到规定位置/opt/data/jirasoftware-home（主目录），/opt/app/jira（安装目录）。

1. 将文件解压缩（解压缩）到目录（如果是同一台机器上，这是您的新安装目录，并且必须与现有安装目录不同）。
   $ chown -R jira /opt/data/jirasoftware-home
   $ chmod -R u=rwx,go-rwx /opt/data/jirasoftware-home
   $ chown -R jira /opt/app/jira
   $ chmod -R u=rwx,go-rwx /opt/app/jira
2. 编辑以下文件：
   <installation-directory>\atlassian-Jira\WEB-INF\classes\Jira-application.properties
   它必须指向您 现有的 Jira主目录。
   jira.home=/opt/data/jirasoftware-home
   也可以使用JIRA_HOME 操作系统的绝对路径设置在操作系统中命名的环境变量 <home-directory>。环境变量优先级高于配置文件Jira-application.properties
   在终端中，执行以下操作：
   export JIRA_HOME=/opt/data/jirasoftware-home (docker启动就是使用的这种方式，所以配置文件内未设置jira.home，需要我们自行修改)
   然后，您可以在用于启动Jira的脚本中指定上述命令。
   <installation-directory>\atlassian-jira\WEB-INF\classes\jira-application.properties在任何文本编辑器中编辑 文件。
   之后jira.home绝对路径添加到你的主目录（不是一个符号链接），例如：
   jira.home=/var/jirasoftware-home
   确保删除了 dbconfig.xml 文件，否则Jira将尝试连接到现有数据库。（不用删除，自己编辑文件修改为最新数据库地址）
3. (可选）如果使用Crowd进行用户管理，请完成以下额外步骤。

如果使用Crowd进行用户管理，则将以下文件从现有安装目录的修改重新应用到新文件。不要复制文件，因为它们在新版本的Jira中可能会有所不同。

<Installation-Directory>/atlassian-Jira/WEB-INF/classes/crowd.properties
<Installation-Directory>/atlassian-Jira/WEB-INF/classes/seraph-config.xml
1.
2.

5.2将JIRA应用程序的新版本连接到新的数据库

mysql -uroot -p  jiradb < jiradb.sql
1.

5.3 （可选）自定义配置文件

新节点使用Jira时，如果想对Jira文件进行了一些自定义修改。这些可能包括连接详细信息，与内存分配有关的设置或其他JVM参数。

我们通常会修改的一些文件：

server.xml
dbconfig.xml
Jira-config.properties
setenv.sh / setenv.bat （内存分配和其他JVM参数）
有关更多信息，请参阅 Jira中的重要文件。

5.4 启动实例

useradd -u 1000 jira
 
su - jira -s /bin/bash -c "/opt/app/jira/bin/start-jira.sh"
1.
2.
3.

观察是否监听8080端口，如果端口需要更改就自行编辑server.xml。

六、配置集群

在集群中安装数据中心

1.安装或升级您的Jira实例

略（上一个步骤已经实现），关闭开启的实例，并同步相应目录到node2

2.设置共享目录

您需要创建一个集群中所有节点都可读写的远程目录。有多种方法可以执行此操作，但最简单的方法是使用NFS共享。

1. 创建一个可由群集中所有节点访问的远程目录，并将其命名为 /opt/case/jirasoftware-sharedhome。
2. 停止您的Jira实例。
3. 将以下目录从Jira本地主目录复制到新 /opt/case/jirasoftware-sharedhome 目录（其中一些可能为空）。

• data
• plugins
• logos
• import
• export
• caches

3.配置您的Jira实例以在集群中工作

1. 在Jira本地主目录中，创建一个 cluster.properties 文件，其内容如下：
   示例cluster.properties文件：

# 此ID在整个群集中必须是唯一的
jira.node.id = node1
# 所有Jira节点的共享主目录的位置
jira.shared.home = /opt/case/jirasoftware-sharedhome
# (可选)如果未设置参数Jira默认会使用主机名，请在/etc/hosts内设置host，或设置下面参数。内部调用40001端口时如果不设置会使用主机名
ehcache.listener.hostName = 172.17.201.18
1.
2.
3.
4.
5.
6.

设置node1和node2的/etc/hosts文件
172.17.210.17 test-210-17.com
172.17.210.18 test-210-18.com

有关更多信息和一些其他参数，请参阅Cluster.properties文件参数。

2. 对于Linux安装：我们建议您增加打开文件的最大数量。为此，将以下行添加到 /bin/setenv.sh：

ulimit -n 65535

3. 启动您的实例，然后去 应用数据中心许可证申请数据中心License。

*群集无效的许可证：我们发现您的JIRA许可证有问题
JIRA被设置为作为数据中心实例运行，但是它没有有效的数据中心许可证。您可以从my.atlassian.com获得有效的数据中心许可证，并在此处替换当前许可证。

有关许可错误的更多信息，请参见我们的文档。

了解更多

申请完成后点相应链接，完成许可证

4.将第一个节点添加到负载均衡器

负载平衡器在节点之间分配流量。如果某个节点停止工作，其余节点将接管其工作负载，而您的用户甚至不会注意到它。

将第一个节点添加到负载均衡器。
重新启动该节点，然后尝试在Jira中打开其他页面。如果负载均衡器正常工作，则访问Jira应该没有问题。

4.1 负载均衡器的选择

官方文档说 We do not officially support any specific Load Balancers, but most commonly see customers using Apache or F5. 感觉是在装逼！

官方文档提到的负载均衡器有：Apache、Haproxy
 官方负载均衡参考链接 本测试使用tengine，配置文件如下（*还未测试）

upstream jira.cluster {
    server 172.17.210.17:8080;
    server 172.17.210.18:8080;
 
    check interval=5000 rise=3 fall=2 timeout=3000 type=tcp;
    check_keepalive_requests 1;
    session_sticky;
}
 
 
server {
    listen       80;
    server_name  jira.web.cn;
 
    #charset koi8-r;
    access_log  /opt/logs/tengine/jira.web.cn_access.log ;
    error_log   /opt/logs/tengine/jira.web.cn_error.log  warn;
 
    #ssl_stapling off;
 
    location / {
          proxy_set_header X-Forwarded-Host $host;
          proxy_set_header X-Forwarded-Server $host;
          proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
          proxy_set_header X-Forwarded-Proto https;
          proxy_pass http://jira.cluster;
          client_max_body_size 100M;
        }
}
 
server {
    listen       443 ssl;
    ssl_certificate     /opt/app/tengine/conf/ssl/jira.crt;
    ssl_certificate_key /opt/app/tengine/conf/ssl/jira.key;
    server_name  jira.web.cn;
 
    return 301 http://$server_name$request_uri;
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.

5.将其余节点添加到集群

1. 将Jira *安装目录 和 本地主目录 从第一个节点复制 到此新节点。
2. 确保新节点可以访问（读取和写入）共享主目录。
3. 编辑cluster.properties文件，然后更改节点ID。所有节点ID在节点之间必须唯一。
4. 启动jira。它将从共享主目录读取配置，并且无需任何额外设置即可开始。
5. 看看新的Jira实例。确保问题创建，搜索，附件和自定义项按预期工作。
6. 如果一切正常，则可以配置负载均衡器以开始将流量路由到新节点。完成此操作后，您可以在一个Jira实例中进行几次更改，以查看它们是否在其他实例中也可见。

在将节点添加到集群时，可以通过转到> System> System info来检查其状态 。您的节点将在“ 群集节点” 部分列出 。

监控数据中心的运行状况

现在您已启动并运行了数据中心，我们建议您从一开始就一直监视其运行状况。这将帮助您避免出现任何问题，避免问题变大和使工作混乱，并且您将始终了解集群中正在发生的事情。

JIRA数据中心配备了一组运行状况检查工具，可让您分别监视整个集群和每个节点，包括所有重要设置。要访问运行状况检查工具，请转到>系统>支持工具。所有运行状况检查均在“ 实例运行状况” 选项卡中列出 。

参考：

 https://confluence.atlassian.com/adminjiraserver087/migrating-jira-applications-to-another-server-998871666.html

 https://developer.atlassian.com/server/jira/platform/configuring-a-jira-cluster/#each-node-on-a-separate-machine

 https://confluence.atlassian.com/adminjiraserver087/backing-up-data-998872458.html

 https://confluence.atlassian.com/enterprise/jira-data-center-load-balancer-examples-781200827.html