Docs Hub VaagaTech Main
Overview Architecture CLI & API Docs Hub VaagaTech Main →
Developer & Platform Reference

CLI & REST API Reference

Automate multi-cloud infrastructure and declarative GitOps pipelines with the vaakops CLI, pipeline manifests, and HTTP management APIs.

Platform Architecture Return to Overview

Declarative Deployment Spec

Define multi-cloud applications, environment routing, and canary safety thresholds in concise YAML manifests.

yaml — vaakops.manifest.yaml GitOps Spec v1 
apiVersion: vaakops.vaagatech.com/v1
kind: ServiceDeployment
metadata:
  name: billing-reconciliation-service
  namespace: finance-core
spec:
  environment: canary # Dynamic: any custom env name supported
  replicas:
    min: 3
    max: 12
    targetCpuUtilization: 75%
  image:
    repository: registry.vaagatech.com/finance/billing
    tag: v2.4.1
  networking:
    domain: billing-canary.internal.vaagatech.com
    tls: managed-letsencrypt
    ingressRateLimit: 5000/minute
  policy:
    requireSignedImages: true
    denyPrivilegedContainers: true
    networkIsolation: strict
  rolloutStrategy:
    type: Canary
    steps:
      - weight: 10%
        pauseSeconds: 300
      - weight: 50%
        pauseSeconds: 600
      - weight: 100%
    automaticRollbackOnErrors: true
    errorThresholdPercentage: 0.5%

CLI & Automation Tooling

Command-line interface for platform engineers and automated CI/CD runners.

bash — vaakops CLI Cross-Platform 
# 1. Authenticate with the VaakOps control plane
vaakops auth login --org vaagatech

# 2. Inspect active environments and cluster health
vaakops env list
vaakops cluster status --region ap-south-1

# 3. Deploy service with real-time canary monitoring
vaakops deploy -f ./vaakops.manifest.yaml --wait

# 4. Trigger drift detection against production state
vaakops drift check --namespace finance-core

# 5. Execute emergency rollback to previous verified state
vaakops rollback service billing-reconciliation-service --to-version v2.4.0

REST API Reference

Programmatic endpoints for CI/CD integrations, monitoring meshes, and infrastructure controllers.

Method Endpoint Description
GET /api/v1/environments List all registered environments and their allocated cluster resources.
POST /api/v1/environments Register a dynamic environment namespace (e.g. uat, canary, perf).
GET /api/v1/deployments List active service deployments, image digests, and health statuses.
POST /api/v1/deployments Submit a deployment manifest for automated GitOps reconciliation.
POST /api/v1/deployments/:id/rollback Trigger immediate atomic rollback to previous verified image tag.
GET /api/v1/drift Fetch drift audit logs comparing cluster reality vs Git manifest.
POST /api/v1/remediate Trigger autonomous agent remediation on specified alert or drift ID.
GET /api/v1/audit-log Retrieve immutable audit records of all control plane operations.