🚀 CloudDeploy - AWS DevOps CI/CD Pipeline

!

📌 Project Overview

CloudDeploy is an end-to-end DevOps project demonstrating a production-style Continuous Integration and Continuous Deployment (CI/CD) pipeline on AWS.

The project automatically builds a Docker image whenever code is pushed to GitHub, stores the image in Amazon ECR, and deploys the latest version to an AWS EC2 instance using GitHub Actions.

This project demonstrates modern DevOps practices including containerization, automation, cloud deployment, and CI/CD.

---

🏗 Architecture

Developer
     │
     ▼
Git Push
     │
     ▼
GitHub Repository
     │
     ▼
GitHub Actions
     │
     ▼
Docker Image Build
     │
     ▼
Amazon Elastic Container Registry (ECR)
     │
     ▼
SSH into EC2
     │
     ▼
Pull Latest Docker Image
     │
     ▼
Stop Previous Container
     │
     ▼
Run Latest Container
     │
     ▼
Application Live

---

🚀 Features

• Automated CI/CD Pipeline
• Dockerized Flask Application
• GitHub Actions Workflow
• Amazon ECR Integration
• Automated EC2 Deployment
• Dynamic Deployment Dashboard
• Health Check Endpoint
• Responsive Professional UI
• Zero Manual Deployment
• Production-ready Gunicorn Server

---

📂 Project Structure

devops-cicd-project/
│
├── app/
│   ├── app.py
│   ├── requirements.txt
│   ├── Dockerfile
│   ├── .dockerignore
│   ├── deployment.json
│   ├── templates/
│   │   └── index.html
│   └── static/
│       ├── css/
│       │   └── style.css
│       ├── js/
│       │   └── app.js
│       └── images/
│
├── .github/
│   └── workflows/
│       └── deploy.yml
│
├── scripts/
│   └── deploy.sh
│
├── docker-compose.yml
├── README.md
└── LICENSE

---

🛠 Technologies Used

Cloud

• AWS EC2
• Amazon ECR
• IAM

DevOps

• Docker
• GitHub Actions
• Git
• CI/CD

Backend

• Python
• Flask
• Gunicorn

Frontend

• HTML5
• CSS3
• JavaScript

---

⚙ CI/CD Workflow

1. Developer pushes code to GitHub.
2. GitHub Actions workflow starts automatically.
3. Repository is checked out.
4. Docker image is built.
5. Image is tagged.
6. Image is pushed to Amazon ECR.
7. GitHub Actions connects to the EC2 instance using SSH.
8. EC2 logs in to Amazon ECR.
9. Latest Docker image is pulled.
10. Existing container is stopped.
11. Old container is removed.
12. New container is started.
13. Updated application becomes available.

---

📦 Docker

Build Image

docker build -t clouddeploy:v1 .

Run Container

docker run -d \
--name clouddeploy \
-p 5000:5000 \
clouddeploy:v1

Stop Container

docker stop clouddeploy

Remove Container

docker rm clouddeploy

---

☁ AWS Services Used

• Amazon EC2
• Amazon ECR
• IAM

---

🔐 GitHub Secrets

Configure the following repository secrets before running the workflow.

Secret	Description
AWS_ACCESS_KEY_ID	IAM User Access Key
AWS_SECRET_ACCESS_KEY	IAM User Secret Key
AWS_ACCOUNT_ID	AWS Account ID
AWS_REGION	AWS Region
ECR_REPOSITORY	Amazon ECR Repository Name
EC2_HOST	EC2 Public IP or DNS
EC2_USERNAME	SSH Username
EC2_SSH_KEY	EC2 Private Key

---

🚀 Local Setup

Clone the repository.

git clone <repository-url>

Move into the application directory.

cd devops-cicd-project/app

Install dependencies.

pip install -r requirements.txt

Run the application.

python app.py

Open your browser.

http://localhost:5000

---

🐳 Docker Compose

Start the application.

docker compose up --build

Run in background.

docker compose up -d

Stop the application.

docker compose down

---

📡 API Endpoints

Home

GET /

Displays the deployment dashboard.

---

Health Check

GET /health

Returns application health status.

---

Deployment Information

GET /api/deployment

Returns deployment metadata in JSON format.

---

📈 Future Improvements

• Kubernetes Deployment
• Amazon EKS
• Helm Charts
• Terraform Infrastructure
• Blue/Green Deployment
• Canary Deployment
• Monitoring with CloudWatch
• Prometheus
• Grafana
• SonarQube
• Trivy Security Scanning
• Slack Notifications
• Automatic Rollback
• Multi-stage Docker Builds
• Image Versioning using Git SHA

---

📷 Screenshots

Add screenshots of:

• Application Dashboard
• GitHub Actions Workflow
• Amazon ECR Repository
• Running EC2 Instance
• Docker Containers
• Successful Deployment

---

👨‍💻 Learning Outcomes

Through this project you will learn:

• Git & GitHub
• Docker Fundamentals
• Docker Image Management
• GitHub Actions
• CI/CD Pipeline Design
• AWS EC2
• Amazon ECR
• IAM Configuration
• SSH Automation
• Deployment Automation
• Production Deployment Practices

---

👤 Author

Suyash Singh

DevOps Engineer | Cloud Enthusiast | AWS | Docker | Linux | CI/CD

GitHub: https://github.com/Suyashrsingh

LinkedIn: https://www.linkedin.com/in/suyash-rishi-singh-6bb18b289/

---

⭐ Support

If you found this project useful:

• ⭐ Star the repository
• 🍴 Fork the project
• 📢 Share it with others
• 💡 Contribute with improvements

Happy Learning! 🚀