NAME

       reclass - command-line interface

SYNOPSIS

       reclass --help
       reclass [options] --inventory
       reclass [options] --nodeinfo=NODENAME

DESCRIPTION

       reclass  is  an  "external  node  classifier" (ENC) as can be used with automation tools, such as Puppet,
       Salt, and Ansible. It is also a stand-alone tool for merging data sources recursively.

       The purpose of an ENC is to allow a system administrator to maintain an inventory of nodes to be managed,
       completely  separately  from  the  configuration  of  the  automation  tool.  Usually,  the external node
       classifier  completely  replaces   the   tool-specific   inventory   (such   as   site.pp   for   Puppet,
       ext_pillar/master_tops for Salt, or /etc/ansible/hosts).

       With respect to the configuration management tool, the ENC then fulfills two jobs:

       • it provides information about groups of nodes and group memberships

       • it gives access to node-specific information, such as variables

       reclass  allows you to define your nodes through class inheritance, while always able to override details
       further up the tree (i.e. in more specific nodes). Think of classes as  feature  sets,  as  commonalities
       between  nodes,  or  as  tags.  Add to that the ability to nest classes (multiple inheritance is allowed,
       well-defined, and encouraged), and you can assemble your infrastructure from  smaller  bits,  eliminating
       duplication  and exposing all important parameters to a single location, logically organised. And if that
       isn't enough, reclass lets you reference other  parameters  in  the  very  hierarchy  you  are  currently
       assembling.

       reclass  will  be used indirectly through adapters most of the time. However, there exists a command-line
       interface that allows querying the database. This manual page describes this interface.

OPTIONS

       Please see the output of reclass --help for the default values of these options:

   Database options
       -s, --storage-type
              The type of storage backend to use

       -b, --inventory-base-uri
              The base URI to prepend to nodes and classes

       -u, --nodes-uri
              The URI to the nodes storage

       -c, --classes-uri
              The URI to the classes storage

   Output options
       -o, --output
              The output format to use (yaml or json)

       -y, --pretty-print
              Try to make the output prettier

   Modes
       -i, --inventory
              Output the entire inventory

       -n, --nodeinfo
              Output information for a specific node

   Information
       -h, --help
              Help output

       --version
              Display version number

SEE ALSO

       Please visit http://reclass.pantsfullofunix.net/ for more information about reclass.

       The  documentation  is  also  available  from  the  ./doc  subtree  in  the  source  checkout,  or   from
       /usr/share/doc/reclass-doc.

AUTHOR

       martin f. krafft

COPYRIGHT

       2020, martin f. krafft