puppet-jerakia's Introduction

http://jerakia.io

jerakia

A pluggable and extendable hierarchical data lookup system

Introduction

Jerakia is a tool that performs key value lookups against a variety of pluggable data stores. It does this using a top-down hierarchical set of queries that allow you to define global values and override them at different levels of a configurable hierarchy. This has many use cases, including infrastructure management where you often have configuration values defined at a global level but wish to override these values based on certain factors such as the environment or location of the request.

Key value pairs of data are looked up using a top-down search path allowing you to override values in a hierarchical way. Jerakia recieves a key to lookup a long with information about the requestor, using that information it traverses down a preconfigured hierarchy of queries until it finds the most relevant answer to return

The main goals and features of Jerakia are:

Hierarchical key value data lookups
Extendable framework to solve even the most complex edge cases
Decoupled from any particular configuration management system
Pluggable framework to encourage community plugin development

Features include:

YAML and JSON data source nativly included
HTTP REST API data source nativly included
Integration with Hashicorp Vault for encrypted secret lookups
REST server API

Usage and Documentation

Documentation is kept on the Official Website

Get help and support on the Jerakia users mailing list

Architecture

Jerakia is a policy based lookup system. A lookup request consists of a key, a namespace and a scope. The scope sets a list of key value pairs used for determining how the request is handled (eg: environment => development). Scopes are also pluggable and Jerakia can set the scope data in a variety of ways, by default it is passed as metadata information within the request, but other future options include PuppetDB, MCollective...etc. Each search request is passed to a pre-determined policy. The policy dictates a series of lookups that should be performed and in what order. Each lookup uses a configurable and pluggable data source to search for the lookup key. Lookups support various plugins to control and manipulate lookup requests and the final result returned from the back end data source is then optionally passed through a number of response filters before the data is finally serialized in a common format (JSON) and returned to the requestor.

Integration

There are various integration options for making requests to Jerakia.

Command line tool
Ruby API
REST API
Hiera 5 Backend
Ansible Lookup Plugin

Legacy (see jerakia-puppet ):

Puppet data binding terminus
Hiera 3.x Backend

Future integrations with other tools such as Chef and Rundeck are under development

Help and support

Raise issues on the github page, we would love to hear any feature requests that aren't currently covered by jerakia. There is also an IRC channel on freenode, #jerakia

License

Jerakia is distributed under the Apache 2.0 license

Achnowledgements

Sponsered by Baloise Group http://baloise.github.io

puppet-jerakia's People

Contributors

Stargazers

Watchers

puppet-jerakia's Issues

Puppet cannot load the jerakia-client gem

Need help,
Can't find what am I missing.

CenotOS 7.4
puppet --version 5.3.3 - PE 2017.3.2
jerakia version 2.4.0 - installed from repo

This is completely development fresh setup for experimentation purposes.
After installing following all instructions from official jerakia site I'm still getting this error:

Error: Could not retrieve catalog from remote server: Error 500 on SERVER: Server Error: Puppet cannot load the jerakia-client gem on node pup.dev

I wasn't able to find obvious instruction about installing jerakia-client

# puppetserver gem install jerakia-client
Fetching: jerakia-client-1.0.0.gem (100%)
Successfully installed jerakia-client-1.0.0
1 gem installed

systemctl restart pe-puppetserver

next error

Error: Could not retrieve catalog from remote server: Error 500 on SERVER: Server Error: Evaluation Error: Error while evaluating a Resource Statement, <h1>Internal Server Error</h1> at /etc/puppetlabs/code/environments/production/manifests/site.pp:32:3 on node pup.dev

and puppetserver.log
https://pastebin.com/gnG9DjAD

trying this:

# puppetserver gem install lookup_http
Fetching: lookup_http-1.0.3.gem (100%)
Successfully installed lookup_http-1.0.3
1 gem installed

But getting same error from above.

Dummy module for tests:

class testmod (
        $param,
) {
        file {'/root/test.txt':
                ensure => present,
                content => "${param}"
        }
}

site.pp

node default {
  #require testmod
  class {'testmod': }
}

# ss -tuln | grep 9843
tcp    LISTEN     0      100    127.0.0.1:9843                  *:*

systemctl status jerakia
● jerakia.service - Jerakia Server
   Loaded: loaded (/etc/systemd/system/jerakia.service; disabled; vendor preset: disabled)
   Active: active (running) since Wed 2017-12-06 15:25:13 +04; 1h 43min ago
 Main PID: 1780 (ruby)
   CGroup: /system.slice/jerakia.service
           └─1780 ruby /opt/jerakia/bin/jerakia server
...

All above is just working without jerakia.
Jerakia is working fine by itself

Recommend Projects

jerakia / puppet-jerakia Goto Github PK