0.0.2: Release.
This is the second 'release' for Puppetboard introducing some new features and compatibility with PuppetDB 1.5 / v3 API.
41
CHANGELOG.rst
Normal file
@@ -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.
|
||||||
51
README.rst
@@ -17,7 +17,7 @@ Because this project is powered by Flask we are restricted to:
|
|||||||
* Python 2.6
|
* Python 2.6
|
||||||
* Python 2.7
|
* 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
|
:alt: View of a node
|
||||||
:width: 1024
|
:width: 1024
|
||||||
:height: 700
|
:height: 700
|
||||||
@@ -68,6 +68,7 @@ and ``uwsgi`` can deal with.
|
|||||||
|
|
||||||
* Apache mod_wsgi configuration: http://flask.pocoo.org/docs/deploying/mod_wsgi/
|
* Apache mod_wsgi configuration: http://flask.pocoo.org/docs/deploying/mod_wsgi/
|
||||||
* uwsgi configuration: ``uwsgi --http :9090 --wsgi-file /path/to/puppetboard/wsgi.py``
|
* 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
|
In the case of uwsgi you'll of course need something like nginx in front of it to
|
||||||
proxy the requests to it.
|
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
|
``/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).
|
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::
|
||||||
|
<VirtualHost *:80>
|
||||||
|
ServerName puppetboard.example.tld
|
||||||
|
DocumentRoot /path/to/puppetboard/public
|
||||||
|
|
||||||
|
RackAutoDetect On
|
||||||
|
Alias /static /path/to/puppetboard/static
|
||||||
|
<Directory /path/to/puppetboard/>
|
||||||
|
Options None
|
||||||
|
Order allow,deny
|
||||||
|
allow from all
|
||||||
|
</Directory>
|
||||||
|
</VirtualHost>
|
||||||
|
|
||||||
Configuration
|
Configuration
|
||||||
=============
|
=============
|
||||||
|
|
||||||
@@ -208,16 +234,16 @@ Screenshots
|
|||||||
:height: 700
|
:height: 700
|
||||||
:align: center
|
:align: center
|
||||||
|
|
||||||
With experimental endpoints
|
API v3
|
||||||
---------------------------
|
------
|
||||||
|
|
||||||
.. image:: https://raw.github.com/nedap/puppetboard/master/screenshots/nodes-experimental.png
|
.. image:: https://raw.github.com/nedap/puppetboard/master/screenshots/nodes-v3.png
|
||||||
:alt: Nodes table with experimental endpoints enabled
|
:alt: Nodes table with experimental endpoints enabled
|
||||||
:width: 1024
|
:width: 1024
|
||||||
:height: 700
|
:height: 700
|
||||||
:align: center
|
: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
|
:alt: Node view with experimental endpoints enabled
|
||||||
:width: 1024
|
:width: 1024
|
||||||
:height: 700
|
:height: 700
|
||||||
@@ -228,18 +254,3 @@ With experimental endpoints
|
|||||||
:width: 1024
|
:width: 1024
|
||||||
:height: 700
|
:height: 700
|
||||||
:align: center
|
: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
|
|
||||||
|
|||||||
|
Before Width: | Height: | Size: 287 KiB After Width: | Height: | Size: 170 KiB |
|
Before Width: | Height: | Size: 110 KiB |
|
Before Width: | Height: | Size: 241 KiB After Width: | Height: | Size: 241 KiB |
|
Before Width: | Height: | Size: 276 KiB After Width: | Height: | Size: 276 KiB |