Docker - 设置 Rust
Rust 是一种通用编程语言，提供内存安全、并发和高性能。内存安全保证所有引用始终指向有效的内存；然而，这种内存管理没有垃圾回收器。为了同时强制执行内存安全并防止数据竞争，其“borrow checker”（借用检查器）会在编译期间跟踪程序中所有引用的对象生命周期。
Docker 则是一个用于开发、运送和运行容器化应用的平台。它提供了一种将应用及其依赖项打包成一个单元的方法，从而保证应用在不同环境中运行的一致性。
为什么需要将 Rust 应用 Docker 化？
- Portability（可移植性） − 它允许您将 Rust 应用及其依赖项打包到一个 container 中，从而便于在不同系统上部署和运行。
- Isolation（隔离性） − Container 提供沙箱环境，避免不同应用之间的冲突。
- Reproducibility（可重现性） − 使用相同的 Docker Image，您可以轻松重现和扩展应用实例及其环境配置。
- Efficiency（效率） − 由于 Docker container 可以快速启动和关闭，它们在微服务架构中非常有用。
Docker 化 Rust 的先决条件
在开始之前，请确保已安装以下内容 −
- Rust − 您可以从 https://www.rust-lang.org/ 下载并安装 Rust 编译器。
- Docker − 您可以从 https://www.docker.com/ 下载并安装 Docker Desktop 或 Docker Engine。
- A Code Editor（代码编辑器） − 您可以选择喜欢的代码编辑器，例如 Visual Studio Code、IntelliJ IDEA 或 Vim。
设置 Rust 核心项目
- 打开您的终端或命令提示符。
- 导航到所需的目录。
- 使用 cargo new 命令创建一个新的 Rust 项目。
$ cargo new my-rust-app
运行此命令后，它将创建一个名为 my-rust-app 的新目录，包含基本的 Rust 项目结构。
项目结构
该项目目录将具有以下结构 −
my-rust-app/
Cargo.toml
src
main.rs
Cargo.toml − 此文件包含项目元数据，包括依赖项和版本信息。
src/main.rs − 这是主要源文件，您将在其中编写 Rust 代码。
添加基本的 Rust 程序
让我们为演示目的创建一个基本的 Rust 程序。您可以打开 src/main.rs 文件，并将内容替换为以下代码 −
fn main() {
println!("Hello, world!");
}
运行这个简单程序时，它会在控制台打印“Hello, world!”。
在本地运行 Rust 项目
要在本地运行项目，您可以导航到项目目录并运行以下命令 −
$ cargo run
运行上述命令后，它将编译 Rust 代码并运行可执行文件。您可以在终端中看到输出“Hello, world!”。
创建 Dockerfile
正如我们在前几章中已经讨论过的，Dockerfile 是一个包含构建 Docker image 指令的文本文档。在这里，我们定义基础 image、依赖项以及创建可运行 container 所需的所有命令。
创建新的 Dockerfile
在你的 Rust 项目的根目录中创建一个名为 Dockerfile 的新文件。
定义基础 Image
Rust 应用程序的流行选择是 rust:alpine image。它提供了一个轻量级的 Alpine Linux 环境，包含 Rust 编译器和标准库。
将基础 image 添加到你的 Dockerfile 中 −
FROM rust:alpine
复制项目文件
下一个指令是将项目目录的内容复制到 container 中 −
COPY . /app
此指令将复制整个项目，包括 Cargo.toml 文件和 src 目录，到 container 中的 /app 目录。
设置工作目录
将工作目录设置为 /app 目录 −
WORKDIR /app
构建 Rust 应用程序
下一个指令是运行 cargo build 命令来构建你的 Rust 应用程序：
RUN cargo build --release
此指令将帮助你在 release 模式下编译 Rust 代码，从而优化其性能。
暴露端口（可选）
如果你的应用程序监听特定端口，你可以暴露它 −
EXPOSE 8080
你可以将 8080 替换为你的应用程序实际使用的端口。
定义入口点
现在你可以指定 container 启动时运行的命令 −
ENTRYPOINT ["target/release/your-app-name"]
请将 your-app-name 替换为你的编译 Rust 可执行文件的实际名称。
完整的 Dockerfile 示例
FROM rust:alpine COPY . /app WORKDIR /app RUN cargo build --release EXPOSE 8080 ENTRYPOINT ["target/release/my-rust-app"]
将上面的内容复制到你的 Dockerfile 中。
构建 Rust Docker Image
现在你已经创建了 Dockerfile，就可以构建 Rust Docker image 了。
构建 Image
打开你的终端或 cmd，并导航到你的项目目录。
运行下面的 docker build 命令 −
$ docker build -t my-rust-app .
"-t my-rust-app" − 命令的这一部分指定了你的 Docker image 的标签。你可以将 my-rust-app 替换为任何想要的名称。
"."：这个点表示 Dockerfile 位于当前目录中。
验证 Image
如果你想验证 image 是否已成功构建，可以运行以下命令列出所有 Docker image −
$ docker images
你可以在列表中看到我们新创建的 my-rust-app image。
将 Image 推送到 Registry（可选）
如果你想与他人分享你的 Docker image 或将其部署到生产环境，你可以轻松地将它推送到 Docker registry，如 Docker Hub、Amazon ECR 或 Google Container Registry。
例如，要将你的 image 推送到 Docker Hub，你需要创建一个 Docker Hub 账户并登录 −
$ docker login
然后，你可以将 image 推送到你的 Docker Hub 仓库 −
$ docker push your-docker-hub-username/my-rust-app
你可以将 your-docker-hub-username 替换为你的实际 Docker Hub 用户名。
运行 Rust Docker Container
现在你已经为 Rust 应用程序准备好了 Docker Image，就可以将其作为 container 运行了。
运行 Container
$ docker run -p 8080:8080 my-rust-app
-p 8080:8080 − 此标志帮助你将主机上的 8080 端口映射到 container 内部的 8080 端口。
my-rust-app − 它指定了你的 Docker image 的名称。
其他命令
列出运行中的 container：
docker ps
停止 container：
docker stop <container_id>
删除 container：
docker rm <container_id>
删除 image：
docker rmi <image_id>
按照这些步骤操作后，你就成功地将 Rust 应用程序 Dockerized，现在可以将其部署到不同的环境中了。
结论
在本章中，我们学习了如何将 Rust 应用程序 Dockerize。首先，我们在 Rust 中创建了一个简单的项目，然后制作了一个 Dockerfile，用于定义镜像内部内容以及镜像的配置方式。然后，构建 Docker image 并最终在 Docker container 中运行它。
作为您开发之旅的下一步，您可以研究高级 Docker 主题，例如 multi-stage builds、Docker Compose，以及其他 container orchestration 工具如 Kubernetes。
关于 Dockerizing Rust 应用程序的常见问题解答
关于 dockerizing Rust 应用程序有一些非常常见的 FAQ，本节将简要回答它们。
1. 如何在 Dockerized Rust 应用程序中处理依赖项？
使用 cargo 来管理您的 Rust 项目的依赖项。cargo.lock 文件将依赖项锁定到特定版本，这将确保构建的一致性。在创建 Docker image 时，cargo 命令将自行解析依赖项并下载它们。
2. Dockerizing Rust 应用程序的最佳实践是什么？
首先，使用应用程序所需的最小 base image，通过传递 environment variables 优化构建过程，并利用 multi-stage builds。出于安全考虑，使用 non-root user，并使用 .dockerignore 文件排除不必要的文件。
3. 如何提升 Dockerized Rust 应用程序的性能？
通过优化 base image 并编译应用程序的 release binary，使您的 Dockerized Rust 应用程序非常快速。对其进行 profiling 以揭示应用程序的瓶颈。除此之外，可以尝试不同的 Docker image layers 方法和 build caching。