Tutorial: Automatizarea implementării soluției utilizând GitHub Actions pentru Microsoft Power Platform

În acest tutorial, veți afla cum să:

  • Creați un depozit noy GitHub
  • Creați două fluxuri de lucru GitHub utilizând GitHub Actions pentru Microsoft Power Platform

Fluxurile de lucru vă pot exporta automat aplicația (ca soluție neadministrată) dintr-un mediu de dezvoltare, pot genera un artefact de construire (soluție gestionată) și pot implementa aplicația în mediul dvs. de producție. Acest tutorial utilizează fișierul Soluție ALMLab pe care le-ați construit și mediile pe care le-ați configurat în tutoriale anterioare.

Tutoriale conexe: Începeți, și Construiți o aplicație bazată pe modele.

Creați un cont de GitHub

  1. Accesați https://github.com și selectați Înregistrare sau Începeți o versiune de încercare gratuită (sau conectați-vă dacă aveți un cont existent).

    Creare cont

  2. După ce vă creați contul, creați un depozit selectând Creare depozit sau Nou.

    Creați un depozit

    Este posibil să vedeți următorul ecran de aterizare alternativ:

    Creați un nou depozit

  3. Creați noul depozit și denumiți-l poweractionslab. Asigurați-vă că selectați Adăugați un fișier README pentru a iniția depozitul și alegeți Creare depozit.

    Inițiază repo.

Crearea unui nou secret pentru autentificarea principală a serviciului

  1. Accesați depozitul și selectați Setări. Extindeți Secrete, apoi selectați Acțiuni.

  2. Pe pagina Secrete, denumiți secretul PowerPlatformSPN. Introduceți secretul clientului din înregistrarea aplicației pe care ați creat-o în Microsoft Entra în câmpul Valoare, apoi selectați Adăugare secret. Veți face referire la secretul clientului în fișierele YML care definesc fluxurile de lucru GitHub mai târziu în acest tutorial.

    Creați noul secret principal al serviciului

    Secretul clientului este acum stocat în siguranță ca secret GitHub.

Creați un flux de lucru pentru a exporta și despacheta fișierul soluției într-o ramură nouă

  1. Selectați Acțiuni, apoi selectați configurați singur un flux de lucru. Sau selectați Configurare în caseta Flux de lucru simplu de sub secțiunea sugerată pentru acest depozit .

    Configurați fluxul de lucru.

  2. Vedeți un nou fișier YAML cu un flux de lucru de bază pentru a vă ajuta să începeți lucrul cu acțiunile GitHub.

    Exemplu de fișier YML

  3. Ștergeți conținutul precreat, apoi lipiți conținutul din fișierul export-and-branch-solution-with-spn-auth.yml . Redenumiți fișierul în export-and-branch-solution.yml.

    Redenumiți și înlocuiți conținutul.

  4. Actualizați <ENVIRONMENTURL> cu adresa URL pentru mediul de dezvoltare de unde doriți să exportați soluția (de exemplu: https://poweractionsdev.crm.dynamics.com).

  5. Actualizați <APPID> și <TENANT ID> cu valorile dvs.

    • Dacă utilizați acreditări, lipiți fișierul export-and-branch-solution.yml în locul conținutului fișierului export-and-branch-solution-with-spn-auth.yml . Actualizați <USERNAME> cu numele de utilizator pe care îl utilizați pentru a vă conecta la mediu.

      Redenumiți și înlocuiți conținutul

    Sfat

    Dacă nu sunteți familiarizat cu GitHub Actions și doriți să aflați mai multe, consultați documentația oficială de la https://docs.github.com/en/actions.

  6. Acum sunteți gata să comiteți modificările. Selectați Începeți realizarea, tip Creați yml de export în câmpul de titlu, apoi adăugați o descriere (opțional). Apoi, selectați Realizați fișier nou.

    Începeți comiterea.

Felicitări, ați creat primul flux de lucru GitHub utilizând următoarele acțiuni:

  • Cine sunt eu: Asigură că vă puteți conecta cu succes la mediul din care doriți să exportați.
  • Exportați soluția: exportă fișierul soluției din mediul dvs. de dezvoltare.
  • Soluție de despachetare: Fișierul soluție pe care îl exportă serverul este un fișier comprimat (zip) cu fișiere de configurare consolidate. Aceste fișiere inițiale nu sunt potrivite pentru gestionarea codului sursă, deoarece acestea nu sunt structurate pentru a face posibil ca sistemele de gestionare a codului sursă să facă în mod corespunzător diferențe între fișiere și să captureze modificările pe care doriți să le comiteți la controlul sursă. Trebuie să despachetați fișierele soluție pentru a le face potrivite pentru stocarea și procesarea controlului sursă.
  • Soluție de ramură: creează o nouă ramură pentru a stoca soluția exportată.

Testați fluxul de lucru pentru export și despachetați

  1. Apoi, testați dacă rulează fluxul de lucru. Accesați Acțiuni, selectați Rulare flux de lucru și alegeți Rulare flux de lucru. Dacă utilizați un alt nume de soluție decât ALMLab, modificați valoarea aici, dar păstrați celelalte valori la fel.

    Rulați fluxul de lucru.

  2. După 5-10 secunde, fluxul de lucru începe. Puteți selecta fluxul de lucru care rulează pentru a monitoriza progresul.

    Faceți clic pentru a vedea fluxul de lucru.

    Selectați și vizualizați fluxul de lucru.

  3. După ce se termină fluxul de lucru, verificați dacă se creează o ramură nouă cu soluția despachetată în solutions/ALMLab folder. Accesați fila Cod și extindeți lista verticală cu ramuri.

  4. Selectați ramura creată de acțiune.

  5. Verificați dacă solutions/ALMLab folderul este creat în ramura nouă. Apoi creați o solicitare de extragere pentru a îmbina modificările în ramura principală. Selectați Contribuire și, în fișa mobilă , selectați Deschidere solicitare de extragere.

  6. Pe ecranul Deschideți o solicitare de extragere , adăugați un titlu și o descriere, dacă doriți, apoi selectați Creare solicitare de extragere.

  7. Ecranul se actualizează pentru a afișa noua solicitare de extragere. Atunci când creați solicitarea de extragere, primiți confirmarea că ramura nu are niciun conflict cu ramura principală. Această confirmare înseamnă că puteți îmbina automat modificările în ramura principală. Selectați Îmbinare solicitare de extragere , apoi selectați Confirmare îmbinare. Opțional, selectați ștergere ramură pentru a elimina ramura acum defunctă.

    Vizualizați ramuri

  8. Reveniți la ramura implicită (principală) și verificați dacă soluția este disponibilă acolo.

Creați un flux de lucru refolosibil pentru a genera un artefact de construcție și importați în producție

În această secțiune, creați un flux de lucru suplimentar care:

  • Creează un soluție gestionată și o publică ca un artefact GitHub
  • Importă artefactul de construcție în mediul de producție
  1. Accesați Acțiuni și selectați Flux de lucru nou.

    Creați un nou flux de lucru.

  2. Alegeți configurați singur un flux de lucru.

    Configurați un flux de lucru.

  3. Redenumiți titlul fluxului de lucru în release-solution-to-prod-with-inputs. Copiați conținutul din fișierul release-solution-to-prod-with-inputs.yml și lipiți-l în ecranul Editare fișier nou .

    Redenumiți și inserați codul.

  4. Realizați modificările. Alegeți Începeți să realizați și apoi adăugați un titlu și o descriere (opțional). Apoi, selectați Realizați fișier nou.

    Angajați modificări.

Apelați fluxul de lucru reutilizabil la evenimentul de lansare

În această secțiune, apelați fluxul de lucru reutilizabil pentru evenimentul de lansare.

  1. Accesați Acțiuni și selectați Flux de lucru nou.

    Creați un nou flux de lucru.

  2. Alegeți configurați singur un flux de lucru.

    Configurați un flux de lucru.

  3. Redenumiți titlul fluxului de lucru în release-action-call. Copiați conținutul din fișierul release-action-call.yml și lipiți-l în ecranul Editare fișier nou .

    Redenumiți și inserați codul.

  4. Actualizați următoarele variabile în noul fișier de flux de lucru:

    • Actualizați <BUILD_ENVIRONMENT> cu URL-ul pentru mediul de construire pe care îl utilizați pentru a genera soluția gestionată. De exemplu: https://poweractionsbuild.crm.dynamics.com.
    • Actualizați <PROD_ENVIRONMENT> cu URL-ul pentru mediul de producție pe care îl implementați. De exemplu: https://poweractionsprod.crm.dynamics.com.
    • Actualizați <APP_ID> cu ID-ul aplicației (client) pe care îl găsiți în lama de App registrations a Azure Portal Microsoft, selectând înregistrarea creată anterior în acest tutorial.
    • Actualizați <TENANT_ID> cu ID-ul directorului (entității găzduite) pe care îl găsiți în lama de App registrations microsoft Azure Portal, selectând înregistrarea pe care ați creat-o anterior în acest tutorial.
  5. Realizați modificările. Alegeți Începeți să realizați și apoi adăugați un titlu (opțional) și o descriere (opțional). Apoi, selectați Realizați fișier nou.

    Angajați modificări.

Testați fluxul de lucru de lansare la producție

Acum sunteți gata să testați ultimul flux de lucru. Acest flux de lucru se declanșează atunci când este implementată o nouă versiune pentru producție.

  1. Accesați Lansări.

    Navigați la versiuni.

  2. Selectați Proiectează o nouă versiune.

  3. Adăugați o etichetă de lansare, un titlu și alegeți Publicați versiunea.

  4. Selectați Acțiuni pentru a vizualiza fluxul de lucru care rulează.

    Selectați pentru a vizualiza fluxul de lucru.

  5. Alegeți fluxul de lucru care rulează pentru a vizualiza acțiunile pe măsură ce rulează.

    Vizualizați fluxul de lucru.

  6. Așteptați finalizarea fiecărei acțiuni.

    Vizualizați ramura.

  7. După ce fluxul de lucru se termină, conectați-vă la mediul de producție și validați că soluția este implementată ca soluție gestionată.

Implementați actualizarea și examinați modificările înainte de lansarea producției

Testați procesul final, apoi vedeți cum puteți să vizualizați și să validați modificările unei aplicații înainte de a o implementa în producție.

  1. Accesați soluția ALMLab în mediul dvs. de dezvoltare și selectați Editare sau selectați numele afișat al soluției.

    Editați soluția.

  2. Selectați și vizualizați tabelul Cerere de pauză.

    Vizualizați tabelul.

  3. Selectați + Adăugare coloană și creați noua coloană așa cum se arată în ilustrația următoare.

    Adăugare coloană.

    Valorile câmpurilor actualizate:**

    • Nume afișat: Aprobat
    • Tip de date: Da/Nu
  4. Selectați Terminat.

  5. Selectează tabelul de salvare. Adăugare coloană.

  6. Reveniți la fila Acțiuni GitHub depozite, selectați Rulare flux de lucru și selectați butonul Rulare flux de lucru.

    Rulați fluxul de lucru.

  7. După 5-10 secunde, fluxul de lucru începe. Selectați fluxul de lucru în rulare pentru a-i monitoriza progresul.

    Selectați fluxul de lucru.

    Vizualizați fluxul de lucru.

  8. După ce fluxul de lucru se termină, accesați ramura nouă selectând Cod , apoi Ramuri.

    Navigați la ramură.

  9. Selectați ramura pe care ați creat-o prin extinderea contribuirii și selectând Deschidere solicitare de extragere.

  10. Adăugați un titlu (opțional), apoi selectați Creare solicitare de extragere.

  11. După ce se actualizează conținutul, selectați fila Fișiere modificate .

  12. Observați că modificările soluției sunt evidențiate în verde pentru a indica faptul că această secțiune a fișierului a fost adăugată în comparație cu același fișier din ramura principală.

  13. Reveniți la fila Conversație . Selectați Solicitări de tragere , apoi selectați solicitarea de extragere pe care ați creat-o anterior.

  14. Pe pagina Solicitare de extragere , selectați Squash și îmbinați pentru a îmbina fișierul soluție actualizat în ramura principală. Opțional, ștergeți care este acum îmbinat în principal.

    Deschideți cererea de extragere pentru o nouă ramură, vizualizați modificările și îmbinați cu ramura implicită

  15. Urmați pașii din secțiunea Testarea lansării fluxului de lucru de producție pentru a crea o versiune nouă și a valida faptul că soluția actualizată este implementată în mediul de producție.

Felicitări, ați configurat cu succes un flux de lucru CI/CD eșantion utilizând acțiuni de GitHub!

Vedeți și

Automatizați-vă fluxul de lucru de la idee la producție