Schnelleinstieg: Verwenden von Salesforce CLI mit DevOps Center

Einrichten einer Pipeline

Erstellen Sie eine Pipeline, fügen Sie ihre Phasen hinzu und konfigurieren Sie sie, aktivieren Sie die Pipeline und hängen Sie Ihr Projekt an.

1. Listen Sie Ihre Projekte auf, um die Projekt-ID zu finden.

   sf devops project list --target-org my-devops-org

   Kopieren Sie die ID des Projekts, das Sie an die Pipeline anhängen möchten. In den Beispielen in diesem Schnelleinstieg wird 0Hn000000000001 verwendet.

2. Erstellen Sie eine inaktive Pipeline und verbinden Sie sie mit Ihrem Repository.

   sf devops pipeline create --target-org my-devops-org --name "Release Pipeline" --repo https://github.com/myorg/myrepo

   Kopieren Sie die Pipeline-ID aus der Befehlsausgabe. In den Beispielen in diesem Schnelleinstieg wird 0XB000000000001 verwendet.

   Die Pipeline bleibt inaktiv, bis Sie ihre Phasen konfigurieren und aktivieren.

   Verwenden Sie --create-repo with --repo-type github|bitbucket, um beim Erstellen der Pipeline ein Repository zu erstellen.

3. Fügen Sie Ihrer Pipeline Phasen hinzu. Eine neue Pipeline enthält eine standardmäßige Endphase. Fügen Sie jede neue Phase vor einer vorhandenen Phase hinzu, indem Sie diese vorhandene Phase mit --next-stage-id angeben.

   Fügen Sie beispielsweise eine Integrationsphase hinzu.

   sf devops pipeline stage add --target-org my-devops-org --pipeline-id 0XB000000000001 --name "Integration" --next-stage-id 0Xc000000000001

   Kopieren Sie die Phasen-ID aus der Befehlsausgabe. In den übrigen Beispielen werden 0Xc000000000005 für die Integrationsphase verwendet. Wiederholen Sie den Befehl für jede zusätzliche Phase, beispielsweise "UAT".

   

   Tipp Zeigen Sie Ihre Pipeline auf der DevOps Center-Benutzeroberfläche an, um die Phasen-IDs für nachfolgende Befehle abzurufen. Oder führen Sie sf devops pipeline get --pipeline-id 0XB000000000001 aus.
4. Konfigurieren Sie jede Phase. Für jede Phase sind eine Verzweigung und eine Umgebung erforderlich. Konfigurieren Sie Phasen von rechts nach links, da die letzte Phase eine Verzweigung aufweisen muss, bevor Sie die Phasen davor konfigurieren können.

   Fügen Sie der Integrationsphase eine Verzweigung hinzu. Die --create-vcs-branch-Kennzeichnung erstellt die Verzweigung im Repository, sofern sie nicht vorhanden ist.

   sf devops stage branch add --target-org my-devops-org --pipeline-id 0XB000000000001 --stage-id 0Xc000000000005 --branch-name integration --create-vcs-branch

   Fügen Sie der Phase eine Sandbox-Umgebung hinzu.

   sf devops stage environment add --target-org my-devops-org --pipeline-id 0XB000000000001 --stage-id 0Xc000000000005 --environment-name Integration_Org --org-type Sandbox

   Es wird ein Browserfenster geöffnet, in dem Sie sich bei der Umgebung authentifizieren können. Verwenden Sie --org-type Production für Produktionsorganisationen. Fügen Sie in einer Headless-Umgebung --no-browser hinzu und befolgen Sie die durch den Befehl zurückgegebenen Authentifizierungsanweisungen.

   Wiederholen Sie die Verzweigungs- und Umgebungsbefehle für jede Phase. Verwenden Sie den Zweigstellennamen, den Umgebungsnamen und den Organisationstyp, der für jede Phase geeignet ist.

5. Aktivieren Sie die Pipeline.
   

   Wichtig Sie können die Pipeline-Phase nicht mehr ändern, nachdem Sie Änderungen über sie höhergestuft haben. Stellen Sie sicher, dass alle Phasen richtig konfiguriert sind, bevor Sie diesen Befehl ausführen.

   sf devops pipeline update --target-org my-devops-org --pipeline-id 0XB000000000001 --activate

6. Hängen Sie Ihr DevOps Center-Projekt an die Pipeline an.

   sf devops pipeline project add --target-org my-devops-org --pipeline-id 0XB000000000001 --project-id 0Hn000000000001

   Die Pipeline ist bereit. Erstellen Sie Arbeitselemente auf der DevOps Center-Benutzeroberfläche oder führen Sie den Befehl sf devops work-item create aus.

Verwalten eines Arbeitselements

Schließen Sie einen Entwicklungszyklus ab, indem Sie ein Arbeitselement starten, Ihre Änderungen übernehmen, eine Überprüfung erstellen und das Arbeitselement als bereit zur Höherstufung markieren.

1. Legen Sie den Arbeitselementstatus auf Wird ausgeführt fest. DevOps Center erstellt eine Funktionsverzweigung für das Arbeitselement.

   sf devops work-item update --target-org my-devops-org --work-item-name WI-000042 --status "In Progress"

2. Rufen Sie die Funktionsverzweigung aus dem verbundenen Repository ab und überprüfen Sie sie in Ihrem lokalen Projekt.

   git fetch origin
   git checkout WI-000042

3. Rufen Sie Änderungen aus Ihrer Entwicklungsorganisation ab. In diesem Beispiel wird eine Apex-Klasse aus der Organisation mit dem Alias-my-sandbox abgerufen.

   sf project retrieve start --target-org my-sandbox --metadata ApexClass:MyNewClass

4. Überprüfen Sie die abgerufenen Dateien, stellen Sie sie in Szene, übernehmen Sie sie und übertragen Sie die Funktionsverzweigung.

   git status
   git add force-app
   git commit -am "Implement new feature"
   git push origin WI-000042

   Passen Sie den an git add übergebenen Pfad an, wenn Ihr Salesforce DX Projekt ein anderes Paketverzeichnis verwendet.

5. Erstellen Sie eine Änderungsanforderung (Pull-Anforderung), um die Funktionsverzweigung mit der Zielverzweigung zusammenzuführen.

   sf devops review create --target-org my-devops-org --work-item-name WI-000042

6. Warten Sie, bis Ihr Team die Änderungsanforderung genehmigt und zusammenführt.
7. Aktualisieren Sie den Arbeitselementstatus, um anzugeben, dass er für die Höherstufung bereit ist.

   sf devops work-item update --target-org my-devops-org --work-item-name WI-000042 --status "Ready to Promote"

Höherstufen eines Arbeitselements

Befördern Sie das Arbeitselement in die nächste Pipeline-Phase. DevOps Center validiert das Sonderangebot, führt die für die Zielphase konfigurierten Test-Suites aus und stellt die Änderungen bereit, wenn die Tests bestanden wurden.

1. Befördern Sie das Arbeitselement mithilfe der Arbeitselement-ID und der Zielphasen-ID.

   sf devops promote --target-org my-devops-org --work-item-id 0Wx000000000042 --target-stage-id 0Xc000000000002

   Die Befehlsausgabe enthält eine Anforderungs-ID. Verwenden Sie sie, um den Sonderangebotsstatus zu überprüfen.

   Status: Completed
   Message: Work items successfully promoted to UAT.
   Request ID: a0B000000000001
   
   Promoted Work Items
   ───────────────────
   0Wx000000000042

2. Verwenden Sie die Anforderungs-ID, um den Sonderangebotsstatus zu überprüfen.

   sf devops request status --target-org my-devops-org --request-token a0B000000000001

Allgemeine Aufgaben

Verwenden Sie diese Befehle während Ihres täglichen Entwicklungs-Workflows.

1. Befördern Sie mehrere Arbeitselemente in dieselbe Phase. Geben Sie --work-item-id einmal für jedes Arbeitselement an.

   sf devops promote --target-org my-devops-org --work-item-id 0Wx000000000042 --work-item-id 0Wx000000000043 --target-stage-id 0Xc000000000002

2. Stellen Sie extern zusammengeführte Änderungen in einer Phase bereit, die nicht mit DevOps Center synchron ist.

   sf devops promotion complete --target-org my-devops-org --target-stage-id 0Xc000000000002

Erweiterte Anwendungsfälle

Verwenden Sie nach Abschluss des grundlegenden Workflows diese Befehle für Sonderangebote, die mehr Kontrolle erfordern.