{"meta":{"title":"Migration à partir de GitLab avec GitHub Actions Importer","intro":"Découvrez comment automatiser GitHub Actions Importer la migration de vos pipelines GitLab 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/gitlab-migration","title":"Migration de GitLab"}],"documentType":"article"},"body":"# Migration à partir de GitLab avec GitHub Actions Importer\n\nDécouvrez comment automatiser GitHub Actions Importer la migration de vos pipelines GitLab vers GitHub Actions.\n\n## À propos de la migration à partir de GitLab avec GitHub Actions Importer\n\nLes instructions ci-dessous vous guident tout au long de la configuration de votre environnement pour migrer GitHub Actions Importer des pipelines GitLab vers GitHub Actions.\n\n### Prérequis\n\n* Un compte GitLab ou une organisation avec des pipelines et des travaux que vous souhaitez convertir en GitHub Actions flux de travail.\n* Accès pour créer un GitLab personal access token pour votre compte ou organisation.\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\n  * L’[interface CLI GitHub](https://cli.github.com) est installée.\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### Limites\n\nIl existe certaines limitations sur la migration automatique des processus à partir de pipelines GitLab vers GitHub ActionsGitHub Actions Importer.\n\n* La mise en cache automatique entre les travaux de différents workflows n’est pas prise en charge.\n* La commande `audit` est uniquement prise en charge lors de l’utilisation d’un compte d’organisation. Toutefois, les commandes `dry-run` et `migrate` peuvent être utilisées avec une organisation ou un compte d’utilisateur.\n\n#### Tâches manuelles\n\nCertaines constructions GitLab doivent être migrées manuellement. Il s’agit notamment des paramètres suivants :\n\n* Valeurs de variables de groupe ou de projet masquées\n* Rapports d’artefact\n\nPour plus d’informations sur les migrations manuelles, consultez « [Migration de GitLab CI/CD vers GitHub Actions](/fr/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-gitlab-cicd) ».\n\n## Installation de l’extension GitHub Actions Importer CLI\n\n1. Installez l’extension CLI GitHub Actions Importer :\n\n   ```bash copy\n   gh extension install github/gh-actions-importer\n   ```\n\n2. 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## Configuration des informations d’identification\n\nLa commande CLI `configure` permet de définir les informations d’identification et les options requises pour GitHub Actions Importer lors de l’utilisation de GitLab et de GitHub.\n\n1. Créer un GitHubpersonal access token (classic). Pour plus d’informations, consultez « [Gestion de vos jetons d’accès personnels](/fr/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-personal-access-token-classic) ».\n\n   Votre jeton doit avoir l’étendue `workflow`.\n\n   Après avoir créé le jeton, copiez-le et enregistrez-le en lieu sûr en vue de l’utiliser ultérieurement.\n\n2. Créez un GitLab personal access token. Pour plus d’informations, consultez [Personal access tokens](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html#create-a-personal-access-token) la documentation GitLab.\n\n   Votre jeton doit avoir l’étendue `read_api`.\n\n   Après avoir créé le jeton, copiez-le et enregistrez-le en lieu sûr en vue de l’utiliser ultérieurement.\n\n3. Dans votre terminal, exécutez la GitHub Actions Importer`configure` commande CLI :\n\n   ```shell\n   gh actions-importer configure\n   ```\n\n   La commande `configure` vous invite à entrer les informations suivantes :\n\n   * Pour « Quels fournisseurs CI configurez-vous ? », utilisez les touches de direction pour sélectionner `GitLab`, appuyez sur <kbd>Space</kbd> pour le sélectionner, puis appuyez sur <kbd>Enter</kbd>.\n   * Pour «Personal access token pour GitHub », entrez la valeur du personal access token (classic) fichier que vous avez créé précédemment, puis <kbd>appuyez sur Entrée</kbd>.\n   * Pour « URL de base de l’instance GitHub », <kbd>appuyez sur Entrée</kbd> pour accepter la valeur par défaut (`https://github.com`).\n   * Pour « Jeton privé pour GitLab », entrez la valeur de GitLab personal access token que vous avez créée précédemment, puis <kbd>appuyez sur Entrée</kbd>.\n   * Pour « URL de base de l’instance GitLab », entrez l’URL de votre instance GitLab, puis appuyez sur <kbd>Entrée</kbd>.\n\n   Voici un exemple de sortie de la commande `configure`.\n\n   ```shell\n   $ gh actions-importer configure\n   ✔ Which CI providers are you configuring?: GitLab\n   Enter the following values (leave empty to omit):\n   ✔ Personal access token for GitHub: ***************\n   ✔ Base url of the GitHub instance: https://github.com\n   ✔ Private token for GitLab: ***************\n   ✔ Base url of the GitLab instance: http://localhost\n   Environment variables successfully updated.\n   ```\n\n4. Dans votre terminal, exécutez la GitHub Actions Importer`update` commande CLI pour vous connecter et GitHub PackagesContainer registry vérifiez que l’image conteneur est mise à jour vers la dernière version :\n\n   ```shell\n   gh actions-importer update\n   ```\n\n   La sortie de la commande devrait ressembler à la sortie ci-dessous :\n\n   ```shell\n   Updating ghcr.io/actions-importer/cli:latest...\n   ghcr.io/actions-importer/cli:latest up-to-date\n   ```\n\n## Effectuer un audit de GitLab\n\nVous pouvez utiliser la commande `audit` pour obtenir une vue d’ensemble de tous les pipelines d’un serveur GitLab.\n\nLa commande `audit` effectue les étapes suivantes :\n\n1. Extrait tous les projets définis dans un serveur GitLab.\n2. Convertit chaque pipeline en flux de travail équivalent GitHub Actions .\n3. Génère un rapport qui résume la façon dont l’exécution et la complexité d’une migration sont possibles avec GitHub Actions Importer.\n\n### Prérequis pour la commande d’audit\n\nPour utiliser la `audit` commande, vous devez disposer d’un personal access token compte d’organisation GitLab configuré.\n\n### Exécution de la commande d'audit\n\nPour effectuer un audit d’un serveur GitLab, exécutez la commande suivante dans votre terminal, en remplaçant `my-gitlab-namespace` par l’espace de noms ou le groupe que vous auditez :\n\n```shell\ngh actions-importer audit gitlab --output-dir tmp/audit --namespace my-gitlab-namespace\n```\n\n### Inspection des résultats de l’audit\n\nLes fichiers dans le répertoire de sortie spécifié contiennent les résultats de l’audit. Consultez le fichier `audit_summary.md` pour obtenir un résumé des résultats de l’audit.\n\nLe résumé de l’audit comporte les sections suivantes.\n\n#### Pipelines\n\nLa section « Pipelines » contient des statistiques de haut niveau concernant le taux de conversion effectué par GitHub Actions Importer.\n\nVous trouverez ci-dessous quelques termes clés qui peuvent apparaître dans la section « Pipelines » :\n\n* Les pipelines **réussis** comportaient 100 % des composants du pipeline et des éléments individuels convertis automatiquement vers leur équivalent GitHub Actions.\n* ```\n            Les pipelines **partiellement convertis avec succès** ont vu toutes les constructions du pipeline converties, mais certains éléments individuels n'ont pas été convertis automatiquement vers leur équivalent GitHub Actions.\n  ```\n* Les pipelines **non pris en charge** sont des types de définition qui ne sont pas pris en charge par GitHub Actions Importer.\n* Les pipelines **ayant échoué** sont ceux qui ont rencontré une erreur irrécupérable lors de la conversion. Cela peut se produire pour l’une des trois raisons suivantes :\n  * Le pipeline a été mal configuré à l’origine et n’était pas valide.\n  * GitHub Actions Importer a rencontré une erreur interne lors de sa conversion.\n  * Une réponse réseau infructueuse a rendu le pipeline inaccessible, ce qui est souvent dû à des informations d’identification non valides.\n\n#### Étapes de génération\n\nLa section « Étapes de génération » contient une vue d’ensemble des étapes de génération individuelles utilisées dans tous les pipelines, ainsi que le nombre d’étapes converties automatiquement par GitHub Actions Importer.\n\nVous trouverez ci-dessous quelques termes clés qui peuvent apparaître dans la section « Étapes de génération » :\n\n* Une étape de génération **connue** est une étape qui a été automatiquement convertie en action équivalente.\n* Une étape de génération **inconnue** est une étape qui n’a pas été automatiquement convertie en action équivalente.\n* Une étape de génération **non prise en charge** désigne une étape qui est soit :\n  * Fondamentalement non pris en charge par GitHub Actions.\n  * Configuré d’une manière incompatible avec GitHub Actions.\n* Une **action** est une liste des actions qui ont été utilisées dans les workflows convertis. Cela peut être important pour :\n  * Si vous utilisez GitHub Enterprise Server, collecte de la liste des actions à synchroniser avec votre instance.\n  * Définir une liste d’autorisation au niveau de l’organisation des actions utilisées. Cette liste d’actions est une liste complète d’actions que vos équipes de sécurité ou de conformité peuvent avoir besoin d’examiner.\n\n#### Tâches manuelles\n\nLa section « Tâches manuelles » contient une vue d’ensemble des tâches qui GitHub Actions Importer ne sont pas en mesure de se terminer automatiquement et que vous devez effectuer manuellement.\n\nVous trouverez ci-dessous quelques termes clés qui peuvent apparaître dans la section « Tâches manuelles » :\n\n* Un **secret** est un secret défini au niveau du dépôt ou de l’organisation, utilisé dans les pipelines convertis. Ces secrets doivent être créés manuellement dans GitHub Actions pour que ces pipelines fonctionnent correctement. Pour plus d’informations, consultez « [Utilisation de secrets dans GitHub Actions](/fr/actions/how-tos/write-workflows/choose-what-workflows-do/use-secrets) ».\n* Un **exécuteur auto-hébergé** désigne un libellé d'exécuteur référencé dans un pipeline converti qui ne correspond pas à un exécuteur hébergé par GitHub. Vous devez définir manuellement ces exécuteurs pour que ces pipelines fonctionnent correctement.\n\n#### Fichiers\n\nLa dernière section du rapport d’audit fournit un manifeste de tous les fichiers qui ont été écrits sur le disque pendant l’audit.\n\nÀ chaque fichier de pipeline correspond une série de fichiers inclus dans l’audit, notamment :\n\n* Le pipeline d’origine tel qu’il a été défini dans GitHub.\n* Toutes les réponses du réseau utilisées pour convertir le pipeline.\n* Le fichier de workflow converti.\n* Les traces de pile qui peuvent être utilisées pour résoudre les problèmes liés à une conversion de pipeline ayant échoué.\n\nDe plus, le fichier `workflow_usage.csv` contient une liste séparée par des virgules de l’ensemble des actions, secrets et exécuteurs qui sont utilisés par chaque pipeline converti avec succès. Cela peut être utile pour déterminer quels workflows utilisent quelles actions, quels secrets ou quels exécuteurs, et pour effectuer des révisions de sécurité.\n\n## Prévoir l’utilisation potentielle de l’exécuteur de génération\n\nVous pouvez utiliser la commande pour prévoir l’utilisation `forecast` potentielle GitHub Actions en calculant les métriques à partir des exécutions de pipeline terminées sur votre serveur GitLab.\n\n### Exécution de la commande de prévisions\n\nPour effectuer une prévision de l’utilisation potentielle GitHub Actions , exécutez la commande suivante dans votre terminal, en `my-gitlab-namespace` remplaçant par l’espace de noms ou le groupe que vous prévoyez. Par défaut, GitHub Actions Importer inclut les sept jours précédents dans le rapport de prévision.\n\n```shell\ngh actions-importer forecast gitlab --output-dir tmp/forecast --namespace my-gitlab-namespace\n```\n\n### Prévision d’un espace de noms entier\n\nPour prédire un espace de noms entier et tous ses sous-groupes, vous devez spécifier chaque sous-groupe dans l’argument `--namespace` ou la variable d’environnement `NAMESPACE`.\n\nPar exemple :\n\n```shell\ngh actions-importer forecast gitlab --namespace my-gitlab-namespace my-gitlab-namespace/subgroup-one my-gitlab-namespace/subgroup-two ...\n```\n\n### Inspection du rapport de prévision\n\nLe fichier `forecast_report.md` dans le répertoire de sortie spécifié contient les résultats de la prévision.\n\nVoici quelques termes clés qui peuvent apparaître dans le rapport de prévision :\n\n* Le **nombre de travaux** correspond au nombre total de travaux terminés.\n* Le **nombre de pipelines** correspond au nombre de pipelines uniques utilisés.\n* ```\n            Le **temps d’exécution** décrit le temps passé par un exécuteur sur un travail. Cette métrique peut être utilisée pour planifier le coût des exécuteurs hébergés sur GitHub.\n  ```\n  * Cette métrique est liée au montant que vous devriez vous attendre à dépenser dans GitHub Actions. Cela varie en fonction du matériel utilisé pendant ces minutes. Vous pouvez utiliser la [GitHub Actions calculatrice de prix](https://github.com/pricing/calculator) pour estimer les coûts.\n* Les métriques de **temps de file d’attente** décrivent le temps passé par un travail à attendre qu’un exécuteur soit disponible pour l’exécuter.\n* Les métriques de **travaux simultanés** décrivent le nombre de travaux en cours d’exécution à un moment donné. Cette métrique peut être utilisée pour définir le nombre d’exécuteurs que vous devez configurer.\n\nEn outre, ces métriques sont définies pour chaque file d’attente d’exécuteurs dans GitLab. C’est particulièrement utile s’il existe une combinaison d’exécuteurs hébergés ou auto-hébergés ou de machines à spécifications élevées ou faibles, afin que vous puissiez voir des métriques spécifiques à différents types d’exécuteurs.\n\n## Effectuer une migration test d’un pipeline GitLab\n\nVous pouvez utiliser la `dry-run` commande pour convertir un pipeline GitLab en flux de travail équivalent GitHub Actions .\n\n### Exécution de la commande dry-run\n\nVous pouvez utiliser la `dry-run` commande pour convertir un pipeline GitLab en flux de travail équivalent GitHub Actions . Une exécution test crée les fichiers de sortie dans un répertoire spécifié, mais n’ouvre pas de demande de tirage pour migrer le pipeline.\n\nPour effectuer une exécution sèche de la migration de vos pipelines GitLab vers GitHub Actions, exécutez la commande suivante dans votre terminal, en `my-gitlab-project` remplaçant par votre projet GitLab slug, et `my-gitlab-namespace` par l’espace de noms ou le groupe (chemin d’accès de groupe complet pour les sous-groupes, par exemple `my-org/my-team`) pour lequel vous effectuez une exécution sèche.\n\n```shell\ngh actions-importer dry-run gitlab --output-dir tmp/dry-run --namespace my-gitlab-namespace --project my-gitlab-project\n```\n\n### Inspection des workflows convertis\n\nVous pouvez afficher les journaux du test et les fichiers de workflow convertis dans le répertoire de sortie spécifié.\n\nS’il existe quelque chose qui GitHub Actions Importer n’a pas été en mesure de convertir automatiquement, comme les étapes de génération inconnues ou un pipeline partiellement réussi, vous pouvez créer des transformateurs personnalisés pour personnaliser davantage le processus de conversion. Pour plus d’informations, consultez « [Extension de GitHub Actions Importer avec des transformateurs personnalisés](/fr/actions/reference/github-actions-importer/custom-transformers) ».\n\n## Effectuer une migration de production d’un pipeline GitLab\n\nVous pouvez utiliser la commande `migrate` pour convertir un pipeline GitLab et ouvrir une pull request avec le workflow GitHub Actions équivalent.\n\n### Exécution de la commande \"migrate\"\n\nPour migrer un pipeline GitLab vers GitHub Actions, exécutez la commande suivante dans votre terminal, en remplaçant les valeurs suivantes :\n\n* ```\n            Valeur `target-url` avec l’URL de votre référentiel GitHub\n  ```\n* `my-gitlab-project` avec le slug de votre projet GitLab\n* `my-gitlab-namespace` avec l’espace de noms ou le groupe vers lequel vous migrez (chemin complet pour les sous-groupes, par ex. `my-org/my-team`)\n\n```shell\ngh actions-importer migrate gitlab --target-url https://github.com/:owner/:repo --output-dir tmp/migrate --namespace my-gitlab-namespace --project my-gitlab-project\n```\n\nLa sortie de la commande inclut l'URL du pull request qui ajoute le workflow converti à votre référentiel. Voici un exemple de sortie réussie :\n\n```shell\n$ gh actions-importer migrate gitlab --target-url https://github.com/octo-org/octo-repo --output-dir tmp/migrate --namespace octo-org --project monas-project\n[2022-08-20 22:08:20] Logs: 'tmp/migrate/log/actions-importer-20220916-014033.log'\n[2022-08-20 22:08:20] Pull request: 'https://github.com/octo-org/octo-repo/pull/1'\n```\n\n### Inspection de la demande de tirage\n\nLa sortie d’une exécution réussie de la commande `migrate` contient un lien vers la nouvelle demande de tirage qui ajoute le workflow converti à votre dépôt.\n\nVoici quelques éléments importants de la demande de tirage :\n\n* Dans la description de la demande de tirage, une section appelée **Étapes manuelles**, qui liste les étapes que vous devez effectuer manuellement avant de pouvoir terminer la migration de vos pipelines vers GitHub Actions. Par exemple, cette section peut vous indiquer de créer des secrets utilisés dans vos workflows.\n* Fichier de workflows converti. Sélectionnez l’onglet **Fichiers changés** dans la demande de tirage pour afficher le fichier de flux de travail à ajouter à votre référentiel GitHub.\n\nUne fois que vous avez terminé d’inspecter la demande de tirage, vous pouvez la fusionner pour ajouter le flux de travail à votre référentiel GitHub.\n\n## Informations de référence\n\nCette section contient des informations de référence sur les variables d’environnement, les arguments facultatifs et la syntaxe prise en charge lors de l’utilisation de GitHub Actions Importer pour migrer depuis GitLab.\n\n### Utilisation de variables d’environnement\n\nGitHub Actions Importer utilise des variables d’environnement pour sa configuration d’authentification. Ces variables sont définies lors du processus de configuration au moyen de la commande `configure`. Pour plus d’informations, consultez la section [Configuration des informations d’identification](#configuring-credentials).\n\nGitHub Actions Importer utilise les variables d’environnement suivantes pour se connecter à votre instance GitLab :\n\n* `GITHUB_ACCESS_TOKEN`: le personal access token (classic) utilisé pour créer des pull requests avec un workflow converti (nécessite l’étendue `workflow`).\n* `GITHUB_INSTANCE_URL`: URL de l’instance cible GitHub (par exemple, `https://github.com`).\n* `GITLAB_ACCESS_TOKEN`: GitLab personal access token utilisé pour afficher les ressources GitLab.\n* `GITLAB_INSTANCE_URL` : URL de l’instance GitLab.\n* `NAMESPACE` : espaces de noms ou groupes qui contiennent les pipelines GitLab.\n\nCes variables d’environnement peuvent être spécifiées dans un fichier `.env.local` qui est chargé par GitHub Actions Importer lors de son exécution.\n\n### Utilisation des arguments facultatifs\n\nVous pouvez utiliser des arguments facultatifs avec les sous-commandes GitHub Actions Importer pour personnaliser votre migration.\n\n#### `--source-file-path`\n\nVous pouvez utiliser l’argument `--source-file-path` avec les sous-commandes `forecast`, `dry-run` ou `migrate`.\n\nPar défaut, GitHub Actions Importer extrait le contenu du pipeline à partir du contrôle de code source. L’argument `--source-file-path` indique à GitHub Actions Importer d'utiliser à la place le chemin d’accès du fichier source spécifié.\n\nPar exemple :\n\n```shell\ngh actions-importer dry-run gitlab --output-dir output/ --namespace my-gitlab-namespace --project my-gitlab-project --source-file-path path/to/.gitlab-ci.yml\n```\n\nSi vous souhaitez fournir plusieurs fichiers sources lors de l’exécution de la sous-commande `forecast`, vous pouvez utiliser la correspondance de modèle dans la valeur du chemin de fichier. L’exemple suivant fournit à GitHub Actions Importer tous les fichiers sources correspondant au chemin de fichier `./tmp/previous_forecast/jobs/*.json`.\n\n```shell\ngh actions-importer forecast gitlab --output-dir output/ --namespace my-gitlab-namespace --project my-gitlab-project --source-file-path ./tmp/previous_forecast/jobs/*.json\n```\n\n#### `--config-file-path`\n\nVous pouvez utiliser l’argument `--config-file-path` avec les sous-commandes `audit`, `dry-run` et `migrate`.\n\nPar défaut, GitHub Actions Importer extrait le contenu du pipeline à partir du contrôle de code source. L’argument `--config-file-path` indique à GitHub Actions Importer d’utiliser les fichiers sources spécifiés à la place.\n\nL’argument `--config-file-path` peut également être utilisé pour spécifier le référentiel vers lequel un workflow réutilisable converti doit être migré.\n\n##### Exemple d'Audit\n\nDans cet exemple, GitHub Actions Importer utilise le fichier de configuration YAML spécifié pour effectuer un audit.\n\n```shell\ngh actions-importer audit gitlab --output-dir path/to/output/ --namespace my-gitlab-namespace --config-file-path path/to/gitlab/config.yml\n```\n\nPour auditer une instance GitLab avec un fichier de configuration, celui-ci doit être au format suivant et chaque valeur `repository_slug` doit être unique :\n\n```yaml\nsource_files:\n  - repository_slug: namespace/project-name\n    path: path/to/.gitlab-ci.yml\n  - repository_slug: namespace/some-other-project-name\n    path: path/to/.gitlab-ci.yml\n```\n\n##### Exemple d’exécution test\n\nDans cet exemple, GitHub Actions Importer utilise le fichier de configuration YAML spécifié comme fichier source pour effectuer une exécution sèche.\n\nLe pipeline est sélectionné en faisant correspondre le `repository_slug` dans le fichier de configuration à la valeur des options `--namespace` et `--project`.\n`path` est ensuite utilisé pour tirer (pull) le fichier source spécifié.\n\n```shell\ngh actions-importer dry-run gitlab --namespace my-gitlab-namespace --project my-gitlab-project-name --output-dir ./output/ --config-file-path ./path/to/gitlab/config.yml\n```\n\n##### Spécifier le référentiel des workflows réutilisables convertis\n\nGitHub Actions Importer utilise le fichier YAML fourni à l’argument `--config-file-path` pour déterminer le référentiel vers lequel les flux de travail réutilisables convertis sont migrés.\n\nPour commencer, vous devez exécuter un audit sans l’argument `--config-file-path` :\n\n```shell\ngh actions-importer audit gitlab --output-dir ./output/\n```\n\nLa sortie de cette commande contient un fichier nommé `config.yml` qui contient une liste de toutes les actions composites converties par GitHub Actions Importer. Par exemple, le fichier `config.yml` peut avoir le contenu suivant :\n\n```yaml\nreusable_workflows:\n  - name: my-reusable-workflow.yml\n    target_url: https://github.com/octo-org/octo-repo\n    ref: main\n```\n\nVous pouvez utiliser ce fichier pour spécifier le référentiel et la référence auxquels un workflow réutilisable ou une action composite doit être ajouté. Vous pouvez ensuite utiliser l’argument `--config-file-path` pour fournir le `config.yml` fichier à GitHub Actions Importer. Par exemple, vous pouvez utiliser ce fichier lors de l'exécution d'une commande `migrate` pour ouvrir une pull request à chaque dépôt unique défini dans le fichier de configuration.\n\n```shell\ngh actions-importer migrate gitlab --project my-project-name --output-dir output/ --config-file-path config.yml --target-url https://github.com/my-org/my-repo\n```\n\n### Syntaxe prise en charge pour les pipelines GitLab\n\nLe tableau suivant montre le type de propriétés GitHub Actions Importer actuellement en mesure de convertir. Pour plus d’informations sur la façon dont la syntaxe de pipeline GitLab s’aligne sur GitHub Actions, consultez [Migration de GitLab CI/CD vers GitHub Actions](/fr/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-gitlab-cicd).\n\n| Pipelines de GitLab                                   | Actions GitHub                                                                                                                      | État                         |\n| :---------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------- | :--------------------------- |\n| `after_script`                                        | `jobs.<job_id>.steps`                                                                                                               | Pris en charge               |\n| `auto_cancel_pending_pipelines`                       | `concurrency`                                                                                                                       | Pris en charge               |\n| `before_script`                                       | `jobs.<job_id>.steps`                                                                                                               | Pris en charge               |\n| `build_timeout` ou `timeout`                          | `jobs.<job_id>.timeout-minutes`                                                                                                     | Pris en charge               |\n| `default`                                             | Non applicable                                                                                                                      | Pris en charge               |\n| `image`                                               | `jobs.<job_id>.container`                                                                                                           | Pris en charge               |\n| `job`                                                 | `jobs.<job_id>`                                                                                                                     | Pris en charge               |\n| `needs`                                               | `jobs.<job_id>.needs`                                                                                                               | Pris en charge               |\n| `only_allow_merge_if_pipeline_succeeds`               | `on.pull_request`                                                                                                                   | Pris en charge               |\n| `resource_group`                                      | `jobs.<job_id>.concurrency`                                                                                                         | Pris en charge               |\n| `schedule`                                            | `on.schedule`                                                                                                                       | Pris en charge               |\n| `script`                                              | `jobs.<job_id>.steps`                                                                                                               | Pris en charge               |\n| `stages`                                              | `jobs`                                                                                                                              | Pris en charge               |\n| `tags`                                                | `jobs.<job_id>.runs-on`                                                                                                             | Pris en charge               |\n| `variables`                                           |                                                                                                                                     |                              |\n| `env`, `jobs.<job_id>.env`                            | Pris en charge                                                                                                                      |                              |\n| Exécuter des pipelines pour les nouvelles validations | `on.push`                                                                                                                           | Pris en charge               |\n| Exécuter des pipelines manuellement                   | `on.workflow_dispatch`                                                                                                              | Pris en charge               |\n| `environment`                                         | `jobs.<job_id>.environment`                                                                                                         | Partiellement pris en charge |\n| `include`                                             | Les fichiers référencés dans une instruction `include` sont fusionnés dans un graphique de travail unique avant d’être transformés. | Partiellement pris en charge |\n| `only` ou `except`                                    | `jobs.<job_id>.if`                                                                                                                  | Partiellement pris en charge |\n| `parallel`                                            | `jobs.<job_id>.strategy`                                                                                                            | Partiellement pris en charge |\n| `rules`                                               | `jobs.<job_id>.if`                                                                                                                  | Partiellement pris en charge |\n| `services`                                            | `jobs.<job_id>.services`                                                                                                            | Partiellement pris en charge |\n| `workflow`                                            | `if`                                                                                                                                | Partiellement pris en charge |\n\nPour plus d’informations sur les constructions GitLab prises en charge, consultez le [`github/gh-actions-importer`dépôt](https://github.com/github/gh-actions-importer/blob/main/docs/gitlab/index.md).\n\n### Syntaxe des variables d’environnement\n\nGitHub Actions Importer utilise le mappage dans le tableau ci-dessous pour convertir les variables d’environnement GitLab par défaut en équivalent le plus proche dans GitHub Actions.\n\n| GitLab                                        | Actions GitHub                                                                        |\n| :-------------------------------------------- | :------------------------------------------------------------------------------------ |\n| `CI_API_V4_URL`                               | `${{ github.api_url }}`                                                               |\n| `CI_BUILDS_DIR`                               | `${{ github.workspace }}`                                                             |\n| `CI_COMMIT_BRANCH`                            | `${{ github.ref }}`                                                                   |\n| `CI_COMMIT_REF_NAME`                          | `${{ github.ref }}`                                                                   |\n| `CI_COMMIT_REF_SLUG`                          | `${{ github.ref }}`                                                                   |\n| `CI_COMMIT_SHA`                               | `${{ github.sha }}`                                                                   |\n| `CI_COMMIT_SHORT_SHA`                         | `${{ github.sha }}`                                                                   |\n| `CI_COMMIT_TAG`                               | `${{ github.ref }}`                                                                   |\n| `CI_JOB_ID`                                   | `${{ github.job }}`                                                                   |\n| `CI_JOB_MANUAL`                               | `${{ github.event_name == 'workflow_dispatch' }}`                                     |\n| `CI_JOB_NAME`                                 | `${{ github.job }}`                                                                   |\n| `CI_JOB_STATUS`                               | `${{ job.status }}`                                                                   |\n| `CI_JOB_URL`                                  | `${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}` |\n| `CI_JOB_TOKEN`                                | `${{ github.token }}`                                                                 |\n| `CI_NODE_INDEX`                               | `${{ strategy.job-index }}`                                                           |\n| `CI_NODE_TOTAL`                               | `${{ strategy.job-total }}`                                                           |\n| `CI_PIPELINE_ID`                              | `${{ github.repository}}/${{ github.workflow }}`                                      |\n| `CI_PIPELINE_IID`                             | `${{ github.workflow }}`                                                              |\n| `CI_PIPELINE_SOURCE`                          | `${{ github.event_name }}`                                                            |\n| `CI_PIPELINE_TRIGGERED`                       | `${{ github.actions }}`                                                               |\n| `CI_PIPELINE_URL`                             | `${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}` |\n| `CI_PROJECT_DIR`                              | `${{ github.workspace }}`                                                             |\n| `CI_PROJECT_ID`                               | `${{ github.repository }}`                                                            |\n| `CI_PROJECT_NAME`                             | `${{ github.event.repository.name }}`                                                 |\n| `CI_PROJECT_NAMESPACE`                        | `${{ github.repository_owner }}`                                                      |\n| `CI_PROJECT_PATH_SLUG`                        | `${{ github.repository }}`                                                            |\n| `CI_PROJECT_PATH`                             | `${{ github.repository }}`                                                            |\n| `CI_PROJECT_ROOT_NAMESPACE`                   | `${{ github.repository_owner }}`                                                      |\n| `CI_PROJECT_TITLE`                            | `${{ github.event.repository.full_name }}`                                            |\n| `CI_PROJECT_URL`                              | `${{ github.server_url }}/${{ github.repository }}`                                   |\n| `CI_REPOSITORY_URL`                           | `${{ github.event.repository.clone_url }}`                                            |\n| `CI_RUNNER_EXECUTABLE_ARCH`                   | `${{ runner.os }}`                                                                    |\n| `CI_SERVER_HOST`                              | `${{ github.server_url }}`                                                            |\n| `CI_SERVER_URL`                               | `${{ github.server_url }}`                                                            |\n| `CI_SERVER`                                   | `${{ github.actions }}`                                                               |\n| `GITLAB_CI`                                   | `${{ github.actions }}`                                                               |\n| `GITLAB_USER_EMAIL`                           | `${{ github.actor }}`                                                                 |\n| `GITLAB_USER_ID`                              | `${{ github.actor }}`                                                                 |\n| `GITLAB_USER_LOGIN`                           | `${{ github.actor }}`                                                                 |\n| `GITLAB_USER_NAME`                            | `${{ github.actor }}`                                                                 |\n| `TRIGGER_PAYLOAD`                             | `${{ github.event_path }}`                                                            |\n| `CI_MERGE_REQUEST_ASSIGNEES`                  | `${{ github.event.pull_request.assignees }}`                                          |\n| `CI_MERGE_REQUEST_ID`                         | `${{ github.event.pull_request.number }}`                                             |\n| `CI_MERGE_REQUEST_IID`                        | `${{ github.event.pull_request.number }}`                                             |\n| `CI_MERGE_REQUEST_LABELS`                     | `${{ github.event.pull_request.labels }}`                                             |\n| `CI_MERGE_REQUEST_MILESTONE`                  | `${{ github.event.pull_request.milestone }}`                                          |\n| `CI_MERGE_REQUEST_PROJECT_ID`                 | `${{ github.repository }}`                                                            |\n| `CI_MERGE_REQUEST_PROJECT_PATH`               | `${{ github.repository }}`                                                            |\n| `CI_MERGE_REQUEST_PROJECT_URL`                | `${{ github.server_url }}/${{ github.repository }}`                                   |\n| `CI_MERGE_REQUEST_REF_PATH`                   | `${{ github.ref }}`                                                                   |\n| `CI_MERGE_REQUEST_SOURCE_BRANCH_NAME`         | `${{ github.event.pull_request.head.ref }}`                                           |\n| `CI_MERGE_REQUEST_SOURCE_BRANCH_SHA`          | `${{ github.event.pull_request.head.sha}}`                                            |\n| `CI_MERGE_REQUEST_SOURCE_PROJECT_ID`          | `${{ github.event.pull_request.head.repo.full_name }}`                                |\n| `CI_MERGE_REQUEST_SOURCE_PROJECT_PATH`        | `${{ github.event.pull_request.head.repo.full_name }}`                                |\n| `CI_MERGE_REQUEST_SOURCE_PROJECT_URL`         | `${{ github.event.pull_request.head.repo.url }}`                                      |\n| `CI_MERGE_REQUEST_TARGET_BRANCH_NAME`         | `${{ github.event.pull_request.base.ref }}`                                           |\n| `CI_MERGE_REQUEST_TARGET_BRANCH_SHA`          | `${{ github.event.pull_request.base.sha }}`                                           |\n| `CI_MERGE_REQUEST_TITLE`                      | `${{ github.event.pull_request.title }}`                                              |\n| `CI_EXTERNAL_PULL_REQUEST_IID`                | `${{ github.event.pull_request.number }}`                                             |\n| `CI_EXTERNAL_PULL_REQUEST_SOURCE_REPOSITORY`  | `${{ github.event.pull_request.head.repo.full_name }}`                                |\n| `CI_EXTERNAL_PULL_REQUEST_TARGET_REPOSITORY`  | `${{ github.event.pull_request.base.repo.full_name }}`                                |\n| `CI_EXTERNAL_PULL_REQUEST_SOURCE_BRANCH_NAME` | `${{ github.event.pull_request.head.ref }}`                                           |\n| `CI_EXTERNAL_PULL_REQUEST_SOURCE_BRANCH_SHA`  | `${{ github.event.pull_request.head.sha }}`                                           |\n| `CI_EXTERNAL_PULL_REQUEST_TARGET_BRANCH_NAME` | `${{ github.event.pull_request.base.ref }}`                                           |\n| `CI_EXTERNAL_PULL_REQUEST_TARGET_BRANCH_SHA`  | `${{ github.event.pull_request.base.sha }}`                                           |\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```"}