implement full CI/CD pipeline with Docker image publishing

Author: stuartasiimwe7

.github/workflows/ci-cd.yml

@@ -0,0 +1,81 @@
+name: CI/CD
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+  release:
+    types: [ published ]
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python 3.12
+      uses: actions/setup-python@v3
+      with:
+        python-version: "3.12"
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements.txt
+    
+    - name: Lint with flake8
+      run: |
+        pip install flake8
+        flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics --exclude=.venv,yolov5,data
+        flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics --exclude=.venv,yolov5,data
+    
+    - name: Run tests
+      run: |
+        python -m pytest tests/ -v
+
+  build-and-push:
+    name: Build and Push Docker Image
+    runs-on: ubuntu-latest
+    needs: test
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Docker Buildx
+      uses: docker/setup-buildx-action@v3
+    
+    - name: Log in to GitHub Container Registry
+      uses: docker/login-action@v3
+      with:
+        registry: ghcr.io
+        username: ${{ github.actor }}
+        password: ${{ secrets.GITHUB_TOKEN }}
+    
+    - name: Extract metadata
+      id: meta
+      uses: docker/metadata-action@v5
+      with:
+        images: ghcr.io/${{ github.repository_owner }}/defectnet
+        tags: |
+          type=ref,event=branch
+          type=sha,prefix={{branch}}-
+          type=raw,value=latest,enable={{is_default_branch}}
+    
+    - name: Build and push Docker image
+      uses: docker/build-push-action@v5
+      with:
+        context: .
+        push: true
+        tags: ${{ steps.meta.outputs.tags }}
+        labels: ${{ steps.meta.outputs.labels }}
+        cache-from: type=gha
+        cache-to: type=gha,mode=max
+

.github/workflows/python-app.yml

@@ -1,6 +1,4 @@
-# DefectNet [![Tests](https://github.com/stuartasiimwe7/DefectNet/actions/workflows/python-app.yml/badge.svg)](https://github.com/stuartasiimwe7/DefectNet/actions/workflows/python-app.yml)
-[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+# DefectNet [![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![CI/CD](https://github.com/stuartasiimwe7/DefectNet/actions/workflows/ci-cd.yml/badge.svg)](https://github.com/stuartasiimwe7/DefectNet/actions/workflows/ci-cd.yml) 
 
 A RestFul API for automated detecting of defects in Printed Circuit Boards (PCBs) using YOLOv5 deep learning models, built with FastAPI.
 
@@ -101,7 +99,7 @@ There is comprehensive test coverage across all components with 32 passing tests
 
 **Prerequisites:** Python 3.8+ (see requirements.txt for dependencies)
 
-### Local Setup
+### Want to replicate?
 
 ```bash
 # Clone and navigate
@@ -124,6 +122,13 @@ uvicorn app:app --reload --host 0.0.0.0 --port 8000
 
 ### Docker Setup
 
+**Option 1: Pull from GitHub Container Registry**
+```bash
+docker pull ghcr.io/stuartasiimwe7/defectnet:latest
+docker run -p 8000:8000 ghcr.io/stuartasiimwe7/defectnet:latest
+```
+
+**Option 2: Build locally**
 ```bash
 docker build -t defectnet .
 docker run -p 8000:8000 defectnet
@@ -173,6 +178,20 @@ MAX_FILE_SIZE_MB=1
 LOG_LEVEL=INFO
 ```
 
+## CI/CD Pipeline
+
+This project uses GitHub Actions for continuous integration and deployment:
+
+**Continuous Integration:**
+- Automated testing on every push/PR
+- Code linting with flake8
+- Python 3.12 compatibility checks
+
+**Continuous Deployment:**
+- Automatic Docker image builds on main branch
+- Published to GitHub Container Registry
+- Tagged with commit SHA and 'latest'
+
 ## Testing
 
 Run all tests:
@@ -201,4 +220,4 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ## Acknowledgments
 
-Built using YOLOv5 by Ultralytics and FastAPI framework for production-ready PCB defect detection.
+Built using YOLOv5 by Ultralytics and FastAPI framework.