shinejh0528/django

Django环境Docker镜像

镜像概述

该镜像是一个预配置的Django开发和运行环境，集成了Django框架及相关依赖，旨在简化Django Web应用的部署流程，支持数据持久化存储和邮件发送功能，适用于开发、测试及小型生产环境。

核心功能与特性

• Web服务器支持：兼容Django内置runserver及gunicorn部署方式
• 数据持久化：通过Docker卷（volume）挂载本地目录，实现代码和数据的持久化存储
• 灵活部署：支持端口映射、容器命名、主机名配置等自定义参数
• 邮件发送：1.1.0及以上版本集成mutt工具，支持通过SMTP发送邮件

使用场景

• Django应用的本地开发环境搭建
• 快速部署Django应用进行测试
• 小型Django Web应用的生产环境部署

使用方法

1. 运行Docker容器

通过docker run命令启动容器，建议配置卷挂载（-v）和端口映射（-p）以实现数据持久化和外部访问。

命令格式：

bash
# -v：可选，挂载本地目录到容器（推荐，实现数据持久化）
# --hostname：可选，设置容器主机名
# --name：可选，指定容器名称
# [django dir]：本地Django项目目录（需替换为实际路径）
# [data dir]：本地数据目录（可选，需替换为实际路径）
# [port]：端口号（需替换为实际端口，如8787）
docker run -itd --hostname [host_name] -v [django dir]:[django dir] -v [data dir]:[data dir] -p [port]:[port] --name [container_name] shinejh0528/django:1.0.0

示例：

bash
docker run -itd --hostname dev -v /home/jhshin:/home/jhshin -v /data:/data -p 8787:8787 --name django shinejh0528/django:1.0.0

2. 启动Django Web服务器

容器运行后，可通过两种方式启动Django服务器：直接在容器内执行命令或通过docker exec远程执行。

2.1 容器内直接启动

进入容器后执行以下命令：

bash
# 使用Django内置服务器
python manage.py runserver 0.0.0.0:[port]

# 使用gunicorn（需先进入项目根目录）
cd [app_root_dir]  # 替换为Django应用根目录
gunicorn [app].wsgi:application --bind 0.0.0.0:[port]

2.2 通过docker exec远程启动

无需进入容器，直接通过宿主机执行：

bash
docker exec -it [container_id/name] python [django dir]/manage.py runserver 0.0.0.0:[port]

示例：

bash
docker exec -it django python /home/jhshin/django/bi_system/1.2.1-rc1/mysite/manage.py runserver 0.0.0.0:8787

3. SMTP邮件发送（1.1.0及以上版本）

1.1.0及以上版本集成mutt工具，可通过以下命令发送邮件：

命令格式：

bash
/usr/bin/mutt -e "my_hdr From:[sender_email]" -s "[subject]" [recipient_email] < [email_content_file]

示例：

bash
/usr/bin/mutt -e "my_hdr From:test@test.com" -s "测试邮件" user@example.com < test.txt

版本信息

详细版本更新说明请参考：https://github.com/Shin-jongwhan/docker/tree/main/release_note/shinejh0528/django