如何通过终端部署已构建的Bitbucket插件至7.21版本服务器?
解决方案:通过复制Jar包到Bitbucket服务器实现插件自动部署
完全可以通过将构建好的Jar包复制到Bitbucket服务器的指定目录完成部署,不过需要配合后续操作让Bitbucket识别并加载插件,具体步骤如下:
1. 确定Bitbucket插件目录
Bitbucket的插件安装目录分两种情况,根据你的部署方式选择:
- 独立安装的Bitbucket:默认插件目录为
<Bitbucket安装路径>/atlassian-bitbucket/WEB-INF/plugins,比如常见的/opt/atlassian/bitbucket/atlassian-bitbucket/WEB-INF/plugins - 使用数据目录的部署:部分环境会将插件放在数据目录下,路径为
<Bitbucket数据目录>/plugins/installed-plugins,可通过Bitbucket管理后台的「System info」查看数据目录位置
2. 从Bamboo传输Jar包到Bitbucket服务器
在Bamboo的CI/CD流水线中添加文件传输或SSH任务,将构建好的插件Jar包传到上述确定的目录。比如用scp命令:
scp /bamboo/build/path/your-plugin.jar bitbucket-user@bitbucket-server-ip:/opt/atlassian/bitbucket/atlassian-bitbucket/WEB-INF/plugins/
3. 让Bitbucket加载新插件
复制Jar包后,Bitbucket不会自动识别,需要手动触发加载,有两种方式可选:
方式一:重启Bitbucket服务器(简单直接,会有短暂服务中断)
如果你的Bitbucket用systemd管理,执行:
sudo systemctl restart bitbucket
其他启动方式对应执行停止和启动命令即可。
方式二:通过REST API热加载(无服务中断,推荐)
用管理员账号调用Bitbucket的插件管理API,触发插件扫描或安装:
curl -u 管理员账号:密码 -X POST http://bitbucket-server:7990/rest/plugins/1.0/ \ -H "Content-Type: application/vnd.atl.plugins.plugin.install+json" \ -d '{"pluginKey":"你的插件Key"}'
注:插件Key可在插件的atlassian-plugin.xml文件中找到。
4. 验证部署结果
登录Bitbucket管理后台,进入Manage apps页面,在「User-installed apps」列表中查看你的插件是否已成功安装并启用。
注意事项
- 确保复制后的Jar包权限正确:Bitbucket运行用户(通常为
atlbitbucket)需要有读取权限,可执行命令调整:sudo chown atlbitbucket:atlbitbucket /opt/atlassian/bitbucket/atlassian-bitbucket/WEB-INF/plugins/your-plugin.jar - 如果插件加载失败,查看Bitbucket日志文件
<Bitbucket数据目录>/log/atlassian-bitbucket.log排查问题 - 更新插件时,建议先删除旧版本的Jar包再复制新包,避免版本冲突
内容的提问来源于stack exchange,提问作者Soeren
相关产品推荐
相关产品推荐

