chef-hipchat-plugin

A plugin for Hipchat to get information from the Chef server. You will need to Deploy/Install this plugin, then configure it. Both are explained in this README.md.

Deployment or Installation

Heroku

Heroku Button

First click the following button to provision the instance:
After provisioning is done, set up heroku toolbelt
Login to the heroku cli: heroku login
Clone the git repo that is under the settings, cd into that directory.
Take note of the heroku application URL, edit the config.json line 96, with that URL.
Added the change to the master branch: git commit -am 'added new baseURL'
Push to heroku: git push heroku master
Refresh your instance, you should see a JSON blob.
Continue to the Configuration section.

Heroku by hand

If you would like to spin this up via heroku by hand, click here: docs/deployment/heroku.md

Local instance

If you would like to run this behind your own firewall, you should use the chef-hipchat-plugin-cookbook. There are a few things you need to do to set it up.

Provision a Ubuntu 14.04 machine
Install chef-client on the machine
Either upload the chef-hipchat-plugin-cookbook to your chef server, or run the chef-solo command that it suggests.
Verify that you can connect to that machine, and see the http://<machine>:3000/atlassian-connect.json
If your hipchat instance can reach the machine, and you chef server can reach the machine you've installed the plugin, you should be good to go.
Continue to the Configuration section.

Configuration

Go to your location, https://<url>/atlassian-connect.json you should see your application ready to install.
Inside Hipchat, click on Configure integrations on the bottom right.
Scroll to the bottom of the page, and click Install an integration from a descriptor URL.
Paste your heroku URL with atlassian-connect.json on the end to the Descriptor URL box, click Install.
Select the Room you'd like to install to, click Continue.
Verify this is what you'd like to install, click Approve.
Configure your Plugin via the required fields, congrats, you've installed the Plugin!

Commands

/chef environment NAME - Returns what is cookbooks are active in this environment
/chef health - Returns the health information of your chef server
/chef license - Returns the license usage for your chef server
/chef nodes - Lists out all the machine that your chef server knows about
/chef node-status FQDN - Returns information since the last converge of machine

License and Authors

Author:: Chef Partner Engineering ([email protected])

License:: Apache License, Version 2.0

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Contributing

Fork it ( https://github.com/chef-partners/chef-hipchat-plugin/fork )
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create a new Pull Request

thomascate / chef-hipchat-plugin Goto Github PK