Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.skyhook.io/llms.txt

Use this file to discover all available pages before exploring further.

​
skyhook deploy

Deploy a service to an environment

​
Synopsis

Deploy a service to a specific environment. The command will infer the service from .koala.toml if in a service directory. You can specify the target environment with —env or be prompted to select one. Refs default to “main” for —config-ref and —ci-ref. When using -y (non-interactive), all unspecified refs will use defaults without prompting. 
skyhook deploy [flags]

​
Examples

  skyhook deploy                      # Deploy current service (prompts for env)
  skyhook deploy --env prod           # Deploy to production
  skyhook deploy --service billing    # Deploy specific service
  skyhook deploy --env staging --build  # Build and deploy to staging
  skyhook deploy --env dev --build --code-ref feature/my-branch -y  # Non-interactive build+deploy

​
Options

      --build               Build new image before deploying
      --ci-ref string       Git ref for CI workflow (default: main)
      --code-ref string     Git ref for code (branch/tag); defaults to current branch
      --config-ref string   Git ref for K8s config (default: main)
      --dry-run             Show what would be deployed without deploying
  -e, --env string          Target environment (e.g., dev, staging, prod)
  -h, --help                help for deploy
  -i, --interactive         Use the interactive multi-step form
  -s, --service string      Service to deploy
      --tag string          Image tag to deploy (for existing images)
  -y, --yes                 Skip all prompts and use defaults

​
Options inherited from parent commands

      --debug        Enable debug mode (shows full API requests/responses)
  -o, --org string   Organization name
  -v, --verbose      Enable user-friendly verbose output

​
SEE ALSO

  • skyhook - skyhook is a CLI tool to help you create and manage k8s services