Buildkite pipeline converter overview
The Buildkite pipeline converter serves as a compatibility layer, enabling the conversion of your existing CI configurations into a format compatible with Buildkite's pipeline definitions.
You can start the translation of your pipelines from other CI providers to Buildkite Pipelines by seeing how workflows from other CI/CD platforms map to the Buildkite Pipelines' concepts and architecture. Rather than serving as a complete automated migration solution, the Buildkite migration tool demonstrates how configurations from these other CI/CD platforms could be structured in a Buildkite pipeline configuration format.
The Buildkite pipeline converter:
-
Supports the following CI providers:
Can be used as a standalone tool or potentially integrated into your Buildkite Migration Services process, offering a way to leverage existing CI configurations within the Buildkite ecosystem.
Can be run using the
bk pipeline migratecommand of the Buildkite CLI.
Interactive web-based version
To get started with the Buildkite pipeline converter, use its interactive web version, also known as the Buildkite migration interactive web tool.
To start translating your existing pipeline or workflow configuration into a Buildkite pipeline:
- If you are using a CI/CD platform other than GitHub Actions, select it from this drop-down.
- In the left panel, enter the pipeline definition to translate into a Buildkite pipeline definition.
- Select the Convert button to reveal the translated pipeline definition in the right panel.
- Copy the resulting Buildkite pipeline YAML configuration on the right and create a new Buildkite pipeline with it.
Conversion errors
If the pipeline configuration you are trying to convert to a Buildkite pipeline contains syntax or other errors, you might see the following Conversion failed message.
In such cases, ensure that the original pipeline configuration you are translating to a Buildkite pipeline is a valid pipeline definition for the CI/CD platform you are migrating from.
Next steps
For more tools and recommendations regarding migrating from your existing CI/CD platform to Buildkite, see: