Snabbstart: Använd Salesforce CLI med DevOps Center

Konfigurera en pipeline

Skapa en pipeline, lägg till och konfigurera dess faser, aktivera pipeline och bifoga ditt projekt.

1. Lista dina projekt för att hitta projekt-ID.

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

   Kopiera ID för projektet som du vill bifoga till pipeline. Exemplen i denna snabbstart använder 0Hn000000000001.

2. Skapa en inaktiv pipeline och anslut den till ditt arkiv.

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

   Kopiera pipeline-ID från kommandoutmatningen. Exemplen i denna snabbstart använder 0XB000000000001.

   Pipeline förblir inaktiv tills du konfigurerar dess faser och aktiverar den.

   För att skapa ett arkiv medan du skapar pipeline, använd --create-repo med --repo-type github|bitbucket.

3. Lägg till faser i din pipeline. En ny pipeline innehåller ett standardslutsteg. Lägg till varje ny fas innan en befintlig fas genom att specificera den befintliga fasen med --next-stage-id.

   Lägg till exempel till en integreringsfas.

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

   Kopiera fas-ID från kommandoutmatningen. De återstående exemplen använder 0Xc000000000005 för integreringsfasen. Upprepa kommandot för varje ytterligare steg, till exempel UAT.

   

   Tips Se din pipeline i DevOps Center användargränssnitt för att få fas-ID:n för efterföljande kommandon. Eller kör sf devops pipeline get --pipeline-id 0XB000000000001.
4. Konfigurera varje fas. Varje fas kräver en gren och en miljö. Konfigurera faser från höger till vänster eftersom det sista steget måste ha en gren innan du kan konfigurera faserna innan det.

   Lägg till en gren i integreringsfasen. Flaggan --create-vcs-branch skapar grenen i arkivet om den inte finns.

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

   Lägg till en sandboxmiljö 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

   Ett webbläsarfönster öppnas så att du kan autentisera till miljön. Använd --org-type Production för produktionsorganisationer. I en sidhuvudlös miljö, lägg till --no-browser och följ autentiseringsinstruktionerna som returneras av kommandot.

   Upprepa kommandona Gren och Miljö för varje steg. Använd det filialnamn, miljönamn och organisationstyp som är lämpliga för varje steg.

5. Aktivera pipeline.
   

   Viktig Det går inte att ändra pipelinesteget efter att du har befordrat ändringar genom det. Se till att alla faser är korrekt konfigurerade innan du kör detta kommando.

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

6. Bifoga ditt DevOps Center projekt till pipeline.

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

   Pipeline är klar. Skapa arbetsobjekt i DevOps Centers användargränssnitt eller kör kommandot sf devops work-item create.

Hantera ett arbetsobjekt

Slutför en utvecklingscykel genom att starta ett arbetsobjekt, utföra dina ändringar, skapa en granskning och markera arbetsobjektet som redo att flyttas upp.

1. Sätt arbetsobjektets status till Pågår. DevOps Center skapar en funktionsgren för arbetsobjektet.

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

2. Hämta funktionsgrenen från det anslutna arkivet och kolla in den i ditt lokala projekt.

   git fetch origin
   git checkout WI-000042

3. Hämta ändringar från din utvecklingsorganisation. Detta exempel hämtar en Apex klass från organisationen med aliaset my-sandbox.

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

4. Granska de hämtade filerna, fasa dem, överlämna dem och pusha funktionsgrenen.

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

   Justera sökvägen som skickas till git add om ditt Salesforce DX projekt använder en annan paketkatalog.

5. Skapa en ändringsbegäran (hämtningsbegäran) för att koppla funktionsgrenen till målgrenen.

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

6. Vänta tills ditt team har godkänt och kopplat ändringsbegäran.
7. Uppdatera arbetsobjektets status för att indikera att det är redo för uppflyttning.

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

Flytta upp ett arbetsobjekt

Flytta upp arbetsobjektet till nästa pipelinesteg. DevOps Center validerar uppflyttningen, kör testsviterna som konfigurerats för målsteget och distribuerar ändringarna om testerna godkänns.

1. Flytta upp arbetsobjektet med hjälp av arbetsobjektets ID och målstegets ID.

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

   Kommandoutmatningen inkluderar ett Begäran-ID. Använd det för att kontrollera erbjudandestatus.

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

2. Använd begärans ID för att kontrollera uppflyttningsstatus.

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

Vanliga uppgifter

Använd dessa kommandon under ditt dagliga utvecklingsflöde.

1. Flytta upp flera arbetsobjekt till samma fas. Ange --work-item-id en gång för varje arbetsobjekt.

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

2. Distribuera externt kopplade ändringar till en fas som inte är synkroniserad med DevOps Center.

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

Avancerade användningsfall

När du har slutfört det grundläggande arbetsflödet, använd dessa kommandon för erbjudanden som kräver mer kontroll.