Hurtigstart: Bruke Salesforce CLI med DevOps Center

Konfigurere en pipeline

Opprett en pipeline, legg til og konfigurer fasene i den, aktiver pipelinen og legg ved prosjektet.

1. Vise en liste over prosjektene for å finne prosjekt-ID-en.

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

   Kopier ID-en til prosjektet som du vil knytte til pågående arbeid. Eksemplene i denne hurtigstartbrukeren bruker 0Hn000000000001.

2. Opprett en inaktiv pipeline og koble den til oppbevaringsstedet.

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

   Kopier pipelin-IDen fra kommandoutdataene. Eksemplene i denne hurtigstartbrukeren bruker 0XB000000000001.

   Pipelinen forblir inaktiv til du konfigurerer fasene og aktiverer den.

   Hvis du vil opprette et repositorium mens du oppretter pipelinen, bruker du --create-repo med --repo-type github|bitbucket.

3. Legg til faser i pipelinen. En ny pipeline inkluderer en standard sluttfase. Legg til hver nye fase før en eksisterende fase ved å angi den eksisterende fasen med --next-stage-id.

   Legg for eksempel til en integrasjonsfase.

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

   Kopier fase-IDen fra kommandoutdataene. De resterende eksemplene bruker 0Xc000000000005 for integrasjonsfasen. Gjenta kommandoen for hver ekstra fase, for eksempel UAT.

   

   Tips Vis pipelinen i DevOps Center for å hente fase-ID-ene for påfølgende kommandoer. Eller kjør sf devops pipeline get --pipeline-id 0XB000000000001.
4. Konfigurer hver fase. Hver fase krever en forgrening og et miljø. Konfigurer faser fra høyre mot venstre fordi den siste fasen må ha en forgreining før du kan konfigurere fasene før den.

   Legg til en forgreining i integrasjonsfasen. --create-vcs-branch-flagget oppretter grenen i repositoriet hvis den ikke finnes.

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

   Legg til et Sandbox-miljø i fasen.

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

   Et nettleservindu åpnes slik at du kan godkjenne til miljøet. Bruk --org-type Production til produksjonsorganisasjoner. I et hodeløst miljø legger du til --no-browser og følger godkjenningsinstruksjonene som returneres av kommandoen.

   Gjenta gren- og miljøkommandoene for hver fase. Bruk filialenavnet, miljønavnet og organisasjonstypen som er riktig for hver fase.

5. Aktiver pipelinen.
   

   Viktig Du kan ikke endre pipelinefasen etter at du har promotert endringer gjennom den. Forsikre deg om at alle fasene er riktig konfigurert før du kjører denne kommandoen.

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

6. Legg ved DevOps Center under behandling.

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

   Pipelinen er klar. Opprett arbeidselementer i DevOps Center-grensesnittet eller kjør sf devops work-item create-kommandoen.

Behandle et arbeidselement

Fullfør en utviklingssyklus ved å starte et arbeidselement, bekrefte endringene, opprette en gjennomgang og merke arbeidselementet som klart til promotering.

1. Angi arbeidselementstatusen til Pågår. DevOps Center oppretter en funksjonsforgrening for arbeidselementet.

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

2. Hent funksjonsforgreningen fra det tilkoblede oppbevaringsstedet, og sjekk den ut i det lokale prosjektet.

   git fetch origin
   git checkout WI-000042

3. Hent endringer fra utviklingsorganisasjonen. Dette eksemplet henter en Apex-klasse fra organisasjonen med aliaset my-sandbox.

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

4. Se gjennom de hentede filene, oppstill dem, bekreft dem og overfør funksjonsforgreningen.

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

   Juster banen overført til git add hvis Salesforce DX-prosjektet bruker en annen pakkemappe.

5. Opprett en endringsforespørsel (pull-forespørsel) for å flette funksjonsforgreningen til målforgreningen.

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

6. Vent til teamet godkjenner og fletter endringsforespørselen.
7. Oppdater arbeidselementstatusen for å angi at den er klar for promotering.

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

Promotere et arbeidselement

Promoter arbeidselementet til neste pipelinefase. DevOps Center validerer promoteringen, kjører testpakkene som er konfigurert for målfasen, og distribuerer endringene hvis testene passerer.

1. Promoter arbeidselementet med arbeidselement-IDen og målfase-IDen.

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

   Kommandoutdataene inkluderer en Forespørsels-ID. Bruk den til å sjekke promoteringsstatus.

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

2. Bruk forespørsels-IDen til å sjekke promoteringsstatusen.

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

Felles oppgaver

Bruk disse kommandoene i den daglige arbeidsflyten for utvikling.

1. Promoter flere arbeidselementer til samme fase. Angi --work-item-id én gang for hvert arbeidselement.

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

2. Distribuer eksternt flettede endringer til en fase som ikke er synkronisert med DevOps Center.

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

Avanserte brukstilfeller

Når du har fullført den grunnleggende arbeidsflyten, bruker du disse kommandoene til promoteringer som krever mer kontroll.