51 lines
2.0 KiB
Markdown
51 lines
2.0 KiB
Markdown
# What is Django?
|
|
|
|
Django is a free and open source web application framework, written in Python, which follows the model-view-controller architectural pattern. Django's primary goal is to ease the creation of complex, database-driven websites with an emphasis on reusability and "pluggability" of components.
|
|
|
|
> [wikipedia.org/wiki/Django_(web_framework)](https://en.wikipedia.org/wiki/Django_%28web_framework%29)
|
|
|
|
%%LOGO%%
|
|
|
|
# How to use this image
|
|
|
|
## Create a `Dockerfile` in your Django app project
|
|
|
|
```dockerfile
|
|
FROM django:onbuild
|
|
```
|
|
|
|
Put this file in the root of your app, next to the `requirements.txt`.
|
|
|
|
This image includes multiple `ONBUILD` triggers which should cover most applications. The build will `COPY . /usr/src/app`, `RUN pip install`, `EXPOSE 8000`, and set the default command to `python manage.py runserver`.
|
|
|
|
You can then build and run the Docker image:
|
|
|
|
```console
|
|
$ docker build -t my-django-app .
|
|
$ docker run --name some-django-app -d my-django-app
|
|
```
|
|
|
|
You can test it by visiting `http://container-ip:8000` in a browser or, if you need access outside the host, on `http://localhost:8000` with the following command:
|
|
|
|
```console
|
|
$ docker run --name some-django-app -p 8000:8000 -d my-django-app
|
|
```
|
|
|
|
## Without a `Dockerfile`
|
|
|
|
Of course, if you don't want to take advantage of magical and convenient `ONBUILD` triggers, you can always just use `docker run` directly to avoid having to add a `Dockerfile` to your project.
|
|
|
|
```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"
|
|
```
|
|
|
|
## Bootstrap a new Django Application
|
|
|
|
If you want to generate the scaffolding for a new Django project, you can do the following:
|
|
|
|
```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
|
|
```
|
|
|
|
This will create a sub-directory named `mysite` inside your current directory.
|