Azure Bot is a chat bot built on the Hubot framework. It was initially generated by generator-hubot, and configured to be deployed on Azure

This README is intended to help get you started. Definitely update and improve to talk about your own instance, how to use and deploy, what functionality is available, etc!

• Create a Personal Access Token in GitHub that you will use to authenticate as you deploy Hubot
  • You may want to consider creating an automation account to own this personal access token
• If you are using SAML authentication for your GitHub organization, you may need to authorize this token

To install and connect the Azure Hubot to your Azure environment you will need to complete the following actions:

Clone This repository to your GitHub Organization

• You will want to set this up as a private repository and give all members of your organization write access to allow inner-sourcing
• This will allow for greater contributions and speed up the development process

Connect to your Azure web portal and authenticate. You will then need to complete the following actions:

• Select Create a resource
• Select Web App
  • Fill in the form data
  • Select Create
• Go to your newly created application on the dashboard
• Configure environment variables that your Hubot will need to use
  • Select application settings
  • Navigate to the Application Settings section
  • Select Add new setting to create key pairs:
    • HUBOT_SLACK_TOKEN=Your Created Slack Token
    • HUBOT_ADAPTER=slack
    • Select Save from top banner
  • NOTE: If you are using a different chat tool, you will need to configure different environment variables
• Set up automatic deployment of this app from your GitHub repository
  • Select Deployment options
  • Select Choose source
  • Select GitHub
    • Fill in the form data
    • NOTE: Use GitHub API Token that has write access to this repository
    • Select the correct azure Hubot repo

Any time the master branch of your Azure Hubot repository is updated, it will trigger the Azure Deployment and update the Hubot. The Hubot only takes around 30 seconds to be re-deployed.
NOTE: The first deployment will take longer as it will need to pull in many of the base dependencies.

You will want to connect the bot from your Chat tooling into VSTS.
This integration should be able to complete at the minimum the following actions:

• Show queue
• Start build
• List Jobs

Other actions are greatly encouraged, and can be seen as enhancements.

You will want to connect the bot from your Chat tooling into GitHub.
This integration should be able to complete at the minimum the following actions:

• List Repositories
• Create Repository
• List members of team

Other actions are greatly encouraged, and can be seen as enhancements.

Having your bot be able to connect to your monitoring environment is a great step in maturity.
The ability to query information or metrics gives you a quick insight to your environment from your chat environment.
This allows teams to collaborate in real time about the environment and have a record of what is happening.
Commands that allow you to fetch metrics and graphs, as well as check endpoints can greatly increase your culture and promote your environments.

Sparkles Giving your teammates points for doing something special is a great way to build culture and promote sharing.
This can be added and enhance your culture.

This is a fairly common script that allows your bot to remember basic strings.
This is useful to remember common end points, or other common data that needs to be stored in chat.