Skip to content

jetify-com/launchpad

Repository files navigation

Launchpad

From Code to Kubernetes in One Step

Join Discord License: Apache 2.0 version tests

What is it?

Launchpad is a command-line tool that lets you easily create applications on Kubernetes.

In practice, Launchpad works similar to Heroku or Vercel, except everything is on Kubernetes.

Demo

The example below initializes a web project with launchpad init, and deploys to a local Kubernetes cluster with launchpad up:

screen cast

Installing Launchpad

In addition to installing Launchpad itself, you will need to install docker since Launchpad depends on it:

  1. Install Docker Desktop.

  2. Install Launchpad:

    curl -fsSL https://get.jetify.com/launchpad | bash

Benefits

A Zero Ops workflow

Launchpad builds any image, publishes it to your Docker Registry, and deploys it to Kubernetes in one step. No need to manually build and push your image, setup your kube-context, or write long pages of Kubernetes YAML.

A Heroku-like experience on your own Kubernetes cluster

Ever wonder how you'd graduate from Heroku or a single EC2 machine to Kubernetes without going through a painful setup again? Faint not! With Launchpad, no manual migrations are required. In fact, developers can deploy and run their applications without needing to learn Kubernetes.

Secret management built-in

Secrets are tied to your launchpad projects, so they can be shared and updated securely by your team.

Quickstart: deploy to your Docker Desktop Kubernetes cluster

In this quickstart, we’ll deploy a cron job to your local Docker Desktop Kubernetes cluster.

  1. Open a terminal in a new empty folder called launchpad/.

  2. Enable Kubernetes on Docker Desktop

  3. Initialize Launchpad in launchpad/:

    > launchpad init

    You will see the following questions:

    ? What is the name of this project? // Press <Enter> to use the default name
    ? What type of service you would like to add to this project? // Choose `Cron Job`
    ? To which cluster do you want to deploy this project? // Choose `docker-desktop`
    

    This creates a launchpad.yaml file in the current directory. You should commit it to source control.

  4. Your launchpad.yaml file should now look like this:

       configVersion: 0.1.2
       projectId: ...
       name: app
       cluster: docker-desktop
       services:
         app-cron:
           type: cron
           image: busybox:latest
           command: [/bin/sh, -c, date; echo Hello from Launchpad]
           schedule: '* * * * *'
  5. Start a new deployment to Kubernetes:

    launchpad up
  6. Wait for a minute, and see the cron job in action:

    > kubectl get pods
    > kubectl logs <pod_name>
  7. Clean up:

    launchpad down

Additional commands

launchpad help - see all commands

launchpad auth - create a user, login, or logout (login required)

launchpad env - manage environment variables and secrets (login required)

launchpad cluster - create a cluster, list your clusters (login required)

Join our Developer Community

Contributing

Launchpad is an open-core project so contributions are always welcome. Please read our contributing guide before submitting pull requests.