Skip to content

Latest commit

 

History

History
39 lines (26 loc) · 1.13 KB

plugins.md

File metadata and controls

39 lines (26 loc) · 1.13 KB

Plugins

Samson now supports writing plugins to add functionality to the core app keeping the core isolated and simpler. You can thus add UI elements to pages that support it, and hook into events such as before and after deploys.

To get started execute the following and follow the on-screen instructions:

rails generate plugin MyCoolNewPlugin

Also feel free to browse the existing plugins in the 'plugins' directory to get a feel. They follow the structure of a Rails Engine.

Current Plugins:

  • Environment variables per project
  • Flowdock
  • Hipchat: Clone of Slack plugin
  • Jenkins
  • Pipelines
  • Slack

Enabling Plugins

To specify which plugins you want to run, Samson looks at the PLUGINS environment variable. Through this mechanism, you can enable and disable plugins.

To selectively enable plugins, you can pass a comma-separated list:

PLUGINS="flowdock,env,slack"

To enable all plugins, use a value of "all":

PLUGINS="all"

To selectively disable plugins, use "all", and then a comma-separated list of plugins, with a minus sign in front of each:

PLUGINS="all,-flowdock,-slack"