ppc64le/rust

注意：这是https://hub.docker.com/_/rust的`ppc64le`架构构建的"每架构"仓库——更多信息，请参见官方镜像文档中的https://github.com/docker-library/official-images#architectures-other-than-amd64和官方镜像FAQ中的https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what。

快速参考

• 维护者：
  https://github.com/rust-lang/docker-rust

• 获取帮助：
  https://dockr.ly/comm-slack、Server Fault、https://unix.stackexchange.com/help/on-topic或https://stackoverflow.com/help/on-topic

支持的标签及对应的Dockerfile链接

• https://github.com/rust-lang/docker-rust/blob/7502a8239b3db41eda6017b17aa50067d140d2a7/stable/bookworm/Dockerfile

• https://github.com/rust-lang/docker-rust/blob/7502a8239b3db41eda6017b17aa50067d140d2a7/stable/bookworm/slim/Dockerfile

• https://github.com/rust-lang/docker-rust/blob/7502a8239b3db41eda6017b17aa50067d140d2a7/stable/trixie/Dockerfile

• https://github.com/rust-lang/docker-rust/blob/7502a8239b3db41eda6017b17aa50067d140d2a7/stable/trixie/slim/Dockerfile

• https://github.com/rust-lang/docker-rust/blob/7502a8239b3db41eda6017b17aa50067d140d2a7/stable/alpine3.21/Dockerfile

• https://github.com/rust-lang/docker-rust/blob/7502a8239b3db41eda6017b17aa50067d140d2a7/stable/alpine3.22/Dockerfile

• https://github.com/rust-lang/docker-rust/blob/7502a8239b3db41eda6017b17aa50067d140d2a7/stable/alpine3.23/Dockerfile

快速参考（续）

• 问题提交地址：
  https://github.com/rust-lang/docker-rust/issues?q=

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/rust/、https://hub.docker.com/r/arm32v7/rust/、https://hub.docker.com/r/arm64v8/rust/、https://hub.docker.com/r/i386/rust/、https://hub.docker.com/r/ppc64le/rust/、https://hub.docker.com/r/riscv64/rust/、https://hub.docker.com/r/s390x/rust/

• 发布的镜像工件详情：
  https://github.com/docker-library/repo-info/blob/master/repos/rust（https://github.com/docker-library/repo-info/commits/master/repos/rust）
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Frust
  https://github.com/docker-library/official-images/blob/master/library/rust（https://github.com/docker-library/official-images/commits/master/library/rust）

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/rust（https://github.com/docker-library/docs/commits/master/rust）

什么是Rust？

Rust是由Mozilla研究院赞助的系统编程语言。它旨在成为一种"安全、并发、实用的语言"，支持函数式和命令式-过程式范式。Rust在语法上与C++相似，但设计用于在保持性能的同时提供更好的内存安全。

***.org/wiki/Rust_(programming_language)

如何使用此镜像

启动运行应用的Rust实例

使用此镜像最直接的方式是将Rust容器同时用作构建和运行环境。在Dockerfile中，编写如下内容可编译并运行项目：

dockerfile
FROM docker.xuanyuan.run/ppc64le/rust:1.67

WORKDIR /usr/src/myapp
COPY . .

RUN cargo install --path .

CMD ["myapp"]

然后，构建并运行Docker镜像：

console
$ docker build -t my-rust-app .
$ docker run -it --rm --name my-running-app my-rust-app

这将创建一个包含所有Rust工具的镜像，大小为1.8GB。如果只需要编译后的应用：

dockerfile
FROM docker.xuanyuan.run/rust:1.67 as builder
WORKDIR /usr/src/myapp
COPY . .
RUN cargo install --path .

FROM docker.xuanyuan.run/debian:bullseye-slim
RUN apt-get update && apt-get install -y extra-runtime-dependencies && rm -rf /var/lib/apt/lists/*
COPY --from=builder /usr/local/cargo/bin/myapp /usr/local/bin/myapp
CMD ["myapp"]

注意：可能需要安装一些共享库，如上面extra-runtime-dependencies行所示。

这种方法将创建一个小于200MB的镜像。如果切换到基于Alpine的Rust镜像，可能还能再节省60MB。

有关更多信息，请参见https://docs.docker.com/develop/develop-images/multistage-build/。

在Docker容器内编译应用

有时可能不适合在容器内运行应用。要在Docker实例内编译（而非运行）应用，可以编写如下命令：

console
$ docker run --rm --user "$(id -u)":"$(id -g)" -v "$PWD":/usr/src/myapp -w /usr/src/myapp ppc64le/rust:1.23.0 cargo build --release

这会将当前目录作为卷添加到容器，将工作目录设置为该卷，并运行命令cargo build --release。这将告诉Rust的构建系统Cargo编译myapp中的 crate，并将可执行文件输出到target/release/myapp。

镜像变体

ppc64le/rust镜像有多种版本，每种版本设计用于特定用例。

ppc64le/rust:<version>

这是默认镜像。如果不确定自己的需求，可能需要使用此版本。它设计为既可作为临时容器（挂载源代码并启动容器以运行应用），也可作为构建其他镜像的基础。

某些标签可能包含bookworm或trixie等名称。这些是https://wiki.debian.org/DebianReleases的版本代号，表示镜像基于哪个发行版。如果镜像需要安装除自带包之外的其他包，可能需要显式指定这些代号，以减少Debian新版本发布时的中断。

此标签基于https://hub.docker.com/_/buildpack-deps/。`buildpack-deps`专为拥有多个镜像的Docker普通用户设计。它包含大量极常见的Debian包，减少了派生镜像需要安装的包数量，从而减小系统上所有镜像的总体大小。

ppc64le/rust:<version>-slim

此镜像不包含默认标签中的常见包，仅包含运行ppc64le/rust所需的最小包。除非在仅部署ppc64le/rust镜像且有空间限制的环境中工作，否则强烈建议使用此仓库的默认镜像。

ppc64le/rust:<version>-alpine

此镜像基于流行的https://alpinelinux.org，可在https://hub.docker.com/_/alpine中获取。Alpine Linux比大多数发行版基础镜像小得多（约5MB），因此通常会生成更精简的镜像。

当最终镜像大小尽可能小是主要关注点时，此变体非常有用。需要注意的是，它使用https://musl.libc.org而非https://www.etalabs.net/compare_libcs.html，因此软件可能会因libc要求/假设的深度而遇到问题。有关可能出现的问题以及使用基于Alpine的镜像的优缺点比较，请参见此Hacker News评论线程。

为最小化镜像大小，基于Alpine的镜像通常不包含其他相关工具（如git或bash）。以此镜像为基础，可在自己的Dockerfile中添加所需内容（如果不熟悉如何安装包，请参见https://hub.docker.com/_/alpine/中的示例）。

许可

查看此镜像中包含的软件的https://www.rust-lang.org/en-US/legal.html。

与所有Docker镜像一样，这些镜像可能还包含其他受其他许可约束的软件（如基础发行版中的Bash等，以及主要软件的任何直接或间接依赖项）。

可能在https://github.com/docker-library/repo-info/tree/master/repos/rust中找到一些能够自动检测到的额外许可信息。

对于任何预构建镜像的使用，镜像用户有责任确保对该镜像的任何使用都符合其中包含的所有软件的相关许可。