Selvstudium: Automatisering af løsningsinstallation ved hjælp af GitHub-handlinger for Microsoft Power Platform
I dette selvstudium lærer du, hvordan du kan:
- Oprette et nyt GitHub-lager
- Oprette to GitHub-arbejdsprocesser ved hjælp af GitHub-handlinger til Microsoft Power Platform
Arbejdsprocesserne kan automatisk eksportere din app (som en ikke-administreret løsning) fra et udviklingsmiljø, generere et build-artefakt (administreret løsning) og installere appen i dit produktionsmiljø. Dette selvstudium bruger den ALMLab-løsning, du har opbygget, og de miljøer, du har konfigureret i tidligere selvstudier.
Relaterede selvstudier: Kom i gang og Byg en modelbaseret app.
Oprette en GitHub-konto
Gå til https://github.com, og klik på Tilmeld dig eller Start en gratis prøveperiode (eller log ind, hvis du har en eksisterende konto).
Når du har oprettet din konto, skal du oprette et lager ved at vælge Opret lager eller Ny.
Du får muligvis vist følgende alternative landingsskærm:
Opret dit nye lager, og navngiv det 'poweractionslab'. Sørg for at vælge Tilføj en README-fil for at starte lageret, og vælg Opret lager.
Oprettelse af en ny hemmelighed for godkendelse af tjenestesikkerhedskonto
Gå til dit lager, og klik på Indstillinger, udvid derefter Hemmeligheder, og klik derefter på Handlinger.
På siden Hemmeligheder skal du navngive det hemmelige 'PowerPlatformSPN'. Brug klienthemmeligheden fra den programregistrering, der er oprettet i Microsoft Entra, og indtast den i feltet Værdi, og vælg derefter Tilføj hemmelighed. Der refereres til klienthemmeligheden i de YML-filer, der bruges til at definere GitHub-arbejdsprocesserne senere i dette laboratorium.
Klienthemmeligheden gemmes nu sikkert som en GitHub-hemmelighed.
Oprette en arbejdsproces for at eksportere løsningsfilen og pakke den ud i en ny forgrening
Klik på Handlinger, og klik på Konfigurer selv en arbejdsproces, eller klik på Konfigurer i feltet Enkel arbejdsproces under forslaget til afsnittet om lager.
Dette starter en ny YAML-fil med en grundlæggende arbejdsproces, der kan hjælpe dig i gang med GitHub-handlinger.
Slet det forudoprettede indhold, indsæt indholdet i filen export-and-branch-solution-with-spn-auth.yml, og omdøb derefter filen til 'export-and-branch-solution'.yml.
Opdater
<ENVIRONMENTURL>med URL-adressen til det udviklingsmiljø, du vil eksportere fra (f.eks.https://poweractionsdev.crm.dynamics.com).Opdater
<APPID>og<TENANT ID>med dine værdier.Hvis du bruger legitimationsoplysninger, skal du indsætte filen export-and-branch-solution.yml i stedet for filen export-and-branch-solution-with-spn-auth.yml. Opdater
<USERNAME>med det brugernavn, du bruger til at oprette forbindelse til miljøet.
Tip
Hvis du ikke kender GitHub-handlinger og vil vide mere, kan du læse den officielle dokumentation på https://docs.github.com/en/actions.
Nu er du klar til at lade dine ændringer træde i kraft. Vælg Start ikrafttrædelse, skriv Opret eksport- yml i titelfeltet, og tilføj derefter en beskrivelse (valgfrit). Klik derefter på Anvend ny fil.
Tillykke, du har netop oprettet din første GitHub-arbejdsproces ved hjælp af følgende handlinger:
- Hvem er jeg: Sikrer, at du kan oprette forbindelse til det miljø, du eksporterer fra.
- Eksporter løsning: Eksporterer løsningsfilen fra dit udviklingsmiljø.
- Pak løsning ud: Den løsningsfil, der eksporteres fra serveren, er en komprimeret fil (zip) med konsoliderede konfigurationsfiler. Disse indledende filer er ikke egnet til kildekodestyring, da de ikke er struktureret til at gøre det muligt for kildekodestyringssystemer at differentiere filerne korrekt og registrere de ændringer, du vil anvende til kildekontrol. Du skal 'udpakke' løsningsfiler for at gøre dem egnede til lagring og behandling i forbindelse med kildekontrol.
- Forgreningsløsning: Opretter en ny forgrening til lagring af den eksporterede løsning.
Teste eksporten og pakke arbejdsprocessen ud
Nu skal du teste, om arbejdsprocessen kører. Gå til Handlinger, Kør arbejdsproces, og vælg Kør arbejdsproces. Hvis du har et andet løsningsnavn end 'ALMLab', skal du ændre værdien her, men lade de andre værdier være, som de er.
Efter 5-10 sekunder starter arbejdsprocessen, og du kan vælge den kørende arbejdsproces for at overvåge status.
Når arbejdsprocessen er fuldført, skal du kontrollere, at der er oprettet en ny forgrening, hvor løsningen er pakket ud til mappen solutions/ALMLab. Gå til fanen Kode, og udvid rullelisten med grene.
Vælg den forgrening, der blev oprettet af handlingen.
Kontroller, at mappen solutions/ALMLab er oprettet i den nye forgrening, og opret derefter en pull-anmodning for at flette ændringerne ind i hovedforgreningen. Klik på Bidrag , og klik på Åbn pullanmodning i pop op-vinduet.
Tilføj en titel og beskrivelse på skærmbilledet Åbn en Pull-anmodning , og klik derefter på Opret Pull-anmodning.
Skærmbilledet opdateres og viser den netop oprettede Pull-anmodning. Efterhånden som Pull-anmodningen oprettes, vises der en bekræftelse på, at der ikke er nogen konflikt med hovedgrenen i vores gren. Denne bekræftelse betyder, at ændringerne automatisk kan flettes sammen i hovedgrenen. Klik på Flet pullanmodning , og klik derefter på Bekræft fletning. Du kan også klikke på Slet gren for at rydde op i den nu afgrenede gren.
Gå tilbage til standard (hoved)-forgreningen, og kontroller, om løsningen nu er tilgængelig der også.
Oprette en arbejdsproces, der kan genbruges, for at oprette en byggegenstand og importere den til produktion
I dette afsnit skal vi oprette endnu en arbejdsproces, som:
- Opretter en administreret løsning og publicerer den som en GitHub-artefakt
- Importerer build-artefaktet i produktionsmiljøet
Naviger til Handlinger, og vælg Ny arbejdsproces.
Vælg konfigurer selv en arbejdsproces.
Omdøb titlen på arbejdsprocessen til 'release-solution-to-prod-with-inputs', og kopiér indholdet fra filen release-solution-to-prod-with-inputs.yml, og indsæt det i skærmbilledet Rediger ny fil.
Anvend ændringerne. Vælg Start ikrafttrædelse, og tilføj derefter en titel og beskrivelse (valgfrit). Vælg derefter Anvend ny fil.
Kalde arbejdsprocessen, der kan genbruges, i releasehændelsen
I dette afsnit kalder vi arbejdsprocessen, der kan genbruges, i forbindelse med releasehændelsen.
Naviger til Handlinger, og vælg Ny arbejdsproces.
Vælg Konfigurere selv en arbejdsproces.
Omdøb titlen på arbejdsprocessen til 'release-action-call', og kopiér indholdet fra filen release-action-call.yml, og indsæt det i skærmbilledet Rediger ny fil.
Opdater følgende variabler i den nye arbejdsprocesfil:
- Opdater
<BUILD_ENVIRONMENT>med URL-adressen til det buildmiljø, du bruger til at oprette den administrerede løsning. Eksempel:https://poweractionsbuild.crm.dynamics.com. - Opdater
<PROD_ENVIRONMENT>med URL-adressen til det produktionsmiljø, du installerer i. Eksempel: https://poweractionsprod.crm.dynamics.com. - Opdater
<APP_ID>med program-id'et (Client), der findes i apptilmeldingerne på Microsoft Azure-portalen ved at klikke på den registrering, der blev oprettet tidligere i dette selvstudium. - Opdater
<TENANT_ID>med Mappe (lejer)-id, der findes i apptilmeldingerne på Microsoft Azure-portalen ved at klikke på den registrering, der blev oprettet tidligere i dette selvstudium.
- Opdater
Anvend ændringerne. Vælg Start ikrafttrædelse, og tilføj derefter en titel (valgfrit) og beskrivelse (valgfrit). Vælg derefter Anvend ny fil.
Teste arbejdsprocessen fra udgivelse til produktionsmiljø
Du er nu klar til at teste den sidste arbejdsproces. Denne arbejdsproces udløses, når der installeres en ny udgivelse i produktionsmiljøet.
Naviger til Udgivelser.
Vælg Kladde af en ny udgivelse.
Tilføj et udgivelsesmærke, en titel, og vælg Publicer udgivelse.
Vælg Handlinger for at se den kørende arbejdsproces.
Vælg den igangværende arbejdsproces for at få vist handlingerne, efterhånden som de køres.
Vent, indtil hver handling er fuldført.
Når arbejdsprocessen er fuldført, skal du logge på produktionsmiljøet og kontrollere, at løsningen er blevet installeret som en administreret løsning.
Installere opdateringen og gennemse ændringerne før udgivelsen til produktionsmiljøet
Vi skal nu teste start til slut-processen, og derefter kan du se, hvordan du kan få vist og validere ændringer af en app, før den installeres i produktionsmiljøet.
Naviger til ALMLab-løsningen i udviklingsmiljøet, og vælg Rediger eller klik på visningsnavn.
Vælg og se tabellen Fri-anmodning.
Klik på + Tilføj kolonne, og opret den nye kolonne som vist i figuren nedenfor.
Opdaterede feltværdier:**
- Visningsnavn: Godkendt
- Datatype: Ja/Nej
Klik på Udført.
Klik på Gem tabel
Naviger tilbage til fanen Handlinger i GitHub-lager, vælg Kør arbejdsproces, og vælg knappen Kør arbejdsproces.
Efter 5-10 sekunder starter arbejdsprocessen, og du kan klikke på den kørende arbejdsproces for at overvåge dens status.
Når arbejdsprocessen er fuldført, skal du navigere til den nye forgrening ved at vælge Kode og derefter Forgreninger.
Vælg den gren, der blev oprettet med udvid, bidrag, og klik på Åbn Pull-anmodning.
Tilføj en titel (valgfrit), og klik derefter på Opret Pull-anmodning.
Når indholdet er opdateret, skal du klikke på fanen Filer ændret.
Bemærk, at ændringerne af løsningen fremhæves med grønt for at angive, at denne sektion af filen blev tilføjet, da den blev sammenlignet med den samme fil i hovedforgreningen.
Gå tilbage til fanen Samtaler. Vælg Pull-anmodninger, og vælg derefter den Pull-anmodning, der tidligere er oprettet.
Vælg Squash og flet på siden Pull-anmodning, og flet den opdaterede løsningsfil ind i hovedgrenen. Slet eventuelt, der nu er flettet sammen til hovedafdelingen.
Følg trinnene i afsnittet Teste arbejdsprocessen fra udgivelse til produktionsmiljø for at oprette en ny udgivelse og validere, at den opdaterede løsning installeres i produktionsmiljøet.
Tillykke! Du har konfigureret et eksempel på CI/CD-arbejdsprocessen ved hjælp af GitHub-handlinger.