keyhan
bf9e827f85
Deploy backend, frontend, PostgreSQL, and Redis on Kubernetes with optional Ingress/TLS, SQL migration hooks, and public registry exposure at repo.3fase.ir. Co-authored-by: Cursor <cursoragent@cursor.com>
99 lines
5.1 KiB
Markdown
99 lines
5.1 KiB
Markdown
# Changelog
|
|
|
|
All notable changes to this project will be documented in this file.
|
|
|
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
|
|
## [Unreleased]
|
|
|
|
### Added
|
|
|
|
#### Helm Chart (`backend/helm/cloudhost-platform/`)
|
|
- **Platform chart** — deploy control plane (backend, frontend, PostgreSQL, Redis) on Kubernetes
|
|
- Ingress with `ingress.enabled` / `ingress.tls.enabled` and cert-manager TLS
|
|
- Post-install migration Job for SQL files in `migrations/`
|
|
- `values-production.example.yaml` for production overrides
|
|
|
|
#### Helm Chart (`backend/helm/cloudhost-app/`)
|
|
- **New Helm chart** replacing legacy Handlebars templates for all deployments
|
|
- `deployment.yaml` — app deployment with `imagePullSecrets`, `imagePullPolicy: Always`, health probes
|
|
- `service.yaml` — ClusterIP service (port 80 → app port)
|
|
- `ingress.yaml` — Nginx ingress with cert-manager TLS
|
|
- `secret.yaml` — user env vars as K8s Secret
|
|
- `db-deployment.yaml` — PostgreSQL or MySQL with readiness/liveness probes
|
|
- `db-service.yaml` — database ClusterIP service
|
|
- `db-pvc.yaml` — database storage with `helm.sh/resource-policy: keep`
|
|
- `db-secret.yaml` — database credentials with `helm.sh/resource-policy: keep`
|
|
- `wp-pvc.yaml` — WordPress wp-content PVC with keep policy
|
|
- `registry-pull-secret.yaml` — imagePullSecret for insecure registries
|
|
- `_helpers.tpl` — shared template helpers (name, namespace, labels, DB image, DB port)
|
|
- `values.yaml` — comprehensive defaults for all runtimes
|
|
- `Chart.yaml` — chart metadata (v0.1.0)
|
|
|
|
#### Helm Service (`backend/src/kubernetes/helm.service.ts`)
|
|
- **New HelmService** wrapping Helm CLI for install/upgrade, rollback, uninstall, history, status
|
|
- Temp file management for kubeconfig and values (mode 0o600, auto-cleanup)
|
|
- Full error handling with structured logging
|
|
|
|
#### Lifecycle Module (`backend/src/lifecycle/`)
|
|
- **New AppLifecycleService** — cron-based scanner (configurable interval, default 60s)
|
|
- State machine: `ACTIVE → SUSPENDED → PENDING_DELETION → DELETED`
|
|
- Auto-suspend expired apps (scale to 0 replicas)
|
|
- Auto-renew hourly plans from wallet balance
|
|
- Admin-configurable grace periods via `PlatformSettings` table
|
|
- `activateApp()` and `renewApp()` for payment reactivation
|
|
- **New LifecycleController** — `GET/PATCH /lifecycle/settings` (admin only)
|
|
- **New LifecycleModule** — wires service, controller, entities
|
|
|
|
#### Billing Enhancements (`backend/src/billing/`)
|
|
- **PlatformSetting entity** — key-value settings table for admin runtime config
|
|
- `calculateCostForApp()` method in BillingService
|
|
- `deductWallet()` method for programmatic wallet deductions
|
|
- Billing controller integrates lifecycle activation on payment
|
|
|
|
#### Application Entity Enhancements
|
|
- New fields: `planId`, `billingCycle`, `lifecycleStatus`, `planExpiresAt`, `suspendedAt`, `scheduledDeletionAt`
|
|
- `AppLifecycleStatus` enum: `active`, `suspended`, `pending_deletion`, `deleted`
|
|
- `BillingCycle` enum: `hourly`, `monthly`, `yearly`
|
|
|
|
#### Frontend
|
|
- Wallet balance display in dashboard header (all pages)
|
|
- Lifecycle status column in user apps list (color-coded badges)
|
|
- Plan expiry countdown in apps list
|
|
- Admin apps page: suspended/pending-deletion summary cards
|
|
- Admin billing page: lifecycle settings management section
|
|
- Updated TypeScript types for lifecycle and billing fields
|
|
|
|
#### Tests
|
|
- `build.service.spec.ts` — WordPress Dockerfile generation, PVC race condition, entrypoint script
|
|
- `helm.service.spec.ts` — HelmService chart path, temp files, history parsing
|
|
- `kubernetes.service.spec.ts` — `buildHelmValues()` logic, password generation
|
|
- `clusters.service.spec.ts` — getDefault logic, delete/reassign logic
|
|
|
|
### Changed
|
|
|
|
#### Build Service (`backend/src/build/build.service.ts`)
|
|
- **Runtime detection** — `detectRuntime()` now reads parent directory (not zip file itself)
|
|
- **WordPress support** — full Dockerfile generation with custom entrypoint for wp-content merging
|
|
- **Laravel fix** — generates `nginx.conf` and `supervisord.conf` inline (no longer requires user-provided files)
|
|
- **Laravel fix** — `composer.lock` made optional (`composer.lock*`)
|
|
- ConfigMap cleanup moved to `finally` block
|
|
|
|
#### Kubernetes Service (`backend/src/kubernetes/kubernetes.service.ts`)
|
|
- `buildHelmValues()` now includes `registry.url` for pull secret generation
|
|
- `deleteApplication()` rewritten — runs `helm uninstall` then explicitly deletes kept resources (PVCs, secrets, TLS certs)
|
|
- Added `scaleDeployment()` method for lifecycle suspend/resume
|
|
|
|
#### Applications Controller
|
|
- Delete endpoint no longer requires `app.clusterId && app.latestImageTag` — always attempts K8s cleanup
|
|
|
|
#### Configuration
|
|
- Added `lifecycle` config section with `scanIntervalMs` and per-cycle `deleteAfterMs` defaults
|
|
|
|
### Documentation
|
|
- **ARCHITECTURE.md** — complete rewrite: added WordPress, Helm charts, billing/lifecycle, all modules
|
|
- **README.md** — complete rewrite: added WordPress, billing, lifecycle, snapshots, tickets, new API endpoints
|
|
- **CHANGELOG.md** — created (this file)
|
|
- **CONTRIBUTING.md** — created with commit conventions, documentation requirements
|