chores: docker set-up

Author: dadadadas111

.dockerignore

@@ -0,0 +1,53 @@
+# Dependencies
+node_modules/
+npm-debug.log
+yarn-error.log
+package-lock.json
+yarn.lock
+
+# Build output
+dist/
+build/
+
+# Environment files
+.env
+.env.local
+.env.*.local
+
+# Firebase credentials
+firebase-service-account.json
+
+# Testing
+coverage/
+.nyc_output/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Git
+.git/
+.gitignore
+.gitattributes
+
+# Documentation (not needed in image)
+*.md
+docs/
+
+# CI/CD
+.github/
+.gitlab-ci.yml
+.travis.yml
+
+# Docker
+Dockerfile
+.dockerignore
+docker-compose*.yml
+
+# Logs
+logs/
+*.log

.github/workflows/docker-build.yml

@@ -0,0 +1,105 @@
+name: Build and Push Docker Image
+
+on:
+  push:
+    branches:
+      - master
+      - main
+    tags:
+      - 'v*'
+  pull_request:
+    branches:
+      - master
+      - main
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  test:
+    name: Test Application
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run linter
+        run: npm run lint
+
+      - name: Run tests
+        run: npm run test
+        continue-on-error: true
+
+      - name: Build application
+        run: npm run build
+
+  build-and-push:
+    name: Build and Push Docker Image
+    runs-on: ubuntu-latest
+    needs: test
+    if: github.event_name == 'push' && (github.ref == 'refs/heads/master' || github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/v'))
+    
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout code
+        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: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      # Optional: Uncomment to push to Docker Hub instead
+      # - name: Log in to Docker Hub
+      #   uses: docker/login-action@v3
+      #   with:
+      #     username: ${{ secrets.DOCKERHUB_USERNAME }}
+      #     password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      - name: Extract metadata (tags, labels)
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=ref,event=branch
+            type=ref,event=pr
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=semver,pattern={{major}}
+            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: .
+          file: ./Dockerfile
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+          platforms: linux/amd64,linux/arm64
+
+      - name: Image digest
+        run: echo ${{ steps.meta.outputs.digest }}

Dockerfile

@@ -0,0 +1,55 @@
+# Multi-stage Dockerfile for IoT Cloud MCP Bridge Server
+
+# Stage 1: Build
+FROM node:18-alpine AS builder
+
+# Set working directory
+WORKDIR /app
+
+# Copy package files
+COPY package*.json ./
+
+# Install dependencies (including dev dependencies for build)
+RUN npm ci
+
+# Copy source code
+COPY . .
+
+# Build the application
+RUN npm run build
+
+# Remove dev dependencies
+RUN npm prune --production
+
+# Stage 2: Production
+FROM node:18-alpine AS production
+
+# Set working directory
+WORKDIR /app
+
+# Create a non-root user
+RUN addgroup -g 1001 -S nodejs && \
+    adduser -S nestjs -u 1001
+
+# Copy package files
+COPY package*.json ./
+
+# Copy built application from builder stage
+COPY --from=builder --chown=nestjs:nodejs /app/dist ./dist
+COPY --from=builder --chown=nestjs:nodejs /app/node_modules ./node_modules
+
+# Create config directory for Firebase service account
+RUN mkdir -p /app/config && chown nestjs:nodejs /app/config
+
+# Switch to non-root user
+USER nestjs
+
+# Expose port
+EXPOSE 3001
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \
+    CMD node -e "require('http').get('http://localhost:3001/api/health', (r) => {process.exit(r.statusCode === 200 ? 0 : 1)})"
+
+# Start the application
+CMD ["node", "dist/main"]

README.md

@@ -36,6 +36,7 @@ A Model Context Protocol (MCP) bridge server for the IoT Cloud REST API, enablin
 
 - **[Quick Start Guide](docs/setup/QUICK_START.md)** - Get started quickly
 - **[Setup Checklist](docs/setup/SETUP_CHECKLIST.md)** - Complete setup guide
+- **[Docker Deployment](docs/deployment/DOCKER_DEPLOYMENT.md)** - Deploy with Docker & CI/CD
 - **[Render Deployment](docs/deployment/RENDER_DEPLOYMENT.md)** - Deploy to Render.com
 - **[Implementation Notes](docs/development/IMPLEMENTATION_NOTES.md)** - Development notes
 - **[Session Summary](docs/development/SESSION_SUMMARY.md)** - Development session logs
@@ -253,11 +254,12 @@ iot-cloud-mcp/
 - [x] Health check endpoint
 - [x] **MVP REST API endpoints** (Definitions, Locations, Groups, Devices, State)
 - [x] **Render deployment guide** (see [RENDER_DEPLOYMENT.md](docs/deployment/RENDER_DEPLOYMENT.md))
+- [x] **Docker configuration** (see [DOCKER_DEPLOYMENT.md](docs/deployment/DOCKER_DEPLOYMENT.md))
+- [x] **CI/CD pipeline** (GitHub Actions for automated builds)
 - [ ] Testing with real Firebase credentials
 - [ ] MCP resources (Partner, Project, Device, Location, Group) - Optional
 - [ ] MCP tools (CRUD operations) - Optional
 - [ ] Extended REST API (POST/PATCH/DELETE operations)
-- [ ] Docker configuration
 
 ## API Endpoints
 
@@ -327,12 +329,105 @@ npm run test:cov
 
 ### Docker
 
+#### Quick Start with Docker Compose
+
+The easiest way to run with Docker:
+
+```bash
+# Create .env file with your configuration
+cp .env.example .env
+
+# Build and start the container
+docker-compose up -d
+
+# View logs
+docker-compose logs -f
+
+# Stop the container
+docker-compose down
+```
+
+#### Manual Docker Build and Run
+
 ```bash
-# Build image
+# Build the image
 docker build -t iot-cloud-mcp .
 
-# Run container
-docker run -p 3001:3001 --env-file .env iot-cloud-mcp
+# Run with environment file
+docker run -d \
+  --name iot-cloud-mcp \
+  -p 3001:3001 \
+  --env-file .env \
+  iot-cloud-mcp
+
+# Or run with inline environment variables
+docker run -d \
+  --name iot-cloud-mcp \
+  -p 3001:3001 \
+  -e NODE_ENV=production \
+  -e PORT=3001 \
+  -e IOT_API_BASE_URL=https://your-api.com \
+  -e IOT_API_KEY=your-key \
+  -e FIREBASE_SERVICE_ACCOUNT='{"type":"service_account",...}' \
+  iot-cloud-mcp
+
+# View logs
+docker logs -f iot-cloud-mcp
+
+# Stop and remove container
+docker stop iot-cloud-mcp && docker rm iot-cloud-mcp
+```
+
+#### Pull from GitHub Container Registry
+
+Once CI/CD is set up, pull pre-built images:
+
+```bash
+# Pull latest image
+docker pull ghcr.io/YOUR_USERNAME/iot-cloud-mcp:latest
+
+# Run the pulled image
+docker run -d \
+  --name iot-cloud-mcp \
+  -p 3001:3001 \
+  --env-file .env \
+  ghcr.io/YOUR_USERNAME/iot-cloud-mcp:latest
+```
+
+### CI/CD Pipeline
+
+The project includes a GitHub Actions workflow that automatically:
+
+- ✅ Runs tests and linting on every push and pull request
+- ✅ Builds Docker images on push to `master`/`main` branch
+- ✅ Pushes images to GitHub Container Registry (GHCR)
+- ✅ Tags images with version numbers (from git tags)
+- ✅ Supports multi-architecture builds (amd64, arm64)
+
+**Setup Steps:**
+
+1. The workflow is already configured in [.github/workflows/docker-build.yml](.github/workflows/docker-build.yml)
+2. GitHub automatically provides `GITHUB_TOKEN` for GHCR access
+3. Push to `master` or `main` branch triggers the build
+4. Images are available at `ghcr.io/YOUR_USERNAME/iot-cloud-mcp`
+
+**Optional: Push to Docker Hub**
+
+To also push to Docker Hub, add secrets to your GitHub repository:
+
+1. Go to **Settings** → **Secrets and variables** → **Actions**
+2. Add `DOCKERHUB_USERNAME` and `DOCKERHUB_TOKEN`
+3. Uncomment the Docker Hub login section in the workflow file
+
+**Triggering Builds:**
+
+```bash
+# Automatic build on push to master
+git push origin master
+
+# Create a version tag for releases
+git tag -a v1.0.0 -m "Release v1.0.0"
+git push origin v1.0.0
 ```
 
 ### Railway