Quickstart Guide

Create a Gitspace and develop a Node.js application.

Create a Gitspace for a Node.js app. Use it to write code, test changes, and publish changes to your remote repository.

Before you begin

Installation

Gitspaces are available when you install Harness Open Source. Go to the installation guide to install Harness Open Source.

Sample application

Create a Gitspace for the sample application in the Node.js demo repository. Fork the repository to make changes during this exercise.

Create a Gitspace

1. Sign up for or Login to Harness Open Source, and create a new project. You will see Gitspace available in the sidenav.

1. Click on "Get Started Now". To create a Gitspace using the sample app:

   • Choose the Other Public Git Repositories tab.

   • Repository URL is https://github.com/harness-community/demo-repo-nm (enter URL of your fork if you forked it). Make sure the URL exactly matches the clone URL for the repository since any extra characters can cause an error.

   • Leave the default branch main selected.

   • Select the IDE and click on Create Gitspace. For this Quickstart, choose VS Code Browser, which will open up the Gitspace in a new browser tab

2. After clicking on Create Gitspace, you’ll be redirected to the Gitspace Details page, where you can view the events and logs as the Gitspace is being created. Once it is ready, you can open the Gitspace by clicking the Open VS Code Online button at the top right of the page.

3. In the new browser tab, click on "Yes, I trust the authors" and "Mark Done" to get started. You can then start coding in the IDE as you normally would.

Developing in Gitspace

Now, let’s install dependencies for the sample app and run it. We will also make changes to it and commit back to the fork.

Run sample app

1. Open a new terminal.

2. All dependencies, packages, tools and libraries needed for this application were installed while provisioning the Gitspace based on the config in devcontainer.json. To run the sample app, run the following command in the terminal:

      npm run dev

   Your application will be available at proxy host 3000. You will see a message at the bottom right of your IDE with a link to open the app in browser.

The application shows the Harness canary in a variety of fun situations and poses.

Making changes to sample app

To make changes to the application, you should have forked it first and then created a Gitspace for the fork.

Steps to make changes and commit to source control:

1. You can make some changes to haikus.json such as delete one of the canary sections below. Save the file.

    { 
      "text": "traffic in bangalore,\ncondiser fying to work",        
      "image": "canary-flying.png"            
    },

1. In the Terminal, configure your GitHub credentials

   • git config --global user.email "[e-mail]"

   • git config --global user.name "Your Name"

2. Now that you've made a few changes, you can use the integrated terminal or the source view to commit your work. We will use the Source Control view for this example.

3. To stage your changes, click + next to the haikus.json file, or next to Changes if you've changed multiple files and you want to stage them all.

4. To commit your staged changes, type a commit message describing the change you've made, then click Commit.

5. Now Sync Changes, it will redirect you to login and authorize to your GitHub. After authorization, your changes will be committed to your fork.

You can now use Harness Open Source Gitspaces for development.