Ă propos de GitHub Actions Importer
Vous pouvez utiliser GitHub Actions Importer pour planifier vos pipelines pris en charge par CI/CD et les migrer automatiquement vers GitHub Actions.
GitHub Actions Importer est distribué en tant que conteneur Docker et utilise une extension CLI GitHub pour interagir avec le conteneur.
Tout workflow converti par GitHub Actions Importer doit ĂȘtre inspectĂ© pour vĂ©rifier son exactitude avant de lâutiliser en tant que charge de travail de production. Lâobjectif est dâatteindre un taux de conversion de 80 % pour chaque workflow. Toutefois, le taux de conversion rĂ©el dĂ©pend de la composition de chaque pipeline qui est converti.
Plateformes CI prises en charge
Vous pouvez utiliser GitHub Actions Importer pour effectuer une migration à partir des plateformes suivantes :
- Azure DevOps
- Bamboo
- Pipelines Bitbucket
- CircleCI
- GitLab (à la fois cloud et auto-hébergé)
- Jenkins
- Travis CI
Prérequis
GitHub Actions Importer a les exigences suivantes :
-
Un environnement dans lequel vous pouvez exécuter des conteneurs basés sur Linux et installer les outils nécessaires.
- Docker est installĂ© et en cours dâexĂ©cution.
- Lâinterface CLI GitHub est installĂ©e.
Remarque : Le conteneur GitHub Actions Importer et lâinterface CLI nâont pas besoin dâĂȘtre installĂ©s sur le mĂȘme serveur que votre plateforme CI.
Installation de lâextension CLI GitHub Actions Importer
-
Installez lâextension CLI GitHub Actions Importer :
Bash gh extension install github/gh-actions-importer
gh extension install github/gh-actions-importer
-
VĂ©rifiez que lâextension est installĂ©e :
$ gh actions-importer -h Options: -?, -h, --help Show help and usage information Commands: update Update to the latest version of GitHub Actions Importer. version Display the version of GitHub Actions Importer. configure Start an interactive prompt to configure credentials used to authenticate with your CI server(s). audit Plan your CI/CD migration by analyzing your current CI/CD footprint. forecast Forecast GitHub Actions usage from historical pipeline utilization. dry-run Convert a pipeline to a GitHub Actions workflow and output its yaml file. migrate Convert a pipeline to a GitHub Actions workflow and open a pull request with the changes.
Mise Ă jour de lâinterface CLI GitHub Actions Importer
Pour vous assurer que vous exécutez la derniÚre version de GitHub Actions Importer, vous devez exécuter réguliÚrement la commande update
 :
gh actions-importer update
Authentification depuis la ligne de commande
Vous devez configurer des informations dâidentification qui permettent Ă GitHub Actions Importer de communiquer avec GitHub et votre serveur CI actuel. Vous pouvez configurer ces informations dâidentification en utilisant des variables dâenvironnement ou un fichier .env.local
. Vous pouvez configurer les variables dâenvironnement dans une invite interactive, en exĂ©cutant la commande suivante :
gh actions-importer configure
Utilisation de lâinterface CLI GitHub Actions Importer
Utilisez les sous-commandes de gh actions-importer
pour commencer votre migration vers GitHub Actions, notamment audit
, forecast
, dry-run
et migrate
.
Audit de vos pipelines CI existants
La sous-commande audit
peut ĂȘtre utilisĂ©e pour planifier votre migration CI/CD en analysant votre empreinte CI/CD actuelle. Cette analyse peut ĂȘtre utilisĂ©e pour planifier une chronologie de migration vers GitHub Actions.
Pour exécuter un audit, utilisez la commande suivante afin de déterminer les options dont vous disposez :
$ gh actions-importer audit -h
Description:
Plan your CI/CD migration by analyzing your current CI/CD footprint.
[...]
Commands:
azure-devops An audit will output a list of data used in an Azure DevOps instance.
bamboo An audit will output a list of data used in a Bamboo instance.
circle-ci An audit will output a list of data used in a CircleCI instance.
gitlab An audit will output a list of data used in a GitLab instance.
jenkins An audit will output a list of data used in a Jenkins instance.
travis-ci An audit will output a list of data used in a Travis CI instance.
PrĂ©vision de lâutilisation
La sous-commande forecast
passe en revue lâutilisation historique du pipeline pour crĂ©er une prĂ©vision de lâutilisation de GitHub Actions.
Pour exécuter une prévision, utilisez la commande suivante afin de déterminer les options dont vous disposez :
$ gh actions-importer forecast -h
Description:
Forecasts GitHub Actions usage from historical pipeline utilization.
[...]
Commands:
azure-devops Forecasts GitHub Actions usage from historical Azure DevOps pipeline utilization.
bamboo Forecasts GitHub Actions usage from historical Bamboo pipeline utilization.
jenkins Forecasts GitHub Actions usage from historical Jenkins pipeline utilization.
gitlab Forecasts GitHub Actions usage from historical GitLab pipeline utilization.
circle-ci Forecasts GitHub Actions usage from historical CircleCI pipeline utilization.
travis-ci Forecasts GitHub Actions usage from historical Travis CI pipeline utilization.
github Forecasts GitHub Actions usage from historical GitHub pipeline utilization.
Test du processus de migration
La sous-commande dry-run
peut ĂȘtre utilisĂ©e pour convertir un pipeline en son Ă©quivalent GitHub Actions, puis Ă©crire le workflow dans votre systĂšme de fichiers local.
Pour effectuer un test, utilisez la commande suivante afin de déterminer les options dont vous disposez :
$ gh actions-importer dry-run -h
Description:
Convert a pipeline to a GitHub Actions workflow and output its yaml file.
[...]
Commands:
azure-devops Convert an Azure DevOps pipeline to a GitHub Actions workflow and output its yaml file.
bamboo Convert a Bamboo pipeline to GitHub Actions workflows and output its yaml file.
circle-ci Convert a CircleCI pipeline to GitHub Actions workflows and output the yaml file(s).
gitlab Convert a GitLab pipeline to a GitHub Actions workflow and output the yaml file.
jenkins Convert a Jenkins job to a GitHub Actions workflow and output its yaml file.
travis-ci Convert a Travis CI pipeline to a GitHub Actions workflow and output its yaml file.
Migration dâun pipeline vers GitHub Actions
La sous-commande migrate
peut ĂȘtre utilisĂ©e pour convertir un pipeline en son Ă©quivalent GitHub Actions, puis crĂ©er une demande de tirage (pull request) avec le contenu.
Pour exécuter une migration, utilisez la commande suivante afin de déterminer les options dont vous disposez :
$ gh actions-importer migrate -h
Description:
Convert a pipeline to a GitHub Actions workflow and open a pull request with the changes.
[...]
Commands:
azure-devops Convert an Azure DevOps pipeline to a GitHub Actions workflow and open a pull request with the changes.
bamboo Convert a Bamboo pipeline to GitHub Actions workflows and open a pull request with the changes.
circle-ci Convert a CircleCI pipeline to GitHub Actions workflows and open a pull request with the changes.
gitlab Convert a GitLab pipeline to a GitHub Actions workflow and open a pull request with the changes.
jenkins Convert a Jenkins job to a GitHub Actions workflow and open a pull request with the changes.
travis-ci Convert a Travis CI pipeline to a GitHub Actions workflow and open a pull request with the changes.
Effectuer des migrations en libre-service Ă lâaide dâIssueOps
Vous pouvez utiliser GitHub Actions et GitHub Issues pour exécuter des commandes CLI pour GitHub Actions Importer. Cela vous permet de migrer vos workflows CI/CD sans installer de logiciel sur votre ordinateur local. Cette approche est particuliÚrement utile pour les organisations qui souhaitent activer les migrations en libre-service vers GitHub Actions. Une fois IssueOps configuré, les utilisateurs peuvent ouvrir un problÚme avec le modÚle approprié pour migrer des pipelines vers GitHub Actions.
Pour plus dâinformations sur la configuration des migrations libre-service avec IssueOps, consultez le dĂ©pĂŽt de modĂšles actions/importer-issue-ops
.
Utilisation du dépÎt de labs GitHub Actions Importer
Le dĂ©pĂŽt de labs GitHub Actions Importer contient des parcours dâapprentissage spĂ©cifiques Ă la plateforme qui vous apprennent Ă utiliser GitHub Actions Importer et Ă aborder les migrations vers GitHub Actions. Vous pouvez utiliser ce dĂ©pĂŽt pour apprendre Ă utiliser GitHub Actions Importer pour vous aider Ă planifier, prĂ©voir et automatiser votre migration vers GitHub Actions.
Pour plus dâinformations, consultez le dĂ©pĂŽt de labs GitHub Actions Importer.
Mentions légales
Certaines parties ont été adaptées à partir de https://github.com/github/gh-actions-importer/ sous la licence MIT :
MIT License
Copyright (c) 2022 GitHub
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.