s390x/rust

注意：这是https://hub.docker.com/_/rust的`s390x`架构构建的"特定架构"仓库——更多信息，请参见官方镜像文档中的"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/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 Research赞助的系统编程语言。它旨在成为一种"安全、并发、实用的语言"，支持函数式和命令式-过程式范式。Rust在语法上类似于C++，但设计用于在保持性能的同时提供更好的内存安全。

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

如何使用此镜像

启动运行应用的Rust实例

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

dockerfile
FROM docker.xuanyuan.run/s390x/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 s390x/rust:1.23.0 cargo build --release

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

镜像变体

s390x/rust镜像有多种版本，每种版本针对特定用例设计。

s390x/rust:<version>

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

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

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

s390x/rust:<version>-slim

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

许可

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

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

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

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