Pika-aloitus: Salesforce CLI:n käyttäminen DevOps Centerin kanssa

Myyntiputken määrittäminen

Luo myyntiputki, lisää ja määritä sen vaiheet, aktivoi se ja liitä projekti.

1. Luetteloi projektisi löytääksesi projektin tunnuksen.

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

   Kopioi myyntiputkeen liitettävän projektin tunnus. Tässä pika-aloituksessa esimerkit käyttävät 0Hn000000000001-funktiota.

2. Luo ei-aktiivinen myyntiputki ja yhdistä se säiliöösi.

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

   Kopioi myyntiputken tunnus komentosta. Tässä pika-aloituksessa esimerkit käyttävät 0XB000000000001-funktiota.

   Myyntiputki ei ole aktiivinen, kunnes määrität sen vaiheet ja aktivoit sen.

   Jos haluat luoda säiliön luodessasi myyntiputkea, käytä --create-repo with --repo-type github|bitbucket.

3. Lisää myyntiputkeesi vaiheita. Uusi myyntiputki sisältää oletusarvoisen lopullisen vaiheen. Lisää jokainen uusi vaihe ennen olemassa olevaa vaihetta määrittämällä olemassa oleva vaihe --next-stage-id.

   Lisää esimerkiksi Integrointi-vaihe.

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

   Kopioi vaiheen tunnus komentosta. Muut esimerkit käyttävät integraatiovaiheelle 0Xc000000000005-objektia. Toista komento jokaiselle lisävaiheelle, kuten UAT.

   

   Vihje Tarkastele myyntiputkeasi DevOps Center -käyttöliittymästä saadaksesi vaiheen tunnukset myöhemmille komentoille. Tai suorita sf devops pipeline get --pipeline-id 0XB000000000001.
4. Määritä jokainen vaihe. Jokainen vaihe vaatii haaran ja ympäristön. Määritä vaiheet oikealta vasemmalle, koska lopullisella vaiheella täytyy olla haara ennen kuin voit määrittää sen edeltäviä vaiheita.

   Lisää haara integrointivaiheeseen. --create-vcs-branch-merkintä luo haaran säilöön, jos sitä ei ole olemassa.

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

   Lisää vaiheeseen sandbox-ympäristö.

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

   Selaimen ikkuna avautuu, josta voit todentaa itsesi ympäristöön. Käytä tuotanto-organisaatioissa --org-type Production. Jos käytät headless-ympäristöä, lisää --no-browser ja noudata komennon palauttamia todennusohjeita.

   Toista haara- ja ympäristökomennot jokaiselle vaiheelle. Käytä kullekin vaiheelle sopivaa haaratoimiston nimeä, ympäristön nimeä ja organisaatiotyyppiä.

5. Aktivoi myyntiputki.
   

   Tärkeää Et voi muokata myyntiputken vaihetta sen ylentämisen jälkeen. Varmista ennen tämän komennon suorittamista, että kaikki vaiheet on määritetty oikein.

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

6. Liitä DevOps Center -projekti myyntiputkeen.

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

   Myyntiputki on valmis. Luo työkohteita DevOps Center -käyttöliittymästä tai suorita sf devops work-item create-komento.

Työkohteen hallinta

Suorita kehityskulku aloittamalla työkohde, sitouttamalla muutoksesi, luomalla tarkastus ja merkitsemällä työkohde valmiiksi ylennettäväksi.

1. Määritä työkohteen tilaksi Käytössä. DevOps Center luo työkohteelle ominaisuushaaran.

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

2. Nouda ominaisuuden haara yhdistetystä säilöstä ja tarkasta se paikallisessa projektissasi.

   git fetch origin
   git checkout WI-000042

3. Nouda muutoksia kehitysorganisaatiostasi. Tämä esimerkki noutaa Apex-luokan organisaatiosta, jonka alias on my-sandbox.

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

4. Tarkasta haetut tiedostot, vaihda ne, sitouta ne ja siirrä ominaisuushaara.

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

   Säädä git add:lle välitettyä polkua, jos Salesforce DX -projektisi käyttää toista pakettihakemistoa.

5. Luo muutospyyntö (noutopyyntö) yhdistääksesi ominaisuuden haaran kohdehaaraan.

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

6. Odota, että tiimisi hyväksyy muutospyynnön ja yhdistää sen.
7. Päivitä työkohteen tila osoittaaksesi, että se on valmis ylennettäväksi.

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

Työkohteen ylentäminen

Ylennä työkohde myyntiputken seuraavaan vaiheeseen. DevOps Center vahvistaa tarjouksen, suorittaa kohdevaiheelle määritetyt testisarjat ja ottaa muutokset käyttöön, jos testit läpäisevät.

1. Ylennä työkohde käyttämällä työkohteen tunnusta ja kohdevaiheen tunnusta.

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

   Komento sisältää pyynnön tunnuksen. Käytä sitä tarkastaaksesi tarjouksen tilan.

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

2. Käytä pyynnön tunnusta tarkastaaksesi tarjouksen tilan.

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

Yleiset tehtävät

Käytä näitä komentoja päivittäisen kehitysprosessisi aikana.

1. Ylennä useita työkohteita samaan vaiheeseen. Määritä --work-item-id kerran jokaiselle työkohteelle.

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

2. Ota ulkoisesti yhdistetyt muutokset käyttöön vaiheeseen, joka ei ole synkronoitu DevOps Centerin kanssa.

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

Edistyneet käyttötarkoitukset

Kun olet suorittanut perustyönkulun, käytä näitä komentoja tarjouksille, jotka vaativat tarkempaa hallintaa.