Skip to main content

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

TypeDescriptionExample
ACP HandlerAgentic Commerce Protocol handler for conversational checkoutDeploy ACP Handler
ChatGPT AppChatGPT plugin powered by StateSet ResponseDeploy ChatGPT App
iCommerce AppFull iCommerce application with agent sandboxiCommerce Quickstart
Custom ServiceAny 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