Merge pull request #1 from weedu230/copilot/add-stans-repo-to-projects

Add STANS Navigation System deployment project to DevOps intermediate

Author: weedu230

src/data/projects/stans-deployment.md

@@ -0,0 +1,99 @@
+---
+title: 'STANS Navigation System Deployment'
+description: 'Deploy and manage the Smart Traffic-Aware Navigation System using Docker and CI/CD.'
+isNew: true
+sort: 1450
+difficulty: 'intermediate'
+nature: 'Docker'
+skills:
+  - 'docker'
+  - 'typescript'
+  - 'nginx'
+  - 'devops'
+seo:
+  title: 'STANS Navigation System Deployment'
+  description: 'Deploy and manage the Smart Traffic-Aware Navigation System using Docker, Nginx, and CI/CD pipelines.'
+  keywords:
+    - 'Docker'
+    - 'TypeScript'
+    - 'React'
+    - 'DevOps'
+    - 'CI/CD'
+roadmapIds:
+  - 'devops'
+---
+
+The goal of this project is to deploy and manage the [STANS (Smart Traffic-Aware Navigation System)](https://github.com/weedu230/STANS) - a React/TypeScript application that calculates optimal routes using graph algorithms. You will learn containerization with Docker, CI/CD automation with GitHub Actions, and production deployment strategies including security best practices.
+
+## Requirements
+
+You will containerize and deploy this traffic navigation system with proper DevOps practices.
+
+### Part 1: Fork and Setup
+
+Fork the [STANS repository](https://github.com/weedu230/STANS) to your GitHub account. Clone it locally and ensure you can run it with:
+
+```bash
+npm install
+npm run dev
+```
+
+### Part 2: Containerization
+
+Create a multi-stage Dockerfile for the STANS application:
+
+- **Stage 1**: Build the React application (`npm run build`)
+- **Stage 2**: Serve the built static files using Nginx
+
+The final Docker image should:
+- Be optimized for size (use Alpine-based images)
+- Expose port 80
+- Include proper Nginx configuration for React routing (handle client-side routing)
+- Not include development dependencies in the final image
+
+Test your Docker image locally:
+
+```bash
+docker build -t stans-app .
+docker run -p 8080:80 stans-app
+```
+
+The containerized application will have Nginx serving the static files inside the container.
+
+### Part 3: CI/CD Pipeline
+
+Create a GitHub Actions workflow (`.github/workflows/deploy.yml`) that:
+
+- Triggers on push to the main branch
+- Runs basic validation (verify the build completes successfully)
+- Builds the Docker image
+- Pushes the image to Docker Hub or GitHub Container Registry
+- (Optional) Deploys to a remote server using SSH
+
+Configure GitHub Secrets for:
+- Docker registry credentials
+- (Optional) SSH keys and server details
+
+### Part 4: Production Deployment
+
+Deploy the containerized application to a cloud server:
+
+- Set up a Linux server on AWS, DigitalOcean, or another provider
+- Install Docker on the server
+- Pull and run your Docker image on the server
+- Set up SSL/TLS with Let's Encrypt using Certbot (configure Nginx on the host for SSL termination)
+- Configure the server firewall (allow ports 80, 443, and 22 only)
+- Ensure the container restarts automatically (`--restart=always`)
+
+## Stretch Goals
+
+- **Monitoring**: Add Prometheus and Grafana to monitor container metrics
+- **Logging**: Implement centralized logging with ELK stack or similar
+- **Health Checks**: Add Docker health checks and configure automatic container restarts
+- **Load Balancing**: Deploy multiple instances behind a load balancer
+- **Infrastructure as Code**: Use Terraform or Ansible to automate the infrastructure setup
+- **Kubernetes**: Deploy the application to a Kubernetes cluster instead of a single server
+
+<hr />
+
+After completing this project, you will have hands-on experience with containerization, CI/CD pipelines, and production deployment of a modern web application.