Migrate to Buildkite Pipelines overview
Migrating to Buildkite is a smooth process with the right context and planning. This page covers the tools and guides that allow you get familiar with Buildkite, help you with planning a migration from your existing CI/CD platform, and introduce you to the Buildkite Migration Services.
Migration tool
The Buildkite migration tool is designed to help you understand Buildkite by providing a hands-on, high-level overview of how workflows from other CI/CD platforms map to Buildkite Pipelines concepts and architecture.
Rather than serving as a complete automated migration solution, the Buildkite migration tool helps you visualize how configurations from from GitHub Actions, CircleCI, Bitbucket Pipelines, and Jenkins (currently in beta) could be structured in the Buildkite Pipelines configuration format.
Using the Buildkite migration tool will accelerate your understanding of Buildkite concepts, allowing you to make informed decisions about how to rearchitect and optimize your pipelines for the Buildkite platform. Use the tool's output as a learning foundation, then iterate and refine your pipeline designs before beginning the actual migration process.
You can immediately start experimenting with the Buildkite migration tool in its interactive web-based app form or run the Buildkite migration tool locally via an HTTP API.
Migration guides
The guides walk through the entire process step by step, covering the key aspects of migration, such as:
- Understanding the differences.
- Trying out Buildkite.
- Provisioning agent infrastructure.
- Translating pipeline definitions.
- Integrating with your tools.
- Sharing your setup.
To get started, choose the guide that corresponds to the CI/CD tool you are migrating from:
Plan your migration
There are multiple approaches you can adopt when planning your migration. Take a look at the following content to understand the common strategies customers usually use to migrate to Buildkite, and the potential pros, cons, and pitfalls of each strategy.
Migration services
If you would like to receive assistance when migrating from your existing CI/CD provider to Buildkite Pipelines, you can work with the Buildkite Migration Services team.
The Migration Services team works directly with your organization to provide strategic planning, implementation guidance, and proven best practices.
If you need further help, guidance, or have any questions, please reach out to support at support@buildkite.com. We're here to help you make a smooth transition to Buildkite.