vmware-samples / vrealize-orchestrator-plug-in-for-redis

vRealize Orchestrator Plug-in for Redis

vRealize Orchestrator Plug-in for Redis

The vRealize Orchestrator Plug-in for Redis is a plug-in which provides integration capabilities with multiple Redis instances.

Plug-in features:

• Operations with hashes, lists, sets, sorted sets, geolocations
• Operations for scripting with Lua
• Cluster configurations are currently not supported

Plugin download

o11nplugin-redis.vmoapp

Supported platform version

The Redis plug-in supports vRO 8.4.2 and later.

Building the plug-in

First, you need to install the vRO Plug-in SDK version 8.4.2 because the project depends on it. After that the plug-in can be built using standard Maven commands:

mvn clean install

This will result in vmoapp and dar files in the o11nplugin-redis/target folder.

Sample scripting

Basic operations

//Store a simple key-value in redis
var statusCode = connection.defaultDatabase.set("test-key", "test-value");
//Retrieve value
var value = connection.defaultDatabase.get("test-key");

Scripting

var script = "return {KEYS[1],KEYS[2],ARGV[1],ARGV[2]}";
//Evaluate script
var result = connection.defaultDatabase.eval(script, ["key1", "key2"], ["arg1", "arg2"]);
//Load and evaluate script by sha
var sha = connection.defaultDatabase.scriptLoad(script);
result = connection.defaultDatabase.evalsha(sha, ["key1", "key2"], ["arg1", "arg2"]);

Dependencies

The Redis plug-in for vRO uses the following third-party libraries:

• Jedis - a Java-based Redis client.
• Google Guava - core libraries for Java-based projects, distributed under the Apache License, Version 2.0
• Apache Commons Pool - a library for object pooling

Contributing

The vrealize-orchestrator-plug-in-for-redis project team welcomes contributions from the community. If you wish to contribute code and you have not signed our contributor license agreement (CLA), our bot will update the issue when you open a Pull Request. For any questions about the CLA process, please refer to our FAQ.