- Project Overview
- Prerequisites
- Manual Deployment Steps
- Creating Dockerfiles and Docker Compose
- Deploying to EC2
- Configuring Nginx Proxy Manager
- Domain Setup and SSL Configuration
- Testing the Setup
- Troubleshooting
- Benefits and Learnings
This project is part of the HNG DevOps Stage 2 task, where I deployed a Dockerized full stack web application with a React frontend and FastAPI + PostgreSQL backend. Nginx Proxy Manager was used for SSL and domain configurations.
- AWS Account
- EC2 Instance running Amazon Linux 2
- Docker and Docker Compose installed
- Route 53 for domain management
- Let's Encrypt for SSL certificates
-
Install WSL and Set Up Environment:
- Enable WSL and install Ubuntu.
- Update and upgrade packages: sudo apt update && sudo apt upgrade
- Install Git: sudo apt install git
- Clone the project repository: git clone https://github.com/khingdave/devops-stage-2.git
-
Install Poetry and PostgreSQL:
- Install Poetry: curl -sSL https://install.python-poetry.org | python3 -
- Add Poetry to PATH: nano ~/.bashrc and add export PATH="$HOME/.local/bin:$PATH"
- Install PostgreSQL: sudo apt install postgresql
- Create PostgreSQL user and database.
-
Set Up Backend:
- Navigate to backend directory: cd backend
- Install dependencies: poetry install
- Set up database tables: poetry run bash ../prestart.sh
- Run the backend server: poetry run uvicorn app.main:app --reload
-
Set Up Frontend:
- Install Node.js and npm.
- Navigate to frontend directory: cd ../frontend
- Install dependencies: npm install
- Run the frontend development server: npm run dev
Created Dockerfiles and docker-compose.yml file to containerize the application. These files are included in the repository.
-
Connect to EC2 Instance:
- Use EC2 Instance Connect to SSH into the instance.
-
Install Docker and Docker Compose:
- Install Docker: sudo amazon-linux-extras install docker && sudo service docker start
- Install Docker Compose: sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose && sudo chmod +x /usr/local/bin/docker-compose
-
Clone Repository and Update .env Files:
- Clone the repository on EC2.
- Update VITE_API_URL in the frontend .env file.
-
Build and Run Containers:
- Run: docker-compose up --build -d
-
Access and Login:
- Open http://:81 and use default credentials to log in.
-
Add Proxy Hosts:
- Add configurations for stagetwoapp.strangled.net, db.stagetwoapp.strangled.net, and proxy.stagetwoapp.strangled.net
-
Configure Route 53:
- Set up A records for https://stagetwoapp.strangled.net/login, db.https://stagetwoapp.strangled.net/login, and proxy.https://stagetwoapp.strangled.net/login.
-
Enable SSL in Nginx Proxy Manager:
- Request a new SSL Certificate using Let's Encrypt and enable Force SSL.
-
Access Application:
- Frontend: https://https://stagetwoapp.strangled.net
- Backend: https://api.stagetwoapp.strangled.net
- Adminer: https://db.stagetwoapp.strangled.net
-
Verify SSL and Redirects:
- Ensure connections are secure and redirects are working.
-
502 Bad Gateway:
- Check Docker containers: docker ps
- Verify Nginx Proxy Manager configuration and domain settings.
-
Database Connection Issues:
- Ensure the database container is running and accessible from the backend container.
Completing this project as part of the HNG DevOps Stage 2 task has given me practical skills in Docker, AWS, and Nginx Proxy Manager. Itβs been a fantastic learning experience that has laid a solid foundation for my future DevOps endeavors.
The repository is organized into two main directories:
- frontend: Contains the ReactJS application.
- backend: Contains the FastAPI application and PostgreSQL database integration.
Each directory has its own README file with detailed instructions specific to that part of the application.
To get started with this template, please follow the instructions in the respective directories: