How to Deploy a Node.js Task Manager with Konduit on Civo

Deploying an application on Kubernetes can require you to manage clusters, configuration, and deployment workflows before you even get your application running. This can add unnecessary infrastructure work when your main goal is to deploy and manage an application.

In this tutorial, you'll deploy a Node.js Task Manager using Konduit on Civo. You'll start with the application code in a GitHub repository, register it with Konduit, configure the deployment settings, and deploy it to the dev environment. You don't need to manage the underlying Kubernetes cluster as part of this workflow.

After deploying the application, you'll verify that the app works, make a change to the application through Git, and let Konduit build and deploy the updated version. You'll also create a staging environment to see how you can separate development work from the existing application environment.

Prerequisites

• A Civo organization account with access to Konstruct.
• A GitHub organization connected to Konstruct.
• A Civo account connected to Konstruct.

Prepare the application

In this section, you'll prepare the Node.js Task Manager application and make it available in your GitHub organization. Konstruct uses the Git repository as the source for building and deploying the application.

You'll use a ready-made Node.js Task Manager application for this tutorial. You can find the source code in the GitHub repository.

Fork the repository into your GitHub organization so that you have your own copy of the application. You can then connect this repository to Konstruct in the next section.

After forking the repository, make sure the following files are available in the repository:

1konduit-nodejs-task-manager/
2├── public/
3│   ├── index.html
4│   ├── app.js
5│   └── styles.css
6├── src/
7│   └── server.js
8├── .gitignore
9├── LICENSE
10├── package.json
11└── README.md

You don't need to make any changes to the application code at this stage. You'll use this repository as the source for the initial deployment.

Register the application

After preparing the repository, you can register the application with Konstruct. This connects your GitHub repository to Konstruct and adds the application to the dev environment.

Sign in to your Konstruct dashboard and navigate to Konduit under Platform as a Service. Make sure you select the organization you want to use before continuing.

Click Register App.

Select the GitHub repository you prepared in the previous section and choose the main branch. Select a suitable application size, such as XS or S, and choose the region where you want to deploy the application.

For the application port, enter 3000.

Click Deploy Now to register the application and start the deployment.

Deploy the application

After registering the application, Konstruct starts the deployment and displays the build progress. Wait for the build and deployment to complete.

Once the deployment finishes successfully, Konstruct displays an option to publish the application.

Click Publish App to make the application publicly accessible.

After a short wait, Konstruct provides a public URL for the application. The application dashboard also shows the published status and URL.

You can use this URL in the next section to access and verify the application.

Access and verify the application

After the application is published, you can access it using the public URL provided by Konstruct.

Open the published URL in your browser. You should see the Task Manager application.

Add a task using the input field and click Add. The task should appear in the task list.

Mark the task as completed and verify that the task status and statistics update correctly.

You can also check the application's health endpoint by adding /health to the application URL:

1https://<your-app-url>/health

Replace:

• <your-app-url> with actual App URL. 

The endpoint should return a similar response:

1{
2  "status": "healthy",
3  "service": "konduit-nodejs-task-manager"
4}

This confirms that the application is running and responding to requests correctly.

Update the application through Git

After verifying the application, you can make changes to the source code and deploy the updated version through Git.

Open the GitHub repository you prepared earlier and select the main branch.

Open the file that contains the application's page title and make a small change. For example, change the main heading from:

1<h1>Task Manager</h1>

to:

1<h1>My Task Manager</h1>

Commit the change directly to the main branch.

Once the change is committed, Konstruct detects the new commit and starts a new build for the application. You can return to the Konstruct dashboard to view the build progress.

Wait for the new build to complete before moving to the next section.

Verify the updated deployment

After the new build completes, open the published application URL again.

You should now see the updated My Task Manager heading on the page.

Verify that the application still works by adding a task and marking it as completed.

You can also check the health endpoint again:

1https://<your-app-url>/health

The endpoint should return a similar response:

1{
2  "status": "healthy",
3  "service": "konduit-nodejs-task-manager"
4}

This confirms that Konstruct successfully deployed the updated application and that it is still responding correctly.

Create a staging environment

You can create a separate environment to test changes without affecting the application running in the dev environment.

From the Konstruct dashboard, open the environment selector and click + New environment.

Enter staging as the environment name and click Create Environment.

After creating the environment, select staging from the environment selector and click Register App.

Select the GitHub repository you prepared earlier and choose the main branch. Select the application size and region, then enter 3000 as the application port.

Click Deploy Now to deploy the application to the staging environment.

After the application is deployed successfully, a pop-up appears with the option to publish the application. Click Publish App.

After clicking Publish App, it may take a few moments for the application to become available. Once the process completes, the application appears as published in the dashboard.

Click the published URL to open the application and verify that it is working correctly.

Conclusion

In this tutorial, you deployed a Node.js Task Manager on Civo using Konstruct. You connected a GitHub repository, registered the application, configured the deployment, and published it to the dev environment.

You also updated the application through Git and verified that Konstruct automatically built and deployed the changes. Finally, you created a separate staging environment and deployed the application there for testing.

This workflow gives you a simple way to deploy an application to separate environments while keeping your application code in Git.