Skip to main content
Version: Community Edition (1.0)

Migration Overview

Migrating a Continuous Integration and Delivery (CI/CD) platform can be straightforward or challenging. Every project, every team is a world; for some, it is trivial while for others, it is a big effort. In any case, it is our dearest hope that the effort benefits you and your team.

These guides will help you migrate from other CI systems to Semaphore. In this page, we'll review the basis for the migration process, as several migration steps are common for all CI systems.

We recommend going through the Guided Tour pages to familiarize yourself with Semaphore before starting the migration plan.

Migration plan​

Here is the recommended plan to migrate from any CI provider to Semaphore.

  1. Set goals

    Write down your goals and reasons for migrating your CI to Semaphore. For example, you might wish to reduce costs or speed up your builds. Setting expectations from the get-go will make the whole migration process clearer and more straightforward.

    If at any point in the process, you have doubts, contact us at support@semaphoreci.com. We want this process to be as smooth and painless as possible.

  2. Compare features

    We suggest breaking down the requirements for the new CI system into three categories:

    • Must have
    • Nice to have
    • Optional

    Use the feature comparison page to select the best Semaphore edition for you.

  3. Install Semaphore

  4. Create a proof of concept for your workflows

    Pick one of your projects to be a pilot in your migration effort.

    The following pages describe key features you might need for the migration:

  5. Optimize performance

    Once your project is building on Semaphore, begin optimizing for performance.

  6. Onboard your team

    Once satisfied with your CI workflow it's time to onboard the rest of your team:

  7. Repeat steps 3-5 for the rest of your projects

  8. Shut down the old CI system

    If you don't have any projects running in your old CI system you can shut it down or cancel your plan once you are satisfied with Semaphore. Remember to deactivate or delete the old secrets connected to the decommissioned systems.

See also​