Hurtig start: Brug Salesforce CLI med DevOps Center

Opsæt en pipeline

Opret en pipeline, tilføj og konfigurer dens faser, aktiver pipelinen, og vedhæft dit projekt.

1. Angiv dine projekter for at finde projekt-id'et.

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

   Kopier id'et for det projekt, du vil vedhæfte til pipelinen. Eksemplerne i denne hurtige start bruger 0Hn000000000001.

2. Opret en inaktiv pipeline, og tilslut den til dit lager.

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

   Kopier pipeline-id'et fra kommandooutputtet. Eksemplerne i denne hurtige start bruger 0XB000000000001.

   Pipelinen forbliver inaktiv, indtil du konfigurerer dens faser og aktiverer den.

   Hvis du vil oprette et lager, mens du opretter pipelinen, skal du bruge --create-repo med --repo-type github|bitbucket.

3. Føj faser til din pipeline. En ny pipeline inkluderer en standardslutfase. Tilføj hver ny fase før en eksisterende fase ved at angive den eksisterende fase med --next-stage-id.

   Tilføj f.eks. en integrationsfase.

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

   Kopier fase-id'et fra kommandooutputtet. I de resterende eksempler anvendes 0Xc000000000005 til integrationsfasen. Gentag kommandoen for hver yderligere fase, f.eks. UAT.

   

   Tip Få vist din pipeline i DevOps Center for at hente fase-id'erne for efterfølgende kommandoer. Eller kør sf devops pipeline get --pipeline-id 0XB000000000001.
4. Konfigurer hver fase. Hver fase kræver en forgrening og et miljø. Konfigurer faser fra højre mod venstre, da den endelige fase skal have en forgrening, før du kan konfigurere faserne før den.

   Føj en forgrening til fasen Integration. --create-vcs-branch opretter forgreningen i lageret, hvis den ikke findes.

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

   Føj et sandbox-miljø til fasen.

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

   Der åbnes et browservindue, så du kan godkende til miljøet. Brug --org-type Production til produktionsorganisationer. I et headless-miljø skal du tilføje --no-browser og følge de godkendelsesinstruktioner, der returneres af kommandoen.

   Gentag forgrening og miljøkommandoer for hver fase. Brug forgreningsnavn, miljønavn og organisationstype, der er relevant for hver fase.

5. Aktiver pipelinen.
   

   Vigtigt Du kan ikke redigere pipelinefasen, når du har promoveret ændringer gennem den. Sørg for, at alle faser er konfigureret korrekt, før du kører denne kommando.

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

6. Vedhæft dit DevOps Center til pipelinen.

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

   Pipelinen er klar. Opret arbejdselementer i DevOps Center-brugergrænsefladen, eller kør sf devops work-item create-kommandoen.

Administrer et arbejdselement

Fuldfør en udviklingscyklus ved at starte et arbejdselement, bekræfte dine ændringer, oprette en gennemgang og markere arbejdselementet, der er klar til promovering.

1. Indstil arbejdselementets status til I gang. DevOps Center opretter en funktionsforgrening for arbejdselementet.

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

2. Hent funktionsforgreningen fra det tilsluttede lager, og se det i dit lokale projekt.

   git fetch origin
   git checkout WI-000042

3. Hent ændringer fra din udviklingsorganisation. Dette eksempel henter en Apex-klasse fra organisationen med alias my-sandbox.

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

4. Gennemse de hentede filer, fase dem, bekræft dem og overfør funktionsforgreningen.

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

   Juster stien, der er videregivet til git add, hvis dit Salesforce DX-projekt bruger en anden pakkemappe.

5. Opret en ændringsanmodning (pull-anmodning) for at flette funktionsforgreningen i målforgreningen.

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

6. Vent på, at dit team godkender og fletter ændringsanmodningen.
7. Opdater arbejdselementets status til at angive, at den er klar til promovering.

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

Promover et arbejdselement

Forfrem arbejdselementet til næste pipelinefase. DevOps Center validerer promoveringen, kører de testsuiter, der er konfigureret for målfasen og implementerer ændringerne, hvis testene passerer.

1. Promover arbejdselementet ved brug af arbejdselement-id'et og målfasens id.

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

   Kommandooutputtet inkluderer et anmodnings-id. Brug det til at kontrollere promoveringsstatus.

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

2. Brug anmodnings-id'et til at kontrollere promoveringsstatussen.

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

Almindelige opgaver

Brug disse kommandoer under dit daglige udviklingsarbejdsflow.

1. Forfrem flere arbejdselementer til den samme fase. Angiv --work-item-id en gang for hvert arbejdselement.

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

2. Implementer eksternt flettede ændringer i en fase, der ikke er synkroniseret med DevOps Center.

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

Avancerede anvendelsessituationer

Når du har fuldført basisarbejdsflowet, skal du bruge disse kommandoer til kampagner, der kræver mere kontrol.