hubot-vsonline
v0.2.9
Published
A Visual Studio Online adapter for hubot
Downloads
1
Readme
Hubot adapter for Visual Studio Online
You should report any issues or submit any pull requests to the Hubot adapter for Visual Studio Online repository.
Getting Started
Running Hubot on an Azure Web Site
If you want to run your Hubot instance on a Microsoft Azure Web Site and have it respond to commands from one (or more) team rooms, see How to: Running Hubot for Visual Studio Online on an Azure Web Site.
Installing the Hubot adapter for Visual Studio Online
First, create your own Hubot template by following the getting started instructions of the hubot repository.
Next, edit the package.json
for your Hubot instance and add a dependency for hubot-vsonline:
"dependencies": {
"hubot-vsonline": "*",
"hubot": ">= 2.0.0",
...
}
Save the file and commit the changes to your Hubot's local Git repository.
Configuring the adapter
The following adapter parameters are required by the Hubot adapter for Visual Studio Online:
HUBOT_VSONLINE_USERNAME
- alternate credentials user name of the Hubot user (this user must be a member of any team room it needs to post responses to)HUBOT_VSONLINE_PASSWORD
- alternate credentials password of the Hubot userHUBOT_VSONLINE_ACCOUNT
- Visual Studio Online account name (for example, if the URL that you connect to is "https://yourname.visualstudio.com/" then use "yourname" as the account name)
The following adapter parameters are optional:
HUBOT_VSONLINE_ADAPTER_BASIC_AUTH_USERNAME
- basic auth user name for your Hubot instanceHUBOT_VSONLINE_ADAPTER_BASIC_AUTH_PASSWORD
- basic auth password for your Hubot instanceHUBOT_VSONLINE_ROOMS
- comma separated list of team room name that you would like Hubot to join on startupHUBOT_URL
- HTTP endpoint that should receive messages. Defaults to /hubot/messagehook
The adapter also supports SSL. The following adapter parameters can be set:
HUBOT_VSONLINE_SSL_ENABLE
- set to trueHUBOT_VSONLINE_SSL_PORT
- defaults to 443HUBOT_VSONLINE_SSL_PRIVATE_KEY_PATH
- location of private keyHUBOT_VSONLINE_SSL_CERT_KEY_PATH
- location of certificateHUBOT_VSONLINE_SSL_REQUESTCERT
- true or false. Defaults to false. Request a client certificateHUBOT_VSONLINE_SSL_REJECTUNAUTHORIZED
- true or false. Check certificate against CA list. Defaults to falseHUBOT_VSONLINE_SSL_CA_KEY_PATH
- Path to authority certificate. Default is null
The adapter also supports receiving team room messages posted to an Azure Service Bus queue. The following parameters are required:
HUBOT_VSONLINE_ADAPTER_RECV_MODE
- set to "servicebus".HUBOT_VSONLINE_ADAPTER_SERVICE_BUS_CONNECTION
- The Service Bus SAS connection stringHUBOT_VSONLINE_ADAPTER_SERVICE_BUS_QUEUE
- Service Bus queue name
License
MIT