Skip to content

Latest commit

 

History

History
56 lines (35 loc) · 2.75 KB

6-migrate.md

File metadata and controls

56 lines (35 loc) · 2.75 KB
Raw

Perform a production migration of a CircleCI pipeline

In this lab, you will use the migrate command to convert a CircleCI pipeline and open a pull request with the equivalent Actions workflow.

Prerequisites

  1. Followed the steps here to set up your GitHub Codespaces environment.
  2. Completed the configure lab.
  3. Completed the dry-run lab.

Performing a migration

Answer the following questions before running a migrate command:

  1. What project do you want to migrate?
    • circleci-hello-world
  2. Where do you want to store the logs?
    • tmp/migrate
  3. What is the URL for the GitHub repository to add the workflow to?

Steps

  1. Run the following migrate command in the codespace terminal. Ensure the values in --target-url for :owner and :repo are replaced with your values:

    gh actions-importer migrate circle-ci --target-url https://github.com/:owner/:repo --output-dir tmp/migrate --circle-ci-project circleci-hello-world

  2. The command will write the URL to the pull request that is created when the command succeeds.

    $ gh actions-importer migrate circle-ci --target-url https://github.com/:owner/:repo --output-dir tmp/migrate --circle-ci-project circleci-hello-world
[2022-08-20 22:08:20] Logs: 'tmp/migrate/log/actions-importer-20220916-014033.log'
[2022-08-20 22:08:20] Pull request: 'https://github.com/:owner/:repo/pull/1'

    Note: It is expected that you will see "Resource not found" warnings in the output. These warnings are present because you are not a member of the CircleCI organization actions-importer-labs.

  3. Open the generated pull request in a new browser tab.

Inspect the pull request

The first thing to notice about the pull request is that there is a list of manual steps to complete.

Next, you can inspect the "Files changed" in this pull request and see the converted workflow that is being added. Any additional changes or code reviews that were needed should be done in this pull request.

action-run

Finally, you can merge the pull request once your review has completed. You can then view the workflow running by selecting the Actions menu in the top navigation bar in GitHub.

At this point, the migration has completed and you have successfully migrated a CircleCI pipeline to Actions.

Next lab

This concludes all labs for migrating CircleCI pipelines to Actions with GitHub Actions Importer.