rules_distroless

Bazel 获取 Debian 软件包的规则

该规则集旨在替换apt-get install 、 passwd 、 groupadd 、 useradd 、 update-ca-certificates等命令。

笔记

rules_distroless 是一个测试版软件，还没有稳定的公共 API，但许多人已经在生产中使用它。

请参阅采用者部分，了解谁已经在使用它。

用法

我们的示例演示了如何完成典型任务，例如创建新用户组或创建新主目录。

• 组添加
• 密码
• 用户添加--home
• 更新 ca 证书
• 密钥工具
• 从 Debian 存储库 apt-get 安装。
• 从 Ubuntu 存储库 apt-get 安装。

我们还有特定于 distroless 的规则，可能很有用

• 展平：展平多个tar档案。
• os_release：创建/etc/os-release文件
• locale：将/usr/lib/locale剥离得更小。
• dpkg_statusd：在 /var/lib/dpkg/status.d 创建一个软件包数据库，以便扫描仪发现已安装的软件包。

公共API文档

• 用于获取/安装 Debian/Ubuntu 软件包的 apt 存储库规则。
• linux 创建 Linux 特定文件的各种规则。

安装

请参阅发行说明上的安装说明：https://github.com/GoogleContainerTools/rules_distroless/releases

要使用提交而不是发布，您可以指向存储库的任何 SHA。

通过 bzlmod，您可以使用archive_override或git_override 。对于WORKSPACE ，您修改http_archive调用；例如，将 commit abc123与WORKSPACE文件一起使用：

1. 将url = "https://github.com/GoogleContainerTools/rules_distroless/releases/download/v0.1.0/rules_distroless-v0.1.0.tar.gz"替换为 GitHub 提供的源存档，例如url = "https://github.com/GoogleContainerTools/rules_distroless/archive/abc123.tar.gz"
2. 将strip_prefix = "rules_distroless-0.1.0"替换为strip_prefix = "rules_distroless-abc123"
3. 更新sha256 。最简单的方法是注释掉该行，然后 Bazel 将打印一条包含正确值的消息。

请注意，GitHub 源档案对 sha256 稳定性没有强有力的保证，请参阅 https://github.blog/2023-02-21-update-on-the-future-stability-of-source-code-archives-和哈希

贡献

该规则集主要用于支持 distroless。我们可能不会处理不支持此使命的功能请求。然而，如果它们符合项目目标（例如不同的压缩格式），我们将接受通过拉取请求进行完全测试的贡献，并且可能会拒绝不符合项目目标的请求（例如支持非基于deb的打包格式）。

采用者

• distroless：https://github.com/GoogleContainerTools/distroless
• Arize AI：https://www.arize.com

收养者？通过向我们发送拉取请求来添加您的公司。