Implement Generic Service JavaScript

Currently, only Node.js 20 from version 20.11.1 is supported.

Further information: Node.js

Download link: Node.js Version20.x

A tool used to check the quality of the code.

Further information: ES Lint

This is used to overwrite the settings of the user workspace in VS Code (IDE).

Further information: Visual Studio Marketplace

Open Solution Designer and create a new project by clicking on the Create button and select Generic Service Projects (JavaScript). Provide additional information required and click on Create. Once this is created the project should appear in the Solution Designer. Optional: Open that project in Solution Designer and write a proper documentation.

In order to build and run the project, the Git project should be cloned to the user's workspace. In order to check out a Generic Service Project, open the project after creation, navigate to the General Information and copy the Git repository URI.

1. Alter the URL and add the Git user, so it looks like the following:

   • Before: https://auto-devops-url/managed-solutions/SOLTSgit
   • After: https://git@auto-devops-url/managed-solutions/SOLTS.git

2. Open a terminal and clone the project. You will be prompted for a password. Please use your personal access token as password:

   git clone https://git@auto-devops-url/managed-solutions/SOLTS.git

In order to install all the needed dependencies to run a Generic Service Project (JavaScript) on a local machine this command needs to be run in the project directory:

npm install

Normally, a Generic Service Project (JavaScript) does not need a build script, so there is none in the package.json file by default. However, with some frameworks, e.g. in frontend development, a build step is taken.

During the execution of the project pipeline, it is checked whether there is a build script in the package.json file. If this is found, it is also executed. Please note that the result must be written to the dist directory, as only the dist directory is included in the Docker image in addition to the src directory.

To run a build on a local computer, the following command can be executed in the project directory:

npm run build

If you also need a build script for local use, we recommend creating a script with the name build:local in the package.json file. This could then be called with the following command:

npm run build:local

It's highly recommended writing unit tests for your JavaScript projects. The unit tests will be executed during the project pipeline execution.

By default, the unit test step Enable Unit Test Execution is disabled

But once you enable Enable Unit Test Execution, the script (mentioned below) is ran. This script is configurable from package.json file in the repository.

npm run test:unit

To execute the linking of the sources on a local computer, the following command can be executed in the project directory:

npm run lint

If the linter should also try to fix problems automatically:

npm run lint:fix

To verify that a container in a pod is healthy and ready to handle traffic, there are several mechanisms. If it is determined that the pod is not healthy, it is restarted. Currently, the health status check is done by checking if the file /dist/src/index.js exists. By default, this file is created in the build process from the src/index.js file. If you deviate from this case, you must ensure that this file is present after a build process, otherwise the pod cannot start.

There are several ways to start a Generic Service Project (JavaScript) in the cluster.

First, it is checked whether a start script is specified in the package.json file. If this exists, it is called. All commands required for the start can be stored in the start script.

To start, call out the following command:

npm run start

If you also need a start script for local use, we recommend creating a script with the name start:local in the package.json file. This could then be called with the following command:

npm run start:local

If there is no start script in the package.json file, it is checked whether there is a file with the name start-server.sh in the root directory. If this file exists, it will be used for the start.

If there is neither a start script in the package.json file nor a start-server.sh file, the command * node dist/src/index.js* is used.