blob

blob 功能允许使用 Azure Blob 存储 作为后端。

• 必须为 -u | --url 参数提供一个 URL，其形式必须如下 blob://<container_name>(/<prefix>)?
• 必须通过环境变量 STORAGE_ACCOUNT 和 STORAGE_MASTER_KEY 提供的 Azure 存储帐户，这些变量在 此处 描述。

示例

这是一个来自我们 CI 的内部项目的示例。

依赖项

• 424 个 crates.io crates：缓存的 - 38MB，解包的 - 214MB
• 13 个来自 10 个 Git 仓库的 crates 源：数据库 - 27MB，检出 - 38MB

场景

以下 CI 作业并行运行，每个作业都在 GKE 上运行的 Kubernetes 作业中运行。容器基础与官方 rust:1.39.0-slim 镜像大致相同。

• 构建 WASM 模块
• 构建本地模块
• 构建本地主机客户端

~ 等待所有作业完成 ~

• 从主机客户端运行 WASM 和本地模块的测试

之前

所有 3 个构建作业每个大约需要 1m2s 来执行 cargo fetch --target x86_64-unknown-linux-gnu

之后

所有3个构建任务每个都需要 3-4秒 来执行 cargo fetcher --include-index sync。

用法

cargo-fetcher 只有 2 个子命令。它们都共享一组选项，每个后端的重要输入在 存储后端 中描述。

除了后端的具体信息外，唯一必需的可选参数是你正在操作 Cargo.lock 锁文件的路径。 cargo-fetcher 需要一个锁文件，否则，生成锁文件的正常 cargo 工作需要本地有一个完整的索引库，这部分抵消了此工具的意义。

-l, --lock-file <lock-file>
    Path to the lockfile used for determining what crates to operate on [default: Cargo.lock]

mirror

mirror 子命令负责从原始位置下载 crate 和索引库，并将它们重新上传到你的存储后端。

它还有一个附加选项，用于确定它应该多频繁地拍摄索引库的快照。

-m, --max-stale <max-stale>
    The duration for which the index will not be replaced after its most recent update.

    Times may be specified with no suffix (default days), or one of:
    * (s)econds
    * (m)inutes
    * (h)ours
    * (d)ays

自定义仓库

镜像的一个问题是自定义仓库的存在。为了处理这些问题，cargo fetcher 使用与 cargo 相同的逻辑来定位 .cargo/config<.toml> 配置文件来检测自定义仓库，但是，cargo 的配置文件仅包含从仓库获取和发布所需的数据，而下载 crate 的 URL 模板实际上位于仓库根目录下的 config.json 文件中。

而不是等待下载仓库索引，然后再获取该仓库的任何 crate，cargo-fetcher 允许您通过环境变量自行指定下载位置，这样它就可以完全并行化索引库和 crate 的获取。

示例

# .cargo/config.toml

[registries]
embark = { index = "<secret url>" }

环境变量形式为 CARGO_FETCHER_<name>_DL，其中 name 是配置文件中仓库的同名（大写）名称。

CARGO_FETCHER_EMBARK_DL="https://secret/rust/cargo/{crate}-{version}.crate" cargo fetcher mirror

URL 的 格式 应与您的仓库 config.json 文件中的格式相同。如果未指定您的仓库，则默认的 /{crate}/{version}/download 将附加到仓库的 URL 上。

sync

sync 子命令实际上是 cargo fetch 的替代品，但它不是从常规位置下载 crate 和注册表，而是从您的存储后端下载，并以与 cargo 相同的方式将它们分散到磁盘上，这样 cargo 就可以在开始构建代码之前不进行任何实际工作。

贡献

我们欢迎社区为此项目做出贡献。

请阅读我们的贡献指南，了解更多关于如何开始的详细信息。

许可证

许可协议为以下之一

• Apache许可证2.0版（LICENSE-APACHE或https://apache.ac.cn/licenses/LICENSE-2.0）
• MIT许可证（LICENSE-MIT或http://opensource.org/licenses/MIT）

任选其一。

贡献

除非您明确表示，否则根据Apache-2.0许可证定义，您有意提交以包含在作品中的任何贡献，应如上双许可，不附加任何额外条款或条件。