bert.hausmans/cmdb-insight
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
df3f6f6899aff9c08d0c863ced20edffa568aa54
cmdb-insight/docs/AZURE-DEPLOYMENT-SUMMARY.md
Bert Hausmans a7f8301196 Add database adapter system, production deployment configs, and new dashboard components 
- Add PostgreSQL and SQLite database adapters with factory pattern
- Add migration script for SQLite to PostgreSQL
- Add production Dockerfiles and docker-compose configs
- Add deployment documentation and scripts
- Add BIA sync dashboard and matching service
- Add data completeness configuration and components
- Add new dashboard components (BusinessImportanceComparison, ComplexityDynamics, etc.)
- Update various services and routes
- Remove deprecated management-parameters.json and taxonomy files
2026-01-14 00:38:40 +01:00

9.3 KiB
Raw Blame History

Azure Deployment - Infrastructure Samenvatting

Applicatie Overzicht

Zuyderland CMDB GUI - Web applicatie voor classificatie en beheer van applicatiecomponenten in Jira Assets.

Technologie Stack

  • Backend: Node.js 20 (Express, TypeScript)
  • Frontend: React 18 (Vite, TypeScript)
  • Database: SQLite (cache layer, ~20MB, geen backup nodig - sync vanuit Jira)
  • Containerization: Docker
  • Authentication: Jira OAuth 2.0 of Personal Access Token
  • Gebruikers: Max. 20 collega's

Infrastructure Vereisten

1. Compute Resources

Aanbevolen: Azure App Service (Basic Tier)

  • App Service Plan: B1 (1 vCPU, 1.75GB RAM) - voldoende voor 20 gebruikers
  • 2 Web Apps: Backend + Frontend (deel dezelfde App Service Plan)
  • Kosten: ~€15-25/maand
  • Voordelen: Eenvoudig, managed service, voldoende voor kleine teams

Alternatief: Azure Container Instances (ACI) - Als je containers prefereert

  • 2 containers: Backend + Frontend
  • Backend: 1 vCPU, 2GB RAM
  • Frontend: 0.5 vCPU, 1GB RAM
  • Kosten: ~€30-50/maand
  • Nadeel: Minder managed features dan App Service

2. Database & Storage

Optie A: PostgreSQL (Aanbevolen) ⭐

  • Azure Database for PostgreSQL: Flexible Server Basic tier (B1ms)
  • Database: ~20MB (huidige grootte, ruimte voor groei)
  • Kosten: ~€20-30/maand
  • Voordelen: Identieke dev/prod stack, betere concurrency, connection pooling

Optie B: SQLite (Huidige situatie)

  • SQLite Database: ~20MB (in Azure Storage)
  • Azure Storage Account: Standard LRS (Hot tier)
  • Kosten: ~€1-3/maand
  • Nadelen: Beperkte concurrency, geen connection pooling

Logs: ~500MB-1GB/maand (Application Insights)

3. Networking

Vereisten:

  • HTTPS: SSL/TLS certificaat (Let's Encrypt of Azure App Service Certificate)
  • DNS: Subdomain (bijv. cmdb.zuyderland.nl)
  • Firewall: Inbound poorten 80/443, outbound naar Jira API
  • Load Balancer: Azure Application Gateway (optioneel, voor HA)

Network Security:

  • Private endpoints (optioneel, voor extra security)
  • Network Security Groups (NSG)
  • Azure Firewall (optioneel)

4. Secrets Management

Azure Key Vault voor:

  • JIRA_OAUTH_CLIENT_SECRET
  • SESSION_SECRET
  • ANTHROPIC_API_KEY
  • JIRA_PAT (indien gebruikt)

Kosten: ~€1-5/maand

5. Monitoring & Logging

Azure Monitor:

  • Application Insights (Basic tier - gratis tot 5GB/maand)
  • Log Analytics Workspace (Pay-as-you-go)
  • Alerts voor health checks, errors

Kosten: ~€0-20/maand (met Basic tier vaak gratis voor kleine apps)

6. Backup & Disaster Recovery

Geen backup vereist - Data wordt gesynchroniseerd vanuit Jira Assets, dus backup is niet nodig. De SQLite database is een cache layer die opnieuw opgebouwd kan worden via sync.

Deployment Architectuur

Aanbevolen: Azure App Service (Basic Tier)

Eenvoudige setup voor kleine teams (20 gebruikers):

┌─────────────────────────────────────┐
│    Azure App Service (B1 Plan)     │
│                                     │
│  ┌──────────┐      ┌──────────┐    │
│  │ Frontend │      │ Backend  │    │
│  │ Web App  │      │ Web App  │    │
│  └──────────┘      └────┬─────┘    │
└─────────────────────────┼──────────┘
                          │
            ┌─────────────┴─────────────┐
            │                          │
    ┌───────▼──────┐      ┌────────────▼────┐
    │ Azure Storage│      │ Azure Key Vault │
    │ (SQLite DB)  │      │ (Secrets)       │
    └──────────────┘      └─────────────────┘
            │
    ┌───────▼──────┐
    │ Application  │
    │ Insights     │
    │ (Basic/FREE) │
    └──────────────┘

Opmerking: Application Gateway is niet nodig voor 20 gebruikers - App Service heeft ingebouwde SSL en load balancing.

Security Overwegingen

1. Authentication

  • Jira OAuth 2.0: Gebruikers authenticeren via Jira
  • Session Management: Sessions in-memory (overweeg Azure Redis Cache voor productie)

2. Network Security

  • HTTPS Only: Alle verkeer via HTTPS
  • CORS: Alleen toegestaan vanuit geconfigureerde frontend URL
  • Rate Limiting: 100 requests/minuut per IP (configureerbaar)

3. Data Security

  • Secrets: Alle secrets in Azure Key Vault
  • Database: SQLite database in Azure Storage (encrypted at rest)
  • In Transit: TLS 1.2+ voor alle communicatie

4. Compliance

  • Logging: Alle API calls gelogd (geen PII)
  • Audit Trail: Wijzigingen aan applicaties gelogd
  • Data Residency: Data blijft in Azure West Europe (of gewenste regio)

Externe Dependencies

1. Jira Assets API

  • Endpoint: https://jira.zuyderland.nl
  • Authentication: OAuth 2.0 of Personal Access Token
  • Rate Limits: Respecteer Jira API rate limits
  • Network: Outbound HTTPS naar Jira (poort 443)

2. AI API (Optioneel)

  • Anthropic Claude API: Voor AI classificatie features
  • Network: Outbound HTTPS naar api.anthropic.com

Deployment Stappen

1. Azure Resources Aanmaken

# Resource Group
az group create --name rg-cmdb-gui --location westeurope

# App Service Plan (Basic B1 - voldoende voor 20 gebruikers)
az appservice plan create --name plan-cmdb-gui --resource-group rg-cmdb-gui --sku B1

# Web Apps (delen dezelfde plan - kostenbesparend)
az webapp create --name cmdb-backend --resource-group rg-cmdb-gui --plan plan-cmdb-gui
az webapp create --name cmdb-frontend --resource-group rg-cmdb-gui --plan plan-cmdb-gui

# Key Vault
az keyvault create --name kv-cmdb-gui --resource-group rg-cmdb-gui --location westeurope

# Storage Account (voor SQLite database - alleen bij SQLite optie)
az storage account create --name stcmdbgui --resource-group rg-cmdb-gui --location westeurope --sku Standard_LRS

Met PostgreSQL (Aanbevolen):

# PostgreSQL Database (Flexible Server)
az postgres flexible-server create \
  --resource-group rg-cmdb-gui \
  --name psql-cmdb-gui \
  --location westeurope \
  --admin-user cmdbadmin \
  --admin-password <secure-password-from-key-vault> \
  --sku-name Standard_B1ms \
  --tier Burstable \
  --storage-size 32 \
  --version 15

# Database aanmaken
az postgres flexible-server db create \
  --resource-group rg-cmdb-gui \
  --server-name psql-cmdb-gui \
  --database-name cmdb

2. Configuration

  • Environment variabelen via App Service Configuration
  • Secrets via Key Vault references
  • SSL certificaat via App Service Certificate of Let's Encrypt

3. CI/CD

  • Azure DevOps Pipelines of GitHub Actions
  • Automatische deployment bij push naar main branch
  • Deployment slots voor zero-downtime updates

Kosten Schatting (Maandelijks)

Voor 20 gebruikers - Basic Setup:

Met SQLite (huidige setup):

Component Schatting
App Service Plan (B1) €15-25
Storage Account €1-3
Key Vault €1-2
Application Insights (Basic) €0-5
Totaal €17-35/maand

Met PostgreSQL (aanbevolen):

Component Schatting
App Service Plan (B1) €15-25
PostgreSQL Database (B1ms) €20-30
Key Vault €1-2
Application Insights (Basic) €0-5
Totaal €36-62/maand

Inclusief: SSL certificaat (gratis via App Service), basis monitoring

Opmerking: Met Basic tier en gratis Application Insights kan dit zelfs onder €20/maand blijven.
Backup: Niet nodig - data wordt gesynchroniseerd vanuit Jira Assets.

Vragen voor Infrastructure Team

  1. DNS & Domain: Kunnen we een subdomain krijgen? (bijv. cmdb.zuyderland.nl)
  2. SSL Certificaat: Azure App Service Certificate of Let's Encrypt via certbot?
  3. Network: Moeten we via VPN/ExpressRoute of direct internet toegang?
  4. Firewall Rules: Welke outbound toegang is nodig? (Jira API, Anthropic API)
  5. Monitoring: Gebruiken we bestaande Azure Monitor setup of aparte workspace?
  6. Backup: Niet nodig - SQLite database is cache layer, data wordt gesynchroniseerd vanuit Jira Assets
  7. Disaster Recovery: Data kan opnieuw gesynchroniseerd worden vanuit Jira (geen backup vereist)
  8. Compliance: Zijn er specifieke compliance requirements? (ISO 27001, NEN 7510)
  9. Scaling: Niet nodig - max. 20 gebruikers, Basic tier is voldoende
  10. Maintenance Windows: Wanneer kunnen we updates deployen?

Next Steps

  1. Kick-off Meeting: Bespreken architectuur en requirements
  2. Proof of Concept: Deploy naar Azure App Service (test environment)
  3. Security Review: Security team review van configuratie
  4. Load Testing: Testen onder verwachte load
  5. Production Deployment: Go-live met monitoring

Contact & Documentatie

  • Application Code: [Git Repository]
  • Deployment Guide: PRODUCTION-DEPLOYMENT.md
  • API Documentation: /api/config endpoint
Reference in New Issue View Git Blame Copy Permalink