Docker Rust应用开发指南：从本地开发到容器化部署

滑隽蔚Maia

于 2025-06-10 09:02:32 发布

阅读量256

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00415/article/details/148549223

Docker Rust应用开发指南：从本地开发到容器化部署

docs Source repo for Docker's Documentation 项目地址: https://gitcode.com/gh_mirrors/docs3/docs

前言

在现代应用开发中，容器化技术已经成为不可或缺的一部分。本文将详细介绍如何使用Docker来开发和运行Rust应用程序，特别是与PostgreSQL数据库交互的场景。通过本指南，您将掌握Docker在Rust开发中的核心应用技巧。

准备工作

在开始之前，请确保您已完成以下准备工作：

已安装最新版本的Docker Desktop
熟悉Docker基本概念和操作
已安装git客户端工具（命令行或图形界面均可）

核心概念解析

容器化数据库的优势

传统方式下，我们需要手动下载、安装和配置PostgreSQL数据库。而使用Docker容器化技术，我们可以：

通过官方PostgreSQL镜像快速启动数据库服务
使用Docker卷(db-data)持久化存储数据
通过自定义网络(postgresnet)实现容器间通信
通过环境变量轻松配置数据库参数

开发环境架构

我们的开发环境将包含两个主要组件：

数据库服务：运行在容器中的PostgreSQL实例
Rust应用服务：处理业务逻辑的Rust后端应用

这两个服务通过Docker网络相互通信，数据则通过Docker卷持久化存储。

详细实施步骤

第一步：设置数据库容器

创建数据卷：
```
docker volume create db-data
```
这个命令创建了一个名为db-data的Docker管理卷，用于持久化数据库数据。
创建专用网络：
```
docker network create postgresnet
```
这个用户定义的桥接网络提供了DNS解析服务，方便容器间通过名称相互访问。

启动PostgreSQL容器：

docker run --rm -d \
  --mount "type=volume,src=db-data,target=/var/lib/postgresql/data" \
  -p 5432:5432 \
  --network postgresnet \
  --name db \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -e POSTGRES_DB=example \
  postgres

这个命令启动了PostgreSQL容器，配置了数据卷、网络端口和必要的环境变量。

验证数据库连接：
```
docker exec -it db psql -U postgres
```
这个命令连接到容器内的PostgreSQL实例，验证数据库是否正常运行。

第二步：准备Rust应用

获取示例代码：使用git克隆示例Rust应用代码库。
初始化Docker配置：
```
docker init
```
这个交互式命令会生成基本的Docker配置文件，包括：
- .dockerignore
- Dockerfile
- compose.yaml
- README.Docker.md
定制Dockerfile：示例应用包含数据库迁移文件(migrations目录)，需要在构建阶段将这些文件绑定挂载到容器中。更新Dockerfile，添加对migrations目录的支持。

关键修改点：
```
RUN --mount=type=bind,source=migrations,target=migrations \
```
这个修改确保数据库迁移文件在构建时可用。
构建应用镜像：
```
docker build -t rust-backend-image .
```

第三步：运行应用容器

启动应用容器：

docker run \
  --rm -d \
  --network postgresnet \
  --name docker-develop-rust-container \
  -p 3001:8000 \
  -e PG_DBNAME=example \
  -e PG_HOST=db \
  -e PG_USER=postgres \
  -e PG_PASSWORD=mysecretpassword \
  -e ADDRESS=0.0.0.0:8000 \
  -e RUST_LOG=debug \
  rust-backend-image

注意这里通过环境变量配置了数据库连接参数。