/cli

CLI tool for dead-simple serverless Docker deployments on managed Kubernetes services. A self-hosted PaaS. ⚡️

Primary LanguageTypeScriptMIT LicenseMIT

❄️ Self-hosted now deployments

Enjoy effortless deployments with a clone of now on a cloud of your choosing.

Features

  • ⚡️ Deploy docker images via snow (or snow deploy)
  • 🔒 Auto-configured SSL
  • 🔃 Auto-scaling

This is Magic 🔮

No, it isn't. This CLI abstracts away the complexities of using Kubernetes, cert-manager, Kaniko, and a private Docker Registry together, replicating the functionality provided by now.

Getting started

> npm i -g @snowjs/cli

# Install CLI tools
> snow install

# Create your kubernetes cluster (GCP)
> snow create

# Get your deployment's IP address
# And create a DNS 'A' record (e.g., myapp.com A 1.2.3.4)
> snow ip

# Deploy
> snow

Supported commands

Detailed descriptions of supported commands at docs/commands.md.

Support Command Description
<none> Deploy
alias [ls] List aliases
alias set <deployment> <alias> Create alias
alias rm <alias> Remove alias
certs [ls] List SSL Certificates
certs issue <cn> [<cn>] Issue certificate
certs rm <cn> Remove a certificate
🆕 create Create Kubernetes cluster
deploy Deploy
domains [ls] List domains
domains add <domain> Add domain
domains buy <domain> Buy domain
domains rm <domain> Remove domain
login Login
logout Logout
ls List deployments
🆕 install Install CLI tools (via brew)
🆕 ip Get IP Address of deployments
rm <name> Remove deployment
scale <deployment> <min> [<max>] Scale deployment
secrets [ls] List secrets
secrets add <key> <value> Create secret
secrets rename <old-key> <new-key> Rename secret
secrets rm <key> Remove secret

Tell me more

The essential CLI commands to understand are snow create and snow deploy.

Dependencies

The following CLI tools (installable via snow install) are necessary to orchestrate the entire end-to-end process, from Kubernetes cluster creation to managing your deployments:

  • kubectl (for managing deployments, secrets)
  • helm (for installing [tiller], cert-manager, and ingress-nginx on your cluster)
  • CLI tool for your cloud provider (e.g., gcloud).

If running Kubernetes locally on Minikube, you will additionally need these cli tools:

  • docker (for running local registry)
  • minikube (for running Kubernetes locally)
  • virtualbox (for creating docker images)