Packaging: the two release lanes disagree on shipping the GPL license text — team decision needed

已关闭
#751 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 2 天内回复

已经有一个关联 PR 被合并了。

  • #787 来自 @Amperstrand —— 已合并

评估

难度
5/5
预计耗时
一周以上
新手友好度
25/100
Issue 类型
功能
描述清晰度
需要澄清
活跃度
活跃
技术栈
go
领域
build-system

调研方向

Read packaging/local-build-ipk.sh and packaging/Makefile to verify the stated packaging difference. The issue explicitly leaves the policy choice to the team, so wait for a decision before changing either lane; done means implementing the chosen outcome and updating equivalence handling if needed.

由索引模型根据 Issue 内容生成。

描述

Migrated from Amperstrand/tollgate-module-basic-go#92 as part of the fork retirement — OpenTollGate/tollgate-module-basic-go is the single source of truth; the fork issue carries the original discussion and any lab evidence. Retirement plan: see the tracking issue linked in the migration comment there.]

Factual divergence (no recommendation attached — decision for the team)

Surfaces from the SDK-vs-SDK-free equivalence spike on main @ d0cb92f (context: upstream OpenTollGate#371, #383).

The two packaging lanes stage the license text differently:

Lane License handling
SDK-free .ipk (packaging/local-build-ipk.sh) Installs the GPL-3.0 text into the payload as /usr/share/doc/tollgate-wrt/LICENSE
SDK .apk (packaging/Makefile, the CI apk lane) Metadata only (PKG_LICENSE:=GPL-3.0-only, PKG_LICENSE_FILES:=LICENSE); no license text inside the package

Consequences (why it needs an explicit decision rather than a silent fix):

  1. Content divergence between formats: .ipk artifacts ship the license text; .apk artifacts built by CI do not. Same version, different contents.
  2. Blocks byte-equivalence between the lanes — this single file (~35 KB GPL text) is the only content difference the spike found between the two staging lists (everything else matches).
  3. GPL-distribution relevance: shipping the text alongside the binary is the compliance-conservative direction; OpenWrt feed packages commonly rely on metadata instead. Both positions are defensible — this is precisely not a call for an agent to make.

Possible outcomes (listed neutrally):

  • Add the install line to packaging/Makefile → both lanes ship it (.apk grows ~35 KB)
  • Remove the install from local-build-ipk.sh → neither ships the text, metadata only
  • Keep as-is and document the divergence (equivalence tooling then treats it as a known, allowed delta)

Until decided, the equivalence tooling mirrors the SDK lane (the designated oracle) and reports this delta loudly with a link here.

主要语言
Go
星标
12
派生
14
平均合并
4 天 19 小时
30 天内合并 PR
213

环境准备

  • 没有 Dockerfile 或 Docker Compose 文件
  • 没有 Pull Request 模板
  • 阅读贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

OpenTollGate/tollgate-module-basic-go 的其他 Issue

查看 OpenTollGate/tollgate-module-basic-go 的全部 Issue

相似的 Issue

更多 Go Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。