Salesfuchs Logo Salesfuchs
Erstgespräch buchen

GitHub für Salesforce: Repository einrichten

Einrichten eines GitHub-Repositorys für Salesforce: Praktische Schritte, VSC-Integration und Best Practices für Berater – effizient und klar.

· · 5 min Lesezeit
GitHub für Salesforce: Repository einrichten
Versionskontrolle mit GitHub macht Salesforce-Deployments nachvollziehbar und sicher.

Ich habe Änderungen an Produktiv-Orgs gesehen, die niemand mehr nachvollziehen konnte - weil alles direkt im Setup erledigt wurde, ohne Versionskontrolle, ohne Dokumentation. Mit einem GitHub-Repository für Ihre Salesforce-Entwicklung gehört das der Vergangenheit an. Die Einrichtung dauert weniger als eine Stunde.

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.

💡
Praxistipp: Falls Git nicht installiert ist, laden Sie es von git-scm.com herunter. Die Installation dauert fünf Minuten und ist für alle weiteren Schritte essenziell.

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 ihrname@ihreorg.my.salesforce.com. Nutzen Sie hier Ihre echten Zugangsdaten. Nach erfolgreicher Anmeldung ist Ihr lokales Setup mit der Cloud verknüpft.

💡
Best Practice: Speichern Sie Ihre Zugangsdaten sicher und nutzen Sie Aliase wie sfdx force:alias:set MyOrg=ihrname@ihreorg.my.salesforce.com, 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.

💡
Lösung für ein häufiges Problem: Falls der Abruf fehlschlägt, prüfen Sie Ihre Internetverbindung und ob die Authentifizierung noch aktiv ist. Mit 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.

💡
Häufige Fehler vermeiden: Ein häufiger Stolperstein sind Merge-Konflikte, besonders bei Teamarbeit. Lernen Sie einfache Git-Befehle wie 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

📬
Dieser Artikel gefällt Ihnen? Jeden Dienstag teile ich Praxiswissen zu Salesforce, CRM und Automatisierung. Kostenlos per Newsletter.

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.

CRM-Checkliste für den Mittelstand Kostenlos

7 Punkte, die Sie vor jeder CRM-Entscheidung prüfen sollten. Kompakt, praxisnah, sofort anwendbar.

Kein Spam. Jederzeit abmeldbar.

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.

💡
Praxistipp: Aktivieren Sie die Auto-Save-Funktion in VSC unter 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.

💡
Lösung für Teams: Legen Sie klare Zugriffsrechte in GitHub fest, um Chaos zu vermeiden. Nutzen Sie 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 username@org.com
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)

Sie wollen Git und DevOps in Ihrem Salesforce-Projekt richtig aufsetzen? Ich helfe Ihnen dabei, einen sauberen Git-Workflow zu etablieren, CI/CD-Pipelines einzurichten und Ihr Team auf eine professionelle Deployment-Strategie umzustellen.

Ob erste Schritte mit Salesforce DX oder die Optimierung bestehender Prozesse: Gemeinsam bringen wir Ihre Entwicklungsumgebung auf den Stand, der bei Enterprise-Kunden Standard ist.

Lassen Sie uns Ihren nächsten Salesforce-Schritt planen

Kostenloses Erstgespräch buchen