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

https://github.com/ngerakines/consul-patch-json

A tool to patch JSON values in consul.
https://github.com/ngerakines/consul-patch-json

consul rust utility

Last synced: 2 months ago
JSON representation

A tool to patch JSON values in consul.

Awesome Lists containing this project

README

        

# consul-patch-json

A small tool used to patch JSON values in consul.

Usage:

$ consul-patch-json apps/foo/config version='"1.0.0"'

# Installation

$ cargo install consul-patch-json

# Consul Configuration

The following environment variables are used to configure consul interaction:

* `CONSUL_HTTP_ADDR`
* `CONSUL_CACERT`
* `CONSUL_CAPATH`
* `CONSUL_CLIENT_CERT`
* `CONSUL_CLIENT_KEY`
* `CONSUL_HTTP_TOKEN`
* `CONSUL_HTTP_SSL_VERIFY`

# Examples

# Adding attributes

$ consul kv put apps/foo/config '{"version": "1.0.0"}'
$ consul-patch-json apps/foo/config description='"My app"'
$ consul kv get apps/foo/config
{"description":"My app","version":"1.0.0"}

# Replacing attributes

$ consul kv put apps/foo/config '{"version": "1.0.0"}'
$ consul-patch-json apps/foo/config version='"1.0.1"'
$ consul kv get apps/foo/config
{"version":"1.0.1"}

# Complex attributes

$ consul kv put apps/foo/config '{"version": "1.0.0"}'
$ consul-patch-json apps/foo/config features='["metrics"]'
$ consul kv get apps/foo/config
{"features":["metrics"],"version":"1.0.0"}

# Reading standard input for single attributes

$ consul kv put apps/foo/config '{"version": "1.0.0"}'
$ echo '["coffee"]' | consul-patch-json apps/foo/config features=--
$ consul kv get apps/foo/config
{"features":["coffee"],"version":"1.0.0"}

# JSON Merge Patch (RFC 7396)

$ consul kv put apps/foo/config '{"version": "1.0.0"}'
$ jo features=$(jo -a coffee metrics) | consul-patch-json apps/foo/config --
$ consul kv get apps/foo/config
{"features":["coffee","metrics"],"version":"1.0.0"}

See also: https://datatracker.ietf.org/doc/html/rfc7396

# JSON Patch (RFC 6902)

$ consul kv put apps/foo/config '{"version": "1.0.0","features":["coffee"]}'
$ cat > patch.json <