使用 PostgresSQL 和 Docker 启动新的 Django 项目

在当今的软件开发环境中，使用容器化技术来简化项目的搭建过程越来越流行。Docker 是一个流行的工具，能够帮助开发者快速构建和部署应用程序。在这篇文章中，我们将介绍如何使用 PostgresSQL 和 Docker 来启动一个新的 Django 项目。这将包括安装 Docker，创建 Django 项目，配置数据库以及运行容器的步骤。

环境准备

首先，确保你已经在你的计算机上安装了 Docker。如果尚未安装，请访问 Docker 官方网站 以获取适合你操作系统的安装指南。完成安装后，可以使用以下命令验证 Docker 是否正常工作：

docker --version

安装 Docker Compose

Django 项目通常需要多个服务（如数据库和 Web 服务器），Docker Compose 是一个非常有用的工具，它允许你使用 YAML 文件来定义和管理多个 Docker 容器。你可以通过以下命令安装 Docker Compose：

sudo apt-get install docker-compose

创建 Django 项目

在你选择的目录下，使用下面的命令创建一个新的 Django 项目：

django-admin startproject myproject

进入项目目录：

cd myproject

设置 Django 应用

在项目目录中，你可以创建一个新的 Django 应用。例如，我们命名为 `myapp`：

python manage.py startapp myapp

接下来，在 `settings.py` 文件中，你需要添加 `myapp` 到 `INSTALLED_APPS` 列表中：

# myproject/settings.py

INSTALLED_APPS = [
    ...
    'myapp',
]

创建 Dockerfile 和 Docker Compose 文件

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

# Dockerfile

FROM python:3.9
# 设置工作目录
WORKDIR /usr/src/app
# 安装所需库
COPY requirements.txt ./
RUN pip install --no-cache-dir -r requirements.txt
# 复制项目文件
COPY . .
# 启动 Django 服务器
CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]

接下来，在项目根目录下创建一个 `docker-compose.yml` 文件。这个文件将定义我们的服务，包括 Django 和 Postgres 数据库：

version: '3.8'

services:
  db:
    image: postgres:13
    environment:
      POSTGRES_DB: mydatabase
      POSTGRES_USER: user
      POSTGRES_PASSWORD: password
    volumes:
      - postgres_data:/var/lib/postgresql/data
  web:
    build: .
    ports:
      - "8000:8000"
    depends_on:
      - db
    environment:
      - DJANGO_DB_HOST=db
      - DJANGO_DB_NAME=mydatabase
      - DJANGO_DB_USER=user
      - DJANGO_DB_PASSWORD=password
volumes:
  postgres_data:

配置数据库连接

接下来，我们需要配置 Django 以连接到 Postgres 数据库。首先，在项目的 `settings.py` 文件中，找到 `DATABASES` 配置，并进行如下更改：

# myproject/settings.py

import os
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': os.environ.get('DJANGO_DB_NAME'),
        'USER': os.environ.get('DJANGO_DB_USER'),
        'PASSWORD': os.environ.get('DJANGO_DB_PASSWORD'),
        'HOST': os.environ.get('DJANGO_DB_HOST'),
        'PORT': '5432',
    }
}

构建和运行 Docker 容器

现在，一切都准备好了。首先，通过以下命令构建 Docker 镜像：

docker-compose build

构建完成后，使用以下命令启动容器：

docker-compose up

你应该会看到 Django 服务器在运行，并且你可以通过浏览器访问 http://localhost:8000 来查看你的 Django 项目。如果你创建了超级用户，可以在浏览器中访问管理界面：

http://localhost:8000/admin

总结

本文介绍了如何使用 Docker 和 PostgresSQL 启动一个新的 Django 项目。通过这种方法，你可以在不同的环境中快速设置和运行 Django 应用程序，同时确保依赖项和服务的一致性。这种方法大大简化了开发和部署流程，是现代开发不可或缺的一部分。