https://github.com/kevoree/kevoree

The Kevoree Java project
https://github.com/kevoree/kevoree

component-based deployment java-8 runtime

Last synced: 2 months ago
JSON representation

The Kevoree Java project

• Host: GitHub
• URL: https://github.com/kevoree/kevoree
• Owner: kevoree
• License: lgpl-3.0
• Created: 2011-01-20T08:56:35.000Z (almost 14 years ago)
• Default Branch: master
• Last Pushed: 2022-11-16T08:29:23.000Z (about 2 years ago)
• Last Synced: 2024-10-13T15:41:31.173Z (3 months ago)
• Topics: component-based, deployment, java-8, runtime
• Language: Java
• Homepage: http://kevoree.org
• Size: 28.9 MB
• Stars: 38
• Watchers: 12
• Forks: 8
• Open Issues: 27
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Kevoree

Please find documentation at http://doc.kevoree.org

![Kevoree icon](https://raw.github.com/dukeboard/kevoree/master/kevoree-docs/kevoree-gris.png)

Please visit [kevoree.org](http://kevoree.org/)

## Structure

This repository contains all the **Kevoree Java** core, api and tooling.  

## Kevoree Java Runtime

Current dev version that only works with `https://new-registry.kevoree.org` is `5.5.0-SNAPSHOT`

### Download

```sh

mkdir -p /tmp/kevoree

cd /tmp/kevoree

wget http://oss.sonatype.org/service/local/artifact/maven/redirect?r=public\&g=org.kevoree\&a=org.kevoree.tools.runtime\&v=LATEST -O kevoree.jar

```

### Run

```sh

java -jar kevoree.jar

```

:warning: Note that you need to make your `.kevoree/config.json` point to the new Kevoree registry available at `https://new-registry.kevoree.org` for dev version **5.5.0-SNAPSHOT**

## Usage with Docker

Maybe the easiest way to get started with Kevoree is to use the Docker image: `kevoree/java:5.5.0-SNAPSHOT`

```sh

docker run -it -v /tmp/main.kevs:/tmp/main.kevs kevoree/java:5.5.0-SNAPSHOT -Dregistry.host=new-registry.kevoree.org -Dnode.bootstrap=/tmp/main.kevs

```

In the example above we are starting a Docker container using the **kevoree/java:5.5.0-SNAPSHOT** image.  

We are mounting a local KevScript file (in `/tmp/main.kevs` to the same location in the container) and we are telling Kevoree to use it to bootstrap with `-Dnode.bootstrap=/tmp/main.kevs`.  

We are also by-passing the default `registry.host` (ie. editor.kevoree.org) to point to the new one at `new-registry.kevoree.org`

## Usage with Maven

### POM file inheriting

If you want to create your own Kevoree component, node, group or channel you can use the **starter-parent** artefact:

```xml

  org.kevoree.library

  starter-parent

  KEVOREE_VERSION

```

### Manual dependencies management

You can also create your own **pom.xml** from scratch without using any `` like so:

```xml

	4.0.0

	your.group.id

	my-kevoree-comp

	1.0.0-SNAPSHOT

	YourGroupId :: MyKevoreeComp

	

    UTF-8

		1.8

		${java.version}

		${java.version}

		KEVOREE_VERSION

		yournamespace

		https://registry.kevoree.org

	

	

		

			org.kevoree

			org.kevoree.api

			${kevoree.version}

			provided

		

	

	

		

			

				org.apache.maven.plugins

				maven-surefire-plugin

			

			

			

				org.kevoree

				org.kevoree.tools.mavenplugin

				${kevoree.version}

				

					

						

							generate

							deploy

						

					

				

				

					${kevoree.registry.url}

					${kevoree.registry.namespace}

					${env.KEVS}

				

			

		

	

```

## 2. Standard Library documentation

[> Standard libraries repository](https://github.com/kevoree/kevoree-library)