DevOps CLI in VS Code verwenden

Bekannte Probleme: Erforderliches Update

Ein Update ist erforderlich. Die aktuelle Version von Flosum DevOps erfordert die neuesten Versionen der Flosum CLI (@flosum/cli Paket) und der Flosum DevOps-CLI-Erweiterung. Frühere CLI-Versionen unterstützen keine Topologien und können nicht mit einem DevOps-Tenant arbeiten, der sie verwendet, daher müssen vorhandene Installationen aktualisiert werden.

Node.js 22 ist erforderlich. Bei Node.js 24, scheinen die Installations- und Aktualisierungsbefehle zwar erfolgreich zu sein, belassen Sie jedoch auf einer früheren Version. Wechseln Sie vor der Installation oder Aktualisierung zu Node.js 22.

Kompatibilität mit Betriebssystemen

Flosum CLI und Flosum DevOps-CLI-Erweiterung sind mit den folgenden Betriebssystemen kompatibel:

• macOS
• Linux

Diese Tools sind derzeit nicht für die Verwendung mit Windows vorgesehen.

Überblick

Dieser Artikel zeigt Ihnen, wie Sie die DevOps-CLI-Erweiterung in Visual Studio Code (VS Code) verwenden, um auf die verfügbaren Befehle zuzugreifen. Die folgenden Abschnitte erläutern jeden Befehl und geben Anweisungen zu seiner Verwendung. Die verfügbaren Befehle hängen davon ab, ob in VS Code derzeit ein DevOps-Projekt geöffnet ist: Einige funktionieren nur innerhalb eines DevOps-Projekts, während andere zum Erstellen eines solchen verwendet werden. Die Befehle sind in die folgenden Abschnitte unterteilt:

• Befehle [Kein offenes DevOps-Projekt]
• Befehle [Offenes DevOps-Projekt]

Bewährte Vorgehensweisen

• Verwenden Sie eindeutige Aliase für DevOps-Tenant-Anmeldedaten, z. B. prod-admin, sandbox-dev, oder customer-xyz, um das Wechseln zu erleichtern.
• Wenn möglich, verwenden Sie den Clone Devops Project Befehl beim Starten eines Projekts, da er die Projektanmeldedaten automatisch konfiguriert.
• Führen Sie Pull Branch vor dem Commit aus, um zu vermeiden, dass veraltete Änderungen gepusht werden.
• Verwenden Sie View Pending Changes vor dem Commit aus, um genau zu überprüfen, was gepusht wird.
• Wenn DevOps-Befehle nicht mehr funktionieren, vergewissern Sie sich, dass für Ihr Projekt noch die richtigen Anmeldedaten zum Herstellen einer Verbindung mit Ihrem DevOps-Tenant festgelegt sind. Führen Sie bei Bedarf den Login Befehl erneut aus.

Zugriff auf die Flosum Command Palette

Flosum-Befehlspalette

Um auf die Flosum-Befehlspalette, stellen Sie sicher, dass die Statusleiste in VS Code sichtbar ist. Steuern Sie ihre Sichtbarkeit über Ansicht > Darstellung > Statusleiste.

1. Klicken Sie auf den Flosum Starter der Befehls-Palette auf der linken Seite der Statusleiste.

   
2. Die Flosum Command Palette öffnet sich oben im VS-Code-Fenster.
3. Die verfügbaren Befehle unterscheiden sich je nachdem, ob ein DevOps-Projekt geöffnet ist.

   1. Flosum Command Palette ohne offenes DevOps-Projekt.

      
   2. Flosum Command Palette mit offenem DevOps-Projekt.

      

Befehle [Kein offenes DevOps-Projekt]

Befehl	Beschreibung
Login	Dieser Befehl erstellt Anmeldedaten zum Herstellen einer Verbindung mit Ihrem DevOps-Tenant.
Logout	Dieser Befehl löscht die ausgewählten Anmeldedaten aus der DevOps-CLI-Erweiterung.
Init Devops Project	Dieser Befehl initialisiert ein leeres Salesforce-Projekt mit den Systemdateien der Flosum-CLI.
Clone Devops Project	Dieser Befehl initialisiert ein Salesforce-Projekt und klont das main Branch aus Ihrem DevOps-Tenant.

Flosum: Login

Dieser Befehl erstellt Anmeldedaten mit einem API-Token, das in der App Flosum Global Settings generiert wurde. Die Anmeldedaten werden verwendet, um eine Verbindung zu Ihrem DevOps-Tenant herzustellen. Anweisungen zum Erstellen eines API-Tokens finden Sie im folgenden Artikel.

• Ein API-Token erstellen

Stellen Sie sicher, dass Sie Ihren API-Token vor dem Start des Anmeldevorgangs in die Zwischenablage kopieren, da ein Klick außerhalb von VS Code die Befehls-Palette schließt.

Sie können mehrere Anmeldedaten haben. Wenn Sie sich anmelden, werden Sie aufgefordert, einen Alias für die Anmeldedaten einzugeben, damit sie sich von anderen unterscheiden lassen. Der Alias hat keinen Einfluss auf die Authentifizierung, daher wählen Sie am besten einen Namen, der angibt, zu welchem Tenant die Anmeldedaten gehören.

---

Flosum: Logout

Dieser Befehl löscht die ausgewählten Anmeldedaten aus der DevOps-CLI-Erweiterung. Die Anmeldedaten können über den Befehl Login erneut hinzugefügt werden.

---

Flosum: Init Devops Project

Dieser Befehl initialisiert ein leeres Salesforce-Projekt mit den Systemdateien der Flosum-CLI.

Wenn dieses Projekt initialisiert ist, sind keine Anmeldedaten damit verknüpft. Nachdem das Projekt erstellt wurde, führen Sie den Flosum: Login Befehl innerhalb des Projekts aus, um eine Verbindung zum gewünschten DevOps-Tenant herzustellen. Siehe den DevOps CLI in VS Code verwenden Befehl für weitere Details aus.

---

Flosum: Clone Devops Project

Dieser Befehl initialisiert ein Salesforce-Projekt und verwendet die ausgewählten Anmeldedaten, um das main Branch aus Ihrem DevOps-Tenant.

Der DevOps-Tenant, mit dem Sie sich verbinden, wird durch die von Ihnen ausgewählten Anmeldedaten bestimmt. Siehe den DevOps CLI in VS Code verwenden Befehl für weitere Informationen zu den Anmeldedaten und zum Erstellen eines API-Tokens.

---

Befehle [Offenes DevOps-Projekt]

Befehl	Beschreibung
Login [Project Mode]	Dieser Befehl wählt die Anmeldedaten aus, die das geöffnete Projekt zum Herstellen einer Verbindung mit dem DevOps-Tenant verwendet.
Logout [Project Mode]	Dieser Befehl entfernt die für das geöffnete Projekt konfigurierten Anmeldedaten.
Checkout Branch	Dieser Befehl ruft einen Branch aus Ihrem DevOps-Tenant ab und kopiert alle Komponenten in Ihr lokales Projekt.
Pull Branch	Dieser Befehl ruft die neuesten Änderungen aus Ihrem DevOps-Tenant für den aktuellen Branch ab.
View Pending Changes	Dieser Befehl zeigt alle lokalen Änderungen an, die noch nicht an Ihren DevOps-Tenant committet wurden.
Discard Changes	Dieser Befehl verwirft alle lokalen Änderungen, die noch nicht an Ihren DevOps-Tenant committet wurden.
Commit Changes	Dieser Befehl committet alle lokalen Änderungen an Ihren DevOps-Tenant.

Flosum: Login [Project Mode]

Dieser Befehl wählt die Anmeldedaten aus, die das geöffnete Projekt zum Herstellen einer Verbindung mit dem DevOps-Tenant verwendet.

Dieser Befehl kann auch neue Anmeldedaten erstellen, aber die folgenden Anweisungen zeigen nur die Auswahl vorhandener Anmeldedaten. Siehe den Flosum: Login Befehl für Details zum Erstellen neuer Anmeldedaten.

---

Flosum: Logout [Project Mode]

Dieser Befehl entfernt die für das geöffnete Projekt konfigurierten Anmeldedaten. Sie müssen den Flosum: Login [Project Mode] Befehl verwenden, bevor Sie die anderen DevOps-Befehle für dieses Projekt verwenden können.

Dieser Befehl löscht die Anmeldedaten nicht, anders als der Flosum: Logout Befehl, wenn kein Projekt geöffnet ist.

---

Flosum: Checkout Branch

Dieser Befehl ruft einen Branch aus Ihrem DevOps-Tenant ab, kopiert alle Komponenten in Ihr lokales Projekt und setzt den Branch als aktuellen Branch des Projekts.

Dieser Befehl kann auch zum Erstellen eines neuen Branches verwendet werden, der ebenfalls in Ihrem DevOps-Tenant erstellt wird. Die folgenden Anweisungen zeigen Ihnen jedoch nur, wie Sie einen vorhandenen Branch auschecken.

---

Flosum: Pull Branch

Dieser Befehl ruft die neuesten Änderungen aus Ihrem DevOps-Tenant für den aktuellen Branch ab. Wenn Sie nicht übermittelte Änderungen haben, müssen Sie diese committen oder zurücksetzen, bevor Sie von DevOps pullen.

---

Flosum: View Pending Changes

Dieser Befehl zeigt alle lokalen Änderungen an, die noch nicht an Ihren DevOps-Tenant committet wurden.

---

Flosum: Discard Changes

Dieser Befehl macht alle lokalen Änderungen rückgängig, die noch nicht an Ihren DevOps-Tenant committet wurden.

---

Flosum: Commit Changes

Dieser Befehl committet alle lokalen Änderungen an Ihren DevOps-Tenant.

Manuelles Zusammenführen

Die DevOps-CLI-Erweiterung unterstützt das Zusammenführen von Codebasen derzeit nicht, wenn Ihr lokales Projekt sowohl nicht übermittelte Änderungen als auch eine Commit-Historie hat, die hinter dem Remote-DevOps-Branch zurückliegt. In diesem Zustand schlagen sowohl Flosum: Commit Changes und Flosum: Pull Branch fehl.

Um ohne Verlust Ihrer Arbeit mit dem Remote-Branch neu zu synchronisieren:

1. Kopieren Sie die betroffenen Dateien (oder die konkreten Änderungen) an einen Ort außerhalb des Projekts, damit Sie sie nach dem Pull erneut anwenden können.
2. Setzen Sie Ihre lokalen Änderungen mit Flosum: Discard Changeszurück. Dadurch wird das Projekt auf seinen zuletzt festgeschriebenen Zustand zurückgesetzt, damit die Erweiterung sauber pullen kann.
3. Holen Sie die neuesten DevOps-Commits mit Flosum: Pull Branch. Ihr lokales Projekt ist jetzt mit dem Remote-Branch synchronisiert.
4. Wenden Sie Ihre gespeicherten Änderungen auf der aktualisierten Codebasis erneut an und lösen Sie dabei alle Konflikte, die durch überlappende Änderungen entstehen.
5. Committen Sie Ihre Änderungen mit Flosum: Commit Changes um sie wieder in den DevOps-Branch zu pushen.