In this tutorial, we will see how can we deploy a sample NodeJS application in a few clicks using the Humalect platform.
Let's get started
Example Node.JS application
Fork this sample Node.JS repository to get started.
This NodeJS application exposes a static API that return a static response and runs on port 80.
Humalect Account Setup
[please skip to point 5 if you have setup your Humalect account and have a functional k8s cluster]
Sign up: visit https://humalect.com and sign up. Complete the registration flow and log in.
Integrate your Cloud Provider: Connect AWS/Azure by visiting this link and following their respective workflows.
Integrate your source code provider: Visit this link, follow the respective workflow to connect Bitbucket/Github/GitLab.
Create a Kubernetes Cluster: Create a k8s cluster by referring to our AWS or Azure docs.
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 NodeJS application. Refer the image below for various options that need to be configured to create a new environment.
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
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
we are done!