https://github.com/devilbox/docker-python-flask
Python Flask development Docker image
https://github.com/devilbox/docker-python-flask
Last synced: 7 months ago
JSON representation
Python Flask development Docker image
- Host: GitHub
- URL: https://github.com/devilbox/docker-python-flask
- Owner: devilbox
- Created: 2019-11-28T08:36:27.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2019-11-30T11:32:03.000Z (about 6 years ago)
- Last Synced: 2025-04-20T19:38:41.720Z (8 months ago)
- Language: Shell
- Size: 13.7 KB
- Stars: 4
- Watchers: 2
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Python Flask Docker image
[](https://travis-ci.com/devilbox/docker-python-flask)
[](https://github.com/devilbox/docker-python-flask/releases)
[](https://gitter.im/devilbox/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[](https://devilbox.discourse.group)
[](https://hub.docker.com/r/devilbox/python-flask)
[](https://opensource.org/licenses/MIT)
This project provides a Python Flask Docker image for development purposes.
View **[Dockerfile](https://github.com/devilbox/docker-python-flask/blob/master/Dockerfile)** on GitHub.
| Docker Hub | Upstream Project |
|------------|------------------|
| 
| 
|
#### Documentation
In case you seek help, go and visit the community pages.
Documentation
Chat
Forum
devilbox.readthedocs.io
gitter.im/devilbox
devilbox.discourse.group
## Docker image tags
* **Image name:** `devilbox/python-flask`
### Rolling tags
Rolling tags are updated and pushed nightly to ensure latest patch-level Python version.
| Image tag | Python version |
|-----------|----------------|
| `3.8-dev` | Latest 3.8.x |
| `3.7-dev` | Latest 3.7.x |
| `3.6-dev` | Latest 3.6.x |
| `3.5-dev` | Latest 3.5.x |
| `2.7-dev` | Latest 2.7.x |
### Release tags
Release tags are fixed and bound to git tags.
| Image Tag | Python version |
|---------------------|----------------|
| `3.8-dev-` | Latest 3.8.x |
| `3.7-dev-` | Latest 3.7.x |
| `3.6-dev-` | Latest 3.6.x |
| `3.5-dev-` | Latest 3.5.x |
| `2.7-dev-` | Latest 2.7.x |
## Example
For easy usage, there is a Docker Compose example project included.
```bash
cp .env.example .env
docker-compose up
```
```bash
curl localhost:3000
```
## Environment Variables
| Variable | Required | Default | Description |
|------------------|----------|-----------| ------------|
| `FLASK_PROJECT` | Yes | | The sub-directory name under `/shared/httpd/` to serve [1] |
| `FLASK_APP_DIR` | | `app` | The main entrypoint dir name |
| `FLASK_APP_FILE` | | `main.py` | The main entrypoint file name |
| `FLASK_PORT` | | `3000` | Docker container internal http port to serve the application |
| `NEW_UID` | | `1000` | User id of the host system to ensure syncronized permissions between host and container |
| `NEW_GID` | | `1000` | Group id of the host system to ensure syncronized permissions between host and container |
* [1] See [Project directory structure](#project-directory-structure) for usage
## Project directory structure
The following shows how to organize your project on the host operating system.
### Basic structure
The following is the least required directory structure:
```bash
/
└── app # Entrypoint dir name can be changed via env var [1]
└── main.py # Entrypoint file name can be changed via env var [2]
```
* [1] Use the `FLASK_APP_DIR` environment variable to define the dir for the entrypoint in `/app/`. Example: `FLASK_APP_DIR=src`.
* [2] Use the `FLASK_APP_FILE` environment variable to define the file for the entrypoint in `/app/main.py`. Example: `FLASK_APP_FILE=test.py`.
### Structure with dependencies
The following directory structure allows for auto-installing Python dependencies during startup into a virtual env.
```bash
/
├── app # Entrypoint dir name can be changed via env var
│ ├── __init__.py
│ └── main.py # Entrypoint file name can be changed via env var
└── requirements.txt # Optional: will pip install in virtual env
```
After you've started the container with a `requirements.txt` in place, a new `venv/` directory will be added with you Python virtual env.
```bash
/
├── app
│ ├── __init__.py
│ ├── main.py
│ └── __pycache__
├── requirements.txt
└── venv
├── bin
├── include
└── lib
```
### Mounting your project
When using this image, you need to mount your project directory into `/shared/httpd/` into the container:
```bash
docker run \
--rm \
-v $(pwd)/:/shared/httpd/ \
devilbox/python-flask:3.9-dev
```
If your local uid or gid are not 1000, you should set them accordingly via env vars to ensure to syncronize file system permissions across the container and your host system.
```bash
docker run \
--rm \
-v $(pwd)/:/shared/httpd/ \
-e NEW_UID=$(id -u) \
-e NEW_GID=$(id -g) \
devilbox/python-flask:3.9-dev
```
## Build locally
```bash
# Build default version (Python 3.8)
make build
# Build specific version
make build PYTHON=3.7
```
## Test locally
```bash
# Test default version (Python 3.8)
make test
# Test specific version
make test PYTHON=3.7
```
## License
**[MIT License](LICENSE)**
Copyright (c) 2019 [cytopia](https://github.com/cytopia)