使用 Docker 部署 Django + MySQL 8 開發環境

前一段時間重裝了系統，而後我尚未備份，致使電腦裏的開發環境全都沒有了。

一想到又要裝 Python 環境，還要裝數據庫，而後安裝過程當中還可能報一堆錯就頭疼。

最近正在學習 Docker，這不正好解決了我當前的痛點了嗎？並且，不止此次重裝系統，之後再重裝都不怕了，只要拿着 Dockerfile 和 docker-compose 文件，無論到什麼環境，一條命令輕鬆跑起來。

以前部署 Python 開發環境，都是用的 virtualenv，或者是 Pipenv。此次使用 Docker 以後，對比下來，仍是 Docker 更加方便，下面就來詳細介紹。

Dockerfile

FROM python:3.6.8

ENV PYTHONUNBUFFERED 1

RUN mkdir -p /code COPY ./requirements.txt /code 
WORKDIR /code 
RUN sed -i "s/archive.ubuntu./mirrors.aliyun./g" /etc/apt/sources.list RUN sed -i "s/deb.debian.org/mirrors.aliyun.com/g" /etc/apt/sources.list 
RUN apt-get clean && apt-get -y update && \ apt-get -y install libsasl2-dev python-dev libldap2-dev libssl-dev libsnmp-dev RUN pip3 install --index-url https://mirrors.aliyun.com/pypi/simple/ --no-cache-dir -r requirements.txt 
COPY ./* /code/ 複製代碼

使用 Dockerfile 來建立鏡像，Python 版本是 3.6.8，將源代碼拷貝到容器中 /code 目錄。

docker-compose

version: '3'

services:
 web:
 build:
 context: .
 dockerfile: Dockerfile
 image: web
 container_name: web
 hostname: web
 restart: always
 command: python /code/manage.py runserver 0.0.0.0:8000
 volumes:
 - .:/web
 ports:
 - "8000:8000"
 depends_on:
 - mysql  

 mysql:
 image: mysql
 container_name: mysql
 hostname: mysql
 restart: always
 command: --default-authentication-plugin=mysql_native_password --mysqlx=0
 ports:
 - 3306:3306
 volumes:
 - ./db:/var/lib/mysql
 environment:
 - MYSQL_HOST=localhost 
 - MYSQL_PORT=3306 
 - MYSQL_DATABASE=dev
 - MYSQL_USER=dev
 - MYSQL_PASSWORD=123456
 - MYSQL_ROOT_PASSWORD=123456
複製代碼

使用 docker-compose 來編排容器，一共啓兩個服務，web 服務就是後臺的 Django 服務，mysql 是數據庫服務。

有三點須要注意：

• web 服務使用 depends_on 命令，表示依賴於 mysql 服務。
• mysql 服務必定要加 --default-authentication-plugin=mysql_native_password 命令。由於從 MySQL 8.0 開始，默認的加密規則使用的是 caching_sha2_password，而咱們的客戶端並不支持。以前使用的是 mysql_native_password。
• 使用 volumes 來持久化數據，不然容器刪除以後，數據就都丟了。

requirements

Django==2.2.11
mysqlclient==1.4.6
複製代碼

啓動 Django 須要的 pip 包，Django 版本至少要 2.0，不然會報錯。

Django settings

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'dev',
        'USER': 'dev',
        'PASSWORD': '123456',
        'HOST': 'mysql',
        'PORT': '3306'
    }
}
複製代碼

在 Django settings 文件中配置數據庫信息，內容須要與 docker-compose 中一致。

有一點須要注意，HOST 必定要配置成 docker-compose 中的服務名稱，在我這裏是 mysql。配置成其餘，好比 localhost 或者 127.0.0.1 會報錯。

由於 Docker 啓動時會設置一個本地網絡，能夠將 mysql 解析到對應服務的容器，而對應的服務並不在 localhost 上。

Run

使用以下命令建立鏡像。

$ docker-compose -f ./docker-compose.yml build
複製代碼

也能夠省略上一步，直接使用以下命令啓動服務，若是沒有鏡像，會先建立鏡像，而後再啓動服務。

$ docker-compose -f ./docker-compose.yml up
複製代碼

排錯

在部署過程當中，可能會碰到以下這些錯誤，基本都是配置錯誤形成的。若是發生了，必定要仔細檢查配置，只要和文中相同，是不會有問題的。

• 'Plugin caching_sha2_password could not be loaded: /usr/lib/x86_64-linux-gnu/mariadb19/plugin/caching_sha2_password.so: cannot open shared object file: No such file or directory'
• django.core.exceptions.ImproperlyConfigured: Error loading MySQLdb module.
• django.db.utils.OperationalError: (2002, "Can't connect to MySQL server on 'db' (115)")
• django.db.utils.OperationalError: (2002, "Can't connect to local MySQL server through socket '/var/run/mysqld/mysqld.sock' (2)")
• django.db.utils.OperationalError: (2002, "Can't connect to MySQL server on '127.0.0.1' (115)")
• django.db.utils.OperationalError: (2002, "Can't connect to local MySQL server through socket '/var/run/mysqld/mysqld.sock' (2)")

我還遇到一個比較坑的問題是這個：

[Warning] root@localhost is created with an empty password ! Please consider switching off the --initialize-insecure option.

我覺得是個人密碼設置不正確，檢查了很久都沒發現問題，後來在網上找到了解釋，直接忽略就好了。

That is just a warning printed by during database file initialization (mysqld --initialize-insecure). The root user with password is created later while the database is listening only on the unix socket.

參考文檔：

fusionblender.net/django-and-…

github.com/docker-libr…

www.jianshu.com/p/4eafa4f87…