library/django

已弃用

该镜像已官方弃用，推荐使用https://hub.docker.com/_/python/%E6%9B%BF%E4%BB%A3%EF%BC%8C2016%E5%B9%B412%E6%9C%8831%E6%97%A5%E5%90%8E%E5%B0%86%E4%B8%8D%E5%86%8D%E6%8E%A5%E6%94%B6%E6%9B%B4%E6%96%B0%E3%80%82%E8%AF%B7%E7%9B%B8%E5%BA%94%E8%B0%83%E6%95%B4%E6%82%A8%E7%9A%84%E4%BD%BF%E7%94%A8%E6%96%B9%E5%BC%8F%E3%80%82

对于该镜像的大多数使用场景，Django实际上并非从此镜像获取，而是来自项目的requirements.txt，因此其唯一“价值”是预安装了mysql-client、postgresql-client和sqlite3，用于Django框架的各种使用场景。

例如，以下Dockerfile可作为使用PostgreSQL的Django项目的良好起点：

dockerfile
FROM python:3.4

RUN apt-get update \
	&& apt-get install -y --no-install-recommends \
		postgresql-client \
	&& rm -rf /var/lib/apt/lists/*

WORKDIR /usr/src/app
COPY requirements.txt ./
RUN pip install -r requirements.txt
COPY . .

EXPOSE 8000
CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]

支持的标签及对应的Dockerfile链接

• https://github.com/docker-library/django/blob/d7f1d0e61cffe81d6ca9797c63fc25eba7e277db/3.4/Dockerfile
• https://github.com/docker-library/django/blob/4fe080675e4a85ef6ee25c811e9d3d3ef0905794/3.4/onbuild/Dockerfile
• https://github.com/docker-library/django/blob/d7f1d0e61cffe81d6ca9797c63fc25eba7e277db/2.7/Dockerfile
• https://github.com/docker-library/django/blob/cecbb2bbbcb69d1b8358398eaf8d9638e3bdd447/2.7/onbuild/Dockerfile

快速参考

• 获取帮助的途径：
  Docker社区论坛、Docker社区Slack 或 Stack Overflow

• 提交问题的地址：
  https://github.com/docker-library/django/issues

• 维护者：
  https://github.com/docker-library/django

• 镜像 artifact 详情：
  https://github.com/docker-library/repo-info/blob/master/repos/django%EF%BC%88https://github.com/docker-library/repo-info/commits/master/repos/django%EF%BC%89
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/pulls?q=label%3Alibrary%2Fdjango
  https://github.com/docker-library/official-images/blob/master/library/django%EF%BC%88https://github.com/docker-library/official-images/commits/master/library/django%EF%BC%89

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/django%EF%BC%88https://github.com/docker-library/docs/commits/master/django%EF%BC%89

• 支持的 Docker 版本：
  https://github.com/docker/docker/releases/latest%EF%BC%88%E5%B0%BD%E6%9C%80%E5%A4%A7%E5%8A%AA%E5%8A%9B%E6%94%AF%E6%8C%81%E4%BD%8E%E8%87%B31.6%E7%89%88%E6%9C%AC%EF%BC%89

什么是 Django？

Django 是一个免费开源的 Web 应用框架，使用 Python 编写，遵循模型-视图-控制器（MVC）架构模式。Django 的主要目标是简化复杂的、数据库驱动网站的创建，强调组件的可重用性和“可插拔性”。

***.org/wiki/Django_(web_framework)

!https://raw.githubusercontent.com/docker-library/docs/164cc29281655dc81242824d1b4f90b4e6d8d7eb/django/logo.png

如何使用该镜像

在 Django 应用项目中创建Dockerfile

dockerfile
FROM django:onbuild

将此文件放在应用根目录，与requirements.txt同级。

该镜像包含多个ONBUILD触发器，可覆盖大多数应用场景。构建过程会执行COPY . /usr/src/app、RUN pip install、EXPOSE 8000，并将默认命令设置为python manage.py runserver。

然后可以构建并运行 Docker 镜像：

console
$ docker build -t my-django-app .
$ docker run --name some-django-app -d my-django-app

可通过浏览器访问http://container-ip:8000进行测试；若需从主机外部访问，可使用以下命令在http://localhost:8000访问：

console
$ docker run --name some-django-app -p 8000:8000 -d my-django-app

不使用Dockerfile

当然，若不想使用便捷的ONBUILD触发器，也可直接使用docker run命令，无需在项目中添加Dockerfile：

console
$ docker run --name some-django-app -v "$PWD":/usr/src/app -w /usr/src/app -p 8000:8000 -d django bash -c "pip install -r requirements.txt && python manage.py runserver 0.0.0.0:8000"

引导新的 Django 应用

若要生成新 Django 项目的脚手架，可执行以下命令：

console
$ docker run -it --rm --user "$(id -u):$(id -g)" -v "$PWD":/usr/src/app -w /usr/src/app django django-admin.py startproject mysite

这将在当前目录下创建名为mysite的子目录。

镜像变体

django镜像有多种变体，适用于不同使用场景。

django:<version>

这是默认镜像。若不确定需求，建议使用此变体。它既可作为临时容器（挂载源代码并启动容器以运行应用），也可作为构建其他镜像的基础。

django:onbuild

此镜像简化了衍生镜像的构建。对于大多数场景，在项目根目录创建包含FROM django:onbuild的Dockerfile，即可快速创建独立的项目镜像。

虽然onbuild变体有助于“快速启动”（短时间内实现 Docker 化），但不建议在项目中长期使用，因为无法控制ONBUILD触发器的执行时机（另见https://github.com/docker/docker/issues/5714%E3%80%81https://github.com/docker/docker/issues/8240%E3%80%81https://github.com/docker/docker/issues/***%EF%BC%89%E3%80%82

当熟悉项目在 Docker 中的运行方式后，建议调整Dockerfile，继承非onbuild变体，并将onbuild变体Dockerfile中的命令（将ONBUILD行移至末尾并移除ONBUILD关键字）复制到自己的文件中，以便更好地控制这些命令，同时提高Dockerfile的透明度，便于自己和他人理解其功能。这也能更轻松地添加额外需求（如在执行原ONBUILD步骤前安装更多包）。

许可证

查看此镜像中包含软件的https://github.com/django/django/blob/master/LICENSE%E3%80%82