{"meta":{"title":"Konfigurieren von Prebuilds","intro":"Du kannst dein Projekt so konfigurieren, dass ein Codespace automatisch erstellt wird, wenn du eine Änderung an dein Repository sendest.","product":"Codespaces","breadcrumbs":[{"href":"/de/codespaces","title":"Codespaces"},{"href":"/de/codespaces/prebuilding-your-codespaces","title":"Vordefinieren von Codespaces"},{"href":"/de/codespaces/prebuilding-your-codespaces/configuring-prebuilds","title":"Konfigurieren von Prebuilds"}],"documentType":"article"},"body":"# Konfigurieren von Prebuilds\n\nDu kannst dein Projekt so konfigurieren, dass ein Codespace automatisch erstellt wird, wenn du eine Änderung an dein Repository sendest.\n\nDu kannst eine Prebuildkonfiguration für die Kombination eines bestimmten Branchs deines Repositorys mit einer bestimmten Dev-Containerkonfigurationsdatei einrichten.\n\nAlle Branches, die aus einem übergeordneten Branch mit Prebuildunterstützung erstellt werden, erhalten in der Regel auch Prebuilds für die gleiche Dev-Containerkonfiguration. Das liegt daran, dass Prebuilds für untergeordnete Branches, die die gleiche Entwicklungscontainerkonfiguration wie der übergeordnete Branch verwenden, größtenteils identisch sind, sodass Entwickler\\*innen auch von den schnelleren Codespace-Erstellungszeiten für diese Branches profitieren können. Weitere Informationen findest du unter [Einführung in Dev-Container](/de/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers).\n\nBei der Konfiguration von Prebuilds für einen Branch stehen Prebuilds für mehrere Computertypen zur Verfügung. Wenn dein Repository jedoch größer als 32 GB ist, sind Prebuilds für 2-Kern- und 4-Kern-Computer nicht verfügbar, da der von diesen bereitgestellte Speicher auf 32 GB begrenzt ist.\n\n## Voraussetzungen\n\nVorbuilds werden mithilfe von GitHub Actions. Daher muss für das Repository, für das Sie Vorabbuilds konfigurieren, GitHub Actions aktiviert werden. Weitere Informationen findest du unter [Einstellung der GitHub Actions für ein Repository verwalten](/de/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository).\n\nDu kannst Prebuilds in jedem Repository einrichten, das einem persönliches Konto gehört. Der Prebuild verbraucht Speicherplatz, für den eine abrechenbare Gebühr anfällt oder, im Fall von Repositorys, die deinem persönlichen Konto gehören, ein Teil deines monatlich enthaltenen Speichers verwendet wird.\n\n> \\[!NOTE]\n> Wenn Sie Prebuilds für ein Fork-Repository erstellen, werden die Speicherkosten dieser Prebuilds von Ihrem monatlich enthaltenen Speicher subtrahiert, während sie verfügbar sind. Wenn Sie Ihren gesamten enthaltenen Speicher verwendet haben und Sie die Abrechnung eingerichtet haben, wird dies in Ihrem persönlichen Konto in Rechnung gestellt. Dies gilt auch dann, wenn die von Ihnen erstellten Codespaces für eine Fork von der Organisation bezahlt werden, die das übergeordnete Repository besitzt. Siehe [GitHub Codespaces Abrechnung](/de/billing/concepts/product-billing/github-codespaces#how-costs-are-assigned-to-a-billable-account).\n\nFür Repositorys, die sich im Besitz einer Organisation befinden, können Sie Vorabbuilds einrichten, wenn sich die Organisation in einem GitHub Team oder GitHub Enterprise einem Plan befindet. Darüber hinaus müssen Sie eine Zahlungsmethode hinzugefügt und ein Ausgabenlimit für GitHub Codespaces das Organisationskonto oder das übergeordnete Unternehmen festlegen. Weitere Informationen findest du unter [Einrichten von Budgets zum Kontrollieren der Ausgaben für Produkte mit verbrauchseinheitenbasierter Abrechnung](/de/billing/how-tos/set-up-budgets#managing-budgets-for-your-organization-or-enterprise) und [Pläne von GitHub](/de/get-started/learning-about-github/githubs-plans).\n\n## Konfigurieren von Prebuilds\n\n1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.\n\n2. Klicke unter dem Repositorynamen auf ** Settings**. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü **** die Option **Einstellungen** aus.\n\n \n\n3. In der Randleiste unter \"Code, Planung und Automatisierung\" klicken Sie auf **Codespaces**.\n\n4. Klicke im Abschnitt „Prebuildkonfiguration“ der Seite auf **Prebuild einrichten**.\n\n \n\n5. Wähle den Branch aus, für den du Prebuilds einrichten möchtest.\n\n \n\n > \\[!NOTE]\n > Alle Branches, die aus einem Basisbranch mit Prebuildunterstützung erstellt werden, erhalten in der Regel auch Prebuilds für die gleiche Dev-Containerkonfiguration. Wenn du beispielsweise Prebuilds für eine Dev-Containerkonfigurationsdatei im Standardbranch des Repositorys aktivierst, erhalten Branches, die auf dem Standardbranch basieren, in den meisten Fällen ebenfalls Prebuilds für die gleiche Dev-Containerkonfiguration.\n\n6. Wähle optional im angezeigten Dropdownmenü **Konfigurationsdatei** die `devcontainer.json`-Konfigurationsdatei aus, die du für deine Prebuilds verwenden möchtest. Weitere Informationen findest du unter [Einführung in Dev-Container](/de/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers#devcontainerjson).\n\n \n\n7. Wähle aus, wie du die Updates von Prebuilds automatisch auslösen möchtest.\n\n * **Bei jedem Push** (Standardeinstellung): Mit dieser Einstellung werden Prebuilds bei jedem Push aktualisiert, der in den angegebenen Branch erfolgt. So wird sichergestellt, dass die aus einem Prebuild generierten Codespaces stets die neueste Codespacekonfiguration enthalten, einschließlich aller zuletzt hinzugefügten oder aktualisierten Abhängigkeiten.\n\n * **Bei Konfigurationsänderung:** Mit dieser Einstellung werden Prebuilds jedes Mal aktualisiert, wenn eine der folgenden Dateien geändert wird:\n\n * `.devcontainer/devcontainer.json`\n\n > \\[!NOTE]\n > Prebuildupdates werden nicht durch Änderungen an `devcontainer.json`-Dateien in Unterverzeichnissen von `.devcontainer` ausgelöst.\n\n * Auf das Dockerfile wird in der `build.dockerfile`-Eigenschaft der `.devcontainer/devcontainer.json`-Datei verwiesen.\n\n Mit dieser Einstellung wird sichergestellt, dass Änderungen an den Konfigurationsdateien des Entwicklungscontainers für das Repository verwendet werden, wenn ein Codespace anhand eines Prebuilds generiert wird. Der GitHub Actions Workflow, der die Vorbuilds aktualisiert, wird weniger häufig ausgeführt, sodass diese Option weniger GitHub Actions Minuten verwendet. Diese Option garantiert jedoch nicht, dass Codespaces immer zuletzt hinzugefügte oder aktualisierte Abhängigkeiten enthalten, sodass diese möglicherweise manuell hinzugefügt oder aktualisiert werden müssen, nachdem ein Codespace erstellt wurde.\n\n * **Geplant**: Mit dieser Einstellung kannst du festlegen, dass deine Prebuilds nach einem benutzerdefinierten Zeitplan aktualisiert werden. Dies kann jedoch den Verbrauch von GitHub Actions Minuten verringern, mit dieser Option können Codespaces erstellt werden, die nicht die neuesten Konfigurationsänderungen des Entwicklercontainers verwenden.\n\n \n\n8. Wähle optional **Prebuild auf bestimmte Regionen beschränken** aus, um Prebuilds nur in bestimmten Regionen zu erstellen. Wähle die Regionen aus, in denen Prebuilds verfügbar sein sollen.\n\n Standardmäßig werden Prebuilds in allen verfügbaren Regionen erstellt, wobei Speichergebühren pro Prebuild anfallen.\n\n \n\n > \\[!NOTE]\n >\n > * Für den Prebuild in jeder Region fallen individuelle Speichergebühren an. Du solltest daher nur Prebuilds für Regionen aktivieren, von denen du weißt, dass sie verwendet werden.\n > * Entwickler können ihre Standardregion festlegen, GitHub Codespacesfür die Sie Prebuilds für weniger Regionen aktivieren können. Weitere Informationen findest du unter [Festlegen der Standardregion für GitHub Codespaces](/de/codespaces/setting-your-user-preferences/setting-your-default-region-for-github-codespaces).\n\n9. Lege unter **Vorlagenverlauf** wahlweise die Anzahl der Prebuildversionen fest, die aufbewahrt werden sollen. Du kannst eine beliebige Zahl zwischen 1 und 5 eingeben. Standardmäßig werden zwei Versionen gespeichert. Das bedeutet, dass nur der neueste Prebuild und die Vorgängerversion gespeichert werden.\n\n \n\n Abhängig von den Triggereinstellungen könnte der Prebuild mit jedem Push oder jeder Konfigurationsänderung im Entwicklungscontainer geändert werden. Wenn du ältere Versionen von Prebuilds aufbewahrst, kannst du einen Prebuild aus einem älteren Commit mit einer anderen Konfiguration für den Entwicklungscontainer erstellen als der aktuelle Prebuild. Mit dieser Einstellung kannst du die Anzahl der aufbewahrten Versionen auf ein für deine Anforderungen geeignetes Maß festlegen.\n\n Wenn Sie die Anzahl der Vorabbuildversionen auf \"1\" festlegen, GitHub Codespaces wird nur die neueste Version des Vorabbuilds gespeichert und die ältere Version bei jeder Aktualisierung der Vorlage gelöscht. Das bedeutet, dass kein vordefinierter Codespace vorhanden ist, wenn du zurück zu einer älteren Konfiguration des Entwicklungscontainers wechselst.\n\n Für jede Prebuildversion, die aufbewahrt wird, fallen Speicherkosten an. Wenn du beispielsweise Prebuilds in vier Regionen generieren und zwei Versionen aufbewahren möchtest, werden dir bis zu acht Prebuilds in Rechnung gestellt. Weitere Informationen findest du unter [GitHub Codespaces Abrechnung](/de/billing/concepts/product-billing/github-codespaces#pricing).\n\n10. Füge wahlweise Benutzer*innen oder Teams hinzu, die benachrichtigt werden sollen, wenn bei der Ausführung des Prebuildworkflows für diese Konfiguration ein Fehler auftritt. Beginne mit der Eingabe eines Benutzernamens, eines Teamnamens oder eines vollständigen Namens, und klicke dann auf den gewünschten Namen, sobald dieser angezeigt wird, um ihn der Liste hinzuzufügen. Die Benutzer*innen oder Teams, die du hinzufügst, erhalten eine E-Mail, wenn Prebuildfehler auftreten. Diese enthält einen Link zu den Ausführungsprotokollen des Workflows, um weitere Untersuchungen zu erleichtern.\n\n \n\n > \\[!NOTE]\n > Personen erhalten nur Benachrichtigungen über fehlerhafte Prebuilds, wenn sie Benachrichtigungen für fehlerhafte Actions-Workflows in ihren persönlichen Einstellungen aktiviert haben. Weitere Informationen findest du unter [Benachrichtigungen für Workflow-Läufe](/de/actions/concepts/workflows-and-actions/notifications-for-workflow-runs).\n\n11. Wähle am unteren Rand der Seite die Option **Erweiterte Optionen anzeigen** aus.\n\n \n\n Wenn du im Abschnitt „Erweiterte Optionen“ die Option **Prebuildoptimierung deaktivieren** auswählst, werden Codespaces ohne Prebuild erstellt, wenn der neueste Prebuildworkflow fehlgeschlagen ist oder gerade ausgeführt wird. Weitere Informationen findest du unter [Fehlerbehebung bei prebuilds](/de/codespaces/troubleshooting/troubleshooting-prebuilds#preventing-out-of-date-prebuilds-being-used).\n\n12. Klicken Sie auf **\"Erstellen\"**.\n\n Wenn die Dev-Containerkonfiguration für das Repository Berechtigungen für den Zugriff auf andere Repositorys angibt, wird dir eine Autorisierungsseite angezeigt. Weitere Informationen dazu, wie dies in der `devcontainer.json`-Datei angegeben ist, findest du unter [Verwalten des Zugriffs auf andere Repositorys innerhalb deines Codespace](/de/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces).\n\n Klicke auf , um die Details der angeforderten Berechtigungen anzuzeigen.\n\n \n\n Klicke auf **Autorisieren und fortfahren**, um diese Berechtigungen für die Erstellung von Prebuilds zu erteilen. Alternativ kannst du auf **Ohne Autorisierung fortfahren** klicken. In diesem Fall funktionieren die Codespaces, die aus den resultierenden Prebuilds erstellt wurden, jedoch möglicherweise nicht ordnungsgemäß\n\n > \\[!NOTE]\n > Benutzer, die Codespaces mit diesem Prebuild erstellen, werden ebenfalls aufgefordert, diese Berechtigungen zu erteilen.\n\nNachdem Sie eine Vorbuildkonfiguration erstellt haben, wird sie auf der GitHub Codespaces Seite Ihrer Repositoryeinstellungen aufgeführt. Ein GitHub Actions Workflow wird in die Warteschlange gestellt und anschließend ausgeführt, um Prebuilds in den von Ihnen angegebenen Regionen zu erstellen, basierend auf der von Ihnen ausgewählten Verzweigungs- und Entwicklungscontainerkonfigurationsdatei.\n\n\n\nInformationen zum Bearbeiten und Löschen von Prebuildkonfigurationen findest du unter [Verwalten von Prebuilds](/de/codespaces/prebuilding-your-codespaces/managing-prebuilds).\n\n## Konfigurieren von Umgebungsvariablen\n\nUm dem Vorabbuildprozess den Zugriff auf Umgebungsvariablen zu ermöglichen, die zum Erstellen Ihrer Entwicklungsumgebung erforderlich sind, können Sie diese entweder als Codespaces Repositoryschlüssel oder als Codespaces Organisationsgeheimnisse festlegen. Geheimnisse, die du auf diese Weise erstellst, sind für alle Personen zugänglich, die einen Codespace aus diesem Repository erstellen. Weitere Informationen findest du unter [Verwalten von Entwicklungsumgebungs-Geheimnissen für Ihr Repository oder Ihre Organisation](/de/codespaces/managing-codespaces-for-your-organization/managing-development-environment-secrets-for-your-repository-or-organization#adding-secrets-for-a-repository).\n\nPrebuilds können bei der Erstellung deiner Umgebung keine Geheimnisse auf Benutzerebene verwenden, da diese erst nach der Erstellung des Codespaces verfügbar sind.\n\n## Konfigurieren von zeitaufwendigen Aufgaben, die im Prebuild enthalten sind\n\nDu kannst die Befehle `onCreateCommand` und `updateContentCommand` in deine `devcontainer.json`-Datei einbinden, um zeitaufwändige Prozesse in die Erstellung des Prebuilds einzubeziehen. Weitere Informationen finden Sie in der Visual Studio Code Dokumentation [devcontainer.json Referenz](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_lifecycle-scripts).\n\n`onCreateCommand` wird nur einmal ausgeführt, wenn der Prebuild erstellt wird, wobei `updateContentCommand` zum Zeitpunkt der Erstellung des Prebuilds und bei nachfolgenden Updates ausgeführt wird. Inkrementelle Builds sollten in `updateContentCommand` enthalten sein, da sie die Quelle deines Projekts darstellen und in jedem Prebuildupdate enthalten sein müssen.\n\n## Weiterführende Lektüre\n\n* [Gewährung des Zugriffs eines Prebuilds auf andere Repositories](/de/codespaces/prebuilding-your-codespaces/allowing-a-prebuild-to-access-other-repositories)\n* [Fehlerbehebung bei prebuilds](/de/codespaces/troubleshooting/troubleshooting-prebuilds)"}