└── README.md /README.md: -------------------------------------------------------------------------------- 1 | # GitHub Actions Importer Full Guide 🚀 2 | 3 | GitHub Actions Importer helps plan, test, and automate your migration to GitHub Actions from the following platforms: 4 | 5 | - Azure DevOps 🔄 6 | - Bamboo (currently in beta) 🎋 7 | - CircleCI 🔄 8 | - GitLab 🔄 9 | - Jenkins 🔄 10 | - Travis CI 🔄 11 | 12 | ## How to Request Support ❓ 13 | 14 | If you need assistance, you can file a support ticket [here](https://example.com/support). 15 | 16 | ## Getting Started 🚀 17 | 18 | GitHub Actions Importer is distributed as a Docker container and this extension to the official GitHub CLI to interact with the Docker container. 19 | 20 | ### Prerequisites ✅ 21 | 22 | The following requirements must be met to be able to use the GitHub Actions Importer: 23 | 24 | - The Docker CLI must be installed and running. 🐳 25 | - The official GitHub CLI must be installed. 💻 26 | - You must have credentials to authenticate with the GitHub Container Registry. 🔑 27 | 28 | ### Installation ⬇️ 29 | 30 | Next, the GitHub Actions Importer CLI extension can be installed via this command: 31 | 32 | 33 | $ gh extension install github/gh-actions-importer 34 | 35 | ### Configuration⚙️ 36 | New versions of the GitHub Actions Importer are released on a regular basis. To ensure you're up to date, run the following command: 37 | $ gh actions-importer update 38 | 39 | 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: 40 | $ gh actions-importer configure 41 | ? Enter value for 'GITHUB_ACCESS_TOKEN' (leave empty to skip): 42 | ... 43 | You can find detailed information about using environment variables in the platform-specific documentation. 44 | 45 | ### Documentation📖 46 | Detailed information about how to use GitHub Actions Importer can be found in the documentation. 47 | 48 | ### Recordings▶️ 49 | You can access recorded demos of GitHub Actions Importer performing migrations to Actions from the following CI/CD platforms: 50 | 51 | - Azure DevOps 52 | - CircleCI 53 | - GitLab 54 | - Jenkins 55 | - Travis CI 56 | - Self-guided learning📚 57 | 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. 58 | 59 | ### Product roadmap 🚧 60 | To learn about new features coming to GitHub Actions Importer, see the GitHub Public Roadmap. 61 | 62 | ## How to offer feedback or make a feature request 📣 63 | 64 | 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). 65 | 66 | Feel free to reach out! 😊 [Click me](https://linktr.ee/ADV_Indian_coder) ADV Indian Coder Vinay Kumar Java Developer 67 | 68 | 69 | --------------------------------------------------------------------------------