Tooling Overview
The MATIH scripts/tools directory provides standalone operational scripts for building, deploying, diagnosing, and validating platform services. These tools are the primary interface for developers and operators working with the platform.
Available Tools
| Tool | Script | Description |
|---|---|---|
| Service Build and Deploy | service-build-deploy.sh | Build and deploy a single service |
| Platform Status | platform-status.sh | Diagnose cluster health |
| Database Tools | setup-databases.sh, flyway-repair.sh | Database setup and migration |
| Port Validation | validate-ports.sh | Detect port drift across layers |
| Ingress Tools | validate-tenant-ingress.sh, tenant-ingress-deploy.sh | Ingress and DNS management |
Additional Tools
| Script | Purpose |
|---|---|
full-service-rebuild.sh | Complete rebuild of a service including base images |
build-base-images.sh | Rebuild base Docker images |
local-service-validate.sh | Validate services locally before deployment |
validate-all-services.sh | Run validation across all services |
aks-health-check.sh | AKS cluster health diagnostics |
dgraph-status.sh | Check Dgraph graph database status |
generate-helm-charts.sh | Generate Helm charts from templates |
update-dockerfiles.sh | Update Dockerfiles with base image changes |
openapi-spec-audit.sh | Audit OpenAPI specifications for consistency |
Tool Design Principles
- Self-contained. Each tool sources its required libraries and can run independently.
- Idempotent. Tools can be run multiple times without side effects.
- Informative output. Color-coded logging with clear success/failure indicators.
- Dry-run support. Many tools support
--dry-runto preview changes. - Argument parsing. All tools accept
--helpfor usage documentation.