Satori/SystemInfoProposal

WORK IN PROGRESS

Specification for https://blueprints.launchpad.net/satori/+spec/poc-system-info

As Satori gathers information about a network location it accumulates a list of resources that are related. That resource list generally includes one or more Nova instances. If the user supplies the credentials to access the server, the discovery process should be extended to include fetching operating system and application-level information. Several open source applications exist today that can catalog this information. Satori should leverage one or more of these applications rather than recreating them.

Chef's Ohai
Ohai

System Info Plugins
Satori could provide a plugin structure so that several discovery applications could be supported.

Proposed Directory Structure
satori/sysinfo/ ohai.py               facter.py                blueprint.py                facts.py

Plugin Structure
def get_systeminfo(resource, config): return {}

Command line usage
Key from local disk:

$ satori https://domain.cqom --system-info=ohai -i /path/to/private.key

Using ssh-style arguments:

$ satori root@10.1.1.45 -i ~/.ssh/id_rsa

$ satori root@10.1.1.45 -i ~/.ssh/id_rsa -o ProxyCommand='ssh -qa bastion.example.com \ -p "nc -w 3600 server3 22"'

SSH Arguments to reserve:


 * o : options. ssh-style. (ProxyCommand, StrictHostKeyChecking)
 * i : identify file. ssh-style. by default, when run from the command-file, satori will try ~/.ssh/id_dsa, and ~/.ssh/id_ecdsa and ~/.ssh/id_rsa
 * L tunneling. ssh-style.

Out of Scope
Interesting ideas that could follow but won't be implemented first:


 * Automatically install the software discovery tool if its missing

Proposed Implementation Plan

 * 1) Alter `satori/shell.py main` to accept a private key
 * 2) Extend `satori/discovery.py run` to attempt to SSH into each server resource, execute the info gathering tool and fetch the results.
 * 3) Add the data to the resource record.
 * 4) Ensure the data is also opinionated.