Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 extern
Octocat-spinner-32 packaging
Octocat-spinner-32 site_scons
Octocat-spinner-32 src
Octocat-spinner-32 webapp
Octocat-spinner-32 .gitignore
Octocat-spinner-32 CHANGES
Octocat-spinner-32 LICENSE
Octocat-spinner-32 NOTICE
Octocat-spinner-32 README
Octocat-spinner-32 SConstruct
README
   Cloudkick Changelog Tool
------------------------------

A command line tool for noting when something was changed on a machine.  The
contents of the message are POST'ed to another server for logging.

=== Configuration ==
There are only two configuration variables.  The address of an endpoint, 
and the secret key to authenticate the client. Both HTTPS and HTTP are 
supported, althgouh the SSL certificate is not yet validated.

== Example Config Flie ==
Put the following in /etc/ckl.conf:
  endpoint http://ckl.example.com/
  secret mySuperSecret

== Example Usage ==
 $ ckl -m 'I reconfigured postfix'

Will post to your configured endpoint the following data:
  - API Key
  - Log Message
  - Machine Hostname
  - Username
  - Timestamp

Endpoints are just HTTP or HTTPS servers configured with an application
to store this data.  The API key is just a secret string that it is up to the
endpoint to validate.

== Endpoints ==
A simple Python based endpoint is bundled in <webapp/ckl.cgi> which uses
an SQLite database to store change log entries.

The protocol is a simple HTTP form POST to the endpoint URL.  It should be
trivial to port the endpoint to any langauge of your choice.
Something went wrong with that request. Please try again.