
This add-on is operated by Rendered Text
Continuous integration and delivery built for speed and simplicity.
Semaphore
Last updated February 20, 2019
Table of Contents
Semaphore add-on is an add-on for providing Semaphore service to all Heroku users.
Semaphore is a hosted continuous integration service for Ruby, JavaScript and Clojure applications.
This document provides all the information you need in order to use Semaphore with your application hosted on Heroku.
Activating the add-on
Semaphore add-on can be attached to a Heroku application in two ways:
A list of all plans available can be found here.
via Heroku web interface at the add-on catalog
via Heroku command-line interface with command
heroku addons:create
$ heroku addons:create semaphore
-----> Adding semaphore to sharp-mountain-4005... done, v18 (free)
Using Semaphore
After enabling the add-on for the first time, you need to go through the following steps:
- Open Semaphore
- Connect with GitHub
- Select project
- Review build settings
- Invite your collaborators from GitHub
- Build
Open Semaphore
You can reach Semaphore via your Heroku application’s resources page or via heroku addons:open semaphore
.
Connect with GitHub
Choose whether you’d like to build from a private or public repository on GitHub.
Now you can authorize Semaphore to access your GitHub account.
Select project
Select the project and the first branch that you want to build.
Review build commands
Semaphore will analyze your project and present you a suggested configuration and build commands that will run every time you push to the selected repository. If necessary you can change the version of your language runtime or build commands at this step.
Invite your collaborators from GitHub
If your project has collaborators on GitHub, you can invite them at this step. Enter their emails and invitations will be sent. After they have signed up, the project will be available on their dashboards.
You can also skip this step and start your first build.
Run Your First Build
At this point, setup is complete and your build will begin. You can watch its’ progress live or come back and view the logs later. Semaphore will automatically test your application every time you push to GitHub. New branches will be detected and built automatically.
After the build is finished, you will receive an email about its result. You can change or set up new notifications in your project settings, Notifications tab.
From now on you can also watch the build status of your project on the Semaphore dashboard.
Migrating between plans
Migrating between plans can be done:
via Heroku interface at add-on catalog
via Heroku command-line interface with command
heroku addons:upgrade
$ heroku addons:upgrade semaphore:newplan
-----> Upgrading semaphore:newplan to sharp-mountain-4005... done, v18 ($49/mo)
Your plan has been updated to: semaphore:newplan
Removing the add-on
This will destroy all associated data and cannot be undone!
Semaphore add-on can be removed:
via Heroku interface at add-on catalog
via Heroku command-line interface with command
heroku addons:destroy
$ heroku addons:destroy semaphore
-----> Removing semaphore from sharp-mountain-4005... done, v20 (free)
Supported application stack
Semaphore can test Ruby, JavaScript and Clojure projects. To find out more about supported application stack please visit Semaphore documentation.
Support
Semaphore support and runtime issues should be logged with Heroku Support at Heroku Support channels. Any non-support related issues or product feedback is welcome at semaphore@renderedtext.com or via Twitter @semaphoreci
For more information about Semaphore visit semaphoreci.com and Semaphore documentation site.