Skip to main content

How to get started with Go on Humalect platform

· 3 min read
Priyansh Khodiyar

Go is a statically typed, compiled high-level programming language designed at Google. It is syntactically similar to C, but with memory safety, garbage collection, structural typing, and CSP-style concurrency.

In this tutorial, we will see how can we deploy a sample Go application in a few clicks using the Humalect platform.

Let's get started!

Example Go application​

Fork THIS sample Go repository to get started.

This Go application exposes a static API that return a static response and runs on port 80.

Humalect Account Setup​

tip

Please skip to point 5 if you have setup your Humalect account and have a functional K8s cluster.

  1. Sign up: visit https://humalect.com and sign up. Complete the registration flow and log in.

  2. Integrate your Cloud Provider: Connect AWS/Azure by visiting THIS link and following their respective workflows.

  3. Integrate your source code provider: Visit THIS link, follow the respective workflow to connect Bitbucket/Github/GitLab.

  4. Create a Kubernetes Cluster: Create a k8s cluster by referring to our AWS or Azure docs.

  5. Create an environment

An environment is a logically isolated k8s namespace that contains all your deployment related entities for a pipeline.

Create an environment for your Go application. Check for various options that need to be configured to create a new environment or use an existing one.

info

These are some important fields:

  • Name of the environment that you wish to created: can be dev, prod or test etc.
  • Cluster in which you want to create this environment.
  • The namespace in the k8s cluster that will host this environment.
  1. Create a project.

A project maps the cluster and the code repository which needs to be deployed.

Refer the image below for various options that need to be configured to create a project.

go-app-project-creation

  1. Create a pipeline.

After creating your project, let's now create a pipeline to define few of the below things for our deployment:

  • The subdomain on which you need your deployment to go live.
  • The port on which your code runs.
  • The branch from your code repo that you want to deploy.
  • The environment that you want to deploy to.
  • Whether you want to enable continuous deployments.
  • The environment variables for your app.

Refer the image below for various options that need to be configured to create a pipeline.

go-app-pipeline-creation

next,

go-app-pipeline-creation

Advanced Options:

  • You can use the Dockerfile available in the git repo, check the box use Docker from source code.
  • Leave the autogenerated k8s YAML files, you can edit them if you wish (this can break things, edit only if you are aware of consequences)

Refer the image below for advanced options related to a pipeline.

go-app-pipeline-advanced

  1. Deploy pipeline.

Once your pipeline is created, hit the deploy pipeline button to deploy your app. If you have enabled continuous deployments while pipeline creation, all your future commits will be automatically deployed.

Refer image below for pipeline deployment.

go-app-deploy-pipeline

  1. See that your app is live.

Hit the See Deployment link next to your latest deployment and it will take you to the URL of your deployed application. The SSL certificates are auto-generated for you.

Refer image below for live deployment.

go-app-live

  1. Check logs and metrics.

Hit the Show Metrics and Logs button to view happenings of your latest deployment.

Refer image below for live deployment logs and metrics.

go-app-logs-metrics

We are done!

Happy deploying!