Zelfstudie: Implementatie van oplossingen automatiseren met behulp van GitHub Actions voor Microsoft Power Platform

In deze handleiding leer je hoe je:

  • Een nieuwe GitHub-repository maken
  • Twee GitHub-werkstromen maken met behulp van GitHub Actions voor Microsoft Power Platform

De workflows kunnen uw app automatisch exporteren (als een onbeheerde oplossing) vanuit een ontwikkelomgeving, een buildartefact genereren (beheerde oplossing) en de app uitrollen in uw productieomgeving. Deze zelfstudie gebruikt de ALMLab-oplossing die u hebt gebouwd en de omgevingen die u hebt opgezet in eerdere zelfstudies.

Gerelateerde zelfstudie: Aan de slag en Eeen modelgestuurde app bouwen.

Een GitHub-account maken

  1. Ga naar https://github.com en selecteer Registreren of Een gratis proefversie starten (of meld u aan als u een bestaand account hebt).

    Account aanmaken

  2. Nadat u uw account hebt gemaakt, maakt u een opslagplaats door Opslagplaats maken of Nieuw te selecteren.

    Een repository maken

    Mogelijk ziet u het volgende alternatieve landingsscherm:

    Een nieuwe repository maken

  3. Maak uw nieuwe repository en geef deze de naam poweractionslab. Zorg ervoor dat u Een README-bestand toevoegen selecteert om de repository te initiëren en kies Repository maken.

    Repo initialiseren.

Een nieuw geheim voor Service Principal-verificatie maken

  1. Ga naar uw opslagplaats en selecteer Instellingen. Vouw Geheimen uit en selecteer vervolgens Acties.

  2. Geef op de pagina Geheimen de naam van het geheim PowerPlatformSPN. Voer in het veld Waarde het clientgeheim in van de toepassingsregistratie die u in Microsoft Entra hebt gemaakt en selecteer vervolgens Geheim toevoegen. U zult later in deze zelfstudie naar het clientgeheim verwijzen in de YML-bestanden die de GitHub-workflows definiëren.

    Het geheim voor de service-principal maken

    Het clientgeheim wordt nu veilig opgeslagen als een GitHub-secret.

Maak een workflow om het solutionbestand te exporteren en uit te pakken in een nieuwe branch

  1. Selecteer Acties en selecteer vervolgens zelf een werkstroom instellen. Of selecteer Configureren in het vak Eenvoudige werkstroom onder het gedeelte voorgesteld voor deze repository.

    Werkstroom instellen.

  2. U ziet een nieuw YAML-bestand met een basiswerkstroom om u te helpen aan de slag te gaan met GitHub acties.

    Voorbeeld YML-bestand

  3. Verwijder de vooraf gemaakte inhoud en plak de inhoud uit het export-and-branch-solution-with-spn-auth.yml bestand. Wijzig de naam van het bestand in export-and-branch-solution.yml.

    Naam wijzigen en inhoud vervangen.

  4. Werk <ENVIRONMENTURL> bij met de URL van de ontwikkelomgeving waaruit u wilt exporteren (bijvoorbeeld: https://poweractionsdev.crm.dynamics.com).

  5. Werk <APPID> en <TENANT ID> bij met uw waarden.

    • Als u aanmeldingsgegevens gebruikt, plakt u de inhoud van het bestand export-and-branch-solution.yml in plaats van de inhoud van het bestand export-and-branch-solution-with-spn-auth.yml. Werk <USERNAME> bij met de gebruikersnaam die u gebruikt om verbinding te maken met de omgeving.

      Naam wijzigen en inhoud vervangen

    Tip

    Als u niet bekend bent met GitHub Actions en meer wilt weten, raadpleegt u de officiële documentatie op https://docs.github.com/en/actions.

  6. U bent nu klaar om uw wijzigingen door te voeren. Selecteer Start commit, typ Create export yml in het titelveld en voeg vervolgens een beschrijving toe (optioneel). Selecteer vervolgens Nieuw bestand committen.

    Commit starten.

Gefeliciteerd, u hebt uw eerste GitHub-workflow gemaakt door gebruik te maken van de volgende acties:

  • Who Am I: zorgt ervoor dat u verbinding kunt maken met de omgeving waaruit u wilt exporteren.
  • Oplossing exporteren: Exporteert het oplossingsbestand uit uw ontwikkelomgeving.
  • Oplossing uitpakken: het oplossingsbestand dat de server exporteert, is een gecomprimeerd (zip)-bestand met geconsolideerde configuratiebestanden. Deze initiële bestanden zijn niet geschikt voor broncodebeheer omdat ze niet zijn gestructureerd om het haalbaar te maken voor broncodebeheersystemen om de bestanden op de juiste manier te differentiëren en de wijzigingen vast te leggen die u wilt vastleggen in versiebeheer. U moet de oplossingsbestanden uitpakken om ze geschikt te maken voor opslag en verwerking in versiebeheer.
  • Branch Solution: Maakt een nieuwe branch om de geëxporteerde oplossing op te slaan.

De export- en uitpakworkflow testen

  1. Test vervolgens of de workflow draait. Ga naar Acties, selecteer Werkstroom uitvoeren en kies Werkstroom uitvoeren. Als u een andere oplossingsnaam gebruikt dan ALMLab, wijzigt u de waarde hier, maar laat u de andere waarden hetzelfde.

    Workflow uitvoeren.

  2. Na 5-10 seconden wordt de workflow gestart. U kunt de actieve workflow selecteren om de voortgang te controleren.

    Klik om de workflow te bekijken.

    Werkstroom selecteren en weergeven.

  3. Nadat de workflow is voltooid, controleert u of er een nieuwe branch is gemaakt met de oplossing die is uitgepakt in de map solutions/ALMLab. Ga naar het tabblad Code en vouw de vervolgkeuzelijst branches uit.

  4. Selecteer de branch die door de actie is aangemaakt.

  5. Controleer of de map solutions/ALMLab is aangemaakt in de nieuwe branch. Maak vervolgens een pull request om de wijzigingen samen te voegen in de hoofdbranch. Selecteer Bijdragen en selecteer in het uitklapmenu Pull-aanvraag openen.

  6. Op het scherm Een pull-aanvraag openen voegt u desgewenst een titel en beschrijving toe en selecteert u vervolgens Pull-aanvraag maken.

  7. Het scherm wordt bijgewerkt en toont de nieuwe pull request. Wanneer u de pull request aanmaakt, krijgt u de bevestiging dat uw branch geen conflicten heeft met de main branch. Deze bevestiging betekent dat u de wijzigingen automatisch kunt samenvoegen in de hoofdbranch. Selecteer Pull-aanvraag samenvoegen en selecteer Samenvoegen bevestigen. Selecteer eventueel branch verwijderen om de nu niet langer gebruikte branch te verwijderen.

    Branches weergeven

  8. Ga terug naar de standaardbranch (main) en controleer of de oplossing daar beschikbaar is.

Een herbruikbare workflow maken om een build-artefact te genereren en te importeren in productie

Maakt u in dit gedeelte een extra werkstroom die:

  • Maakt een beheerde oplossing en publiceert deze als een GitHub-artefact
  • Importeert het buildartefact naar de productieomgeving

  1. Ga naar Acties en selecteer Nieuwe workflow.

    Nieuwe workflow maken.

  2. Kies zelf een workflow instellen.

    Een werkstroom instellen.

  3. Wijzig de titel van de werkstroom in release-solution-to-prod-with-inputs. Kopieer de inhoud uit het release-solution-to-prod-with-inputs.yml bestand en plak deze in het scherm Nieuw bestand bewerken .

    Naam wijzigen en code plakken.

  4. Voer de wijzigingen door. Kies Commit starten en voeg vervolgens een titel en beschrijving (optioneel) toe. Selecteer vervolgens Commit new file.

    Wijzigingen vastleggen.

Roep de herbruikbare workflow aan voor het release-event

In deze sectie roept u de herbruikbare werkstroom aan op de release-gebeurtenis.

  1. Ga naar Acties en selecteer Nieuwe workflow.

    Nieuwe workflow maken.

  2. Kies ervoor om zelf een werkstroom in te stellen.

    Een werkstroom instellen.

  3. Wijzig de naam van de workflow in release-action-call. Kopieer de inhoud uit het release-action-call.yml bestand en plak deze in het scherm Nieuw bestand bewerken .

    Naam wijzigen en code plakken.

  4. Werk de volgende variabelen bij in het nieuwe werkstroombestand:

    • Werk <BUILD_ENVIRONMENT> bij met de URL voor de buildomgeving die u gebruikt om de beheerde oplossing te genereren. Voorbeeld: https://poweractionsbuild.crm.dynamics.com.
    • Werk <PROD_ENVIRONMENT> bij met de URL voor de productieomgeving waarnaar u implementeert. Voorbeeld: https://poweractionsprod.crm.dynamics.com.
    • Werk <APP_ID> bij met de toepassings-id (client) die u vindt in de blade App-registraties van Microsoft Azure Portal door de registratie te selecteren die u eerder in deze zelfstudie hebt gemaakt.
    • Werk <TENANT_ID> bij met de map-id (tenant) die u vindt op de blade App-registraties van microsoft Azure Portal door de registratie te selecteren die u eerder in deze zelfstudie hebt gemaakt.

  5. Voer de wijzigingen door. Kies Commit starten en voeg vervolgens een titel (optioneel) en beschrijving (optioneel) toe. Selecteer vervolgens Nieuw bestand committen.

    Wijzigingen vastleggen.

De workflow voor vrijgave naar productie testen

U bent nu klaar om de laatste werkstroom te testen. Deze werkstroom wordt geactiveerd wanneer een nieuwe release wordt geïmplementeerd in productie.

  1. Ga naar Releases.

    Ga naar releases.

  2. Selecteer Nieuwe release opstellen.

  3. Voeg een releasetag en een titel toe en kies Release publiceren.

  4. Selecteer Actions om de lopende workflow te bekijken.

    Selecteer om de workflow weer te geven.

  5. Kies de actieve werkstroom om de acties te bekijken terwijl ze worden uitgevoerd.

    Workflow weergeven.

  6. Wacht tot elke actie is voltooid.

    Branch weergeven.

  7. Nadat de werkstroom is voltooid, meldt u zich aan bij uw productieomgeving en controleert u of de oplossing is geïmplementeerd als een beheerde oplossing.

De update implementeren en de wijzigingen bekijken voor de productieversie

Test het end-to-end-proces en bekijk hoe u wijzigingen in een app kunt bekijken en valideren voordat u deze in productie implementeert.

  1. Ga naar de ALMLab-oplossing in uw ontwikkelomgeving en selecteer Bewerken of selecteer de weergavenaam van de oplossing.

    Oplossing bewerken.

  2. Selecteer en bekijk de tabel Verlofaanvraag.

    Bekijk de tabel.

  3. Selecteer + Kolom toevoegen en maak de nieuwe kolom, zoals wordt weergegeven in de volgende afbeelding.

    Kolom toevoegen.

    Bijgewerkte veldwaarden:**

    • Weergavenaam: Goedgekeurd
    • Gegevenstype: Ja/Nee

  4. Selecteer Gereed.

  5. Selecteer Tabel opslaan. Kolom toevoegen.

  6. Ga terug naar het tabblad Actions van je GitHub-repositories, selecteer Run workflow en selecteer de knop Run workflow.

    De werkstroom uitvoeren.

  7. Na 5–10 seconden wordt de workflow gestart. Selecteer de actieve werkstroom om de voortgang ervan te controleren.

    Workflow selecteren.

    De werkstroom weergeven.

  8. Nadat de workflow is voltooid, gaat u naar de nieuwe branch door Code en vervolgens Branches te selecteren.

    Navigeren naar branch.

  9. Selecteer de vertakking die u hebt gemaakt door contribute uit te vouwen en Open pull request te selecteren.

  10. Voeg een titel toe (optioneel) en selecteer vervolgens Pullaanvraag maken.

  11. Nadat de inhoud is bijgewerkt, selecteert u het tabblad Gewijzigde bestanden.

  12. Merk op dat de wijzigingen in de oplossing groen zijn gemarkeerd om aan te geven dat deze sectie van het bestand is toegevoegd in vergelijking met hetzelfde bestand in de hoofd-branch.

  13. Ga terug naar het tabblad Conversatie. Selecteer pull requests en selecteer vervolgens de pull request die u eerder hebt gemaakt.

  14. Selecteer op de pagina Pull requestSquash and merge om het bijgewerkte oplossingsbestand samen te voegen in uw hoofdbranch. U kunt eventueel verwijderen wat nu is samengevoegd met main.

    Open een pull-aanvraag voor een nieuwe branch, bekijk wijzigingen en voeg samen in de standaard-branch

  15. Volg de stappen in de sectie 'Werkstroom Release naar productie testen' om een nieuwe release te maken en te controleren of de bijgewerkte oplossing is geïmplementeerd in uw productieomgeving.

Gefeliciteerd, u hebt een voorbeeld-CI/CD-werkstroom ingesteld met behulp van GitHub acties.

Zie ook

Automatiseer uw workflow van idee tot productie

  • Laatst bijgewerkt om