ci-mirrors:基于 Rust 生态的 CI 镜像管理工具项目

用户可通过此项目管理 Rust 项目 CI 镜像内容,支持添加新文件到 ci-mirrors.rust-lang.org,通过 TOML 配置定义文件名称、源URL、SHA256 及许可证等信息,确保镜像文件准确性与合规性。【此简介由AI生成】

分支1Tags0
文件最后提交记录最后更新时间
4 天前
3 天前
6 个月前
1 年前
1 年前
1 年前
1 年前
1 年前
27 天前

ci-mirrors 工具

本仓库包含用于管理 ci-mirrors.rust-lang.org 内容的工具。

本仓库的内容根据 MIT 许可证或 Apache 2.0 许可证授权,您可以选择任一许可证。

Warning

ci-mirrors 仅设计用于 Rust 项目管理的仓库。我们不对第三方提供任何保证。

上传新文件

要将新文件上传到 ci-mirrors,请打开一个新的 PR,在 files/ 目录下的某个 TOML 文件中添加一个新条目。每个条目具有以下模式:

  • name:文件在 ci-mirrors 上的名称。可以使用斜杠定义层次结构,例如在文件名前加上使用它的仓库作为前缀。

  • source:要镜像的原始文件的 URL。工具将自动从此处下载文件,因此请确保无需用户交互或 JavaScript 即可开始下载。会跟随重定向。

  • sha256:要镜像文件的 SHA256。如果镜像文件与哈希不匹配,上传将失败。

  • license:文件的许可信息。这是一个自由格式字段:对于从开源代码构建的工件,您应填写许可证标识符;对于其他所有内容,您应提供许可条款的链接。

  • rename-from:如果 source 文件的名称与 name 不同,则需要添加此字段,以使用 source 中的文件名明确标记这是预期情况。

您可以通过手动修改 files 目录中的 TOML 文件,或使用以下命令来添加新条目:

$ cargo run -- add-file <source-url> --path <cdn-name> --toml-file <path-to-toml-file> [--license <license>]

一旦 PR 合并,该文件将可在以下位置获取:

https://ci-mirrors.rust-lang.org/${name}

Note

部分文件标记了 legacy = true,且没有源文件或许可证。这些文件是在本工具引入之前添加到 ci-mirrors 中的。不应再将新文件标记为 legacy = true

修改或删除已上传文件

目前不支持修改或删除已上传文件。执行此操作会破坏当前依赖该文件的仓库。如果您确实需要执行此操作,请在 Zulip 上联系基础架构团队。

Note

ci-mirrors 的存储空间无需担心。如果您需要上传文件的新版本,只需单独添加新版本,无需删除旧版本。

项目介绍

用户可通过此项目管理 Rust 项目 CI 镜像内容,支持添加新文件到 ci-mirrors.rust-lang.org,通过 TOML 配置定义文件名称、源URL、SHA256 及许可证等信息,确保镜像文件准确性与合规性。【此简介由AI生成】

定制我的领域