A containerized microservice platform for automating the ingestion, processing, and serving of Windows Update metadata from the wsusscn2.cab file.

• Automated Sync: Periodically downloads and processes the latest wsusscn2.cab file
• Metadata Extraction: Parses update metadata and stores it in PostgreSQL
• CAB Rebuilding: Creates WUA-compatible CAB files grouped by various strategies
• REST API: Provides access to update metadata and CAB files
• Token Authentication: Secure API access with role-based permissions
• Web UI: User interface for managing tokens and viewing data
• Containerized: Runs as a set of Docker containers

• Docker and Docker Compose
• 2GB+ of RAM for the containers
• 10GB+ of disk space

1. Clone the repository:

   git clone https://github.com/yourusername/WSUSSCN2-API.git
   cd WSUSSCN2-API

2. Configure the environment:

   # Review and modify the default configuration
   cp iaac/.env.example iaac/.env

3. Start the services:

   cd iaac
   docker-compose up -d

4. Access the UI:

   http://localhost:3000
   

   Default credentials: admin / admin

1. Clone the repository:

   git clone https://github.com/yourusername/WSUSSCN2-API.git
   cd WSUSSCN2-API

2. Build and push the Docker images:

   # Build API image
   docker build -t wsusscn2-api/api:latest ./api
   
   # Build microservices images
   docker build -t wsusscn2-api/sync:latest ./backend/microservices/sync
   docker build -t wsusscn2-api/parse:latest ./backend/microservices/parse
   docker build -t wsusscn2-api/rebuild:latest ./backend/microservices/rebuild
   
   # Build UI image
   docker build -t wsusscn2-api/ui:latest ./ui
   
   # Push images to your registry if needed

3. Deploy to Kubernetes:

   # Create namespace and deploy components
   kubectl apply -f iaac/k8s/namespace.yaml
   kubectl apply -f iaac/k8s/configmap.yaml
   kubectl apply -f iaac/k8s/secrets.yaml
   kubectl apply -f iaac/k8s/postgres.yaml
   kubectl apply -f iaac/k8s/redis.yaml
   kubectl apply -f iaac/k8s/minio.yaml
   kubectl apply -f iaac/k8s/api.yaml
   kubectl apply -f iaac/k8s/microservices.yaml
   kubectl apply -f iaac/k8s/ui.yaml

4. Access the UI:

   http://wsusscn2-api.local
   

   Default credentials: admin / admin

   Note: You may need to add an entry to your hosts file or configure DNS to resolve wsusscn2-api.local to your Kubernetes ingress IP.

The system consists of several microservices:

• API Gateway: Entry point for all client requests
• Sync Service: Downloads and verifies the wsusscn2.cab file
• Parse Service: Extracts metadata from the CAB file
• Rebuild Service: Creates WUA-compatible CAB files
• UI: Web interface for managing tokens and viewing data

For more details, see Architecture Documentation.

For more details on permissions, see Permissions Documentation.

The system is configured through environment variables. See .env for available options.

WSUSSCN2-API/
├── api/                              # REST API
├── backend/microservices/            # Backend microservices
├── ui/                               # Radix UI frontend
├── configs/                          # Configuration files
├── iaac/                             # Infrastructure as code
└── docs/                             # Documentation

Each component can be built separately:

# Build API
cd api
dotnet build

# Build microservices
cd backend/microservices/sync
dotnet build

# Build UI
cd ui
npm install
npm run build

This project is licensed under the MIT License - see the LICENSE file for details.