puppet-graphql

This module provides a helper function to retrieve information from a GraphQL endpoint during catalog compilation.

Table of Contents

1. Description
2. Setup - The basics of getting started with graphql
3. Usage - Configuration options and additional functionality
4. Limitations - OS compatibility, etc.
5. Development - Guide for contributing to the module

Description

This module has been implemented mainly for the use-case of retrieving IP addresses from Netbox IPAM. But it can be used for any kind of GraphQL HTTP API.

Setup

This module only needs Ruby's built-in NEt::HTTP library. No further setup needed

Usage

Currently there is only a single function you can use in your puppet code:

$query = @(EOT)
    {
      site_list {
        id,
        slug,
        name,
      }
    }
    | EOT

$result = graphql::graphql_query({
    'url'     => 'https://netbox.tld/graphql/',
    'headers' => { 'Authorization' => "Token somenetboxtoken" },
    'query'   => $query,
})

# $result could be undef in case an error occured
# the error will be logged to the puppetserver logs and a notify resource will be created
if $result {
  $my_sites = $result['data']['site_list']
}


# ...

Limitations

This functions in this module - as all Puppet functions - can only be executed on the puppetmaster host during catalog compile time.

Development

Pull requests welcome.

If you submit a change to this module, be sure to regenerate the reference documentation as follows:

puppet strings generate --format markdown --out REFERENCE.md