Tutorial: Automatitzar el desplegament de solucions utilitzant GitHub Actions per a Microsoft Power Platform

En aquest tutorial, aprendreu com:

• Crear un dipòsit de GitHub nou
• Crea dos fluxos de treball de GitHub utilitzant GitHub Actions per a Microsoft Power Platform

Els fluxos de treball poden exportar automàticament la vostra aplicació (com a solució no administrada) des d'un entorn de desenvolupament, generar un artefacte de compilació (solució administrada) i implementar l'aplicació en el vostre entorn de producció. Aquest tutorial utilitza la solució ALMLab que heu creat i els entorns que heu configurat en els tutorials anteriors.

Tutorials relacionats: Introducció i Crear una aplicació basada en models.

Crea un compte a GitHub

1. Ves a https://github.comi selecciona Registrar-te o començar una prova gratuïta (o iniciar sessió si tens un compte existent).

   

2. Després de crear el teu compte, crea un repositori seleccionant Crear repositori o Nou.

   

   Es veu la següent pantalla de destinació alternativa:

   

3. Crea el teu nou repositori i posa-li poweractionslabnom. Assegura't de seleccionar Afegir un fitxer README per iniciar el repositori i triar Crear repositori.

   

Creació d'un nou secret per a l'autenticació de l'entitat de seguretat de servei

1. Ves al teu repositori i selecciona Configuració. Expandeix Secrets i després selecciona Accions.

2. A la pàgina de Secrets , anomena el secret PowerPlatformSPN. Introdueix el secret del client des del registre d'aplicació que has creat a Microsoft Entra al camp Valor, i després selecciona Afegir secret. Més endavant en aquest tutorial faràs referència al secret del client als fitxers YML que defineixen els fluxos de treball de GitHub.

   

   El secret del client ara s'emmagatzema de forma segura com un secret de GitHub.

Crear un flux de treball per exportar i desempaquetar el fitxer de solució a una nova branca

1. Selecciona Accions, i després selecciona configurar tu mateix un flux de treball. O bé, selecciona Configurar a la caixa de flux de treball Simple sota la secció suggerida per a aquest repositori .

   

2. Veus un nou fitxer YAML amb un flux de treball bàsic per ajudar-te a començar amb les accions de GitHub.

   

3. Elimina el contingut precreat i després enganxa el contingut del fitxer export-and-branch-solution-with-spn-auth.yml . Reanomena el fitxer a export-and-branch-solution.yml.

   

4. Actualitzeu <ENVIRONMENTURL> amb l'URL de l'entorn de desenvolupament des del qual voleu exportar (per exemple: https://poweractionsdev.crm.dynamics.com).

5. Actualitzeu <APPID> i <TENANT ID> amb els vostres valors.

   • Si utilitzes credencials, enganxa el fitxer export-and-branch-solution.yml en comptes del contingut del fitxer export-and-branch-solution-with-spn-auth.yml . Actualitza <USERNAME> amb el nom d'usuari que utilitzes per connectar-te a l'entorn.

     

   Propina

   Si no coneixes GitHub Actions i vols saber-ne més, consulta la documentació oficial a https://docs.github.com/en/actions.

6. Ara estàs preparat per comprometre't amb els teus canvis. Seleccioneu Inicia la publicació, escriviu Creació d'un YML d'exportació en el camp de títol i afegiu una descripció (opcional). A continuació, seleccioneu Publica el nou fitxer.

   

Felicitats, has creat el teu primer flux de treball a GitHub utilitzant les següents accions:

• Qui sóc jo: Assegura que puguis connectar-te amb èxit a l'entorn des del qual vols exportar.
• Exporta la solució: exporta el fitxer de la solució des de l'entorn de desenvolupament.
• Desempaqueta la solució: El fitxer de solució que exporta el servidor és un fitxer comprimit (zip) amb fitxers de configuració consolidats. Aquests fitxers inicials no són adequats per a la gestió del codi font perquè no estan estructurats per fer possible que els sistemes de gestió de codi font facin correctament la diferència entre els fitxers i capturin els canvis que vols comprometre al control de versions. Cal desempaquetar els fitxers de solució per fer-los adequats per a l'emmagatzematge i processament de control de versió.
• Solució de branca: crea una branca nova per emmagatzemar la solució exportada.

Provar el flux de treball d'exportació i desempaquetament

1. A continuació, proveu que s'executa el flux de treball. Ves a Accions, selecciona Executar flux de treball i tria Executar flux de treball. Si utilitzes un nom de solució diferent de ALMLab, canvia el valor aquí però mantén els altres valors iguals.

   

2. Després de 5–10 segons, comença el flux de treball. Pots seleccionar el flux de treball en execució per monitoritzar el progrés.

   

   

3. Quan acabi el flux de treball, comprova que s'ha creat una nova branca amb la solució desempaquetada a la solutions/ALMLab carpeta. Ves a la pestanya de Codi i expandeix el desplegable de branques.

4. Selecciona la branca que ha creat l'acció.

5. Comprova que la solutions/ALMLab carpeta s'ha creat a la nova branca. Després, crea una pull request per fusionar els canvis a la branca principal. Selecciona Contribuir i al flyout selecciona Obre sol·licitud de tirada.

6. A la pantalla Obre una sol·licitud de tirada , afegeix un títol i una descripció si vols, i després selecciona Crear sol·licitud de tirada.

7. La pantalla s'actualitza per mostrar la nova pull request. Quan crees la pull request, reps confirmació que la teva branca no té conflicte amb la branca principal. Aquesta confirmació significa que pots fusionar els canvis automàticament a la branca principal. Selecciona Fusió pull request i després selecciona Confirmar fusió. Opcionalment, selecciona eliminar la branca per eliminar la branca ara desapareguda.

   

8. Torna a la branca per defecte (principal) i comprova que la solució està disponible allà.

Crear un flux de treball reutilitzable per generar un artefacte de compilació i importar-lo a producció

En aquesta secció, crea un flux de treball addicional que:

• Crea una solució administrada i la publica com un artefacte de GitHub
• Importa l'artefacte de compilació a l'entorn de producció

1. Ves a Accions i selecciona Nou flux de treball.

   

2. Tria configurar tu mateix un flux de treball.

   

3. Canvia el títol del flux de treball a release-solution-to-prod-with-inputs. Copia el contingut del fitxer release-solution-to-prod-with-inputs.yml i enganxa'l a la pantalla de Editar nou fitxer .

   

4. Publiqueu els canvis. Trieu Inicia la publicació i afegiu un títol i una descripció (opcional). A continuació, seleccioneu Publica el nou fitxer.

   

Trucar al flux de treball reutilitzable a l'esdeveniment de publicació

En aquesta secció, crides el flux de treball reutilitzable a l'esdeveniment de llançament.

1. Ves a Accions i selecciona Nou flux de treball.

   

2. Trieu Configura un flux de treball.

   

3. Canvia el títol del flux de treball a release-action-call. Copia el contingut del fitxer release-action-call.yml i enganxa'l a la pantalla d'Editar nou fitxer .

   

4. Actualitzeu les següents variables en el nou fitxer de flux de treball:

   • Actualitza <BUILD_ENVIRONMENT> amb l'URL de l'entorn de compilació que estàs utilitzant per generar la solució gestionada. Per exemple: https://poweractionsbuild.crm.dynamics.com.
   • Actualitza <PROD_ENVIRONMENT> amb l'URL de l'entorn de producció on estàs desplegant. Per exemple: https://poweractionsprod.crm.dynamics.com.
   • Actualitza <APP_ID> amb l'ID d'aplicació (client) que trobis a la fulla App registrations del Microsoft Azure Portal seleccionant el registre que has creat anteriorment en aquest tutorial.
   • Actualitza <TENANT_ID> amb l'ID del Directori (inquilí) que trobis a la fulla App registrations del Microsoft Azure Portal seleccionant el registre que vas crear anteriorment en aquest tutorial.

5. Publiqueu els canvis. Trieu Inicia la publicació i afegiu un títol (opcional) i una descripció (opcional). A continuació, seleccioneu Publica el nou fitxer.

   

Provar el flux de treball de llançament a producció

Ara estàs preparat per provar l'últim flux de treball. Aquest flux de treball s'activa quan una nova versió es desplega en producció.

1. Ves a Releases.

   

2. Seleccioneu Esborrany d'una versió nova.

3. Afegiu una etiqueta de versió, un títol i trieu Publica la versió.

4. Seleccioneu Accions per veure el flux de treball en execució.

   

5. Trieu el flux de treball en execució per veure les accions mentre s'executen.

   

6. Espereu que es completi cada acció.

   

7. Un cop acabat el flux de treball, inicia sessió al teu entorn de producció i valida que la solució està desplegada com a solució gestionada.

Implementar l'actualització i revisar els canvis abans de la versió de producció

Prova el procés d'extrem a extrem i després mira com pots veure i validar els canvis en una aplicació abans de desplegar-la a producció.

1. Ves a la solució ALMLab del teu entorn de desenvolupament i selecciona Editar o selecciona el nom de visualització de la solució.

   

2. Seleccioneu i visualitzeu la taula Sol·licitud de temps lliure.

   

3. Selecciona + Afegeix columna i crea la nova columna tal com es mostra a la figura següent.

   

   Valors de camp actualitzats:**

   • Nom de visualització: Aprovat
   • Tipus de dades: Sí/No

4. Seleccioneu Fet.

5. Selecciona Taula de Desar.

6. Torna a la pestanya d'Accions dels teus repositoris de GitHub, selecciona Executar flux de treball i selecciona el botó Executar flux de treball.

   

7. Després de 5–10 segons, comença el flux de treball. Selecciona el flux de treball en execució per monitorar-ne el progrés.

   

   

8. Quan acabi el flux de treball, ves a la nova branca seleccionant Code i després Branches.

   

9. Selecciona la sucursal que has creat expandint la contribució i seleccionant Obre sol·licitud pull.

10. Afegeix un títol (opcional) i després selecciona Crea sol·licitud pull.

11. Després de les actualitzacions de contingut, selecciona la pestanya Fitxers modificats .

12. Tingueu en compte que els canvis a la solució es ressalten en verd per indicar que aquesta secció del fitxer s'ha afegit quan es compara amb el mateix fitxer a la branca principal.

13. Torna a la pestanya Conversa . Selecciona Pull requests i després selecciona la pull request que has creat abans.

14. A la pàgina de sol·licituds de tirada , selecciona Squash i fusiona per fusionar el fitxer de solució actualitzat amb la teva branca principal. Opcionalment, elimina això que ara està fusionat amb el principal.

    

15. Segueix els passos de la secció de Prova del flux de treball de la versió a producció per crear una nova versió i validar que la solució actualitzada està desplegada al teu entorn de producció.

Felicitats, has configurat amb èxit un flux de treball de CI/CD d'exemple utilitzant accions de GitHub!

Vegeu també

Automatitza el teu flux de treball des de la idea fins a la producció