awesome-compose/django/README.md
Guillaume Lours f716bfb382
add configuration to use django sample with Docker Dev Environments feature (#252)
Signed-off-by: Guillaume Lours <guillaume.lours@docker.com>
2022-07-12 12:18:35 +02:00

59 lines
1.4 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## Compose sample application
### Django application in dev mode
Project structure:
```
.
├── compose.yaml
├── app
   ├── Dockerfile
   ├── requirements.txt
   └── manage.py
```
[_compose.yaml_](compose.yaml)
```
services:
web:
build: app
ports:
- '8000:8000'
```
## Deploy with docker compose
```
$ docker compose up -d
Creating network "django_default" with the default driver
Building web
Step 1/6 : FROM python:3.7-alpine
...
...
Status: Downloaded newer image for python:3.7-alpine
Creating django_web_1 ... done
```
## Expected result
Listing containers must show one container running and the port mapping as below:
```
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
3adaea94142d django_web "python3 manage.py r…" About a minute ago Up About a minute 0.0.0.0:8000->8000/tcp django_web_1
```
After the application starts, navigate to `http://localhost:8000` in your web browser:
Stop and remove the containers
```
$ docker compose down
```
## Use with Docker Development Environments
You can use this sample with the Dev Environments feature of Docker Desktop.
To develop directly the web service inside a container, you just need to use the https git url of the sample:
`https://github.com/docker/awesome-compose/tree/master/django`
![page](../dev-envs.png)