Verwalten von Prebuilds

Du kannst die Prebuildkonfigurationen für dein Repository überprüfen, ändern und löschen.

Wer kann dieses Feature verwenden?

Einstellungen auf Repositoryebene für GitHub Codespaces sind für alle Repositorys verfügbar, die persönlichen Konten gehören.

Für Repositorys im Besitz von Organisationen sind Einstellungen auf Repositoryebene für GitHub Codespaces für Organisationen in GitHub Team und GitHub Enterprise-Plänen verfügbar. Um auf die Einstellungen zugreifen zu können, muss die Organisation oder ihr Stammunternehmen eine Zahlungsmethode hinzugefügt und ein Ausgabenlimit für GitHub Codespaces festgelegt haben. Weitere Informationen findest du unter Auswählen der Besitzerinnen und Zahlerinnen von Codespaces in deiner Organisation und Pläne von GitHub.

In diesem Artikel

Informationen zum Verwalten von Prebuilds

Die Prebuilds, die Sie für ein Repository konfigurieren, werden mithilfe eines GitHub Actions Workflows erstellt und aktualisiert, der GitHub Codespaces vom Dienst verwaltet wird.

Je nach den Einstellungen in einer Prebuildkonfiguration kann der Workflow zur Aktualisierung des Prebuilds durch diese Ereignisse ausgelöst werden:

  • Erstellen oder Aktualisieren der Prebuildkonfiguration
  • Pushen eines Commits oder Pull Requests an einen Branch, der für Prebuilds konfiguriert ist
  • Ändern einer der Konfigurationsdateien für den Entwicklercontainer
  • Ein Zeitplan, den du in der Prebuildkonfiguration festgelegt hast
  • Manuelles Auslösen des Workflows

Die Einstellungen in der Prebuildkonfiguration bestimmen, welche Ereignisse automatisch eine Aktualisierung des Prebuilds auslösen. Weitere Informationen findest du unter Konfigurieren von Prebuilds.

Personen mit Administratorzugriff auf das Repository können den Fortschritt von Prebuilds überprüfen und Prebuildkonfigurationen bearbeiten und löschen.

Um alle Repositorys zu finden, die eine Prebuildkonfiguration hosten, musst du eine Kopie deines Nutzungsberichts abrufen, indem du die Schritte für Anzeigen Ihres Nutzungsverhaltens von getakteten Produkten und Lizenzen ausführst.

Anzeigen des Fortschritts von Vorabversionen

Sie können den aktuellen Status des aktuellen Workflows anzeigen, der für jede Vorbuildkonfiguration ausgeführt wird, die Sie auf der GitHub Codespaces Seite Ihrer Repositoryeinstellungen eingerichtet haben. Diese Status lauten beispielsweise „Wird derzeit ausgeführt“ oder „Zuletzt vor einer Stunde ausgeführt“.

Klicke auf Ausgabe anzeigen, um die Protokollausgabe für die letzte Ausführung des Prebuildworkflows anzuzeigen.

Screenshot der Seite "Prebuild-Konfiguration". Zwei Prebuildkonfigurationen sind aufgeführt. Die Schaltfläche „Ausgabe anzeigen“ für eine Konfiguration ist hervorgehoben.

Hier wird die Ausgabe der letzten Workflowausführung auf der Registerkarte Aktionen angezeigt.

Screenshot der vorab erstellten Workflow-Ausgabe auf der Registerkarte „Aktionen“ von GitHub.

Wenn Sie alternativ alle Vorabbuildworkflows anzeigen möchten, die der angegebenen Verzweigung zugeordnet sind, wählen Sie das Dropdownmenü aus, und klicken Sie auf "Ansichtsausführungen".

Screenshot: Dropdownmenü mit Optionen für eine Konfiguration, das durch Klicken auf eine Schaltfläche mit drei Punkten angezeigt wird. Die Option „Ausführungen anzeigen“ ist ausgewählt.

Hier wird der Verlauf der Ausführungen der Prebuild-Workflows des zugeordneten Branchs angezeigt.

Screenshot der Liste „Codespaces-Prebuilds“ mit Ausführungsverlauf für Prebuild-Workflows.

Bearbeiten einer Prebuildkonfiguration

  1. Klicken Sie auf der Codespaces Seite Ihrer Repositoryeinstellungen auf die Auslassungspunkte rechts neben der Vorbuildkonfiguration, die Sie bearbeiten möchten.

  2. Klicke im Dropdownmenü auf Bearbeiten.

    Screenshot: Dropdownmenü mit Optionen für eine Konfiguration, das durch Klicken auf eine Schaltfläche mit drei Punkten angezeigt wird. Die Option „Bearbeiten“ ist ausgewählt.

  3. Nimm die erforderlichen Änderungen an der Prebuildkonfiguration vor, und klicke dann auf Aktualisieren.

    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.

    Klicke auf , um die Details der angeforderten Berechtigungen anzuzeigen.

    Screenshot: Autorisierungsseite für eine Prebuildkonfiguration. In dieser Anforderung sind drei Berechtigungen aufgeführt.

    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äß

    Hinweis

    Benutzer, die Codespaces mit diesem Prebuild erstellen, werden ebenfalls aufgefordert, diese Berechtigungen zu erteilen.

Deaktivieren einer Prebuildkonfiguration

Um die Aktualisierung von Prebuilds für eine Konfiguration anzuhalten, kannst du Workflowausführungen für die Konfiguration deaktivieren. Wenn du die Workflowausführungen für eine Prebuildkonfiguration deaktivierst, werden die zuvor erstellten Prebuilds für diese Konfiguration nicht gelöscht. Folglich werden die Codespaces weiterhin anhand eines vorhandenen Prebuilds generiert.

Das Deaktivieren der Workflowausführungen für eine Prebuildkonfiguration ist nützlich, wenn du Fehler bei der Prebuilderstellung untersuchen musst.

  1. Klicken Sie auf der Codespaces Seite Ihrer Repositoryeinstellungen rechts neben der Prebuild-Konfiguration, die Sie deaktivieren möchten, auf die Auslassungspunkte.

  2. Klicke im Dropdownmenü auf Ausführungen deaktivieren.

    Screenshot: Dropdownmenü für die Konfiguration vor dem Build, das durch Klicken auf eine Schaltfläche mit drei Punkten angezeigt wird Die Option „Ausführungen deaktivieren“ ist ausgewählt.

  3. Um zu bestätigen, dass du diese Konfiguration deaktivieren möchtest, klicke auf OK.

Löschen einer Prebuildkonfiguration

Hinweis

Eine Liste der Repositories, die ein Prebuild enthalten, kannst du erhalten, indem du eine Kopie deines Nutzungsberichts erstellst.

Durch das Löschen einer Prebuildkonfiguration werden auch alle zuvor erstellten Prebuilds für diese Konfiguration gelöscht. Dadurch stehen die von dieser Konfiguration erstellten Prebuilds kurz nach dem Löschen der Konfiguration nicht mehr zur Verfügung, wenn du einen neuen Codespace erstellst.

Nach dem Löschen einer Prebuildkonfigurationen werden Workflowausführungen für diese Konfiguration, die in der Warteschlange eingereiht waren oder bereits gestartet wurden, weiterhin ausgeführt. Sie werden im Ausführungsverlauf der Workflows zusammen mit den zuvor abgeschlossenen Workflowausführungen aufgeführt.

  1. Klicken Sie auf der Codespaces Seite Ihrer Repositoryeinstellungen auf die Auslassungspunkte rechts neben der prebuild-Konfiguration, die Sie löschen möchten.

  2. Klicke im Dropdownmenü auf Löschen.

    Screenshot: Dropdownmenü für die Konfiguration vor dem Build, das durch Klicken auf eine Schaltfläche mit drei Punkten angezeigt wird Die Option „Löschen“ ist ausgewählt.

  3. Klicke auf OK, um das Löschen zu bestätigen.

Manuelles Auslösen von Prebuilds

Es kann nützlich sein, eine Workflowausführung für eine Prebuildkonfiguration manuell auszulösen. Im Allgemeinen ist dies nur beim Debuggen eines Problems mit dem Workflow für eine Prebuildkonfiguration notwendig.

  1. Klicken Sie auf der Codespaces Seite Ihrer Repositoryeinstellungen auf die Auslassungspunkte rechts neben der Vorbuildkonfiguration, deren Workflow Sie auslösen möchten.

  2. Klicke im Dropdownmenü auf Manuell auslösen.

    Screenshot: Dropdownmenü für die Konfiguration vor dem Build, das durch Klicken auf eine Schaltfläche mit drei Punkten angezeigt wird Die Option „Manuell auslösen“ ist ausgewählt.

Weiterführende Lektüre