StateSet Deploy

One-click deployment service for commerce handlers, agents, and iCommerce apps on managed Kubernetes.

StateSet Deploy

StateSet Deploy builds and hosts commerce handlers and iCommerce applications on managed Kubernetes infrastructure. Connect your GitHub repository and deploy with a single click.

Features

• One-click deploy — Push to GitHub, Deploy builds and ships automatically.
• Docker builds — Builds container images from your repo’s Dockerfile.
• Managed Kubernetes — Runs on production-grade K8s with autoscaling and health checks.
• HTTPS by default — TLS certificates provisioned automatically.
• Custom domains — Point your own domain at a deployment.
• Persistent storage — Attach volumes for databases, file uploads, or caches.
• Environment secrets — Inject API keys and credentials securely.
• Deployment logs — Stream build and runtime logs in the console.

Supported Deployment Types

Type	Description	Example
ACP Handler	Agentic Commerce Protocol handler for conversational checkout	Deploy ACP Handler
ChatGPT App	ChatGPT plugin powered by StateSet Response	Deploy ChatGPT App
iCommerce App	Full iCommerce application with agent sandbox	iCommerce Quickstart
Custom Service	Any Docker container with an HTTP endpoint	—

How It Works

1. Connect — Link your GitHub repository in the StateSet Console.
2. Configure — Set environment variables, resource limits, and domain.
3. Deploy — StateSet builds a Docker image, pushes it to the registry, and creates a Kubernetes deployment.
4. Monitor — View build logs, runtime metrics, and health status in the console.

Quickstart

Deploy from the Console

1. Go to Dashboard > Deployments > New Deployment.
2. Select your GitHub repository.
3. Configure environment variables (e.g., STATESET_API_KEY).
4. Click Deploy.

Deploy via CLI

stateset deploy --repo https://github.com/your-org/your-app \
  --env STATESET_API_KEY=$STATESET_API_KEY \
  --domain your-app.stateset.cloud

Architecture

GitHub Push → Build (Docker) → Registry → Kubernetes Deployment
                                              │
                                              ├── HTTPS Ingress
                                              ├── Autoscaling
                                              ├── Health Checks
                                              └── Persistent Storage

Related Documentation

• Deploy README
• Deploy ACP Handler
• Deploy ChatGPT App
• Cloud API Reference