Linux安装Bitbucket7.6.0教程-绝对干货满满

1.准备工作

2.升级系统Git版本

3.安装BitBucket

4.插件下载和安装

Bitbucket是一款基于 Git 的代码托管与协作工具，专为团队打造。Bitbucket 一流的 Jira 和 Trello 集成旨在集结整个软件团队以便共同处理一个项目。我们为您的团队提供了一个平台，方便您的团队开展从概念到云的代码协作、通过自动化测试构建优质代码，以及从容地部署代码。企业级代码管理，用Bitbucket非常合适。

1.准备工作

官网bin文件安装包下载：https://www.atlassian.com/software/stash/downloads/binary/atlassian-bitbucket-7.6.0-x64.bin

或者：https://product-downloads.atlassian.com/software/stash/downloads/atlassian-bitbucket-7.6.0-x64.bin

agent下载地址：https://u062.com/f/25928676-481086283-6b3110（访问密码：5882）（如链接失效可评论联系补链）

agent官方使用方法见：https://gitee.com/pengzhile/atlassian-agent

2.升级系统Git版本

（大坑之一）

Bitbucket要求Git版本2.19以上，如果Git版本不满足要求，安装时也会给出提示。

升级Git版本方法见：https://blog.csdn.net/sdujava2011/article/details/112847108

3.安装BitBucket

3.1 赋予安装文件atlassian-bitbucket-7.6.0-x64.bin可执行权限，然后直接运行该安装文件

chmod +x atlassian-bitbucket-7.6.0-x64.bin./atlassian-bitbucket-7.6.0-x64.bin

3.2 安装过程中会有很多安装选项让选择，英文OK的同志们应该都没什么问题，这里就不赘述了，大部分都默认即可，有特殊目录需要的，可以在设置相关目录时进行自定义修改。

3.3 如果在安装时选择了将Bitbucket安装为Service，那么安装完成后可以用如下命令启动/停止Bitbucket

service atlbitbucket startservice atlbitbucket stop

如果没有安装service，就到Bitbucket安装目录下的bin目录下，执行start-bitbucket.sh脚本启动Bitbucket。

Bitbucket启动之后，访问http://ip:7990，如果能进入Bitbucket初始化设置界面，说明安装成功。

3.4 在http://ip:7990上进行初始化设置时，需要选择Bitbucket数据库，如果使用内置数据库，选择Internal；如果需要使用MySQL等第三方数据库，选择External。

3.5 如果选择使用第三方数据库，这里以MySQL为例，那么会发现界面上有提示“缺少mysql驱动”，此时需要下载mysql驱动jar包，先停止bitbucket服务，然后将jar包放置到bitbucket安装目录下的/app/WEB-INF/lib/目录下。

想看官网的文档可以见这里：Connecting Bitbucket Server to MySQL | Bitbucket Data Center and Server 7.14 | Atlassian DocumentationConnecting Bitbucket Server to MySQL | Bitbucket Data Center and Server 7.14 | Atlassian Documentation

（大坑之二）

Bitbucket Data Center不支持使用MySQL和MariaDB。

（大坑之三）

Bitbucket Server不支持MySQL5.6.16之前的版本。

（大坑之四）

并且，Bitbucket对于mysql驱动的版本是有要求的，仅支持mysql jdbc驱动的5.1版本，驱动jar包可以在这里下载：

https://u062.com/f/25928676-481089810-9991a6（访问密码：5882，如链接失效评论补链）

因为这个lib目录下的文件所属用户都是atlbitbucket，所以将jar包放到指定目录后还需要更改其所属用户和用户组，使用如下命令：

chown atlbitbucket:atlbitbucket mysql-connector-java-5.1.48.jar

3.6 将atlassian-agent.jar文件放到Bitbucket安装目录下的bin文件夹下，然后配置JAVA_OPTS环境变量，这里试过编辑start-bitbucket.sh脚本和.bashrc文件，启动后agent都没有正常加载，所以这里配置环境变量选择在/etc/profile文件中配置，打开/etc/profile文件，在最后一行添加如下内容：

（这里没有正常加载的原因有可能时没有修改atlassian-agent.jar文件的所有者和用户组为atlbitbucket，2021年6月15日想起来看了一下我的测试环境atlassian-agent.jar的所有者和用户组是root，如果也有人遇到这个问题可以试试）

export JAVA_OPTS="-javaagent:{你的Bitbucket安装目录}/bin/atlassian-agent.jar ${JAVA_OPTS}"

3.7 mysql驱动jar包和JAVA_OPTS环境变量都配置好之后，执行service atlbitbucket start启动Bitbucket。

3.8 继续访问http://ip:7990访问Bitbucket页面，这时候就可以选择MySql数据库进行配置了。

如果配置好数据库信息，点击Next后出现

The target database is not configured for UTF-8 support.

(大坑之五)

MySQL的字符集不能使用utf8mb4，需要将数据库字符集相关参数修改为

character_set_database = uft8collation_database = utf8_bin

如果配置好数据库信息，点击Next后出现

Bitbucket does not have adequate permissions to create a temporary table in the target database when connected as the specified user. Please check that the user has permissions to CREATE TEMPERARY TABLES.

(大坑之六)

这里提示无法创建临时表，这时候先检查数据用户的权限。如果是权限问题，那我只能说，算你幸运。

但是你可能发现用户权限并没有问题。这时，你可能想到了一个“巧妙”的方法，那就是在已有环境中把Bitbucket数据库的库表导出后，提前导入，这样Bitbucket是不是可以检测到表已经创建，就不需要创建这些临时表了呀。

哈哈哈哈哈哈哈，这将是你人生中失败的一次灵机一动

如果你想到了上面这个方法，那么报错就变成了

The target database contains tables whose names collide with Bitbucket's tables. Please migrate to a clean empty database.

(大坑之七)

当你遇到了大坑之六，而且排除了用户权限的问题的时候，那么这个时候，这个问题应该解决不了了，如果有大神解决过这个问题，希望可以在评论区秀出你的神级操作。

网上找到的一个关于原因的说法，我觉得是比较靠谱的，那就是因为开启了gtid，不过gtid是生产环境主从同步一个很关键的参数，所以emmmmm，你懂我意思吧

地址：bitbucket安装连接数据库时提示没有创建临时表权限_weixin_34326429的博客-CSDN博客

大坑之五之前的坑在测试环境都已经遇到过了，时隔四个月，换了个环境部署竟然又遇到了几个新坑，真的是醉了，实在不行，临时解决办法可以使用Internal数据库，不使用External数据库。

3.9 最后一步，激活

在License and settings页面，选择“I have a Bitbucket license key”。

在atlassian-agent.jar存放的目录下，执行如下命令，其中XXXX-XXXX-XXXX-XXXX替换为你自己页面上显示的Server ID：

java -jar atlassian-agent.jar -m admin@mail.com -o org -p bitbucket -s XXXX-XXXX-XXXX-XXXX

执行结束后将生成的key填入，点击Next，之后配置一下admin账户的相关信息就OK了。

4.插件下载和安装

在Bitbucket界面，管理>插件管理进行插件jar文件上传，使用atlassian-agent.jar 进行序列号计算，注意-p 后面的内容用单引号包含；

中文：https://marketplace.atlassian.com/apps/1220595/chinese-language-pack-for-bitbucket/version-history

Rest API：https://marketplace.atlassian.com/apps/1211542/atlassian-rest-api-browser?hosting=server&tab=installation

个人图形：https://marketplace.atlassian.com/apps/1210934/awesome-graphs-for-bitbucket?hosting=cloud&tab=overview

图形展示：https://marketplace.atlassian.com/apps/1212147/charts-graphs-for-bitbucket?hosting=datacenter&tab=overview