Deploy & Configure·Last Verified: 2026-07-14

Deploy from GitHub

Learn how repository scopes, auto-deploy configurations, and push webhooks operate.

Deploying source repositories involves linking your GitHub user or organization to Kubeletto. Once configured, Kubeletto registers webhook routes to listen to git commits.

How Auto-Deploy works

  • Kubeletto listens for GitHub push webhook payloads.
  • When a push event matches your configured deployment branch (e.g. main), it triggers an asynchronous build queue event.
  • A worker clones the branch at the current commit SHA and initiates compilation.

Manual Redeploy

To trigger a fresh build without forcing a new git commit, run the redeploy trigger:

Redeploy repository
kubeletto deploy my-service --repo git@github.com:your-user/your-repo.git --branch main

Cancelling a Deployment

There is currently no way to abort an in-progress build or rollout — from the CLI, the console, or the API. A running deployment always runs to a terminal state (active, build_failed, or deploy_failed).

If a bad deployment already went live, roll the service back to its last-known-good revision instead of trying to cancel it:

Roll back instead of cancelling
kubeletto rollback my-service --list
kubeletto rollback my-service --to <revision> --wait
Was this helpful?