Docker Compose 搭建 Django 示例项目

准备工作

创建一个空的项目目录。可以将目录命名为易于记忆的名称。此目录是应用程序映像的上下文。该目录应该只包含构建该图像的资源。
在项目目录中创建一个名为Dockerfile的新文件。 Dockerfile 通过一个或多个配置该映像的构建命令定义应用程序的映像内容。构建后，您可以在容器中运行映像。
将以下内容添加到Dockerfile。
```
 # syntax=docker/dockerfile:1
 FROM python:3
 ENV PYTHONDONTWRITEBYTECODE=1
 ENV PYTHONUNBUFFERED=1
 WORKDIR /code
 COPY requirements.txt /code/
 RUN pip install -r requirements.txt
 COPY . /code/
```
这个Dockerfile从Python3父图像开始。通过添加新code目录来修改父图像。通过安装requirements.txt文件中定义的 Python 要求进一步修改父映像。
保存并关闭Dockerfile。
在项目目录中创建一个requirements.txt文件。此文件被Dockerfile中RUN pip install -r requirements.txt使用.
在文件中添加所需的软件。
```
 Django>=3.0,<4.0
 psycopg2>=2.8
```
保存并关闭requirements.txt文件。
在项目目录中创建一个名为docker-compose.yml的文件。

该docker-compose.yml文件描述了制作您的应用程序的服务。在此示例中，这些服务是 Web 服务器和数据库。 compose 文件还描述了这些服务使用哪些 Docker 映像、它们如何链接在一起、它们可能需要安装在容器内的任何卷。最后，该docker-compose.yml文件描述了这些服务公开的端口。

将以下配置添加到文件中。

 version: "3.9"
       
 services:
   db:
     image: postgres
     volumes:
       - ./data/db:/var/lib/postgresql/data
     environment:
       - POSTGRES_DB=django
       - POSTGRES_USER=django
       - POSTGRES_PASSWORD=django
   web:
     build: .
     command: python manage.py runserver 0.0.0.0:8000
     volumes:
       - .:/code
     ports:
       - "8000:8000"
     environment:
       - POSTGRES_NAME=django
       - POSTGRES_USER=django
       - POSTGRES_PASSWORD=django
     depends_on:
       - db

该文件定义了两个服务：db服务和web服务。这里使用内置开发服务器在端口8000上运行应用程序，不要在生产环境中使用它。

保存并关闭docker-compose.yml文件。

创建Django项目

切换到项目目录的根目录。
通过运行docker-compose run命令创建 Django 项目，如下所示。
```
 sudo docker-compose run web django-admin startproject composeexample .
```
这指示 Compose使用服务的映像和配置django-admin startproject composeexample 在容器中运行。 web由于web图像尚不存在，Compose 从当前目录构建它，如build: ..docker-compose.yml 构建服务映像后web，Compose 将运行它并 django-admin startproject在容器中执行命令。此命令指示 Django 创建一组代表 Django 项目的文件和目录。
docker-compose命令完成后，执行ls -l命令列出项目的内容。如果您在 Linux 上运行 Docker，则django-admin创建的文件归 root 所有。发生这种情况是因为容器以 root 用户身份运行。如果您在 Mac 或 Windows 上运行 Docker，您应该已经拥有所有文件的所有权，包括由 django-admin。
更改新文件的所有权。
```
 sudo chown -R $USER:$USER composeexample manage.py
```
请勿更改 Postgres 文件所在的 data 文件夹的权限，否则 Postgres 将因权限问题无法启动。

连接数据库

在您的项目目录中，编辑该composeexample/settings.py文件。

替换以下内容。

 # settings.py
    
 import os
       
 [...]
 ALLOWED_HOSTS = ['*']
 [...]
    
 DATABASES = {
     'default': {
         'ENGINE': 'django.db.backends.postgresql',
         'NAME': os.environ.get('POSTGRES_NAME'),
         'USER': os.environ.get('POSTGRES_USER'),
         'PASSWORD': os.environ.get('POSTGRES_PASSWORD'),
         'HOST': 'db',
         'PORT': 5432,
     }
 }

这些设置是由docker-compose.yml中指定的postgres Docker映像决定的。

保存并关闭文件。
从项目的顶级目录运行docker-compose up命令。
```
 docker-compose up
```
此时，Django 应用程序应该在 Docker 主机上的8000端口上运行。在适用于 Mac 的 Docker Desktop 和适用于 Windows 的 Docker Desktop 上，Web 浏览器打开http://localhost:8000以查看 Django 欢迎页面。
列出正在运行的容器。在另一个终端窗口中使用docker ps或docker container ls命令列出正在运行的 Docker 进程。
使用以下任一方法关闭服务并进行清理：
1. 在与启动项目的相同终端窗口键入Ctrl-C来停止应用程序：
2. 为了更优雅的关闭，切换到不同的终端窗口，然后在 Django 示例项目目录的顶层下运行docker-compose down。

Docker Compose 搭建 Django 示例项目

......

准备工作

创建Django项目

连接数据库

CATALOG