Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/github/gh-actions-importer
GitHub Actions Importer helps you plan and automate the migration of Azure DevOps, Bamboo, Bitbucket, CircleCI, GitLab, Jenkins, and Travis CI pipelines to GitHub Actions.
https://github.com/github/gh-actions-importer
gh-extension github-actions
Last synced: 27 days ago
JSON representation
GitHub Actions Importer helps you plan and automate the migration of Azure DevOps, Bamboo, Bitbucket, CircleCI, GitLab, Jenkins, and Travis CI pipelines to GitHub Actions.
- Host: GitHub
- URL: https://github.com/github/gh-actions-importer
- Owner: github
- License: mit
- Created: 2022-10-31T23:05:35.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-07-30T08:27:05.000Z (3 months ago)
- Last Synced: 2024-10-02T06:43:27.772Z (about 1 month ago)
- Topics: gh-extension, github-actions
- Language: C#
- Homepage:
- Size: 789 KB
- Stars: 994
- Watchers: 60
- Forks: 679
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- jimsghstars - github/gh-actions-importer - GitHub Actions Importer helps you plan and automate the migration of Azure DevOps, Bamboo, Bitbucket, CircleCI, GitLab, Jenkins, and Travis CI pipelines to GitHub Actions. (C# #)
README
# GitHub Actions Importer
[](https://github.com/github/gh-actions-importer/actions/workflows/ci.yml)
[GitHub Actions Importer](https://docs.github.com/en/actions/migrating-to-github-actions/automating-migration-with-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
## How to request support
If you need assistance, you can file a support ticket [here](https://support.github.com).
## Getting started
GitHub Actions Importer is distributed as a Docker container and this extension to the official [GitHub CLI](https://cli.github.com) to interact with the Docker container.
### Prerequisites
The following requirements must be met to be able to use the GitHub Actions Importer:
- The Docker CLI must be [installed](https://docs.docker.com/get-docker/) and running.
- The official [GitHub CLI](https://cli.github.com) must be installed.
- You must have credentials to [authenticate](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry#authenticating-to-the-container-registry) with the GitHub Container Registry.
### Installation
Next, the GitHub Actions Importer CLI extension can be installed via this command:
```bash
gh extension install github/gh-actions-importer
```
### Configuration
New versions of the GitHub Actions Importer are released on a regular basis. To ensure you're up to date, run the following command:
```bash
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:
```bash
$ 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.
#### Using a custom Docker registry
We highly recommend using the [official GitHub Container Registry to pull the GitHub Actions Importer Docker image](https://github.com/actions-importer/preview/pkgs/container/cli/). 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.
```bash
# .env.local
CONTAINER_REGISTRY=my-custom-registry.com
```
### Documentation
Detailed information about how to use GitHub Actions Importer can be found in the [documentation](https://docs.github.com/en/actions/migrating-to-github-actions/automating-migration-with-github-actions-importer).
### Recordings
You can access recorded demos of GitHub Actions Importer performing migrations to Actions from the following CI/CD platforms:
- [Azure DevOps](https://youtu.be/gG-2bkmBRlI)
- [CircleCI](https://youtu.be/YkFnNEyM9Hg)
- [GitLab](https://youtu.be/3t5ywu0_qk4)
- [Jenkins](https://youtu.be/WqiGP6h4fa0)
- [Travis CI](https://youtu.be/ndc-FNa_X3c)
### Self-guided learning
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](https://github.com/actions/importer-labs/tree/main#readme).
## Product roadmap
To learn about new features coming to GitHub Actions Importer, see the [GitHub Public Roadmap](https://github.com/orgs/github/projects/4247).
## How to offer feedback or make a feature request
If you would like to offer feedback or make a feature request, please create a new discussion [here](https://github.com/github/gh-actions-importer/discussions/new/choose).