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 unter GitHub-Pläne.

In diesem Artikel

Informationen zum Verwalten von Prebuilds

Die von dir konfigurierten Prebuilds für ein Repository werden mit einem GitHub Actions-Workflow erstellt und aktualisiert, der vom GitHub Codespaces-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, muss nach den Schritten für „Anzeigen deiner GitHub Codespaces-Nutzung“ eine Kopie des Nutzungsberichts abgerufen werden.

Anzeigen des Fortschritts von Prebuilds

Du kannst den aktuellen Status der letzten Workflowausführung für jede von dir eingerichtete Prebuildkonfiguration auf der GitHub Codespaces-Seite in deinen Repositoryeinstellungen anzeigen. 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: Seite „Prebuildkonfiguration“. 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: Prebuildworkflowausgabe auf der Registerkarte „Aktionen“ von GitHub.com

Alternativ kannst du das Dropdownmenü auswählen und auf Ausführungen anzeigen klicken, um alle Prebuildworkflowausführungen anzuzeigen, die dem angegebenen Branch zugeordnet sind.

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 Ausführungsverlauf der Prebuildworkflows aus dem zugeordneten Branch angezeigt.

Screenshot: Liste „Codespaces-Prebuilds“ mit Ausführungsverlauf für Prebuildworkflows

Bearbeiten einer Prebuildkonfiguration

  1. Klicke auf der Codespaces-Seite deiner Repositoryeinstellungen auf die Auslassungspunkte rechts neben der Prebuildkonfiguration, die du bearbeiten möchtest.

  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 wird, 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. Klicke auf der Codespaces-Seite der Repositoryeinstellungen auf die Auslassungspunkte rechts neben der Prebuildkonfiguration, die du deaktivieren möchtest.

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

    Screenshot: Dropdownmenü mit Optionen für eine Konfiguration, 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 Repositorys mit einem Prebuild erhält man durch Abrufen des „Nutzungsberichts“.

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 zuvor abgeschlossen Workflowausführungen aufgeführt.

  1. Klicke auf der Codespaces-Seite deiner Repositoryeinstellungen auf die Auslassungspunkte rechts neben der Prebuildkonfiguration, die du löschen möchtest.

  2. Klicke im Dropdownmenü auf Löschen.

    Screenshot: Dropdownmenü mit Optionen für eine Konfiguration, 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. Klicke auf der Codespaces-Seite deiner Repositoryeinstellungen auf die Auslassungspunkte rechts neben der Prebuildkonfiguration, deren Workflows du auslösen möchtest.

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

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

Weitere Informationsquellen