Ein GitHub-Repository für Ihre Salesforce-Instanz einzurichten und es mit Visual Studio Code (VSC) zu nutzen, kann Ihren Entwicklungsprozess als Salesforce-Berater erheblich verbessern. Versionskontrolle ist ein Muss, um Änderungen nachzuverfolgen und die Zusammenarbeit im Team zu erleichtern. In diesem Artikel zeige ich Ihnen Schritt für Schritt, wie Sie ein Repository erstellen, den Master-Branch initialisieren und es in VSC integrieren – praxisnah und direkt umsetzbar.
Die Versionskontrolle mit GitHub löst typische Probleme wie: Wie halte ich den Überblick über Änderungen? Wie vermeide ich Konflikte im Team? Welche Tools brauche ich wirklich? Ich gehe auf diese Fragen ein und liefere Ihnen Lösungen, die Sie sofort anwenden können.
Ein gutes Setup spart Zeit und Nerven – das weiß jeder, der schon einmal Änderungen an Apex-Klassen oder Lightning-Komponenten manuell synchronisieren musste.
Die beste Art, die Zukunft vorherzusagen, ist, sie zu gestalten.
– Peter Drucke
Neues Repository erstellen
Gehen Sie auf github.com und melden Sie sich an. Klicken Sie oben rechts auf das Plus-Symbol und wählen Sie Neues Repository. Geben Sie einen Namen wie salesforce-projekt ein und stellen Sie es auf privat – das schützt Ihre sensiblen Daten. Nach dem Erstellen erhalten Sie eine URL, die Sie gleich brauchen.
Repository lokal klonen
Öffnen Sie Ihr Terminal – auf Windows die Eingabeaufforderung oder PowerShell, auf Mac/Linux das Terminal – und geben Sie ein: git clone https://github.com/IhrBenutzername/salesforce-projekt.git. Ersetzen Sie IhrBenutzername durch Ihren GitHub-Namen. Damit laden Sie das Repository auf Ihren Rechner. Wechseln Sie mit cd salesforce-projekt in den Ordner.
Salesforce CLI vorbereiten
Salesforce Developer Experience, kurz Salesforce DX, ist das moderne Framework für Entwickler. Laden Sie die Salesforce Command Line Interface (CLI) von der offiziellen Seite herunter: Salesforce CLI Download. Installieren Sie sie gemäß den Anweisungen für Ihr Betriebssystem.
Erstellen Sie ein neues Projekt mit: sfdx force:project:create -n MeinProjekt. Ersetzen Sie MeinProjekt durch einen Namen Ihrer Wahl. Das Kommando generiert eine Projektstruktur mit Ordnern wie force-app, die Sie später nutzen.
Authentifizierung mit Ihrer Salesforce-Instanz
Verbinden Sie Ihr Projekt mit Ihrer Salesforce-Organisation. Geben Sie im Terminal ein: sfdx force:auth:login -u [email protected]. Nutzen Sie hier Ihre echten Zugangsdaten. Nach erfolgreicher Anmeldung ist Ihr lokales Setup mit der Cloud verknüpft.
sfdx force:alias:set [email protected], um später schneller zu arbeiten.Package.xml erstellen
Metadaten sind das Herzstück Ihrer Salesforce-Konfiguration – Apex-Klassen, Trigger oder Lightning-Komponenten. Erstellen Sie im Projektstammverzeichnis eine Datei namens package.xml. Ein einfaches Beispiel:
<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
<types>
<members>*</members>
<name>ApexClass</name>
</types>
<types>
<members>*</members>
<name>ApexTrigger</name>
</types>
<version>58.0</version>
</Package> Dieses Beispiel ruft alle Apex-Klassen und Trigger ab. Passen Sie es an Ihre Bedürfnisse an – eine detaillierte Anleitung finden Sie im Trailhead-Modul Metadaten lokal entwickeln.
Metadaten abrufen
Führen Sie im Terminal aus: sfdx force:source:retrieve -x package.xml. Das Kommando lädt die angegebenen Metadaten in den Ordner force-app/main/default. Überprüfen Sie den Inhalt, um sicherzustellen, dass alles korrekt übernommen wurde.
sfdx force:org:display sehen Sie den Status.Lokale Änderungen speichern
Nach dem Abruf der Metadaten müssen Sie diese in GitHub sichern. Geben Sie im Terminal ein: git add ., um alle Änderungen zu stagen, gefolgt von git commit -m "Initialer Commit der Salesforce-Metadaten", um sie zu committen. Pushen Sie sie mit git push origin main auf GitHub. Beachten Sie: Ältere Repositories nutzen oft master statt main – prüfen Sie dies im GitHub-Interface.
Ein hilfreicher Artikel dazu ist Salesforce Ben: Git für Salesforce einführen. Er erklärt, wie Sie den Übergang zu Git-basierten Workflows meistern.
git pull und git merge, um diese zu lösen. Ein weiterer Tipp: Commiten Sie oft und mit präzisen Nachrichten – das erleichtert das Nachvollziehen später.VSC einrichten
Laden Sie Visual Studio Code von code.visualstudio.com herunter, falls nicht vorhanden. Alternativ empfehle ich VSCodium, das ohne die Microsoft-Tracker daherkommt. Installieren Sie die Salesforce Extension Pack und GitLens über den Marketplace: Erweiterungen > Salesforce Extension Pack suchen. Öffnen Sie Ihr Projekt mit Datei > Ordner öffnen und wählen Sie den geklonten Ordner.
Arbeiten mit Git in VSC
Nutzen Sie die Quellcodeverwaltung (Cmd+Shift+G), um Änderungen zu committen. Klicken Sie auf das Häkchen für einen Commit, geben Sie eine Nachricht ein und drücken Sie das Synchronisationssymbol, um zu pushen oder zu pullen. Details dazu finden Sie bei SFDC Stop: VSC mit GitHub verbinden.
Datei > Automatisches Speichern, um versehentliche Datenverluste zu vermeiden.Branching-Strategien einführen
Nutzen Sie Feature-Branches für neue Entwicklungen (git checkout -b feature/neue-funktion) und Release-Branches für Deployments. Pull Requests fördern Code-Reviews und Qualität – ein Ansatz, den dieser LinkedIn-Post empfiehlt.
Automatisierung nutzen
GitHub Actions kann Tests oder Deployments automatisieren. Ein Beispiel dafür bietet Mirketa: Automatisierung mit GitHub Actions. Starten Sie mit einfachen Workflows und skalieren Sie nach Bedarf.
Einstellungen > Mitarbeiter im Repository, um Rollen zu definieren.Häufige Fragen
Muss ich Git-Kenntnisse haben, um Salesforce mit GitHub zu nutzen?
Grundlegende Git-Kenntnisse wie Commit, Push und Branch sind notwendig. Die Salesforce CLI und VS Code erleichtern die Arbeit erheblich, aber das Konzept der Versionskontrolle sollten Sie verstehen.
Was ist der Unterschied zwischen einem Change Set und einem SFDX-basierten Deployment über GitHub?
Change Sets sind einfacher zu bedienen, aber wenig flexibel und kaum automatisierbar. SFDX mit GitHub ermöglicht vollständige CI/CD-Pipelines, Code-Reviews und nachvollziehbare Deployment-Historien.
Kann ich Salesforce-Metadaten für alle Komponenten per GitHub deployen?
Die meisten Metadatentypen lassen sich per SFDX deployen, aber nicht alle. Bestimmte Konfigurationen wie bestimmte Standard-Felder oder Organization-weite Einstellungen sind ausgenommen.
Wie sichere ich mein GitHub-Repository gegen ungewollte Änderungen an der Production-Org?
Branch-Protection-Rules für den Main-Branch und ein Review-Prozess per Pull Request sind der Standard. Kombiniert mit einer CI/CD-Pipeline, die erst Tests in einer Sandbox durchführt, ist die Production gut geschützt.
Ihre nächsten Schritte im Überblick
| Step | Description | Command/Example |
|---|---|---|
| Clone Repository | Clone to local machine | git clone https://github.com/YourUsername/repo.git |
| Initialize Salesforce DX Project | Create new project with Salesforce CLI | sfdx force:project:create -n ProjectName |
| Authenticate with Salesforce Org | Connect to your Salesforce instance | sfdx force:auth:login -u [email protected] |
| Retrieve Metadata | Pull metadata using package.xml | sfdx force:source:retrieve -x package.xml |
| Stage and Commit Changes | Prepare and commit changes to local repository | git add .; git commit -m "Message" |
| Push to GitHub | Upload changes to remote repository | git push origin main (or 'master' for older repos) |
Ein GitHub-Repository für Ihre Salesforce-Instanz aufzusetzen, den Master-Branch zu initialisieren und es in VSC zu nutzen, ist machbar, wenn Sie diese Schritte befolgen. Sie profitieren von besserer Übersicht, Teamarbeit ohne Kopfzerbrechen und einem modernen Workflow.
Die wichtigsten Todos: Repository erstellen, Salesforce DX einrichten, Metadaten abrufen, committen und VSC optimal nutzen. Mit diesen Strategien vermeiden Sie typische Fallstricke und heben Ihre Projekte auf ein neues Level. Zu guter Letzt noch eine Übersicht der genutzten VSC und Git Befehle:
