Problembehandlung beim Erstellen und Löschen von Codespaces

In diesem Artikel findest du Schritte zur Behandlung gängiger Probleme, die beim Erstellen oder Löschen von Codespaces auftreten können, einschließlich Speicher- und Konfigurationsproblemen.

In diesem Artikel

Erstellen von Codespaces

Kein Zugriff zum Erstellen eines Codespace

GitHub Codespaces ist nicht für alle Repositorys verfügbar. Wenn die Optionen zum Erstellen eines Codespaces nicht angezeigt werden, ist GitHub Codespaces für dieses Repository möglicherweise nicht verfügbar.

Wenn auf Ihrem persönlichen Konto noch monatliches Inklusivkontingent für GitHub Codespaces verfügbar ist oder Sie eine Zahlungsmethode und ein Ausgabenlimit eingerichtet haben, können Sie einen Codespace für jedes öffentliche Repository erstellen.

Du kannst auch einen Codespace für jedes private Repository erstellen, auf das du mindestens Lesezugriff hast, sofern dieses private Repository im Besitz eines persönlichen Kontos ist. Wenn ein Repository privat ist und einer Organisation gehört, können Sie abhängig von den Einstellungen der Organisation oder ihres übergeordneten Unternehmens möglicherweise einen Codespace für dieses Repository erstellen.

Wenn du keinen Codespace für ein Repository erstellen kannst, kann dies an einer der folgenden Organisations- oder Unternehmenseinstellungen liegen.

  • Besitzer von Organisationen und Unternehmen können auswählen, welche Benutzer auf GitHub Codespaces in den privaten Repositorys einer Organisation zugreifen können. Weitere Informationen finden Sie unter Aktivieren oder Deaktivieren von GitHub Codespaces für Ihre Organisation.
  • Besitzer von Organisationen und Unternehmen können das Forken für einige oder alle privaten Repositorien einer Organisation deaktivieren. Wenn du nur Lesezugriff auf ein Repository hast und es nicht forken kannst, kannst du keinen Codespace für das Repository erstellen. Weitere Informationen finden Sie unter Die Forking-Richtlinie für deine Organisation verwalten.

Informationen zu weiteren Organisations- und Unternehmenseinstellungen, die sich darauf auswirken können, ob Sie einen Codespace erstellen können, finden Sie unter Aktivieren oder Deaktivieren von GitHub Codespaces für Ihre Organisation.

Weitere Informationen zum enthaltenen Nutzungskontingent für persönliche Konten und zum Festlegen eines Ausgabenlimits finden Sie unter GitHub Codespaces Abrechnung und Einrichten von Budgets zum Kontrollieren der Ausgaben für Produkte mit verbrauchseinheitenbasierter Abrechnung.

Codespace wird beim Erstellen nicht geöffnet.

Du erstellst einen Codespace, aber dieser wird nicht geöffnet:

  1. Versuche, die Seite neu zu laden, falls ein Zwischenspeicherungs- oder Berichtsproblem aufgetreten ist.
  2. Wechseln Sie zu Ihrer GitHub Codespaces Seite: https://github.com/codespaces Und überprüfen Sie, ob dort der neue Codespace aufgeführt ist. Der Prozess hat den Codespace vielleicht erfolgreich erstellt, hat dies jedoch nicht an deinen Browser gemeldet. Wenn der neue Codespace aufgelistet ist, kannst du ihn direkt über diese Seite öffnen.
  3. Versuche erneut, den Codespace für das Repository zu erstellen, um einen vorübergehenden Kommunikationsfehler auszuschließen.

Wenn Sie immer noch keinen Codespace für ein Repository erstellen können, in dem GitHub Codespaces verfügbar ist, Du musst dich ggf. an den Support wenden. Weitere Informationen finden Sie unter Arbeiten mit Unterstützung für GitHub Codespaces.

Fehler beim Erstellen des Codespace

Wenn beim Erstellen eines Codespace ein Fehler auftritt, ist dies wahrscheinlich auf ein temporäres Infrastrukturproblem in der Cloud zurückzuführen, z. B. auf ein Problem beim Bereitstellen eines virtuellen Computers für den Codespace. Ein weniger häufiger Grund für Fehler ist, wenn das Erstellen des Containers länger als eine Stunde dauert. In diesem Fall wird der Build abgebrochen, und für das Erstellen des Codespaces wird ein Fehler ausgegeben.

Hinweis

Ein Codespace, der nicht erfolgreich erstellt wurde, kann nie verwendet werden und sollte gelöscht werden. Weitere Informationen finden Sie unter Einen Codespace löschen.

Wenn du einen Codespace erstellst und dabei ein Fehler auftritt, führe Folgendes durch:

  1. Überprüfen Sie GitHubdie Statusseite auf etwaige aktive Vorfälle.

  2. Wechseln Sie zu Ihrer GitHub Codespaces Seite, löschen Sie den Codespace, und erstellen Sie einen neuen Codespace.

  3. Wenn der Container erstellt wird, sieh dir die Protokolle an, die gestreamt werden, und stelle sicher, dass der Build nicht hängen geblieben ist. Ein Containerbuild, der länger als eine Stunde dauert, wird abgebrochen, was zu einem Fehler bei der Erstellung führt.

    Dieses Szenario tritt häufig auf, wenn ein Skript ausgeführt wird, das zur Benutzereingabe auffordert und auf eine Antwort wartet. Wenn dies der Fall ist, entferne die interaktive Eingabeaufforderung, damit der Build nicht-interaktiv abgeschlossen werden kann.

Hinweis

So zeigen Sie die Protokolle während eines Builds an * Wenn die ersten Schritte des Buildvorgangs im Browser länger als einige Sekunden dauern, wird die Seite „Einrichten Ihres Codespace“ angezeigt. Klicke auf Protokolle anzeigen.

Screenshot der Seite „Einrichten deines Codespace“ in einem Browser. Der Link „Protokolle anzeigen“ ist dunkelorange umrandet.

  • Klicken Sie in der VS Code Desktopanwendung in der angezeigten Popupmeldung "Remoteverbindung einrichten" auf "Codespace erstellen".

    Screenshot einer Popupmeldung in VS Code mit dem Text „Remoteverbindung einrichten: Codespace erstellen“.

    Protokollnachrichten werden im Terminal in VS Code ausgegeben.

  1. Wenn das Erstellen eines Containers sehr lange dauert, solltest du Prebuilds verwenden, um das Erstellen von Codespaces zu beschleunigen. Weitere Informationen finden Sie unter Konfigurieren von Prebuilds.

Löschen von Codespaces

Ein Codespace kann nur wie folgt gelöscht werden:

  • Von der Person, die den Codespace erstellt hat
  • Von einem Organisationsbesitzer, wenn der Codespace im Besitz einer Organisation ist
  • Automatisches Löschen am Ende eines Aufbewahrungszeitraums

Weitere Informationen findest du unter Einen Codespace löschen und Konfigurieren des automatischen Löschens deiner Codespaces.

Containerspeicher

Beim Erstellen eines Codespace verfügt er über eine begrenzte Speichermenge, und im Laufe der Zeit ist es möglicherweise erforderlich, Speicherplatz freizugeben. Führen Sie einen der folgenden Befehle im GitHub Codespaces Terminal aus, um Speicherplatz freizugeben.

  • Entferne mithilfe von sudo apt autoremove Pakete, die nicht mehr verwendet werden.
  • Bereinige den apt-Cache mithilfe von sudo apt clean.
  • Zeigen Sie die zehn größten Dateien im Codespace mit sudo find / -printf '%s %p\n'| sort -nr | head -10 an.
  • Lösche nicht benötigte Dateien, z. B. Buildartefakte und Protokolle.

Einige destruktivere Optionen:

  • Entferne nicht verwendete Docker-Images, Netzwerke und Container mithilfe von docker system prune. (Fügen Sie -a an, wenn Sie alle Images entfernen möchten, und --volumes, wenn Sie alle Volumes entfernen möchten.)
  • Entferne nicht nachverfolgte Dateien aus der Arbeitsstruktur: git clean -i.

Konfiguration

Wenn Änderungen an der Konfiguration deines Entwicklungscontainers zu einem Containerfehler führen, wird der Codespace im Wiederherstellungsmodus ausgeführt, und es wird eine Fehlermeldung angezeigt.

This codespace is currently running in recovery mode due to a container error.

Überprüfe die Erstellungsprotokolle, und aktualisiere nach Bedarf die Entwicklungscontainerkonfiguration. Weitere Informationen finden Sie unter GitHub Codespaces-Protokolle.

Anschließend kannst du versuchen, den Codespace neu zu starten oder den Container neu zu erstellen. Weitere Informationen zum Neuerstellen des Containers finden Sie unter Einführung in Dev-Container.