Deploy an Application

This guide covers deploying an application using the App Platform — from a Docker image, a git repository, or a marketplace template.

Option 1: Deploy from a Docker Image

The simplest way to deploy. Point to any public or private container image.

curl -X POST http://localhost:8080/api/v1/apps \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-api",
    "source_type": "image",
    "image_url": "nginx:latest",
    "port": 80,
    "replicas": 2,
    "env": {
      "NODE_ENV": "production"
    }
  }'

Uncloud creates a Kubernetes Deployment, Service, and Ingress. Your app is accessible at my-api.<base-domain>.

Option 2: Deploy from Git

Build and deploy directly from a git repository:

curl -X POST http://localhost:8080/api/v1/apps \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-frontend",
    "source_type": "git",
    "repo_url": "https://github.com/user/frontend.git",
    "repo_branch": "main",
    "build_command": "npm run build",
    "port": 3000
  }'

Uncloud clones the repo, runs the build, pushes the image to the internal registry, and deploys.

Option 3: Deploy from Marketplace

Deploy a pre-configured application template:

# List available templates
curl http://localhost:8080/api/v1/library/templates

# Deploy WordPress
curl -X POST http://localhost:8080/api/v1/apps \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-blog",
    "template_id": "tmpl_wordpress",
    "port": 80
  }'

Configure Environment Variables

Set environment variables for your app:

curl -X PATCH http://localhost:8080/api/v1/apps/app_your_id \
  -H "Content-Type: application/json" \
  -d '{
    "env": {
      "DATABASE_URL": "postgresql://user:pass@host:5432/db",
      "REDIS_URL": "redis://cache:6379",
      "LOG_LEVEL": "info"
    }
  }'

Set Secrets

For sensitive values, use the secrets API:

curl -X POST http://localhost:8080/api/v1/apps/app_your_id/secrets \
  -H "Content-Type: application/json" \
  -d '{
    "key": "API_SECRET_KEY",
    "value": "super-secret-value"
  }'

Secrets are stored in Kubernetes Secrets and are not visible in the dashboard.

Scale Your App

curl -X PATCH http://localhost:8080/api/v1/apps/app_your_id \
  -H "Content-Type: application/json" \
  -d '{"replicas": 5}'

Add a Custom Domain

curl -X POST http://localhost:8080/api/v1/apps/app_your_id/domains \
  -H "Content-Type: application/json" \
  -d '{"domain": "api.example.com"}'

Then add a CNAME record pointing api.example.com to your cluster’s domain.

View Logs

# Application logs
curl http://localhost:8080/api/v1/apps/app_your_id/logs

# Build logs (for git/upload deployments)
curl http://localhost:8080/api/v1/apps/app_your_id/build-log

Redeploy

Trigger a new deployment (pulls latest image or rebuilds from git):

curl -X POST http://localhost:8080/api/v1/apps/app_your_id/deploy

Rollback

View deployment history and roll back to a previous version:

# List deployments
curl http://localhost:8080/api/v1/apps/app_your_id/deployments

# Rollback
curl -X POST http://localhost:8080/api/v1/apps/app_your_id/deployments/dep_previous_id/revert

Monitor Performance

curl http://localhost:8080/api/v1/apps/app_your_id/metrics

Next Steps

Add a custom domain with automatic TLS
Set up CI/CD pipelines for automated deployments
Configure backups for your app data

​Option 1: Deploy from a Docker Image

​Option 2: Deploy from Git

​Option 3: Deploy from Marketplace

​Configure Environment Variables

​Set Secrets

​Scale Your App

​Add a Custom Domain

​View Logs

​Redeploy

​Rollback

​Monitor Performance

​Next Steps