Table of contents
- Introduction
- Prerequisites 🛠️
- Step 1: Clone the Repository 🧑💻
- Step 2: Build the Flask App Image🖼️
- Step 3: Create Docker Network🌐
- Step 4: Create Docker Volume💾
- Step 5: Run MySQL Container🚢
- Step 6: Run Flask App Container🏃♂️
- Step 7: Access MySQL Container🛢️
- Step 8: Add Data to Flask App💬
- Step 9: Restart MySQL Container🔄
- Simplify Deployment with Docker Compose 🚢
- Conclusion🎉
Introduction
DevOps practices have revolutionized the software development lifecycle, emphasizing collaboration and automation. In this tutorial, we will explore the deployment of a two-tier Flask app with a MySQL database using Docker. The primary concepts covered in this project are Docker volumes and Docker networks, ensuring data persistence and efficient communication between containers.
Prerequisites 🛠️
Before diving into the tutorial, make sure you have Docker installed on your machine. You can download Docker from here.
Step 1: Clone the Repository 🧑💻
Begin by cloning the project repository from GitHub:
git clone https://github.com/ArjunMnn/two-tier-flask-app.git
cd two-tier-flask-app
Step 2: Build the Flask App Image🖼️
Navigate to the Flask app directory and build the Docker image using the provided Dockerfile:
docker build -t flask-app .
Step 3: Create Docker Network🌐
Create a Docker network to facilitate communication between the Flask app and MySQL containers:
docker network create -d bridge two-tier-app-nw
Step 4: Create Docker Volume💾
Create a Docker volume to ensure persistent storage for the MySQL database:
docker volume create --name two-tier-app-volume --opt type=none --opt device=/home/ubuntu/volumes/two-tier-app --opt o=bind
Step 5: Run MySQL Container🚢
Start the MySQL container with the following command:
docker run -d -p 3306:3306 -v two-tier-app-volume:/var/lib/mysql/ -e MYSQL_ROOT_PASSWORD=test@123 -e MYSQL_DATABASE=testdb -e MYSQL_USER=admin -e MYSQL_PASSWORD=admin --network=two-tier-app-nw --name mysql mysql:latest
Step 6: Run Flask App Container🏃♂️
Run the Flask app container, ensuring it connects to the created network:
docker run -d -p 5000:5000 -e MYSQL_HOST=mysql -e MYSQL_USER=admin -e MYSQL_PASSWORD=admin -e MYSQL_DB=testdb --network=two-tier-app-nw --name flask-app flask-app:latest
Step 7: Access MySQL Container🛢️
Access the MySQL container to create a table inside the testdb
database:
docker exec -it CONTAINER_ID bash
Inside the container, run the following MySQL query to create a table:
CREATE TABLE messages (
id INT AUTO_INCREMENT PRIMARY KEY,
message TEXT
);
Exit the container.
Step 8: Add Data to Flask App💬
With the Flask app running, access it through your browser and add some data.
Step 9: Restart MySQL Container🔄
Stop and remove the MySQL container:
docker stop mysql
docker rm mysql
Then, restart the MySQL container to demonstrate data persistence:
docker run -d -p 3306:3306 -v two-tier-app-volume:/var/lib/mysql/ -e MYSQL_ROOT_PASSWORD=test@123 -e MYSQL_DATABASE=testdb -e MYSQL_USER=admin -e MYSQL_PASSWORD=admin --network=two-tier-app-nw --name mysql mysql:latest
Simplify Deployment with Docker Compose 🚢
So far, we've meticulously followed the step-by-step process for deploying our two-tier Flask app using individual Docker commands. Now, let's take it a step further and streamline the entire deployment process with Docker Compose.
Docker Compose Configuration
Create a docker-compose.yml
file in your project directory with the following content:
version: '3'
services:
mysql:
image: mysql:latest
container_name: mysql
ports:
- "3306:3306"
volumes:
- two-tier-app-volume:/var/lib/mysql/
environment:
MYSQL_ROOT_PASSWORD: test@123
MYSQL_DATABASE: testdb
MYSQL_USER: admin
MYSQL_PASSWORD: admin
networks:
- two-tier-app-nw
flask-app:
image: flask-app:latest
container_name: flask-app
ports:
- "5000:5000"
environment:
MYSQL_HOST: mysql
MYSQL_USER: admin
MYSQL_PASSWORD: admin
MYSQL_DB: testdb
networks:
- two-tier-app-nw
volumes:
two-tier-app-volume:
external: true
networks:
two-tier-app-nw:
driver: bridge
Deploy with Docker Compose
With the docker-compose.yml
file in place, deploying the entire stack becomes a breeze. Run the following command:
docker-compose up -d
Docker Compose will orchestrate the deployment of both the MySQL and Flask app containers, ensuring seamless communication between them. This single command replaces the manual execution of each Docker command we used earlier.
Additional Commands
To stop and remove the containers created by Docker Compose, use:
docker-compose down
This concludes our journey in deploying a two-tier Flask app using both individual Docker commands and the efficiency of Docker Compose. Choose the approach that best suits your needs and workflow.
Conclusion🎉
Congratulations! You have successfully deployed a two-tier Flask app with a MySQL database using Docker. This tutorial covered essential DevOps practices, including Docker volumes and networks, ensuring seamless container orchestration and data persistence. Feel free to explore and extend this project based on your requirements. Happy coding!