Multistage

Author: aleyipsoftwire

.dockerignore

@@ -0,0 +1,13 @@
+.git
+.github
+.idea
+.pytest_cache
+.venv
+.vscode
+ansible
+**/__pycache__
+.env*
+.gitignore
+.gitpod.yml
+.python-version
+Dockerfile

.env.template

@@ -2,9 +2,6 @@
 # Needed because of the presence of the "todo_app" folder
 FLASK_APP=todo_app/app
 
-# Turn on debug mode (which enables reloading on code changes and the interactive debugger: https://flask.palletsprojects.com/en/2.3.x/config/#DEBUG)
-FLASK_DEBUG=true
-
 TRELLO_API_KEY=<DELIBERATELY MISSING>
 TRELLO_API_TOKEN=<DELIBERATELY MISSING>
 TRELLO_BOARD_ID=<DELIBERATELY MISSING>

.env.test

@@ -2,9 +2,6 @@
 # Needed because of the presence of the "todo_app" folder
 FLASK_APP=todo_app/app
 
-# Turn on debug mode (which enables reloading on code changes and the interactive debugger: https://flask.palletsprojects.com/en/2.3.x/config/#DEBUG)
-FLASK_DEBUG=true
-
 TRELLO_API_KEY=TRELLO_API_KEY
 TRELLO_API_TOKEN=TRELLO_API_TOKEN
 TRELLO_BOARD_ID=TRELLO_BOARD_ID

Dockerfile

@@ -1,4 +1,4 @@
-FROM python:3.9-slim
+FROM python:3.9-slim as base
 
 # Set up poetry
 ENV POETRY_HOME="/opt/poetry"
@@ -14,7 +14,16 @@ WORKDIR /app
 COPY poetry.lock pyproject.toml /app/
 RUN poetry install --no-interaction --no-ansi
 
-# Run project
 COPY todo_app /app/todo_app
+
 EXPOSE 8000
+
+FROM base as production
+
+ENV FLASK_DEBUG=false
+CMD poetry run gunicorn --bind 0.0.0.0 "todo_app.app:create_app()"
+
+FROM base as development
+
+ENV FLASK_DEBUG=true
 CMD poetry run gunicorn --bind 0.0.0.0 "todo_app.app:create_app()"

README.md

@@ -47,11 +47,13 @@ Replace the board and list ids with the respective ids from your Trello board.
 ## Running the App
 
 Once the all dependencies have been installed, start the Flask app in development mode within the Poetry environment by running:
+
 ```bash
 $ poetry run flask run
 ```
 
 You should see output similar to the following:
+
 ```bash
  * Serving Flask app 'todo_app/app'
  * Debug mode: on
@@ -62,6 +64,7 @@ Press CTRL+C to quit
  * Debugger is active!
  * Debugger PIN: 113-666-066
 ```
+
 Now visit [`http://localhost:5000/`](http://localhost:5000/) in your web browser to view the app.
 
 ## Running the Tests
@@ -79,9 +82,9 @@ $ poetry run pytest
 3. Replace the IP address in the `inventory` file with the IP address(es) of the managed VM(s)
 4. Create a file `ansible-pw.txt` containing the vault password
 5. Run the following command in the `ansible` directory, to provision the VM:
-    ```bash
-    $ ansible-playbook playbook.yml -i inventory --vault-password-file ansible-pw.txt
-    ```
+   ```bash
+   $ ansible-playbook playbook.yml -i inventory --vault-password-file ansible-pw.txt
+   ```
 
 ### Note on env variables
 
@@ -100,7 +103,23 @@ then enter the value you want to encrypt when prompted.
 
 ## Docker
 
+Run the project with mounting:
+```bash
+docker build --target development --tag todo-app:dev .
+docker run -dit \
+    --name todo-app-dev \
+    -p 8000:8000 \
+    --env-file .env \
+    --mount type=bind,source="$(pwd)/todo_app",target=/app/todo_app,readonly \
+    todo-app:dev
+```
+
+Run the project in production environment:
 ```bash
-docker build --tag todo-app .
-docker run -p 8000:8000 --env-file .env todo-app
+docker build --target production --tag todo-app:prod .
+docker run -dit \
+    --name todo-app-prod \
+    -p 8000:8000 \
+    --env-file .env \
+    todo-app:prod
 ```