ekidd/rust-musl-builder

rust-musl-builder：轻松构建静态Rust二进制文件的Docker容器

• https://github.com/emk/rust-musl-builder
• https://github.com/emk/rust-musl-builder/blob/master/CHANGELOG.md

更新说明：此版本有重大更新，可能会中断某些构建。详情参见https://github.com/emk/rust-musl-builder/blob/master/CHANGELOG.md%E3%80%82%E5%A6%82%E6%9E%9C%E8%BF%99%E4%BA%9B%E6%9B%B4%E6%96%B0%E5%AF%BC%E8%87%B4%E6%9E%84%E5%BB%BA%E4%B8%AD%E6%96%AD%EF%BC%8C%E5%8F%AF%E5%B0%86%60Dockerfile%60%E6%9B%B4%E6%96%B0%E4%B8%BA%60FROM ekidd/rust-musl-builder:1.48.0`以回退到之前的版本。

什么是rust-musl-builder？

该镜像允许使用diesel、sqlx或openssl构建静态Rust二进制文件。这些镜像可作为无依赖的单个可执行文件分发，且应能在任何现代Linux系统上运行。

尝试运行以下命令：

sh
alias rust-musl-builder='docker run --rm -it -v "$(pwd)":/home/rust/src ekidd/rust-musl-builder'
rust-musl-builder cargo build --release

此命令假设$(pwd)可被uid 1000、gid 1000读写。目前不尝试在构建之间缓存库，因此最适合用于制作最终发布构建。

更实际的示例，可参见https://github.com/emk/rust-musl-builder/blob/master/examples/using-diesel%E5%92%8Chttps://github.com/emk/rust-musl-builder/blob/master/examples/using-sqlx%E7%9A%84%60Dockerfile%60%E3%80%82

部署Rust应用程序

幸运的话，你只需从target/x86_64-unknown-linux-musl/release复制应用程序二进制文件，即可直接安装到任何相当现代的x86_64 Linux机器上。特别是，你应该能够使用TravisCI和GitHub制作静态发布二进制文件，或者将Rust应用程序复制到https://hub.docker.com/_/alpine/%E4%B8%AD%E3%80%82%E8%AF%A6%E6%83%85%E5%A6%82%E4%B8%8B%EF%BC%81

可用标签

通常，我们提供以下标记的Docker镜像：

• latest、stable：当前稳定版Rust，现已包含OpenSSL 1.1。我们会在每个新稳定版发布后以及大多数点发布后尽快更新。
• X.Y.Z：特定版本的稳定版Rust。
• beta：通常每六周与稳定版一起更新，通常不会针对beta修复版本更新。
• nightly-YYYY-MM-DD：特定的nightly版本。这些版本几乎总是支持clippy、rls和rustfmt，通过https://rust-lang.github.io/rustup-components-history/index.html%E9%AA%8C%E8%AF%81%E3%80%82%E5%A6%82%E6%9E%9C%E9%9C%80%E8%A6%81%E7%89%B9%E5%AE%9A%E6%97%A5%E6%9C%9F%E4%BB%A5%E5%85%BC%E5%AE%B9%60tokio%60%E6%88%96%E5%85%B6%E4%BB%96%E4%BD%BF%E7%94%A8%E4%B8%8D%E7%A8%B3%E5%AE%9ARust%E7%9A%84%E6%B5%81%E8%A1%8C%E5%BA%93%EF%BC%8C%E8%AF%B7%E6%8F%90%E4%BA%A4issue%E3%80%82

至少，每个镜像应能编译https://github.com/emk/rust-musl-builder/blob/master/examples/using-diesel%E5%92%8Chttps://github.com/emk/rust-musl-builder/blob/master/examples/using-sqlx%E3%80%82

构建缓存

你可以通过在rust-musl-builder别名中添加以下-v命令来提高构建性能：

txt
-v cargo-git:/home/rust/.cargo/git
-v cargo-registry:/home/rust/.cargo/registry
-v target:/home/rust/src/target

还需要修复挂载卷的权限：

sh
rust-musl-builder sudo chown -R rust:rust \
  /home/rust/.cargo/git /home/rust/.cargo/registry /home/rust/src/target

工作原理

rust-musl-builder使用musl-libc、musl-gcc和新的rustuptarget支持。它包含多个库的静态版本：

• 标准musl-libc库。
• OpenSSL，许多Rust应用程序需要。
• libpq，使用diesel与PostgreSQL的应用程序需要。
• libz，libpq需要。
• SQLite3。参见https://github.com/emk/rust-musl-builder/blob/master/examples/using-diesel/%E3%80%82

该库还设置了编译使用这些库的流行Rust crate所需的环境变量。

额外功能

此镜像还支持以下附加功能：

• 使用musl-libc进行armv7的基本编译。但目前并非所有库都支持。
• https://github.com/rust-lang-nursery/mdBook%E5%92%8C%60mdbook-graphviz%60%EF%BC%8C%E7%94%A8%E4%BA%8E%E4%BB%8EMarkdown%E6%96%87%E4%BB%B6%E6%9E%84%E5%BB%BA%E5%8F%AF%E6%90%9C%E7%B4%A2%E7%9A%84HTML%E6%96%87%E6%A1%A3%E3%80%82%E5%8F%AF%E4%B8%8E%60cargo doc`输出一起构建手册！
• https://github.com/EmbarkStudios/cargo-about%EF%BC%8C%E7%94%A8%E4%BA%8E%E6%94%B6%E9%9B%86%E4%BE%9D%E8%B5%96%E9%A1%B9%E7%9A%84%E8%AE%B8%E5%8F%AF%E8%AF%81%E3%80%82
• https://github.com/mmstick/cargo-deb%EF%BC%8C%E7%94%A8%E4%BA%8E%E6%9E%84%E5%BB%BADebian%E8%BD%AF%E4%BB%B6%E5%8C%85%E3%80%82
• https://github.com/EmbarkStudios/cargo-deny%EF%BC%8C%E7%94%A8%E4%BA%8E%E6%A3%80%E6%9F%A5Rust%E9%A1%B9%E7%9B%AE%E7%9A%84%E5%B7%B2%E7%9F%A5%E5%AE%89%E5%85%A8%E9%97%AE%E9%A2%98%E3%80%82

使OpenSSL工作

如果应用程序使用OpenSSL，还需要采取一些额外步骤以确保它能找到OpenSSL的受信任证书列表（不同Linux发行版存储位置不同）。可使用openssl-probe实现，如下所示：

rust
fn main() {
    openssl_probe::init_ssl_cert_env_vars();
    //... 你的代码
}

使Diesel工作

除了设置OpenSSL，还需要在Cargo.toml中添加以下行：

toml
[dependencies]
diesel = { version = "1", features = ["postgres", "sqlite"] }

# SQLite需要
libsqlite3-sys = { version = "*", features = ["bundled"] }

# Postgres需要
openssl = "*"

对于PostgreSQL，还需要在main.rs中按以下顺序包含diesel和openssl（以避免链接错误）：

toml
extern crate openssl;
#[macro_use]
extern crate diesel;

如果这不起作用，可能可以通过颠倒顺序解决。有关链接diesel、pq-sys和openssl-sys的最新问题讨论，请参见https://github.com/emk/rust-musl-builder/issues/69%E3%80%82

使用Travis CI和GitHub制作静态发布版本

这些说明受https://github.com/japaric/rust-cross%E5%90%AF%E5%8F%91%E3%80%82

首先，阅读Travis CI：GitHub Releases上传页面，并按说明运行travis setup releases。然后将以下行添加到现有.travis.yml文件中，将myapp替换为你的包名：

yaml
language: rust
sudo: required
os:
- linux
- osx
rust:
- stable
services:
- docker
before_deploy: "./build-release myapp ${TRAVIS_TAG}-${TRAVIS_OS_NAME}"
deploy:
  provider: releases
  api_key:
    secure: "..."
  file_glob: true
  file: "myapp-${TRAVIS_TAG}-${TRAVIS_OS_NAME}.*"
  skip_cleanup: true
  on:
    rust: stable
    tags: true

接下来，将https://github.com/emk/rust-musl-builder/blob/master/examples/build-release%E5%A4%8D%E5%88%B6%E5%88%B0%E9%A1%B9%E7%9B%AE%E4%B8%AD%E5%B9%B6%E8%BF%90%E8%A1%8C%60chmod +x build-release`。

最后，添加执行实际构建的Dockerfile：

dockerfile
FROM ekidd/rust-musl-builder

# 我们需要将源代码添加到镜像中，因为`rust-musl-builder`假设UID为1000，但TravisCI已切换到2000。
ADD --chown=rust:rust . ./

CMD cargo build --release

当你向项目推送新标签时，build-release将自动使用rust-musl-builder构建新的Linux二进制文件，并使用Cargo构建新的Mac二进制文件，然后将两者上传到仓库的GitHub发布页面。

工作示例参见https://github.com/faradayio/cage%E3%80%82

使用Alpine Linux和Rust二进制文件制作小型Docker镜像

Docker现在支持多阶段构建，可轻松使用rust-musl-builder构建Rust应用程序并使用Alpine Linux部署。工作示例参见https://github.com/emk/rust-musl-builder/blob/master/examples/using-diesel/Dockerfile%E3%80%82

添加更多C库

如果使用需要特定C库的Docker crate，可基于此镜像创建Dockerfile，并使用musl-gcc编译所需库。示例参见https://github.com/emk/rust-musl-builder/blob/master/examples/adding-a-library/Dockerfile%E3%80%82%E9%80%9A%E5%B8%B8%E6%AF%8F%E4%B8%AA%E6%96%B0%E5%BA%93%E9%83%BD%E9%9C%80%E8%A6%81%E4%B8%80%E4%BA%9B%E5%AE%9E%E9%AA%8C%EF%BC%8C%E4%BD%86%E5%AF%B9%E4%BA%8E%E5%A4%A7%E5%A4%9A%E6%95%B0%E7%AE%80%E5%8D%95%E7%9A%84%E7%8B%AC%E7%AB%8B%E5%BA%93%E6%9D%A5%E8%AF%B4%E6%95%88%E6%9E%9C%E5%BE%88%E5%A5%BD%E3%80%82

如果需要特别常用的库，请提交PR将其添加到主Dockerfile中！我们希望开箱即支持流行的Rust crate。

ARM支持（实验性）

要 targeting ARM硬浮点（树莓派）：

sh
rust-musl-builder cargo build --target=armv7-unknown-linux-musleabihf --release

二进制文件将写入target/$TARGET_ARCHITECTURE/release。默认情况下，除非使用--target指定，否则target为x86_64-unknown-linux-musl。

此版本缺少x86_64构建使用的许多库，可能应从基础镜像中拆分并使用自己的标签。

开发说明

修改镜像后，运行./test-image确保一切正常。

构建可移植Rust二进制文件的其他方法

如果由于某种原因此镜像不符合你的需求，还有许多其他人在从事类似项目：

• https://github.com/messense/rust-musl-cross%EF%BC%9A%E5%B1%95%E7%A4%BA%E5%A6%82%E4%BD%95%E4%B8%BA%E5%A4%9A%E7%A7%8D%E6%9E%B6%E6%9E%84%E6%9E%84%E5%BB%BA%E4%BA%8C%E8%BF%9B%E5%88%B6%E6%96%87%E4%BB%B6%E3%80%82
• https://github.com/japaric/rust-cross%EF%BC%9A%E5%8C%85%E5%90%AB%E6%9C%89%E5%85%B3%E5%A6%82%E4%BD%95%E4%BA%A4%E5%8F%89%E7%BC%96%E8%AF%91Rust%E5%BA%94%E7%94%A8%E7%A8%8B%E5%BA%8F%E7%9A%84%E8%AF%A6%E7%BB%86%E8%AF%B4%E6%98%8E%E3%80%82
• https://github.com/clux/muslrust%EF%BC%9A%E4%B9%9F%E6%94%AF%E6%8C%81libcurl%E3%80%82
• https://github.com/golddranks/rust_musl_docker%EF%BC%9A%E5%8F%A6%E4%B8%80%E4%B8%AADocker%E9%95%9C%E5%83%8F%E3%80%82

许可证

https://github.com/emk/rust-musl-builder/blob/master/LICENSE-APACHE.txt%E6%88%96https://github.com/emk/rust-musl-builder/blob/master/LICENSE-MIT.txt%E3%80%82