Lokale IDE verbinden

Verbinde die bevorzugte lokale Entwicklungsumgebung mit Codesphere Workspaces, um mit cloudbasierten Ressourcen und den gewohnten Tools zu arbeiten. Codesphere unterstützt mehrere Workflows: Git-basierte Synchronisation, die VS Code-Erweiterung für Echtzeit-Remote-Verbindungen und SSH-Verbindungen für jeden SSH-fähigen Editor (einschließlich JetBrains IDEs, Vim, Emacs und weitere).

Git-basierter Workflow (am einfachsten)​

Der gängigste und oft bevorzugte Ansatz besteht darin, wie gewohnt lokal zu arbeiten und Git als Synchronisationsmechanismus zu nutzen. Diese Methode ermöglicht die Verwendung jeder beliebigen IDE oder jedes Editors auf dem lokalen Rechner ohne besondere Konfiguration.

So funktioniert es:

1. Repository klonen und lokal mit der bevorzugten IDE arbeiten (VS Code, IntelliJ, vim usw.)
2. Änderungen vornehmen, committen und in das Git-Repository pushen
3. Codesphere synchronisiert Änderungen automatisch bei jedem Commit, sofern Git-Automatisierungen konfiguriert sind oder eine CLI-Automatisierung eingerichtet wurde
4. Der Codesphere Workspace wird automatisch aktualisiert und löst je nach Konfiguration Builds und Deployments aus

Dieser Workflow ist ideal für Teams, die ihre bestehenden Entwicklungspraktiken beibehalten möchten und gleichzeitig die Infrastruktur der Plattform für Builds, Tests und Deployments nutzen wollen. Keine besonderen Plugins oder Verbindungen erforderlich – einfach der gewohnte Git-Workflow.

VS Code-Erweiterung​

Die Codesphere VS Code-Erweiterung nutzt die Tunnel-Funktionalität von Microsoft, um eine sichere Verbindung zwischen dem lokalen VS Code und Codesphere Workspaces herzustellen und Codeänderungen sofort zu synchronisieren.

Einrichtung:​

1. Installiere die Erweiterung aus dem VS Code Marketplace oder suche in der Erweiterungsansicht von VS Code nach „Codesphere"
2. Klicke auf das Codesphere-Symbol in der Activity Bar und melde dich an
3. Wähle den Workspace aus und klicke auf Create Tunnel
4. Authentifiziere dich bei GitHub, indem du den Code in die Browseraufforderung kopierst
5. Nach Abschluss der Einrichtung auf Connect klicken und die GitHub-Authentifizierung auswählen

VS Code wird neu geladen und mit dem Workspace verbunden. Greife direkt aus der lokalen IDE auf das Codesphere-Terminal zu, löse CI-Pipelines aus und nutze die Git-Integration. Alle Tunnel-Verbindungen sind im Tab Remote Explorer einsehbar.

SSH-Client-Verbindungen​

Bei Cluster-Konfigurationen, die direkten Netzwerkzugriff erlauben, kann eine Verbindung über SSH-basierte Ansätze hergestellt werden. Diese Methode funktioniert mit JetBrains IDEs (IntelliJ IDEA, PyCharm, WebStorm usw.) und jedem anderen Editor, der SSH-Remote-Entwicklung unterstützt.

Voraussetzungen​

• Direkter IP-Zugriff muss in der Codesphere Cluster-Konfiguration aktiviert sein
• SSH-Client installiert und innerhalb des Workspace konfiguriert (z. B. nix-env -iA nixpkgs.openssh_hpn & konfigurierte Schlüssel)

Verbindung über SSH​

1. Verbindungsdetails ermitteln: IP-Adresse und SSH-Zugangsdaten für den Workspace beschaffen
2. IDE konfigurieren:
   • Für JetBrains IDEs: JetBrains Gateway oder die Funktion Remote Development nutzen, um sich per SSH zu verbinden
   • Für andere Editoren: SSH-Remote-Entwicklung anhand der Dokumentation des jeweiligen Editors konfigurieren
3. Verbindung herstellen: Mit der angegebenen IP-Adresse und den Zugangsdaten verbinden
4. Remote-Pfad festlegen: Das lokale Projektverzeichnis dem Workspace-Pfad zuordnen