{"meta":{"title":"Automatisieren der Migration mit GitHub Actions Importer","intro":"Verwenden Sie GitHub Actions Importer, um die Migration zu GitHub Actions zu planen und zu automatisieren.","product":"GitHub Actions","breadcrumbs":[{"href":"/de/actions","title":"GitHub Actions"},{"href":"/de/actions/tutorials","title":"Anleitungen"},{"href":"/de/actions/tutorials/migrate-to-github-actions","title":"Migrieren zu GitHub Actions"},{"href":"/de/actions/tutorials/migrate-to-github-actions/automated-migrations","title":"Automatisierte Migrationen"},{"href":"/de/actions/tutorials/migrate-to-github-actions/automated-migrations/use-github-actions-importer","title":"Verwenden von GitHub Actions Importer"}],"documentType":"article"},"body":"# Automatisieren der Migration mit GitHub Actions Importer\n\nVerwenden Sie GitHub Actions Importer, um die Migration zu GitHub Actions zu planen und zu automatisieren.\n\n## Informationen zu GitHub Actions Importer\n\nSie können GitHub Actions Importer verwenden, um Ihre unterstützten CI/CD-Pipelines zu planen und automatisch zu GitHub Actions zu migrieren.\n\nGitHub Actions Importer wird als Docker-Container verteilt und verwendet eine [GitHub-CLI-Erweiterung](https://cli.github.com) für die Interaktion mit dem Container.\n\nJeder Workflow, der von GitHub Actions Importer konvertiert wird, sollte auf seine Korrektheit überprüft werden, bevor er als Produktionsworkload verwendet wird. Das Ziel besteht darin, eine Konvertierungsrate von 80 % für jeden Workflow zu erzielen. Die tatsächliche Konvertierungsrate hängt jedoch von der Zusammensetzung jeder einzelnen Pipeline ab, die konvertiert wird.\n\n## Unterstützte CI-Plattformen\n\nSie können GitHub Actions Importer verwenden, um von den folgenden Plattformen zu migrieren:\n\n* Azure DevOps\n* Bamboo\n* Bitbucket-Pipelines\n* CircleCI\n* GitLab (sowohl Cloud als auch selbst gehostet)\n* Jenkins\n* Travis CI\n\n## Voraussetzungen\n\nFür GitHub Actions Importer gelten die folgenden Voraussetzungen:\n\n* Eine Umgebung, in der du Linux-basierte Container ausführen und die erforderlichen Tools installieren kannst:\n  * Docker ist [installiert](https://docs.docker.com/get-docker/) und wird ausgeführt.\n  * Die [GitHub-CLI](https://cli.github.com) ist installiert.\n\n  > [!NOTE]\n  > Der GitHub Actions Importer-Container und die CLI müssen nicht auf demselben Server wie deine CI-Plattform installiert werden.\n\n### Installieren der GitHub Actions Importer-CLI-Erweiterung\n\n1. So installierst du die GitHub Actions Importer-CLI-Erweiterung:\n\n   ```bash copy\n   gh extension install github/gh-actions-importer\n   ```\n\n1. Überprüfe, ob die Erweiterung installiert ist:\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### Aktualisieren der GitHub Actions Importer-CLI\n\nVergewissern Sie sich regelmäßig, dass die aktuelle Version von GitHub Actions Importer ausgeführt wird, indem Sie den Befehl `update` ausführen:\n\n```bash\ngh actions-importer update\n```\n\n### Authentifizieren über die Befehlszeile\n\nSie müssen Anmeldeinformationen konfigurieren, die es GitHub Actions Importer ermöglichen, mit GitHub und Ihrem aktuellen CI-Server zu kommunizieren. Sie können diese Anmeldeinformationen mithilfe von Umgebungsvariablen oder einer `.env.local`-Datei konfigurieren. Die Umgebungsvariablen können in einer interaktiven Eingabeaufforderung konfiguriert werden, indem Sie den folgenden Befehl ausführen:\n\n```bash\ngh actions-importer configure\n```\n\n## Verwenden der GitHub Actions Importer-CLI\n\nVerwenden Sie die Unterbefehle von `gh actions-importer`, um die Migration zu GitHub Actions zu beginnen, einschließlich `audit`, `forecast`, `dry-run` und `migrate`.\n\n### Die Überprüfung Ihrer vorhandenen CI-Pipelines\n\nDer Unterbefehl `audit` kann verwendet werden, um die CI/CD-Migration zu planen, indem der aktuelle CI/CD-Speicherbedarf analysiert wird. Diese Analyse kann verwendet werden, um einen Zeitplan für die Migration zu GitHub Actions zu erstellen.\n\nUm eine Überwachung auszuführen, verwende den folgenden Befehl, um die verfügbaren Optionen zu ermitteln:\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### Vorhersagen der Nutzung\n\nDer Unterbefehl `forecast` überprüft die Pipelinenutzung in der Vergangenheit, um eine Prognose der GitHub Actions-Nutzung zu erstellen.\n\nUm eine Vorhersage auszuführen, verwende den folgenden Befehl, um die verfügbaren Optionen zu ermitteln:\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### Testen des Migrationsprozesses\n\nDer Unterbefehl `dry-run` kann verwendet werden, um eine Pipeline in ihre GitHub Actions-Entsprechung zu konvertieren und dann den Workflow in das lokale Dateisystem zu schreiben.\n\nUm einen Testlauf auszuführen, verwende den folgenden Befehl, um die verfügbaren Optionen zu ermitteln:\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### Migrieren einer Pipeline zu GitHub Actions\n\nDer Unterbefehl `migrate` kann verwendet werden, um eine Pipeline in dessen GitHub Actions Entsprechung zu konvertieren und dann eine Pullanforderung mit dem Inhalt zu erstellen.\n\nUm eine Migration auszuführen, verwende den folgenden Befehl, um die verfügbaren Optionen zu ermitteln:\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## Durchführen von Self-Service-Migrationen mithilfe von IssueOps\n\nSie können GitHub Actions und GitHub Issues verwenden, um CLI-Befehle für GitHub Actions Importer auszuführen. Dadurch können Sie Ihre CI/CD-Workflows migrieren, ohne Software auf Ihrem lokalen Computer zu installieren. Dieser Ansatz eignet sich besonders für Organisationen, die Self-Service-Migrationen zu GitHub Actions aktivieren möchten. Sobald IssueOps konfiguriert ist, können Benutzer ein Issue mit der entsprechenden Vorlage öffnen, um Pipelines zu GitHub Actions zu migrieren.\n\nWeitere Informationen zum Einrichten von Self-Service-Migrationen mit IssueOps finden Sie im Vorlagenrepository [`actions/importer-issue-ops`](https://github.com/actions/importer-issue-ops).\n\n## Verwenden des GitHub Actions Importer-Labs-Repositorys\n\nDas Repository mit den GitHub Actions Importer-Labs enthält plattformspezifische Lernpfade, die vermitteln, wie man GitHub Actions Importer verwendet und Migrationen zu GitHub Actions angeht. Anhand dieses Repositorys erfahren Sie, wie GitHub Actions Importer verwendet wird, um Ihre Migration zu GitHub Actions zu planen, vorherzusagen und zu automatisieren.\n\nWeitere Informationen finden Sie im Repository [GitHub Actions Importer Labs](https://github.com/actions/importer-labs/tree/main#readme).\n\n## Rechtliche Hinweise\n\nTeile wurden von https://github.com/github/gh-actions-importer/ unter der MIT-Lizenz übernommen:\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```"}