Varkes (Greek for “small boats”) is a framework which mocks applications. This "small boat" allows you to mock even a complex application (a "big ship") and develop your functionality in an easy way. Instead of setting up and deploying an often complex application, you simply pair the mock with Kyma to develop and experiment with it. When you are done, simply switch the "ships" to connect to and work with the target application.
Varkes framework provides the following node modules to make the application mocks work:
API Server serves an API to pair with a Kyma cluster to register Events and APIs and send Events. For details, see API Server.
App Connector is a library used by the API-Server covering all communication to a Kyma cluster. For details, see App Connector.
Cockpit a UI of the API server for a convenient way of management. For details, see Cockpit.
OpenAPI Mock which mocks the application APIs based on the OpenAPI specification. For details, see OpenAPI mock.
OData Mock which mocks the application APIs based on the OData specification. For details, see OData mock.
The diagram shows how an application mock integrates with a Kyma cluster and which functionality is taken over by which framework modules:
Kyma on Minikube not supported At the moment the application connector API of Kyma is exposed via node ports on minikube (based on nginx ingress). The port number is not propagated correct in the links returned by the API of the application connector. With that the app-connector module will fail when trying to call that links. The issue is currently getting addressed in Kyma and a fix is planned for release 1.2 (based on istio-ingress avoiding node port usage)
examples folder includes mocks based on OpenAPI and OData packages.
NOTE: Using examples in the
masterbranch without cloning the repository is currently impossible because of the development version numbers used in the
package.jsonfiles which are not published to the npm registry. If you want to use the examples without cloning the whole repository, use the tags in the
releasebranch. There you can find the latest version of the dependencies already included in the
To create Docker images of examples, use the
release branch, where the npm installed in Docker containers can get the latest version from the registry.
This project is maintained by Lerna. To start developing perform these steps:
- If you don't have lerna, install it by running
npm install -g lerna.
- Clone this repo and run
make resolvein the project root to install dependencies and link local dependencies.
- Introduce your changes and commit freely. There is no need to update the package versions in dependent subprojects.
To increase the version number, run
lerna version --no-git-tag-version, stating the new version number. When omitting the flag, it also creates a new git tag with the given version number. This command also updates the dependency version in the
package.json of subprojects.
To see how CI operates on Lerna, check the makefile in the root folder.