🚀 CI-CD-NodeJS-App

📌 Project Overview

This repository contains a complete CI/CD automation pipeline for deploying a Node.js application using GitHub Actions, Docker, and AWS EC2.

The project demonstrates essential DevOps principles including:

• Automated build and deployment workflow
• Docker containerization
• Continuous Integration via GitHub Actions
• Continuous Deployment to AWS EC2
• Automatic health checks after deployment

This repository represents a real-world, fully automated DevOps pipeline.

---

🎯 Project Objectives

• Automate the build and deployment of a Node.js application
• Containerize the application using Docker
• Automatically push Docker images to Docker Hub
• Deploy new versions on an EC2 instance once code is pushed to main
• Maintain a clean and simple CI/CD workflow
• Apply fast, idempotent, and reliable deployment practices

---

🛠 Technologies Used

• Node.js / Express
• Docker
• GitHub Actions
• AWS EC2
• SSH Authentication
• Linux (Ubuntu / Amazon Linux)

---

📂 Project Structure

CI-CD-NodeJS-App/
│
├── app.js                  # Main Node.js application
├── package.json            # Dependencies & app metadata
├── Dockerfile              # Docker image definition
├── README.md               # Project documentation
├── EC2 Instance.png
├── EC2_NodeJS-status.png
├── deployed page.png
├── security groups.png
│
└── .github/
    └── workflows/
        └── push-up.yaml    # CI/CD pipeline definition

---

⚙️ Application Code (Node.js)

const express = require('express');
const app = express();
const port = 3000;

app.get('/', (req, res) => {
  res.send('Hello, Abdallah, Welcome to you in DevOpe Era!');
});

app.listen(port, () => {
  console.log(`Server is running on http://localhost:${port}`);
});

---

🐳 Docker Containerization

Docker is used to package the application in a portable, reproducible container image.

Dockerfile

FROM node:16

WORKDIR /usr/src/app

COPY package*.json ./

RUN npm install

COPY . .

EXPOSE 3000

CMD ["npm", "start"]

Build Docker Image

docker build -t nodejs-app .

Run the Container

docker run -p 3000:3000 nodejs-app

---

🚦 CI/CD Pipeline (GitHub Actions)

The CI/CD pipeline is implemented in:

.github/workflows/push-up.yaml

🔁 Triggered On:

• Push to main
• Pull Requests targeting main

🔧 Pipeline Steps:

1. Checkout repository
2. Set up Docker Buildx
3. Authenticate to Docker Hub
4. Build Docker image
5. Push image to Docker Hub (for pushes to main)
6. SSH into AWS EC2
7. Pull latest image
8. Stop old container (if exists)
9. Start new container mapped to ${DEPLOY_PORT}
10. Apply Docker health checks
11. Clean up old Docker images

---

🔐 Required GitHub Secrets

Add these under:

Settings → Secrets and variables → Actions

Secret Name	Description
DOCKER_USERNAME	Docker Hub username
DOCKER_PASSWORD	Docker Hub password/token
AWS_SSH_KEY	Private SSH key for EC2
AWS_HOST	EC2 public IP/DNS
DEPLOY_PORT	Port exposed on EC2 server

---

🧪 Running the Application Locally

Install dependencies:

npm install

Start the server:

npm start

Visit:

http://localhost:3000

---

🌐 Deployment Architecture

        ↓
GitHub Actions CI/CD Pipeline
        ↓
Docker Image Build
        ↓
Push Image to Docker Hub
        ↓
SSH into AWS EC2
        ↓
Pull Latest Image
        ↓
Stop Old Container
        ↓
Start New Container
        ↓
Health Check

📸 Screenshots (Ordered)

Order requested: EC2 NodeJS Status (1) → EC2 Instance (2) → Security Groups (3) → Deployed Page (4)

1) EC2 NodeJS Status

2) EC2 Instance Details

3) Security Groups

4) Deployed Page

🎯 Summary

This project demonstrates a complete, real-world CI/CD pipeline using GitHub Actions, Docker, and AWS EC2. The pipeline builds, ships, deploys, and verifies the application automatically—making it an efficient and fully automated DevOps workflow.