CircleCI 2.0 Migration Center


Find the resources, support, and information you need to make your transition to CircleCI 2.0.

Why CircleCI 2.0?

CircleCI 2.0 gives your team more power, flexibility, and control over your delivery pipeline. See how migrating to CircleCI 2.0 will help your team build smarter, faster.

  • Speed

    By choosing which resource class you need for optimal performance on any workflow, you’ll never be slowed down by inadequate provisioning.

  • Flexibility

    Languages that run on Linux and macOS run on CircleCI. First-class Docker support means you can configure your environment exactly as you want.

  • Efficiency

    Advanced caching strategies and workspaces as part of Workflows help save time when running multiple jobs across a number of projects.

  • Customization & Control

    Infinite ways to orchestrate jobs (build, test, deploy) using Workflows.


Now Available

Get set up for migration success

Getting to green builds on CircleCI 2.0 starts with a plan. We’ve worked with thousands of teams to help them get building on 2.0, and have discovered some best practices along the way.

Download migration guide
step 1 Get an overview of the new .circleci/config.yml format

Start by familiarizing yourself with the new file format. Watch this video, or check out the docs.

step 2 Get a list of the projects still building on 1.0

Use this script to see which projects are building on CircleCI 1.0. Stop building any inactive projects you don’t plan to migrate.

step 3 Create a new branch on your projects for getting 2.0 up and running

You can get your projects building on CircleCI 2.0 without impacting your team. Create a new branch for testing so your team can keep building while you get things set up.

step 4 Use the configuration translator to jump-start your migration

The configuration translation endpoint will help you get started with your config file. You will want to tweak the output, but it should help you get started.

step 5 Use the CLI to validate your 2.0 configuration (and avoid stacking up failed builds)

You can use the command line interface to validate your config changes with a pre-commit Git hook. This will help you avoid running a bunch of failed builds while you are fine-tuning your syntax. Read how in the docs or watch this video.

success
Congratulations!

Your jobs are passing, congratulations! Now you can have some fun.

Share your success. Let your team know about the changes you made to your CircleCI config in a demo. Your projects will likely be building faster, and with more flexibility.

Celebrate with them, and with us. Tweet us @CircleCI with screenshots of your jobs running on 2.0, and we may just send you some limited edition CircleCI 2.0 stickers.

Resource Library

New Migration Guide

1.0 to 2.0 Migration Steps

Reference this step-by-step guide to guide you through the details and steps required for migrating your CircleCI 1.0 projects to CircleCI 2.0. This guide walks you through getting started by identifying projects, tips on writing your first 2.0 configuration file, getting to your first green build, and setting up Workflows.

Download Now

Recorded Events

Webinar: Migrating from CircleCI 1.0 to 2.0
On Demand

Sr. Customer Success Engineer, Ryan O’hara presents a step-by-step overview of the migration process from CircleCI 1.0 to 2.0 along with some key best practices.

View now

Webinar: Introduction to .circleci/config/yml
On Demand

An overview of creating a .circleci/config.yml file and other sample configurations on CircleCI 2.0.

View now

Webinar: Workflows 101
On Demand

Customer Success Engineer, Rose Kaplan-Bomberg presents some examples of Workflows on CircleCI 2.0.

View now

Demo: Get started with pre-built Docker images on CircleCI
On Demand

Use official CircleCI pre-built Docker container images in your 2.0 configuration files.

View now

Demo: How to get started on CircleCI 2.0
On Demand

A quick walkthrough of getting a project up and running on the CircleCI 2.0 platform.

View now

Thank You for Submitting Your Info


You should receive an automated response notifying you that we received your info. Someone from our Enterprise team will be reaching out to you shortly.


CircleCI Success Logo