Alpine OS running Python Flask

This image is used to run flask applications. To start a container use

docker run --name flaskapp --restart=always \
	-p 80:80 \
	-v /path/to/app/:/app \
	-d jazzdd/alpine-flask

-v /path/to/app/:/app - specifies the path to the folder containing a file named app.py, which should be your main application

-p 80:80 - the image exposes port 80, in this example it is mapped to port 80 on the host

---

Installing additional python or flask packages

This image comes with a basic set of python packages and the basic flask and python-pip installation.

If you need any non-default python or flask packages, the container will install them on its first run using python pip and a requirements.txt file. Save a requirements.txt file in the root folder of your app, which is mounted to the /app folder of the container. The format of the file is described in the pip documentation. After that you can create a new container with the above docker command. The entrypoint script will take care of the package installation listed in the requirements file.

If an additional package is needed during runtime of the container it can be installed with following command.

docker exec YOUR_CONTAINER_ID/NAME /bin/bash -c "pip install package-name"

---

Internals

The flask application is started using a UWSGI socket.

Nginx is used to map the socket to port 80 within the image. This image does not offer any SSL capability, please use a nginx proxy for this. Nginx will deliver static content (e.g. CSS or JS Files) directly without going through flask or uwsgi.

Log messages

Logs can be displayed using docker logs -f CONTAINER_ID/NAME

---

Using this image to control docker with flask

This image can be used to create a privileged container, which can control your docker server. Therfore the docker socket must be mounted as volume within this container and an additional option is needed to run the container.

docker run --name flaskapp --restart=always \
    -p 80:80 \
    -v /path/to/app/:/app \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -d jazzdd/alpine-flask -o gid

-o gid enables the docker option (docker will be installed into the container on the first run). GID is the docker group id of your host system. The container matches the gid of the docker group and adds the nginx user (this user is running nginx and uwsgi) to the docker group.

Now you could use:

from subprocess import call
call(["docker", "run", "-p 80" ,"-v /path/to/app/:/app", "-d jazzdd/alpine-flask"])

to get another container running with the flask app.

Debug mode

Debug mode means the container doesn't use uwsgi and nginx but starts the flask app with a simple python app.py. So you can make use of the build-in flask development webserver and the automated reload system after editing the application.

To start a container in debug mode use:

docker run --name flaskapp --restart=always \
	-p 80:80 \
	-v /path/to/app/:/app \
	-d jazzdd/alpine-flask -d

Your app.py file must have a section similiar to the following example to start the app within the debug mode.

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=80, debug=True)

To get the command line output of your app use docker logs -f CONTAINER_ID/NAME.