GitLab自定义发布配置问题：自动生成夜间发布包遇阻

针对你在公共GitLab实例上配置夜间发布时遇到的问题，逐一解答如下：

a) 是否可替换自动tar包为自定义tar包？ #

可以。核心思路是通过流水线生成make dist/make distcheck的tar包后，用GitLab的发布机制替代默认的VCS tar包：

• 先关闭自动生成的VCS源码包（参考问题d的步骤）；
• 再通过CI流水线的release关键字或GitLab Release API，将自定义tar包直接关联到发布。

b) 如何上传无额外zip包裹的工件？ #

在.gitlab-ci.yml中明确指定单个tar包的路径，避免包含目录或多个文件，GitLab就会直接上传该文件而非打包成zip。示例配置：

nightly_build:
  stage: build
  script:
    - autoreconf -i  # 生成Autotools必要文件
    - ./configure
    - make distcheck
  artifacts:
    paths:
      - ./your-project-*.tar.gz  # 匹配生成的tar包，确保只有单个文件
    expire_in: 30d

注意：如果生成的tar包在子目录，要写完整路径（比如./build/your-project.tar.gz），且路径仅匹配这一个文件，不要用通配符匹配多个文件或目录。

c) 如何向发布附加文件而非链接？ #

有两种可靠方式：

1. 使用CI的release关键字（推荐）
   在流水线job中添加release配置，直接指定要附加的tar包文件。GitLab 14.0+支持直接附加文件到发布：

   nightly_release:
     stage: deploy
     script:
       - autoreconf -i
       - ./configure
       - make dist
     release:
       tag_name: nightly-${CI_JOB_STARTED_AT}
       description: "Nightly build generated via make dist"
       assets:
         files:
           - path: ./your-project-*.tar.gz
     artifacts:
       paths:
         - ./your-project-*.tar.gz
       expire_in: 30d
   

   这样生成的tar包会直接作为发布的附件，而非链接。

2. 调用GitLab Release API
   在流水线job中用curl调用API上传文件，适合需要更灵活控制的场景：

   curl --header "PRIVATE-TOKEN: ${CI_JOB_TOKEN}" \
        --upload-file ./your-project.tar.gz \
        "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/releases/nightly-${CI_JOB_STARTED_AT}/assets/links?name=your-project.tar.gz&filepath=/your-project.tar.gz"
   

d) 如何关闭VCS内容的自动分发？ #

进入项目的设置 → 通用 → 可见性、项目特征、权限，找到发布板块，取消勾选「创建发布时自动生成源代码压缩包」选项，保存后即可关闭自动生成Git仓库tar包的功能。

e) GitLab为何采用此机制？ #

GitLab的默认设计是兼顾开发者和终端用户的多元需求：

• 对开发者而言，自动生成的VCS源码包是未经过Autotools处理的原始仓库快照，方便快速拉取代码参与开发，无需本地执行autoreconf等步骤；
• 对终端用户来说，虽然需要预生成的tar包，但GitLab保留该功能是遵循开源项目的常见发布模式——多数开源项目会同时提供原始源码快照和预构建/预生成的发布包，覆盖不同使用场景。另外，默认开启该功能也能避免部分用户因找不到源码包而产生困惑。

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