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 pipeline converter 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 convertcommand of the Buildkite CLI.
Interactive web-based version
To get started with the Buildkite pipeline converter, use its interactive web version.
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 dropdown.
- 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 a Conversion failed message.
In this case, 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: