À 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.
Note
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.