Napomena
Za pristup ovoj stranici potrebna je autorizacija. Možete se pokušati prijaviti ili promijeniti direktorije.
Za pristup ovoj stranici potrebna je autorizacija. Možete pokušati promijeniti direktorije.
U ovom ćete vodiču saznati kako:
- Stvoriti novo spremište GitHub
- Stvorite dva GitHub tijeka rada pomoću GitHub Actions za Microsoft Power Platform
Tijekovi rada mogu automatski izvesti vašu aplikaciju (kao neupravljano rješenje) iz razvojnog okruženja, generirati artefakt međuverzije (upravljano rješenje) i uvesti aplikaciju u vaše proizvodno okruženje. Ovaj korisnički priručnik koristi Rješenje ALMLab koje ste izradili i okruženja koja ste postavili u prethodnim korisničkim priručnicima.
Povezani korisnički priručnici: Početak i Izrada aplikacije stvorene prema modelu.
Stvaranje GitHub računa
Idite https://github.com na i odaberite Registrirajtese ili Pokrenite besplatnu probnu verziju (ili se prijavite ako imate postojeći račun).
Kada stvorite račun, stvorite spremište tako da odaberete Stvori spremište ili Novo.
Možda ćete vidjeti sljedeći alternativni zaslon:
Stvorite novo spremište i dodijelite mu naziv
poweractionslab. Provjerite jeste li odabrali Dodaj README datoteku da biste pokrenuli spremište i odaberite Stvori spremište.
Stvaranje nove tajne za provjeru autentičnosti usluge
Idite u spremište i odaberite Postavke. Proširite Tajne, a zatim odaberite Akcije.
Na stranici Tajne imenujte tajnu
PowerPlatformSPN. Unesite tajnu klijenta iz registracije aplikacije koju ste stvorili Microsoft Entra u polje Vrijednost, a zatim odaberite Dodaj tajnu. U YML datotekama koje definiraju tijekove rada sustava Office 2010 potražite u GitHub u ovom vodiču.
Tajna klijenta sada je sigurno pohranjena kao GitHub tajna.
Stvaranje tijeka rada za izvoz i raspakiravanje datoteke rješenja u novu granu
Odaberite Akcije, a zatim sami postavite tijek rada. Možete i odabrati Konfiguriraj u okviru Jednostavni tijek rada ispod odjeljka predloženog za ovo spremište .
Vidjet ćete novu YAML datoteku s osnovnim tijekom rada koji će vam pomoći da započnite s GitHub akcijama.
Izbrišite unaprijed stvoreni sadržaj, a zatim zalijepite sadržaj iz export-and-branch-solution-with-spn-auth.yml datoteke. Preimenujte datoteku u
export-and-branch-solution.yml.
Ažurirajte
<ENVIRONMENTURL>pomoću URL-a za razvojno okruženje iz kojeg želite izvesti (na primjer:https://poweractionsdev.crm.dynamics.com).Ažurirajte
<APPID>i<TENANT ID>vašim vrijednostima.Ako koristite vjerodajnice, zalijepite export-and-branch-solution.yml datoteku umjesto sadržaja export-and-branch-solution-with-spn-auth.yml datoteke. Ažurirajte
<USERNAME>korisničkim imenom koje koristite za povezivanje s okruženjem.
Savjet
Ako ne znate raditi s GitHub Actions i želite saznati više, pročitajte službenu dokumentaciju na web-mjestu https://docs.github.com/en/actions.
Sada ste spremni za izvršavanje promjena. Odaberite Započni izvršavanje, upišite Stvori izvoznu yml u polje za naslov, a zatim dodajte opis (neobavezno). Zatim odaberite Izvrši novu datoteku.
Čestitamo, stvorili ste GitHub tijek rada pomoću sljedećih akcija:
- Tko sam ja: osigurava da se možete uspješno povezati s okruženjem iz kojeg želite izvesti.
- Izvoz rješenja: Izvozi datoteku rješenja iz vašeg razvojnog okruženja.
- Raspakiraj rješenje: datoteka rješenja koju poslužitelj izvozi komprimirana je (zip) datoteka sa konsolidiranim konfiguracijskim datotekama. Te početne datoteke nisu prikladne za upravljanje izvornim kodom jer nisu strukturirane da bi sustave za upravljanje izvornim kodom bilo moguće pravilno razlikovati na datotekama i bilježiti promjene koje želite izvršiti za kontrolu izvora. Morate raspakirati datoteke rješenja da bi bili prikladni za izvornu kontrolu pohrane i obradu.
- Rješenje grane: Stvara novu granu za pohranu izvezenog rješenja.
Testiranje tijeka rada izvoza i raspakiravanja
Zatim testirajte radi li tijek rada. Idite na Akcije, odaberite Pokreni tijek rada, a zatim Pokreni tijek rada. Ako koristite neki drugi naziv rješenja od
ALMLab, ovdje promijenite vrijednost, ali ostale vrijednosti zadržite iste.
Tijek rada se pokreće nakon 5 – 10 sekundi. Tijek rada koji se izvodi možete odabrati da biste nadgledali tijek rada.
Kada tijek rada završi, provjerite je li stvoren novi ogranak s rješenjem raspakiranom u
solutions/ALMLabmapu. Idite na karticu Kod i proširite padajući izbornik grana.Odaberite ogranak koji je akcija stvorila.
Provjerite je li
solutions/ALMLabmapa stvorena u novom ogranku. Zatim stvorite zahtjev za povlačenjem da biste spojili promjene u glavni ogranak. Odaberite Doprinos i na potpaleti odaberite Otvori zahtjev za povlačenje.Na zaslonu Otvaranje zahtjeva za povlačenjem po potrebi dodajte naslov i opis, a zatim odaberite Stvori zahtjev za povlačenje.
Zaslon se ažurira da bi se prikazao novi zahtjev za povlačenje. Kada stvorite zahtjev za povlačenje, dobit ćete potvrdu da grana nije u sukobu s glavnim ograncima. Ova potvrda znači da promjene možete automatski spojiti u glavni ogranak. Odaberite Spoji zahtjev za povlačenjem, a zatim Odaberite Potvrdi spajanje. Ako želite, odaberite izbriši ogranak da biste uklonili ogranak za uklanjanje trenutnog uklanjanja.
Vratite se na zadani (glavni) ogranak i provjerite je li rješenje tamo dostupno.
Stvaranje ponovno iskoristivog tijeka rada za generiranje artefakta međuverzije i uvoz u proizvodnju
U ovom odjeljku stvorite dodatni tijek rada koji:
- Stvara upravljano rješenje i objavljuje ga kao GitHub artefakt
- Uvozi artefakt međuverzije u proizvodno okruženje
Idite na Akcije i odaberite Novi tijek rada.
Sami odaberite postavljanje tijeka rada.
Preimenujte naslov tijeka rada u
release-solution-to-prod-with-inputs. Kopirajte sadržaj iz datoteke release-solution-to-prod-with-inputs.yml ga zalijepite na zaslon Uređivanje nove datoteke.
Izvršite promjene. Odaberite Započni izvršavanje, a zatim dodajte naslov i opis (neobavezno). Zatim odaberite Izvrši novu datoteku.
Pozivanje ponovno iskoristivog tijeka rada na događaju izdavanja
U ovom ćete odjeljku pozvati tijek rada koji se može ponovno koristiti u događaju izdanja.
Idite na Akcije i odaberite Novi tijek rada.
Odaberite samostalno postavljanje tijeka rada.
Preimenujte naslov tijeka rada u
release-action-call. Kopirajte sadržaj iz datoteke release-action-call.yml ga zalijepite na zaslon Uređivanje nove datoteke.
Ažurirajte sljedeće varijable u novoj datoteci tijeka rada:
- Ažurirajte
<BUILD_ENVIRONMENT>URL-om za okruženje međuverzije koje koristite za generiranje upravljanog rješenja. Na primjer:https://poweractionsbuild.crm.dynamics.com. - Ažurirajte
<PROD_ENVIRONMENT>URL-om za produkcijsko okruženje u koje implementirate. Na primjer:https://poweractionsprod.crm.dynamics.com. - Ažurirajte
<APP_ID>ID-om aplikacije (klijenta) koji pronađete na App registrations na microsoftovu računalu Azure Portal tako da odaberete registraciju koju ste prethodno stvorili u ovom vodiču. - Ažurirajte
<TENANT_ID>s ID-om direktorija (klijenta) koji se nalazi na App registrations na microsoftovu Azure Portal tako da odaberete registraciju koju ste prethodno stvorili u ovom vodiču.
- Ažurirajte
Izvršite promjene. Odaberite Započni izvršavanje, a zatim dodajte naslov (neobavezno) i opis (neobavezno). Zatim odaberite Izvrši novu datoteku.
Testiranje objavljivanja u proizvodni tijek rada
Sada ste spremni za testiranje posljednjeg tijeka rada. Ovaj tijek rada pokreće se kada se novo izdanje implementira u produkciju.
Idite na Izdanja.
Odaberite Skica novog izdanja.
Dodajte oznaku izdanja, naslov i odaberite Objavi izdanje.
Odaberite Radnje za prikaz pokrenutog tijeka rada.
Odaberite pokrenuti tijek rada da biste pregledali radnje dok se izvode.
Pričekajte da se svaka radnja dovrši.
Kada tijek rada završi, prijavite se u produkcijsko okruženje i provjerite je li rješenje implementiran kao upravljano rješenje.
Uvođenje ažuriranja i pregled promjena prije proizvodnog izdanja
Testirajte postupak od kraja do kraja, a zatim pogledajte kako pregledati i provjeriti valjanost promjena u aplikaciji prije nego što je implementirate u produkcijsku implementaciju.
Idite na rješenje ALMLab u svom razvojnom okruženju i odaberite Uređivanje ili odaberite zaslonski naziv rješenja.
Odaberite i pregledajte tablicu Zahtjev za slobodno vrijeme.
Odaberite + Dodaj stupac i stvorite novi stupac kao što je prikazano na sljedećoj slici.
Ažurirane vrijednosti polja:**
- zaslonsko ime: Odobreno
- Vrsta podataka: Da/Ne
Odaberite Gotovo.
Odaberi Tablicu za spremaj.
Vratite se na karticu GitHub spremišta, odaberite Pokreni tijek rada, a zatim gumb Pokreni tijek rada.
Tijek rada se pokreće nakon 5 – 10 sekundi. Odaberite pokrenuti tijek rada da biste nadgledali njegov napredak.
Kada tijek rada završi, idite u novi ogranak tako da odaberete Kod, a zatim Grane.
Odaberite ogranak koji ste stvorili proširivanjem doprinosa i odabirom mogućnosti Otvori zahtjev za povlačenje.
Dodajte naslov (neobavezno), a zatim odaberite Stvori zahtjev za povlačenje.
Nakon ažuriranja sadržaja odaberite karticu Datoteke promijenjene .
Primijetite da su promjene rješenja označene zelenom bojom da bi se naznačilo da je ovaj odjeljak datoteke dodan u usporedbi s istom datotekom u glavnoj grani.
Vratite se na karticu Razgovori. Odaberite Povlačenje zahtjeva, a zatim odaberite zahtjev za povlačenje koji ste prethodno stvorili.
Na stranici Zahtjev za povlačenje odaberite Stisni i spoji da biste spojili ažuriranu datoteku rješenja u glavni ogranak. Možete i izbrisati, a sada je spojeno u glavno.
Slijedite korake u odjeljku Testiranje izdanja u produkcijsku tijeku rada da biste stvorili novo izdanje i provjerili je li ažurirano rješenje uvedeno u produkcijsko okruženje.
Čestitamo, uspješno ste postavili ogledni CI/CD tijek rada pomoću GitHub akcija!