diff --git a/CHANGELOG.rst b/CHANGELOG.rst new file mode 100644 index 0000000..628a589 --- /dev/null +++ b/CHANGELOG.rst @@ -0,0 +1,41 @@ +######### +Changelog +######### + +0.0.2 +===== +In this release we've introduced a few new things. First of all we now require +pypuppetdb version 0.0.4 or later which includes support for the v3 API +introduced with PuppetDB 1.5. + +Because of changes in PuppetDB 1.5 and therefor in pypuppetdb users of the v2 +API, regardless of the PuppetDB version, will no longer be able to view reports +or events. + +In light of this the following settings have been removed: + +* ``PUPPETDB_EXPERIMENTAL`` + +Two new settings have been added: + +* ``PUPPETDB_API``: an integer, defaulting to ``3``, representing the API + version we want to use. +* ``ENABLE_QUERY``: a boolean, defaulting to ``True``, on wether or not to + be able to use the Query tab. + +We've also added a few new features: + +* Thanks to some work done during PuppetConf together with Nick Lewis (from + Puppet Labs) we now expose all of PuppetDB's metrics in the Metrics tab. The + formatting isn't exactly pretty but it's a start. +* Spencer Krum added the graphing capabilities to the Facts tab. +* Daniel Lawrence added a feature so that facts on the node view are clickable + and take you to the complete overview of that fact for your infrastructure + and made the nodes in the complete facts list clickable so you can jump to a + node. +* Klavs Klavsen contributed some documentation on how to run Puppetboard with + Passenger. + +0.0.1 +===== +Initial release. diff --git a/README.rst b/README.rst index ecf9adb..3978570 100644 --- a/README.rst +++ b/README.rst @@ -17,7 +17,7 @@ Because this project is powered by Flask we are restricted to: * Python 2.6 * Python 2.7 -.. image:: https://raw.github.com/nedap/puppetboard/master/screenshots/node-experimental.png +.. image:: https://raw.github.com/nedap/puppetboard/master/screenshots/node-v3.png :alt: View of a node :width: 1024 :height: 700 @@ -68,6 +68,7 @@ and ``uwsgi`` can deal with. * Apache mod_wsgi configuration: http://flask.pocoo.org/docs/deploying/mod_wsgi/ * uwsgi configuration: ``uwsgi --http :9090 --wsgi-file /path/to/puppetboard/wsgi.py`` + * Passenger In the case of uwsgi you'll of course need something like nginx in front of it to proxy the requests to it. @@ -76,6 +77,31 @@ Don't forget that you also need to serve the ``static/`` folder on the ``/static`` URL of your vhost. (I'm considering embedding the little additional Javascript and CSS this application has so no one has to bother with that). +Passenger +^^^^^^^^^ +From within the Puppetboard checkout: + +.. code-block:: bash + mkdir public + mkdir tmp + ln -s wsgi.py passenger_wsgi.py + +The apache vhost configuration: + +.. code-block:: + + ServerName puppetboard.example.tld + DocumentRoot /path/to/puppetboard/public + + RackAutoDetect On + Alias /static /path/to/puppetboard/static + + Options None + Order allow,deny + allow from all + + + Configuration ============= @@ -208,16 +234,16 @@ Screenshots :height: 700 :align: center -With experimental endpoints ---------------------------- - -.. image:: https://raw.github.com/nedap/puppetboard/master/screenshots/nodes-experimental.png +API v3 +------ + +.. image:: https://raw.github.com/nedap/puppetboard/master/screenshots/nodes-v3.png :alt: Nodes table with experimental endpoints enabled :width: 1024 :height: 700 :align: center -.. image:: https://raw.github.com/nedap/puppetboard/master/screenshots/node-experimental.png +.. image:: https://raw.github.com/nedap/puppetboard/master/screenshots/node-v3.png :alt: Node view with experimental endpoints enabled :width: 1024 :height: 700 @@ -228,18 +254,3 @@ With experimental endpoints :width: 1024 :height: 700 :align: center - -Error page ----------- - -.. image:: https://raw.github.com/nedap/puppetboard/master/screenshots/no-experimental.png - :alt: Accessing disabled experimental feature - :width: 1024 - :height: 700 - :align: center - -.. image:: https://raw.github.com/nedap/puppetboard/master/screenshots/broken.png - :alt: Error message - :width: 1024 - :height: 700 - :align: center diff --git a/screenshots/facts.png b/screenshots/facts.png index d26d05f..fd62d46 100644 Binary files a/screenshots/facts.png and b/screenshots/facts.png differ diff --git a/screenshots/no-experimental.png b/screenshots/no-experimental.png deleted file mode 100644 index 7960da0..0000000 Binary files a/screenshots/no-experimental.png and /dev/null differ diff --git a/screenshots/node-experimental.png b/screenshots/node-v3.png similarity index 100% rename from screenshots/node-experimental.png rename to screenshots/node-v3.png diff --git a/screenshots/nodes-experimental.png b/screenshots/nodes-v3.png similarity index 100% rename from screenshots/nodes-experimental.png rename to screenshots/nodes-v3.png