MATIH Platform is in active MVP development. Documentation reflects current implementation status.
7. Tenant Lifecycle
Platform Deployment
Overview

Platform Deployment Overview

The platform deployment system tracks all deployments across environments, providing version management, deployment history, and rollback support. Deployment records are created by the CD pipeline and queried by administrators for operational visibility.


Architecture

The deployment tracking system is separate from Helm release management. While Helm releases track individual service deployments per tenant, platform deployments track coordinated releases of the entire platform across environments.

CD Pipeline                PlatformDeploymentController    PlatformDeploymentService
    |                              |                              |
    |--- Record deployment ------->|                              |
    |                              |--- recordDeployment() ------>|
    |                              |                              |--- Store record
    |                              |                              |--- Update current tag
    |<-- 201 Created --------------|<-- PlatformDeployment -------|

Deployment Record Fields

FieldDescription
imageTagContainer image tag (e.g., v2.1.0-abc1234)
gitCommitGit commit hash
gitBranchSource branch name
environmentTarget environment (dev, staging, prod)
acrRegistryContainer registry URL
helmChartVersionHelm chart version used
statusDeployment status
serviceVersionsPer-service version map
initiatedByWho triggered the deployment

Section Pages

PageDescription
Current DeploymentQuerying the current platform version
Rolling UpdatesHow rolling updates are tracked
Platform RollbackRolling back to a previous deployment