Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/zeebe-io/zeebe-client-ruby

Zeebe client containing a simple wrapper for the gRPC protocol used by https://zeebe.io.
https://github.com/zeebe-io/zeebe-client-ruby

grpc-protocol ruby zeebe zeebe-client

Last synced: about 2 months ago
JSON representation

Zeebe client containing a simple wrapper for the gRPC protocol used by https://zeebe.io.

Awesome Lists containing this project

README

        

# Zeebe Ruby Client

![Build Status](https://github.com/zeebe-io/zeebe-client-ruby/workflows/ci/badge.svg)

[Zeebe](https://zeebe.io) client containing a simple wrapper for the GRPC protocol used by Zeebe.

## General Usage

Install the gem:

gem install zeebe-client

Run a Zeebe instance locally:

```sh
docker run -it --rm -p 26500:26500 camunda/zeebe:8.4.0
```

And then try the available [demo script](examples/demo.rb).

See the [changelog](CHANGELOG.md) before upgrading.

## Development

The `gen-grpc.sh` script can be used to generate Ruby code for the Zeebe proto.

To start Zeebe locally for running the integration tests use:

```sh
bundle exec rake zeebe:start
bundle exec rake spec
bundle exec rake zeebe:stop
```

To retrieve the latest GRPC proto from the Zeebe repository:

```sh
wget -O proto/gateway.proto https://raw.githubusercontent.com/camunda/zeebe/develop/gateway-protocol/src/main/proto/gateway.proto
```

## Status

This is a community extension for [Zeebe](https://zeebe.io) that will be maintained on a best effort basis.

## License

zeebe-client-ruby is licensed under the Apache License, Version 2.0. See LICENSE for more information.

## Code of Conduct

This project adheres to the Contributor Covenant [Code of
Conduct](/CODE_OF_CONDUCT.md). By participating, you are expected to uphold
this code. Please report unacceptable behavior to [email protected].