下载Bitbucket仓库时如何确保压缩包文件名称固定为master.zip

方案1：直接构造带文件名参数的下载链接 #

Bitbucket原生支持在分支下载链接末尾添加文件名参数，通过指定响应头的下载文件名实现固定命名，完全不需要额外配置：

• 固定命名下载路径格式为 https://bitbucket.org/*你的团队名*/*你的仓库名*/get/master.zip?filename=你需要的固定文件名.zip，比如你要输出custom-plugin.zip就把参数值设为这个即可。
• 你直接把这个路径配置到WordPress的插件更新逻辑里就行，Bitbucket返回的压缩包会直接使用你指定的文件名，不会附带commit ID，WordPress会正常识别为现有插件的更新包。

方案2：通过Pipeline自动生成固定压缩包 #

如果不想用带参数的链接，也可以配置推送master分支时自动打包上传到仓库下载区：

• 首先在仓库根目录新建bitbucket-pipelines.yml文件，添加如下配置：

image: atlassian/default-image:3
pipelines:
  branches:
    master:
      - step:
          name: 打包WordPress插件
          script:
            # 打包时排除不需要的配置和git文件
            - zip -r custom-plugin.zip . -x "bitbucket-pipelines.yml" ".git/*" ".gitignore"
            - pipe: atlassian/bitbucket-upload-file:0.7.1
              variables:
                BITBUCKET_USERNAME: $BITBUCKET_USERNAME
                BITBUCKET_APP_PASSWORD: $BITBUCKET_APP_PASSWORD
                FILENAME: "custom-plugin.zip"

• 在仓库的Pipeline设置页添加拥有文件上传权限的应用密码作为变量，后续每次推送到master分支都会自动生成固定命名的压缩包，你直接用下载区的固定链接配置到WordPress即可。

适配说明 #

如果是自建部署的Bitbucket Server实例，方案1的参数名需要替换为downloadName，其余逻辑不变。

内容的提问来源于stack exchange，提问作者Garrett Massey