https://github.com/kumuluz/kumuluzee-nodejs-samples
KumuluzEE Node.js and JavaScript samples for KumuluzEE microservices using Node.js.
https://github.com/kumuluz/kumuluzee-nodejs-samples
cloud-native jakartaee java javaee javascript kumuluzee microservices nodejs samples
Last synced: about 2 months ago
JSON representation
KumuluzEE Node.js and JavaScript samples for KumuluzEE microservices using Node.js.
- Host: GitHub
- URL: https://github.com/kumuluz/kumuluzee-nodejs-samples
- Owner: kumuluz
- Created: 2018-06-13T12:23:39.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T15:58:32.000Z (over 2 years ago)
- Last Synced: 2025-04-09T19:55:51.786Z (about 2 months ago)
- Topics: cloud-native, jakartaee, java, javaee, javascript, kumuluzee, microservices, nodejs, samples
- Language: JavaScript
- Homepage: https://ee.kumuluz.com/
- Size: 426 KB
- Stars: 0
- Watchers: 12
- Forks: 0
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
Awesome Lists containing this project
README
# KumuluzEE Node.js Samples
> These samples demonstrate how to get started using KumuluzEE microservice framework. They provide small, specific, working samples that can be used as a reference for your own projects.
These samples and quickstarts contain several working projects that demonstrate how to use [KumuluzEE](https://github.com/kumuluz/kumuluzee) microservices. They also serve as test projects for the framework itself.
We recommend that you go through some of these samples to get a better understanding of the framework and use them as a reference for your own projects.
Keep in mind that while projects containing multiple microservices are located in the same repository in order to simplify things, is is often recommended that you separate microservices by repository as well.
Samples will be constantly added over time.
## About
The samples demonstrate many different use cases for using KumuluzEE to create self-sustaining microservices. The latest version of the samples will always use the latest version of the KumuluzEE framework. Therefore, it is recommended to use the latest version of the KumuluzEE framework for these samples. This way, you will also get all the latest features of the KumuluzEE. Refer to the usage section on how to build and run the samples.
Some samples are tagged as well. The tags (eg. `v2.2.0`) will correspond to the KumuluzEE release version in order to easily access the desired version of the framework that is used in the examples. The `master` branch will always use the latest snapshot version of the framework and the latest samples.
The following samples are available (list might not be up-to-date; please refer to the actual list above):
Node.js samples:
- KumuluzEE Config
- KumuluzEE Discovery
- Tutorial with Node.js and Java services
## Requirements
In order to run these examples as they are intended, you will need the following:
1. Node.js >= 8.0.0 , you can use any implementation:
* If you have installed Node, you can check the version by typing the following in a command line:
```
node -v
```
2. NPM 5.5.0 (or newer):
* If you have installed NPM, you can check the version by typing the following in a command line:
```
npm -v
```
3. Git:
* If you have installed Git, you can check the version by typing the following in a command line:
```
git --version
```
## Usage
1. Clone the Git repository containing the examples:
```
git clone git@https://github.com/kumuluz/kumuluzee-nodejs-samples.git
```
2. Checkout the desired tagged version of the examples and the KumuluzEE framework (alternatively skip this step if you want the latest and greatest)
```
cd kumuluzee-nodejs-samples
git checkout v2.4.0
```
To run a specific sample, please refer to the specific README file of the sample.
Most of the time you either run it directly with a NPM command or build Docker containers and run them.
## Changelog
Recent changes can be viewed on Github on the [Releases Page](https://github.com/kumuluz/kumuluzee-nodejs-samples/releases)
## Contribute
See the [contributing docs](https://github.com/kumuluz/kumuluzee-nodejs-samples/blob/master/CONTRIBUTING.md)
When submitting an issue, please follow the [guidelines](https://github.com/kumuluz/kumuluzee-nodejs-samples/blob/master/CONTRIBUTING.md#bugs).
Issues related to KumuluzEE itself should be submitted at Issues page of appropriate library.
## License
MIT