Source release: ship only the top-level LICENSE and NOTICE, not the subdirectory copies
还没有人认领这个 Issue。
评估
- 难度
- 5/5
- 预计耗时
- 一周以上
- 新手友好度
- 35/100
- Issue 类型
- 缺陷
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- docker
- 领域
- build-system, release
调研方向
Start with no-release.txt and the listed Dockerfiles, especially oplugins-op/Dockerfile, streamer/Dockerfile, admin-api/Dockerfile, and the runtime image Dockerfiles. Trace how source archives and image builds consume the license files, then verify that the source tarball contains only the intended top-level files while image builds still receive their required licensing files.
由索引模型根据 Issue 内容生成。
描述
The 0.9.0-incubating-RC7 source release (apache-openserverless-0.9.0-incubating-src.tar.gz) contains the top-level LICENSE, NOTICE and DISCLAIMER, plus 85 more LICENSE/NOTICE/DISCLAIMER files in subdirectories. They come from the submodules and from each runtime image directory:
- one set per submodule:
admin-api/,build/,cli/,devcontainer/,oplugins/,oplugins-op/,runtimes/,streamer/,testing/; - one set per runtime image:
runtimes/runtime/{go,java,nodejs,python}/*/andruntimes/experimental/*/; build/openwhisk/LICENSE.txt,NOTICE.txtandlicenses/LICENSE-spray.txt(from the vendored OpenWhisk sources);cli/tests/oplugins/LICENSE(test data).
Together they run to about 94,000 lines (runtimes/LICENSE alone is 37,204 lines).
Please ship only the top-level LICENSE and NOTICE in the source release, and leave the subdirectory ones out (e.g. via no-release.txt).
Why
For the source release, the top-level LICENSE and NOTICE are the ones that count. The subdirectory files mostly describe something else: the container images built from each directory, which bundle OS packages, language runtimes and dependencies that are not in the source release. Shipping them in the source tarball is confusing for users and reviewers, who cannot tell which file applies to what. It also means the same facts are maintained in many places, and they have already drifted apart. In RC7:
oplugins/LICENSEandoplugins-op/LICENSEstate that the source distribution "is licensed in its entirety under the Apache License, Version 2.0". The top-levelLICENSEcorrectly lists MIT, ISC and BSD-3-Clause code in the source (the pre-built JavaScript bundles), and there is more that is not yet listed (#260).- 20 of the subdirectory
LICENSE/NOTICEfiles refer readers to aWARNfile, butno-release.txtremoves everyWARNfile from the source release. - 19 of the subdirectory
NOTICEfiles sayCopyright 2024 The Apache Software Foundation; the top-levelNOTICEand 8 others sayCopyright 2024-2026. oplugins-op/LICENSEsays the operator bundlesgradlew/gradlew.batandConcurrentMapBackedCache.scala; neither exists underoplugins-op/.- Third-party content that should be attributed (cert-manager #263, Kvrocks #262, Milvus #260) is missing from the subdirectory files as well as the top-level ones. So there are two places to fix instead of one, and no place that is complete.
With only the top-level files, there is one place to review and keep correct for each release.
Things to handle
- Image builds use these files. 26 Dockerfiles
COPYtheir directory'sDISCLAIMER LICENSE NOTICEinto the image (e.g.oplugins-op/Dockerfile:152,streamer/Dockerfile:30,admin-api/Dockerfile:47, everyruntimes/runtime/*/*/Dockerfile,build/standalone/Dockerfile:47). The images do need their ownLICENSE/NOTICE(as convenience binaries), so dropping the files from the source tarball needs one of:- generate the image
LICENSE/NOTICEat image build time (they are largely derived from the image contents anyway); or - keep them in git but outside the source release, and have the image build (CI) supply them; or
- if they must stay in the source tree, rename them (e.g.
LICENSE-image,NOTICE-image) and add a first line saying they describe the container image, not the source, so they are not mistaken for the source release's licensing.
- generate the image
- The top-level
LICENSEpoints atbuild/openwhisk/licenses/LICENSE-spray.txt. Either keep that one file, or inline the Spray licence text in the top-levelLICENSE. The Spray licence is Apache-2.0, already reproduced there. build/openwhisk/LICENSE.txt/NOTICE.txtare the vendored OpenWhisk project's own files. The top-levelNOTICEalready carries the OpenWhisk attribution, so they can go too.- Optional: the same applies to the 27 subdirectory
DISCLAIMERfiles, which duplicate the top-levelDISCLAIMER.
Related: #260, #262, #263, #267.
- 主要语言
- Python
- 星标
- 576
- 派生
- 29
- 平均合并
- 3 天 39 分钟
- 30 天内合并 PR
- 5
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
apache/openserverless 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 85/100
apache/openserverless#269 ·
-
难度 2/5 1-3 小时 新手友好度 84/100
apache/openserverless#267 ·
-
难度 5/5 一周以上 新手友好度 8/100
apache/openserverless#273 · 2 条评论 ·
-
难度 4/5 1-2 天 新手友好度 42/100
apache/openserverless#271 · 1 条评论 ·
-
enhancement
难度 5/5 一周以上 新手友好度 25/100
apache/openserverless#215 ·
查看 apache/openserverless 的全部 Issue
相似的 Issue
-
customer-reported question
难度 2/5 1-3 小时 新手友好度 62/100
Azure/azure-sdk-for-python#49548 · 1 条评论 · 1 个 reaction ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 88/100
btclib-org/btclib-wallet#409 ·
维护者通常 1 天内回复
-
Phase 2 PSA Capability & Career Profile
难度 2/5 1-3 小时 新手友好度 62/100
bcgov/digital-journeys#2310 ·
-
bug good first issue
难度 2/5 1-3 小时 新手友好度 78/100
fastmachinelearning/hls4ml#1582 ·
维护者通常 3 天内回复
-
Sort models未关闭enhancement good first issue
难度 2/5 1-3 小时 新手友好度 62/100
维护者通常 1 天内回复