GitHub Actions Importer helps plan, test, and automate your migration to GitHub Actions from the following platforms:

• Azure DevOps
• Bamboo
• Bitbucket
• CircleCI
• GitLab
• Jenkins
• Travis CI

If you need assistance, you can file a support ticket here.

GitHub Actions Importer is distributed as a Docker container and this extension to the official GitHub CLI to interact with the Docker container.

The following requirements must be met to be able to use the GitHub Actions Importer:

• The Docker CLI must be installed and running.
• The official GitHub CLI must be installed.
• You must have credentials to authenticate with the GitHub Container Registry.

Next, the GitHub Actions Importer CLI extension can be installed via this command:

gh extension install github/gh-actions-importer

New versions of the GitHub Actions Importer are released on a regular basis. To ensure you're up to date, run the following command:

gh actions-importer update

In order for GitHub Actions Importer to communicate with your current CI/CD server and GitHub, various credentials must be available for the command. These can be configured using environment variables or a .env.local file. These environment variables can be configured in an interactive prompt by running the following command:

$ gh actions-importer configure
? Enter value for 'GITHUB_ACCESS_TOKEN' (leave empty to skip):
...

You can find detailed information about using environment variables in the platform-specific documentation.

We highly recommend using the official GitHub Container Registry to pull the GitHub Actions Importer Docker image. However, if you need to use a custom Docker registry, you can configure GitHub Actions Importer to use a custom Docker registry by setting the CONTAINER_REGISTRY environment variable in your .env.local file.

# .env.local
CONTAINER_REGISTRY=my-custom-registry.com

Detailed information about how to use GitHub Actions Importer can be found in the documentation.

You can access recorded demos of GitHub Actions Importer performing migrations to Actions from the following CI/CD platforms:

• Azure DevOps
• CircleCI
• GitLab
• Jenkins
• Travis CI

The GitHub Actions Importer labs repository contains platform-specific learning paths that teach you how to use GitHub Actions Importer and how to approach migrations to GitHub Actions. To learn more, see the GitHub Actions Importer labs repository.

To learn about new features coming to GitHub Actions Importer, see the GitHub Public Roadmap.

If you would like to offer feedback or make a feature request, please create a new discussion here.