使用 Docker Compose 编排 Django 应用

2025/10/8 4:39:49 来源：https://blog.csdn.net/m0_65621281/article/details/139458464 浏览: 次关键词：使用 Docker Compose 编排 Django 应用

1. 使用 Docker Compose 编排 Django 应用

1.1 准备工作

确保已安装 Docker 和 Docker Compose。

# 安装
$ sudo pip install -U docker-compose#卸载
$ sudo pip uninstall docker-compose

创建一个新的目录来存放项目文件。
在该目录下创建一个名为 requirements.txt 的文件，并列出Django 项目所需的 Python 库。

1.2 创建 Dockerfile

在项目目录下创建一个名为 Dockerfile 的文件，并添加以下内容：

FROM python:3
ENV PYTHONUNBUFFERED 1
RUN mkdir /code
WORKDIR /code
COPY requirements.txt /code/
RUN pip install -r requirements.txt
COPY . /code/

1.3 创建 docker-compose.yml 文件

在项目目录下创建一个名为 docker-compose.yml 的文件，并添加以下内容：

version: "3"
services:db:image: postgresenvironment:POSTGRES_PASSWORD: 'postgres'web:build: .command: python manage.py runserver 0.0.0.0:8000volumes:- .:/codeports:- "8000:8000"

1.4 启动Django 应用

$ docker-compose run web django-admin startproject django_example .

由于 web 服务所使用的镜像并不存在，所以 Compose 会首先使用 Dockerfile 为 web 服务构建一个镜像，接着使用这个镜像在容器里运行 django-admin startproject django_example 指令。

这将在当前目录生成一个 Django 应用。

$ ls
Dockerfile       docker-compose.yml          django_example       manage.py       requirements.txt

首先，我们要为应用设置好数据库的连接信息。用以下内容替换 django_example/settings.py 文件中 DATABASES = … 定义的节点内容.


DATABASES = {'default': {'ENGINE': 'django.db.backends.postgresql','NAME': 'postgres','USER': 'postgres','HOST': 'db','PORT': 5432,'PASSWORD': 'postgres',}
}

1.5 运行Docker Compose

在项目目录下打开终端，并运行以下命令：

docker-compose up

这将构建并启动 Django 应用和数据库容器。

1.5 访问 Django 应用

这个 Django 应用已经开始在你的 Docker 守护进程里监听着 8000 端口了。打开 127.0.0.1:8000 即可看到 Django 欢迎页面。

6. 其他配置

可以根据需要修改 docker-compose.yml 文件，例如：

添加其他服务，例如 Nginx 或 Redis。
配置环境变量。
调整资源限制。

2. docker-compose.yml 文件解释

Docker Compose 文件解释

Docker Compose 文件定义了一个包含两个服务的应用：

db: 该服务使用 postgres 镜像启动一个 PostgreSQL 数据库容器。
web: 该服务使用当前目录（.) 构建一个 Docker 镜像，并运行 python manage.py runserver 0.0.0.0:8000 命令启动一个 Web 应用程序容器。

以下是 Docker Compose 文件的详细解释：

version: 指定 Docker Compose 文件的版本。本例中使用的是版本 3。

services: 定义应用程序中的服务。本例中定义了两个服务：db 和 web。

db: 定义 db 服务的配置：

image: 指定使用的 Docker 镜像。本例中使用 postgres 镜像。
environment: 设置环境变量。本例中设置 POSTGRES_PASSWORD 环境变量为 postgres。

web: 定义 web 服务的配置：

build: 指定构建 Docker 镜像的上下文目录。本例中使用当前目录（.）。
command: 指定运行容器时要执行的命令。本例中执行 python manage.py runserver 0.0.0.0:8000 命令启动 Web 应用程序。
volumes: 将宿主机的目录挂载到容器中。本例中将当前目录（.）挂载到容器的 /code 目录。
ports: 将容器的端口映射到宿主机的端口。本例中将容器的 8000 端口映射到宿主机的 8000 端口。