Skip to main content

Erstellen eines Codespaces für ein Repository

Du kannst einen Codespace für einen Branch in einem Repository erstellen, um online entwickeln zu können.

Note

GitHub Codespaces ist nicht in Subdomänen von GHE.com verfügbar, z. B. in octocorp.ghe.com.

Informationen zum Erstellen eines Codespaces für ein Repository

Sie können einen Codespace auf GitHub, in Visual Studio Code oder mit der GitHub CLI erstellen. Verwende die Registerkarten in diesem Artikel, um Anweisungen für jede dieser Möglichkeiten zum Erstellen eines Codespaces anzuzeigen.

Sie können GitHub Codespaces für Ihr persönliches GitHub-Konto verwenden, wobei das Kontingent der kostenlosen Nutzung jeden Monat für Konten im Free- und Pro-Tarif enthalten ist. Du kannst GitHub Codespaces über deine monatlich enthaltene Speicher- und Computenutzung hinaus weiterhin verwenden, indem du Zahlungsdetails angibst und ein Ausgabenlimit festlegst. Weitere Informationen findest du unter Informationen zur Abrechnung für GitHub Codespaces.

Organisationen können Mitgliedern und externen Mitarbeitern das Erstellen und Verwenden von Codespaces auf Kosten der Organisation ermöglichen. Weitere Informationen finden Sie unter Auswählen der Besitzerinnen und Zahlerinnen von Codespaces in deiner Organisation.

Die Möglichkeit zum Erstellen von Codespaces aus organisationseigenen Repositorys hängt von mehreren Faktoren ab, unter anderem von der Sichtbarkeit des Repositorys und den Einstellungen der Organisation oder ihres übergeordneten Unternehmens. Weitere Informationen finden Sie unter Problembehandlung beim Erstellen und Löschen von Codespaces.

Note

Wenn du über verwaltetes Benutzerkonto verfügst, kannst du nur dann Codespaces für deine persönlichen Repositorys erstellen, wenn das Repository ein Fork eines organisationseigenen Repositorys ist und du GitHub Codespaces auf Kosten der Organisation verwenden darfst. Weitere Informationen finden Sie unter Informationen zu Enterprise Managed Users.

Wenn du ein neues Projekt startest, kannst du einen Codespace über eine Vorlage erstellen und später in einem Repository in GitHub veröffentlichen. Weitere Informationen findest du unter Erstellen eines Codespaces aus einer Vorlage.

Wenn du einen Codespace aus einem Repository erstellst, wird der Codespace einem bestimmten Branch zugeordnet, der nicht leer sein kann. Du kannst pro Repository oder sogar pro Branch mehr als einen Codespace erstellen.

Du kannst alle verfügbaren Codespaces anzeigen, die du unter github.com/codespaces erstellt hast. Zum Anzeigen dieser Seite wählen Sie in der oberen linken Ecke von GitHub aus und klicken dann auf Codespaces. Dadurch gelangst du zu github.com/codespaces.

Der Codespace-Erstellungsprozess

Wenn du einen Codespace erstellst, erfolgt eine Reihe von Schritten zum Erstellen und Herstellen einer Verbindung mit deiner Entwicklungsumgebung:

  • Schritt 1: VM und Speicher werden deinem Codespace zugewiesen.
  • Schritt 2: Der Container wird erstellt, und dein Repository wird geklont.
  • Schritt 3: Du kannst eine Verbindung mit dem Codespace herstellen.
  • Schritt 4: Der Codespace wird mit dem Setup nach der Erstellung fortgesetzt.

Weitere Informationen dazu, was geschieht, wenn du einen Codespace erstellst, findest du unter Ausführliche Informationen zu GitHub Codespaces.

Weitere Informationen zum Lebenszyklus eines Codespaces findest du unter Grundlegendes zum Codespacelebenszyklus.

Wenn du Git-Hooks für deinen Codespace verwenden möchtest, solltest du die Hooks mithilfe der devcontainer.json-Lebenszyklusskripts einrichten, z. B. postCreateCommand. Diese werden in Schritt 4 oben ausgeführt. Informationen zu Lebenszyklusskripts findest du in der Spezifikation von Entwicklungscontainern auf der Website zu Entwicklungscontainern. Da der Dev-Container für Ihren Codespace erstellt wird, nachdem das Repository geklont wurde, gelten alle im Dev-Containerimage konfigurierten Git-Vorlagenverzeichnisse nicht für Ihren Codespace. Hooks müssen stattdessen installiert werden, nachdem der Codespace erstellt wurde.

Während der Entwicklung in einem Codespace mit VS Code kannst du Code bearbeiten, debuggen und Git-Befehle verwenden. Weitere Informationen findest du in der VS Code documentation.

Um die Erstellung von Codespaces zu beschleunigen, können Repositoryadministrator*innen GitHub Codespaces-Prebuilds für ein Repository aktivieren. Weitere Informationen finden Sie unter Weitere Informationen zu GitHub Codespaces-Prebuilds.

Erstellen eines Codespaces für ein Repository

Note

Weitere Informationen zur GitHub CLI findest du unter Informationen zur GitHub CLI.

Verwende zum Erstellen eines neuen Codespaces den Unterbefehl gh codespace create.

gh codespace create

Du wirst aufgefordert, ein Repository auszuwählen. In einer Meldung wirst du darüber informiert, wer für den Codespace bezahlt. Du wirst dann aufgefordert, einen Branch, eine Entwicklungscontainer-Konfigurationsdatei (sofern mehrere vorhanden sind) und einen Computertyp (sofern mehrere vorhanden sind) auszuwählen.

Alternativ kannst du Flags verwenden, um einige oder alle Optionen anzugeben:

gh codespace create -r OWNER/REPO -b BRANCH --devcontainer-path PATH -m MACHINE-TYPE

In diesem Beispiel ersetze owner/repo durch den Repositorybezeichner. Ersetze branch durch den Namen des Branch oder den vollständigen SHA-Hash des Commits, den du zunächst im Codespace auschecken möchtest. Wenn du das -r-Flag ohne das b-Flag verwendest, wird der Codespace aus dem Standardbranch erstellt.

Ersetze path durch den Pfad zur Dev-Containerkonfigurationsdatei, die du für den neuen Codespace verwenden möchtest. Wenn du dieses Flag auslässt und mehrere Dev-Containerdateien verfügbar sind, wirst du aufgefordert, eine davon in einer Liste auszuwählen. Weitere Informationen zur Konfigurationsdatei für den Entwicklungscontainer findest du unter Einführung in Entwicklungscontainer.

Ersetze machine-type durch einen gültigen Bezeichner für einen verfügbaren Computertyp. Bezeichner sind Zeichenfolgen wie basicLinux32gb und standardLinux32gb. Der Typ der verfügbaren Computer hängt vom Repository, deinem persönlichen Konto und deinem Standort ab. Wenn du einen ungültigen oder nicht verfügbaren Computertyp eingibst, werden die verfügbaren Typen in der Fehlermeldung angezeigt. Wenn du dieses Flag auslässt und mehrere Computertypen verfügbar sind, wirst du aufgefordert, einen Typ aus einer Liste auszuwählen.

Ausführliche Informationen zu den Optionen für diesen Befehl findest du im GitHub CLI-Handbuch.

Weiterführende Themen