{"meta":{"title":"Zusätzliche Argumente und Einstellungen","intro":"GitHub Actions Importer verfügt über mehrere zusätzliche Argumente und Einstellungen, mit denen du den Migrationsprozess an deine Anforderungen anpassen kannst.","product":"GitHub Actions","breadcrumbs":[{"href":"/de/actions","title":"GitHub Actions"},{"href":"/de/actions/reference","title":"Verweis"},{"href":"/de/actions/reference/github-actions-importer","title":"GitHub Actions Importer (Importwerkzeug)"},{"href":"/de/actions/reference/github-actions-importer/supplemental-arguments-and-settings","title":"Zusätzliche Argumente und Einstellungen"}],"documentType":"article"},"body":"# Zusätzliche Argumente und Einstellungen\n\nGitHub Actions Importer verfügt über mehrere zusätzliche Argumente und Einstellungen, mit denen du den Migrationsprozess an deine Anforderungen anpassen kannst.\n\nDieser Artikel enthält allgemeine Informationen zum Konfigurieren der zusätzlichen Argumente und Einstellungen von GitHub Actions Importer, z. B. optionale Parameter, Pfadargumente und Netzwerkeinstellungen.\n\n## Optionale Parameter\n\nGitHub Actions Importer verfügt über mehrere optionale Parameter, mit denen du den Migrationsprozess anpassen kannst.\n\n### Einschränken zulässiger Aktionen\n\nDie folgenden Optionen können verwendet werden, um die in konvertierten Workflows zulässigen Aktionen zu begrenzen. In Kombination können diese Optionen die Liste der zulässigen Aktionen erweitern. Wenn keine dieser Optionen angegeben wird, sind alle Aktionen zulässig.\n\n* `--allowed-actions` gibt eine Liste von Aktionen an, die in konvertierten Workflows zugelassen werden sollen. Platzhalter werden unterstützt. Alle anderen als die bereitgestellten Aktionen werden nicht zugelassen.\n\n  Beispiel:\n\n  ```shell\n  --allowed-actions actions/checkout@v6 actions/upload-artifact@* my-org/*\n  ```\n\n  Du kannst eine leere Liste bereitstellen, um keine Aktionen zuzulassen. Beispiel: `--allowed-actions=`.\n\n* `--allow-verified-actions` gibt an, dass alle Aktionen von verifizierten Erstellern zulässig sind.\n\n* `--allow-github-created-actions` gibt an, dass von der `github`- oder `actions`-Organisation veröffentlichte Aktionen zulässig sind.\n\n  Solche Aktionen umfassen z. B. `github/super-linter` und `actions/checkout`.\n\n  Diese Option entspricht `--allowed-actions actions/* github/*`.\n\n### Verwenden einer Anmeldeinformationsdatei für die Authentifizierung\n\nDer Parameter `--credentials-file` gibt den Pfad zu einer Datei mit Anmeldeinformationen für verschiedene Server an, bei denen sich GitHub Actions Importer authentifizieren kann. Dies ist nützlich, wenn Buildskripts (z. B. `.travis.yml` oder `jenkinsfile`) in mehreren GitHub Enterprise Server-Instanzen gespeichert werden.\n\nEine Anmeldeinformationsdatei muss eine YAML-Datei sein, die eine Liste von Server- und Zugriffstokenkombinationen enthält. GitHub Actions Importer verwendet die Anmeldeinformationen für die URL, die der Netzwerkanforderung am ehesten entspricht.\n\nBeispiel:\n\n```yaml\n- url: https://github.com\n  access_token: ghp_mygeneraltoken\n- url: https://github.com/specific_org/\n  access_token: ghp_myorgspecifictoken\n- url: https://jenkins.org\n  access_token: abc123\n  username: marty_mcfly\n```\n\nFür die obige Anmeldeinformationsdatei verwendet GitHub Actions Importer das Zugriffstoken `ghp_mygeneraltoken`, um alle Netzwerkanforderungen bei `https://github.com` zu authentifizieren, _es sei denn_, die Netzwerkanforderung gilt für ein Repository in der Organisation `specific_org`. In diesem Fall wird stattdessen das Token `ghp_myorgspecifictoken` zur Authentifizierung verwendet.\n\n#### Alternative Quellcodeanbieter\n\nGitHub Actions Importer kann automatisch Quellcode aus Nicht-GitHub-Repositorys abrufen. Eine Anmeldeinformationsdatei kann den `provider`, die Anbieter-URL und die Anmeldeinformationen angeben, die zum Abrufen des Quellcodes erforderlich sind.\n\nBeispiel:\n\n```yaml\n- url: https://gitlab.com\n  access_token: super_secret_token\n  provider: gitlab\n```\n\nIm obigen Beispiel verwendet GitHub Actions Importer das Token `super_secret_token` zum Abrufen von Quellcode, der auf `https://gitlab.com` gehostet wird.\n\nUnterstützte Werte für `provider` lauten:\n\n* `github` (Standardwert)\n* `gitlab`\n* `bitbucket_server`\n* `azure_devops`\n\n### Steuern optionaler Features\n\nAnhand der Option `--features` kannst du die Features einschränken, die in den von GitHub Actions Importer erstellten Workflows verwendet werden. Dies ist nützlich, um die neuere GitHub Actions-Syntax bei der Migration zu einer älteren GitHub Enterprise Server-Instanz aus den Workflows auszuschließen. Wenn du die Option `--features` verwendest, musst du die Version von GitHub Enterprise Server angeben, zu der migriert wird.\n\nBeispiel:\n\n```shell\ngh actions-importer dry-run ... --features ghes-3.3\n```\n\nFolgende Werte werden für `--features` unterstützt:\n\n* `all` (Standardwert)\n* `ghes-latest`\n* `ghes-<number>`, wobei `<number>` der Version von GitHub Enterprise Server entspricht, `3.0` oder höher. Beispiel: `ghes-3.3`.\n\nSie können die Liste der verfügbaren Feature-Flags für GitHub Actions Importer anzeigen, indem Sie den Befehl `list-features` ausführen. Beispiel:\n\n```shell copy\ngh actions-importer list-features\n```\n\nEs sollte in etwa folgende Ausgabe angezeigt werden:\n\n<!-- markdownlint-disable search-replace -->\n\n```shell\nAvailable feature flags:\n\nactions/cache (disabled):\n        Control usage of actions/cache inside of workflows. Outputs a comment if not enabled.\n        GitHub Enterprise Server >= ghes-3.5 required.\n\ncomposite-actions (enabled):\n        Minimizes resulting workflow complexity through the use of composite actions. See https://docs.github.com/en/actions/creating-actions/creating-a-composite-action for more information.\n        GitHub Enterprise Server >= ghes-3.4 required.\n\nreusable-workflows (disabled):\n        Avoid duplication by re-using existing workflows. See https://docs.github.com/en/actions/using-workflows/reusing-workflows for more information.\n        GitHub Enterprise Server >= ghes-3.4 required.\n\nworkflow-concurrency-option-allowed (enabled):\n        Allows the use of the `concurrency` option in workflows. See https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions#concurrency for more information.\n        GitHub Enterprise Server >= ghes-3.2 required.\n\nEnable features by passing --enable-features feature-1 feature-2\nDisable features by passing --disable-features feature-1 feature-2\n```\n\n<!-- markdownlint-enable search-replace -->\n\nUm Funktionsflaggen umzuschalten, können Sie eine der folgenden Methoden verwenden:\n* Verwende die Optionen `--enable-features` und `--disable-features`, wenn du den Befehl `gh actions-importer` ausführst.\n* Verwende eine Umgebungsvariable für jedes Featureflag.\n\nDu kannst die Optionen `--enable-features` und `--disable-features` verwenden, um bestimmte Features auszuwählen, die für die Dauer des Befehls aktiviert oder deaktiviert werden sollen.\nMit dem folgenden Befehl wird beispielsweise die Verwendung von `actions/cache` und `composite-actions` deaktiviert:\n\n```shell\ngh actions-importer dry-run ... --disable-features=composite-actions actions/cache\n```\n\nDu kannst den Befehl `configure --features` verwenden, um Featureflags interaktiv zu konfigurieren und automatisch in deine Umgebung zu schreiben:\n\n```shell\n$ gh actions-importer configure --features\n\n✔ Which features would you like to configure?: actions/cache, reusable-workflows\n✔ actions/cache (disabled): Enable\n? reusable-workflows (disabled):\n› Enable\n  Disable\n```\n\n### Deaktivieren des Zwischenspeicherns von Netzwerkantworten\n\nStandardmäßig speichert GitHub Actions Importer Antworten aus Netzwerkanforderungen zwischen, um die Netzwerklast zu verringern und die Laufzeit zu verkürzen. Du kannst die Option `--no-http-cache` verwenden, um den Netzwerkcache zu deaktivieren. Beispiel:\n\n```shell\ngh actions-importer forecast ... --no-http-cache\n```\n\n## Pfadargumente\n\nBeim Ausführen von GitHub Actions Importer sind Pfadargumente relativ zum Datenträger des Containers. Absolute Pfade relativ zum Hostcomputer des Containers werden nicht unterstützt. Bei der Ausführung von GitHub Actions Importer wird das Verzeichnis des `/data`-Containers in das Verzeichnis eingebunden, in dem GitHub Actions Importer ausgeführt wird.\n\nEin Beispiel: Wenn der folgende Befehl im Verzeichnis `/Users/mona` verwendet wird, gibt er die GitHub Actions Importer-Überwachungszusammenfassung an das Verzeichnis `/Users/mona/out` aus:\n\n```shell\ngh actions-importer audit --output-dir /data/out\n```\n\n## Verwenden eines Proxys\n\nUm auf Server zuzugreifen, die mit einem HTTP-Proxy konfiguriert sind, musst du die folgenden Umgebungsvariablen mit der URL des Proxys festlegen:\n\n* `OCTOKIT_PROXY`: für alle GitHub-Server.\n* `HTTP_PROXY` (oder `HTTPS_PROXY`): für alle anderen Server.\n\nBeispiel:\n\n```shell\nexport OCTOKIT_PROXY=https://proxy.example.com:8443\nexport HTTPS_PROXY=$OCTOKIT_PROXY\n```\n\nWenn der Proxy eine Authentifizierung erfordert, müssen ein Benutzername und ein Kennwort in der Proxy-URL enthalten sein. Beispiel: `https://username:password@proxy.url:port`.\n\n## Deaktivieren der SSL-Zertifikatüberprüfung\n\nStandardmäßig werden SSL-Zertifikate beim Senden von Netzwerkanforderungen von GitHub Actions Importer überprüft. Du kannst die SSL-Zertifikatüberprüfung mit der Option `--no-ssl-verify` deaktivieren. Beispiel:\n\n```shell\ngh actions-importer audit --output-dir ./output --no-ssl-verify\n```\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```"}