Knowledge Base: Integrating with Lighthouse

Beanstalk allows you to integrate with Lighthouse. Lighthouse is a task and bug management system which offers basic integration with Subversion. Each time a commit is made, a simple tag-based syntax is used to manipulate or edit cases in Lighthouse.

How to set up integration with Lighthouse

After you have created your Beanstalk account, and created your repository, you can integrate the repository with Lighthouse. In order to integrate, select your repository, choose "Setup" tab, then choose "Integration" and select "Lighthouse".

On the Lighthouse integration page, you will see brief instructions on how to use Lighthouse integration with Beanstalk. Click on the "Activate" button to start setting up integration with Lighthouse. You will be redirected to a page where you will need to insert your account name.

After inserting an account name, you will be redirected to a page where you will need to insert tokens. Tokens are the connection between your users in Beanstalk and Lighthouse. You will need to create the tokens in your Lighthouse account.

In order to create a token, go to your Lighthouse account and click on your name in the top right.

You will see a section in the middle of the sidebar called "CREATE AN API TOKEN". Select the account that you want to add the token for from the dropdown, then insert the label of the token and click create.

You should see your newly created token in "YOUR API TOKENS" section now.

After you created the token, copy/paste the token into Beanstalk. Each Lighthouse user will need to create a token.

Now all you need to do is select the Lighthouse project you would like to integrate with in Beanstalk.

After this, finish the setup by clicking the "Activate!" button.

How to use the integration

Once you have setup integration with Beanstalk and Lighthouse, you can add keywords to your commit messages that will update tickets in Lighthouse. For example:

Prototype new feature [#15]

The #15 will add this log message as a comment to ticket #15. You can also change various properties.

Extended tags

You can use additional tags to edit or manipulate cases as well. For example:

New feature is implemented and tested [#15 tagged:committed responsible:chris milestone:"Beta Release" state:resolved]

This commit message will add a tag, set responsible user, set milestone, and change state of the ticket in Lighthouse.

Check out the list of example tags, which can be used:

Example Lighthouse tags

• tagged - Adds the tag(s) to the ticket, but does not replace them.
• responsible - Sets the user responsible for the ticket. Use responsible:none to clear it.
• milestone - Sets the milestone for the ticket. Use milestone:none to clear the milestone.
• state - Sets the ticket state. Valid values are: new, open, hold, resolved, and invalid.