{"meta":{"title":"Automatisation de la migration avec GitHub Actions Importer","intro":"Utilisez GitHub Actions Importer pour planifier et automatiser votre migration vers GitHub Actions.","product":"GitHub Actions","breadcrumbs":[{"href":"/fr/actions","title":"GitHub Actions"},{"href":"/fr/actions/tutorials","title":"Tutoriels"},{"href":"/fr/actions/tutorials/migrate-to-github-actions","title":"Migrer vers GitHub Actions"},{"href":"/fr/actions/tutorials/migrate-to-github-actions/automated-migrations","title":"Migrations automatisées"},{"href":"/fr/actions/tutorials/migrate-to-github-actions/automated-migrations/use-github-actions-importer","title":"Utiliser GitHub Actions Importer"}],"documentType":"article"},"body":"# Automatisation de la migration avec GitHub Actions Importer\n\nUtilisez GitHub Actions Importer pour planifier et automatiser votre migration vers GitHub Actions.\n\n## À propos de GitHub Actions Importer\n\nVous pouvez utiliser GitHub Actions Importer pour planifier vos pipelines pris en charge par CI/CD et les migrer automatiquement vers GitHub Actions.\n\nGitHub Actions Importer est distribué en tant que conteneur Docker et utilise une extension [CLI GitHub](https://cli.github.com) pour interagir avec le conteneur.\n\nTout 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.\n\n## Plateformes CI prises en charge\n\nVous pouvez utiliser GitHub Actions Importer pour effectuer une migration à partir des plateformes suivantes :\n\n* Azure DevOps\n* Bambou\n* Pipelines Bitbucket\n* CircleCI\n* GitLab (à la fois cloud et auto-hébergé)\n* Jenkins\n* Travis CI\n\n## Prérequis\n\nGitHub Actions Importer a les exigences suivantes :\n\n* Un environnement dans lequel vous pouvez exécuter des conteneurs basés sur Linux et installer les outils nécessaires.\n  * Docker est [installé](https://docs.docker.com/get-docker/) et en cours d’exécution.\n  * L’[interface CLI GitHub](https://cli.github.com) est installée.\n\n  > [!NOTE]\n  > 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.\n\n### Installation de l’extension CLI GitHub Actions Importer\n\n1. Installez l’extension CLI GitHub Actions Importer :\n\n   ```bash copy\n   gh extension install github/gh-actions-importer\n   ```\n\n1. Vérifiez que l’extension est installée :\n\n   ```bash\n   $ gh actions-importer -h\n   Options:\n     -?, -h, --help  Show help and usage information\n\n   Commands:\n     update     Update to the latest version of GitHub Actions Importer.\n     version    Display the version of GitHub Actions Importer.\n     configure  Start an interactive prompt to configure credentials used to authenticate with your CI server(s).\n     audit      Plan your CI/CD migration by analyzing your current CI/CD footprint.\n     forecast   Forecast GitHub Actions usage from historical pipeline utilization.\n     dry-run    Convert a pipeline to a GitHub Actions workflow and output its yaml file.\n     migrate    Convert a pipeline to a GitHub Actions workflow and open a pull request with the changes.\n   ```\n\n### Mise à jour de l’interface CLI GitHub Actions Importer\n\nPour vous assurer que vous exécutez la dernière version de GitHub Actions Importer, vous devez exécuter régulièrement la commande `update` :\n\n```bash\ngh actions-importer update\n```\n\n### Authentification depuis la ligne de commande\n\nVous 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 :\n\n```bash\ngh actions-importer configure\n```\n\n## Utilisation de la CLI GitHub Actions Importer\n\nUtilisez les sous-commandes de `gh actions-importer` pour commencer votre migration vers GitHub Actions, notamment `audit`, `forecast`, `dry-run` et `migrate`.\n\n### Audit de vos pipelines CI existants\n\nLa 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.\n\nPour exécuter un audit, utilisez la commande suivante afin de déterminer les options dont vous disposez :\n\n```bash\n$ gh actions-importer audit -h\nDescription:\n  Plan your CI/CD migration by analyzing your current CI/CD footprint.\n\n[...]\n\nCommands:\n  azure-devops  An audit will output a list of data used in an Azure DevOps instance.\n  bamboo        An audit will output a list of data used in a Bamboo instance.\n  circle-ci     An audit will output a list of data used in a CircleCI instance.\n  gitlab        An audit will output a list of data used in a GitLab instance.\n  jenkins       An audit will output a list of data used in a Jenkins instance.\n  travis-ci     An audit will output a list of data used in a Travis CI instance.\n```\n\n### Prévision de l’utilisation\n\nLa sous-commande `forecast` passe en revue l’utilisation historique du pipeline pour créer une prévision de l’utilisation de GitHub Actions.\n\nPour exécuter une prévision, utilisez la commande suivante afin de déterminer les options dont vous disposez :\n\n```bash\n$ gh actions-importer forecast -h\nDescription:\n  Forecasts GitHub Actions usage from historical pipeline utilization.\n\n[...]\n\nCommands:\n  azure-devops  Forecasts GitHub Actions usage from historical Azure DevOps pipeline utilization.\n  bamboo        Forecasts GitHub Actions usage from historical Bamboo pipeline utilization.\n  jenkins       Forecasts GitHub Actions usage from historical Jenkins pipeline utilization.\n  gitlab        Forecasts GitHub Actions usage from historical GitLab pipeline utilization.\n  circle-ci     Forecasts GitHub Actions usage from historical CircleCI pipeline utilization.\n  travis-ci     Forecasts GitHub Actions usage from historical Travis CI pipeline utilization.\n  github        Forecasts GitHub Actions usage from historical GitHub pipeline utilization.\n```\n\n### Test du processus de migration\n\nLa 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.\n\nPour effectuer un test, utilisez la commande suivante afin de déterminer les options dont vous disposez :\n\n```bash\n$ gh actions-importer dry-run -h\nDescription:\n  Convert a pipeline to a GitHub Actions workflow and output its yaml file.\n\n[...]\n\nCommands:\n  azure-devops  Convert an Azure DevOps pipeline to a GitHub Actions workflow and output its yaml file.\n  bamboo        Convert a Bamboo pipeline to GitHub Actions workflows and output its yaml file.\n  circle-ci     Convert a CircleCI pipeline to GitHub Actions workflows and output the yaml file(s).\n  gitlab        Convert a GitLab pipeline to a GitHub Actions workflow and output the yaml file.\n  jenkins       Convert a Jenkins job to a GitHub Actions workflow and output its yaml file.\n  travis-ci     Convert a Travis CI pipeline to a GitHub Actions workflow and output its yaml file.\n```\n\n### Migration d’un pipeline vers GitHub Actions\n\nLa sous-commande `migrate` peut être utilisée pour convertir un pipeline en son équivalent GitHub Actions, puis créer une demande de tirage avec le contenu.\n\nPour exécuter une migration, utilisez la commande suivante afin de déterminer les options dont vous disposez :\n\n```bash\n$ gh actions-importer migrate -h\nDescription:\n  Convert a pipeline to a GitHub Actions workflow and open a pull request with the changes.\n\n[...]\n\nCommands:\n  azure-devops  Convert an Azure DevOps pipeline to a GitHub Actions workflow and open a pull request with the changes.\n  bamboo        Convert a Bamboo pipeline to GitHub Actions workflows and open a pull request with the changes.\n  circle-ci     Convert a CircleCI pipeline to GitHub Actions workflows and open a pull request with the changes.\n  gitlab        Convert a GitLab pipeline to a GitHub Actions workflow and open a pull request with the changes.\n  jenkins       Convert a Jenkins job to a GitHub Actions workflow and open a pull request with the changes.\n  travis-ci     Convert a Travis CI pipeline to a GitHub Actions workflow and open a pull request with the changes.\n```\n\n## Effectuer des migrations en libre-service à l’aide d’IssueOps\n\nVous 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.\n\nPour plus d’informations sur la configuration des migrations libre-service avec IssueOps, consultez le dépôt de modèles [`actions/importer-issue-ops`](https://github.com/actions/importer-issue-ops).\n\n## Utilisation du dépôt de labs GitHub Actions Importer\n\nLe 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.\n\nPour plus d’informations, consultez le dépôt [GitHub Actions Importer labs](https://github.com/actions/importer-labs/tree/main#readme).\n\n## Mentions légales\n\nCertaines parties ont été adaptées à partir de https://github.com/github/gh-actions-importer/ sous la licence MIT :\n\n```text\nMIT License\n\nCopyright (c) 2022 GitHub\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```"}