DevOps CI/CD Documentation for EMSv2026

 

🚀 DevOps CI/CD Documentation for EMSv2026

📌 1. Understand Your Application Stack

Before CI/CD, identify your components:

• Frontend → Angular / React
• Backend → Spring Boot / Django / .NET
• Database → SQL Server / MySQL
• Repo → GitHub

👉 CI/CD will automate:

• Build
• Test
• Deploy

---

🔧 2. Prerequisites

✔ GitHub repository (already created)
✔ Working project (frontend + backend)
✔ Basic Git knowledge
✔ Server or Cloud (Azure / AWS / Local VM)

---

🗂️ 3. Project Structure (Recommended)

EMSv2026/
 ├── frontend/
 ├── backend/
 ├── database/
 ├── docker/
 └── .github/workflows/

---

🔁 4. CI/CD Pipeline Flow

Developer → Git Push → CI Build → Test → Package → Deploy → Live App

---

⚙️ 5. Step-by-Step CI Setup (GitHub Actions)

✅ Step 5.1: Create Workflow Folder

Inside your project:

.github/workflows/

---

✅ Step 5.2: Create CI Pipeline File

Create file:

ci-cd.yml

---

✅ Step 5.3: Add Basic CI Pipeline

Example (Angular + Spring Boot/ASPY.NET CORE REST)

name: EMSv2026 CI/CD Pipeline

on:
  push:
    branches: [ "main" ]

jobs:

  build:
    runs-on: ubuntu-latest

    steps:
    - name: Checkout Code
      uses: actions/checkout@v3

    # Frontend Build
    - name: Setup Node
      uses: actions/setup-node@v3
      with:
        node-version: 18

    - name: Install Frontend Dependencies
      run: |
        cd frontend
        npm install

    - name: Build Frontend
      run: |
        cd frontend
        npm run build --prod

    # Backend Build
    - name: Setup Java
      uses: actions/setup-java@v3
      with:
        distribution: 'temurin'
        java-version: 17

    - name: Build Backend
      run: |
        cd backend
        mvn clean install

---

🧪 6. Add Testing Stage

    - name: Run Backend Tests
      run: |
        cd backend
        mvn test

👉 Why?

• Ensures code is stable before deployment

---

📦 7. Add Packaging (Artifact Creation)

    - name: Upload Build Artifacts
      uses: actions/upload-artifact@v3
      with:
        name: ems-build
        path: |
          frontend/dist/
          backend/target/*.jar

---

🐳 8. Dockerize the Application (Recommended)

Step 8.1: Backend Dockerfile

FROM openjdk:17
COPY target/*.jar app.jar
ENTRYPOINT ["java","-jar","/app.jar"]

Step 8.2: Frontend Dockerfile

FROM nginx:latest
COPY dist/ /usr/share/nginx/html

---

🚀 9. CD (Deployment Step)

Option 1: Deploy to Server (VM)

    - name: Deploy to Server
      uses: appleboy/ssh-action@v0.1.6
      with:
        host: ${{ secrets.SERVER_IP }}
        username: ${{ secrets.USER }}
        password: ${{ secrets.PASSWORD }}
        script: |
          cd EMSv2026
          git pull
          docker-compose up -d --build

---

Option 2: Deploy to Cloud

• Azure App Service
• AWS EC2 / Elastic Beanstalk
• Docker Hub + Kubernetes

---

🔐 10. Add Secrets in GitHub

Go to:

Repo → Settings → Secrets → Actions

Add:

• SERVER_IP
• USER
• PASSWORD
• DB_CONNECTION

---

📊 11. Pipeline Stages Summary

Stage	Purpose
Build	Compile code
Test	Validate code
Package	Create deployable
Deploy	Release to server

---

🔄 12. Workflow Trigger

Pipeline runs when:

git push origin main

---

🧠 13. Best Practices

✔ Use separate branches (dev, test, prod)
✔ Enable code reviews (PRs)
✔ Use environment-based configs
✔ Add logging & monitoring
✔ Use Docker + docker-compose

---

🎯 14. Final CI/CD Architecture

Developer
   ↓
GitHub Repo
   ↓
GitHub Actions (CI/CD)
   ↓
Docker Build
   ↓
Server / Cloud Deployment
   ↓
Live EMSv2026 App