Migration of existing Coral pipelines

This document describes how to migrate from a previous version of Coral to the next.

Migrate from Coral v1 to v2

For users of Coral v1, the steps required in order to get to v2 are:

  1. Port v1 templates to the v2 format. The new format is significantly different and we hope that the Developer Preview version allowed people enough time to familiarize themselves with the new format to become productive with v2 once it hit.
  2. Coral will assist with migrating existing pipelines, clicking Project settings -> Coral Settings in your v1 project will allow you to move through an assistant.

Assisted migration

The assisted migration will perform three operations:

  1. Collect and store information about v1 software delivery pipelines in v2, while still keeping the references in the original storage. The way this is done is that Coral will search for policies, build definitions and release definitions that have a link back to the repository of the software delivery pipeline. The resources it finds, will be coded into an internal coral template storage and then applied to v2. To after the first step of the assisted migration, you will have your existing Coral v1 pipelines and a new set of Coral v2 pipelines that refer to a super set of resources.
  2. Once all the pipelines have been successfully imported into v2, it is time to register the templates that you want to expose to your project, this should be the templates that you have ported from v1 or new and modernized versions of them.
  3. Finally, the assistant will allow you to finalize the switch to v2. If something is not working then reach out to the coral maintainers and we will help with getting you back to v1 and diagnose the problem.