You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何通过终端部署已构建的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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.19 11:40:31