​
App Platform

The App Platform is Uncloud’s PaaS layer — deploy applications from container images or git repositories with automatic SSL, custom domains, scaling, and rollback support.

​
How Apps Work

When you deploy an app, Uncloud creates the following Kubernetes resources:
  • Deployment — Manages your application pods
  • Service — Internal networking and load balancing
  • Ingress — External access with TLS termination
  • ConfigMap — Environment variables
  • Secret — Sensitive environment variables

​
Source Types

SourceDescription
imageDeploy from a Docker image (e.g., nginx:latest)
gitBuild and deploy from a git repository
uploadUpload a tarball of your source code

​
App Lifecycle

​
Deployment Flow

​
Image-Based Deployment

POST /api/v1/apps
{
  "name": "my-api",
  "source_type": "image",
  "image_url": "myregistry.com/my-api:v1.2",
  "port": 3000,
  "replicas": 2
}
  1. Uncloud creates a Kubernetes Deployment with the specified image
  2. A Service and Ingress are created for routing
  3. The app becomes accessible at my-api.yourdomain.com

​
Git-Based Deployment

POST /api/v1/apps
{
  "name": "my-frontend",
  "source_type": "git",
  "repo_url": "https://github.com/user/repo.git",
  "repo_branch": "main",
  "build_command": "npm run build",
  "port": 3000
}

​
Features

​
Custom Domains

Attach one or more custom domains to any app. Uncloud configures Ingress rules and can provision TLS certificates via cert-manager.

​
Environment Variables & Secrets

  • Env vars — Stored in ConfigMaps, visible in the dashboard
  • Secrets — Stored in Kubernetes Secrets, masked in the UI

​
Scaling

Set the number of replicas for horizontal scaling: 
PATCH /api/v1/apps/{id}
{ "replicas": 5 }

​
Deployment History & Rollback

Every deployment is recorded. Roll back to any previous deployment: 
POST /api/v1/apps/{id}/deployments/{deploymentId}/revert

​
Build Logs & App Logs

  • Build logs — Output from the build process (git/upload sources)
  • App logs — Live tail of application stdout/stderr from running pods

​
Metrics

Monitor CPU, memory, disk, and network usage per app via the metrics API.

​
Audit Log

Every action (deploy, config change, domain add) is recorded in the audit log for compliance and debugging.

​
Marketplace Templates

Deploy pre-configured applications with one click:
TemplateCategoryDescription
WordPressCMSFull WordPress with MySQL
GhostCMSModern publishing platform
StrapiCMSHeadless CMS
GrafanaMonitoringMetrics visualization
RedisCacheIn-memory data store
RabbitMQQueueMessage broker

​
Kubernetes Mapping

App ConceptKubernetes Resource
AppDeployment
NetworkingService + Ingress
Env varsConfigMap
SecretsSecret
Custom domainIngress rule + TLS cert
BuildJob (build pod)