Discover No-Code Kubernetes with the
harpoon GitHub App

Why GitHub + harpoon?

With harpoon available in the GitHub Marketplace, users are able to easily access harpoon's functionality, allowing them to leverage Kubernetes in a simplified and intuitive manner. The drag and drop capabilities eliminate the need for extensive coding knowledge, empowering developers to focus more on their applications and less on infrastructure management.

GitHub + harpoon offers a powerful synergy that combines the strengths of both platforms to enhance developers' productivity and streamline their Kubernetes workflows. Firstly, the ability to seamlessly deploy your GitHub repositories directly to Kubernetes through harpoon simplifies the deployment process and reduces time-consuming manual steps. Additionally, harpoon's integration with GitHub Actions allows developers to leverage their existing CI/CD workflows and take advantage of automated testing and deployment pipelines. Lastly, our single sign-on (SSO) capability with GitHub ensures a seamless and secure authentication experience, eliminating the need for separate login credentials. Together, harpoon provides developers with a comprehensive and efficient solution for managing Kubernetes deployments and accelerating the development lifecycle with GitHub.

How to set up the integration

1. Find the harpoon app
To get started, search for harpoon in the GitHub Marketplace, then click on the app. From there, select the “Set up a plan button” and then “Install it for free.”

  

  

2. Enter your credentials
You will then be prompted to enter your GitHub credentials and billing information, although no charges will be made to your account. Then, select the “Complete order and begin installation” button and “Install.”

  

  

3. Register with harpoon
If you’re new to harpoon, you can register with GitHub directly but clicking “Sign in with GitHub”.

4. Link your Cloud Service Provider account
While you can drag out any software or Kubernetes components you like, if you want to do actual deployments, you will first need to link your cloud service provider account. At the moment, harpoon supports Amazon Web Services (AWS), Google Cloud (GCP), and Microsoft Azure. We also support air-gapped, on-premise environments using VMWare.

In order to link your account, you will need to provide harpoon with your cloud service provider credentials. Your keys are only used for provisioning the necessary virtual infrastructure to provision Kubernetes in your account and scale up/down your cluster as you designate. We take security very seriously at harpoon, and use an extensive and layered security approach.

5. Start the cluster
Once you’ve linked your cloud service provider account, just click the “Start” button on the cloud/node element in the workspace. That’s it. The cloud/node element will turn yellow and update you on the status of your cluster deployment in real-time. While your experience may vary a bit, we tend to find that you can get a cluster up in under 10 minutes. When the cluster is running, the cloud will return and the element will glow a happy blue color.

6. Deployment
You can search for any container image you’d like by linking your GitHub account to search any GitHub repository (public or private) or by using Docker Hub. To deploy with harpoon, you can drag any search result over to the workspace for a visual representation of the software.

Deploying containers is as easy as hitting the “Deploy” button. GitHub containers will require you to build the repository first. In order for harpoon to successfully build a GitHub repository, we currently require the repository to have a top-level Dockerfile, which is an industry best practice. If the Dockerfile is there, once you click the “Build” button, harpoon will automatically find it and build a container image. After a successful build, the “Deploy” button will become enabled and you can deploy the software directly.

Once you have a deployment, you can attach any Kubernetes element to it, including Ingress Routes, ConfigMaps, Secrets, and Persistent Volume Claims (PVC).

Learn more and get support

For more detailed instructions on using harpoon, visit: https://docs.harpoon.io/. We can also be reached through the chat option on the app. In the bottom left corner of the page, select the blue message icon to submit a query to our “How can we help” form. Finally, you can also contact support@harpoon.io for additional inquiries.

What’s next?

Now that you have the resources to deploy your software to Kubernetes, what are you waiting for? Visit https://github.com/marketplace/harpoon-io to get started today.