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 finden Sie 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.
Hier wird die Ausgabe der letzten Workflowausführung auf der Registerkarte Aktionen angezeigt.
Alternativ kannst du das Dropdownmenü auswählen und auf Ausführungen anzeigen klicken, um alle Prebuildworkflowausführungen anzuzeigen, die dem angegebenen Branch zugeordnet sind.
Hier wird der Ausführungsverlauf der Prebuildworkflows aus dem zugeordneten Branch angezeigt.
Bearbeiten einer Prebuildkonfiguration
-
Klicke auf der Codespaces-Seite deiner Repositoryeinstellungen auf die Auslassungspunkte rechts neben der Prebuildkonfiguration, die du bearbeiten möchtest.
-
Klicke im Dropdownmenü auf Bearbeiten.
-
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.
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.
-
Klicke auf der Codespaces-Seite der Repositoryeinstellungen auf die Auslassungspunkte rechts neben der Prebuildkonfiguration, die du deaktivieren möchtest.
-
Klicke im Dropdownmenü auf Ausführungen deaktivieren.
-
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.
-
Klicke auf der Codespaces-Seite deiner Repositoryeinstellungen auf die Auslassungspunkte rechts neben der Prebuildkonfiguration, die du löschen möchtest.
-
Klicke im Dropdownmenü auf Löschen.
-
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.
-
Klicke auf der Codespaces-Seite deiner Repositoryeinstellungen auf die Auslassungspunkte rechts neben der Prebuildkonfiguration, deren Workflows du auslösen möchtest.
-
Klicke im Dropdownmenü auf Manuell auslösen.