This time we’d like to surprise our community, especially the new Semaphore users. If you are considering trying out Semaphore, this simple guide will help you understand the basics of Semaphore and how to get up and running by following these steps .
This guide is based on our experience with onboarding teams, now long-time Semaphore customers, such as Confluent, Dribbble, Tigera, and many others.
Adding your first project
Adding your first project to Semaphore is pretty simple and can be done in two ways:
- Fork and run
With fork and run, you can try one of the example projects we have prepared for you. You will be able to Semaphore in action and reach your first green build in a jiff:
- Add your own project
You can try your own projects in Semaphore, which can be done in a few simple steps through the web interface or from the command line.
- Creating Your First Project
- Semaphore Concepts
- Customizing Your Pipeline
- Customizing the Build Environment
Reaching your first green build
If your build on Semaphore is still red, you are just one tiny step away from making it green especially if you continue reading this section.
Second, if you’re still having problems, launch a debugging session via SSH. This will provide direct access to the virtual machines Semaphore uses for running jobs. An SSH session can help you to quickly test solutions while getting familiar with the build environment.
In addition, our FAQ troubleshooting tips should come in handy when trying to get your builds to a green state:
You can access your Project Settings by entering the desired project and clicking on Settings.
This is where you can set up your Secrets, Slack Notifications, Badges to display your projects’ current build status and more.
One of the settings that particularly sparks interest of new users is the Workflow Triggers functionality. It is available in the Project Settings => General => What to build? And it allows you to choose which GitHub events should trigger new workflows for your Semaphore project:
Adding People to an Organization
To let other people view your pipelines and delegate project management, open the menu and go to People. This will show the members in your organization and set permissions.
- Environment variables and secrets
- Deploying with promotions
- Fail-fast & Auto-cancel
The list of most useful features was built based on new users’ interests. For more information on working with Semaphore and its capabilities, check out the official Semaphore Documentation.
Here is also the Semaphore Roadmap from which you can learn more about the upcoming features. If you have a suggestion or an idea of a feature that would help Semaphore meet your needs, please submit a New Idea.
Extending your trial for another 14 days
If your 14-day trial is about to expire and you need a few more weeks to get up and running, just send us a quick email at firstname.lastname@example.org from the same address you’ve used to sign up and let us know what delighted you the most about Semaphore . We’ll extend your trial and our team will be happy to answer any additional questions you might have about Semaphore.