Quick Start: Salesforce CLI gebruiken met DevOps Center

Een pijplijn instellen

Maak een pijplijn, voeg de fasen ervan toe en configureer deze, activeer de pijplijn en voeg uw project bij.

1. Vermeld uw projecten om de project-ID te vinden.

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

   Kopieer de ID van het project dat u aan de pijplijn wilt koppelen. De voorbeelden in deze 0Hn000000000001 voor snelstartgebruik.

2. Maak een inactieve pijplijn en verbind deze met uw opslagplaats.

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

   Kopieer de pijplijn-ID uit de uitvoer van de opdracht. De voorbeelden in deze 0XB000000000001 voor snelstartgebruik.

   De pijplijn blijft inactief totdat u de fasen ervan configureert en deze activeert.

   Gebruik voor het maken van een opslagplaats tijdens het maken van de pijplijn --create-repo met --repo-type github|bitbucket.

3. Voeg fasen toe aan uw pijplijn. Een nieuwe pijplijn omvat een standaard eindfase. Voeg elke nieuwe fase vóór een bestaande fase toe door die bestaande fase op te geven met --next-stage-id.

   Voeg bijvoorbeeld een integratiefase toe.

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

   Kopieer de fase-ID uit de uitvoer van de opdracht. De resterende voorbeelden gebruiken 0Xc000000000005 voor de integratiefase. Herhaal de opdracht voor elke extra fase, zoals UAT.

   

   Tip Bekijk uw pijplijn in de UI van DevOps Center om de fase-ID's voor volgende opdrachten op te halen. Of voer sf devops pipeline get --pipeline-id 0XB000000000001 uit.
4. Configureer elke fase. Elke fase vereist een vertakking en een omgeving. Configureer fasen van rechts naar links, omdat de laatste fase een vertakking moet hebben voordat u de fasen ervoor kunt configureren.

   Voeg een vertakking toe aan de integratiefase. De --create-vcs-branch vlag maakt de vertakking in de repository als deze niet bestaat.

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

   Voeg een sandboxomgeving toe aan de fase.

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

   Er wordt een browservenster geopend waarin u zich kunt verifiëren bij de omgeving. Gebruik --org-type Production voor productieorganisaties. Voeg in een headless omgeving --no-browser toe en volg de authenticatie-instructies die door de opdracht worden geretourneerd.

   Herhaal de vertakkings- en omgevingsopdrachten voor elke fase. Gebruik de filiaalnaam, de omgevingsnaam en het organisatietype die geschikt zijn voor elke fase.

5. Activeer de pijplijn.
   

   Belangrijk U kunt de pijplijnfase niet wijzigen nadat u wijzigingen hebt doorgevoerd. Zorg ervoor dat alle fasen correct zijn geconfigureerd voordat u deze opdracht uitvoert.

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

6. Koppel uw DevOps Center project aan de pijplijn.

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

   De pijplijn is gereed. Maak werkitems in de DevOps Center UI of voer de opdracht sf devops work-item create uit.

Een werkitem beheren

Voltooi een ontwikkelingscyclus door een werkitem te starten, uw wijzigingen door te voeren, een beoordeling te maken en het werkitem als gereed voor doorzetten te markeren.

1. Stel de status van het werkitem in op In behandeling. DevOps Center maakt een functievertakking voor het werkitem.

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

2. Haal de functievertakking op uit de verbonden opslagplaats en bekijk deze in uw lokale project.

   git fetch origin
   git checkout WI-000042

3. Wijzigingen ophalen uit uw ontwikkelingsorganisatie. Dit voorbeeld haalt een Apex klasse op uit de organisatie met de alias my-sandbox.

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

4. Controleer de opgehaalde bestanden, faseer ze, commit ze en push de functievertakking.

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

   Pas het pad aan dat wordt doorgegeven aan git add als uw Salesforce DX project een andere pakketdirectory gebruikt.

5. Maak een veranderingsverzoek (pullverzoek) om de functievertakking samen te voegen met de doelvertakking.

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

6. Wacht tot uw team het veranderingsverzoek heeft goedgekeurd en samengevoegd.
7. Werk de status van het werkitem bij om aan te geven dat het gereed is voor doorzetten.

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

Een werkitem doorzetten

Het werkitem doorzetten naar de volgende pijplijnfase. DevOps Center valideert de speciale actie, voert de testreeksen uit die zijn geconfigureerd voor de doelfase en implementeert de wijzigingen als de tests slagen.

1. Promoot het werkitem met behulp van de werkitem-ID en de doelfase-ID.

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

   De opdrachtuitvoer omvat een verzoek-ID. Gebruik deze om de status van de speciale actie te controleren.

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

2. Gebruik de aanvraag-ID om de status van de speciale actie te controleren.

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

Veel voorkomende taken

Gebruik deze opdrachten tijdens uw dagelijkse ontwikkelwerkstroom.

1. Meerdere werkitems doorzetten naar dezelfde fase. Geef --work-item-id eenmaal op voor elk werkitem.

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

2. Implementeer extern samengevoegde wijzigingen in een fase die niet meer synchroon loopt met DevOps Center.

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

Geavanceerde gebruikscases

Nadat u de basiswerkstroom hebt voltooid, gebruikt u deze opdrachten voor speciale acties die meer controle vereisen.