Deploy your app

Once you have a running Kubernetes cluster, you can deploy your containerized applications on top of it. Follow these steps to set up and run a Kubernetes cluster and deploy your first app.

  1. Set up a Kubernetes cluster
  2. Link your cluster to KubeSail
  3. Deploy from GitHub repository

deploy from repo

Step 1: Set up a Kubernetes cluster

There's a few options to set up and run a Kubernetes cluster. You can either run Kubernetes on a local machine, or use a managed Kubernetes provider. Depending on where you choose to run Kubernetes, the setup steps are different.

Managing your own cluster

Installing Kubernetes on your own machine, a dedicated computer, or Raspberry Pi is ideal for a learning environment. There's several options for running Kubernetes locally.

Managed cloud services

Running Kubernetes on a managed cloud service is ideal for a production environment. These services come with Kubernetes pre-installed. There's several options for provisioning a cluster.

Install the KubeSail agent on your cluster to enable two main functions:

  • Manage apps on your cluster
  • Expose apps to the internet

From the KubeSail dashboard under Clusters, click + Add Cluster.

add new cluster

To add your cluster to KubeSail, apply the configuration file to your cluster using kubectl:

kubectl apply -f https://byoc.kubesail.com/<your-kubesail-username>.yaml

Step 3: Deploy from GitHub repository

From the KubeSail dashboard under Repos, click Connect New Repository, and select which repo you want to install the KubeSail DeployBot. You can grant access to selected repositories within the user or organization's account.

give deploybot permissions

Once you grant KubeSail access to a GitHub repository, it appears under Repos within the KubeSail dashboard.

Select the newly added repository to view the suggested pipeline. Pick a branch to build and a Kubernetes context from the dropdowns, and then click Build Now. You can view the build logs beneath your pipeline.

build pipeline

Once your app successfully builds and deploys, it appears under Apps within the KubeSail dashboard.