Notă
Accesul la această pagină necesită autorizare. Puteți încerca să vă conectați sau să modificați directoarele.
Accesul la această pagină necesită autorizare. Puteți încerca să modificați directoarele.
Î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
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).
După ce vă creați contul, creați un depozit selectând Creare depozit sau Nou.
Este posibil să vedeți următorul ecran de aterizare alternativ:
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.
Crearea unui nou secret pentru autentificarea principală a serviciului
Accesați depozitul și selectați Setări. Extindeți Secrete, apoi selectați Acțiuni.
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.
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ă
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 .
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.
Ș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.
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).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.
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.
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.
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
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.
După 5-10 secunde, fluxul de lucru începe. Puteți selecta fluxul de lucru care rulează pentru a monitoriza progresul.
După ce se termină fluxul de lucru, verificați dacă se creează o ramură nouă cu soluția despachetată în
solutions/ALMLabfolder. Accesați fila Cod și extindeți lista verticală cu ramuri.Selectați ramura creată de acțiune.
Verificați dacă
solutions/ALMLabfolderul 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.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.
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ă.
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
Accesați Acțiuni și selectați Flux de lucru nou.
Alegeți configurați singur un flux de lucru.
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 .
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.
Apelați fluxul de lucru reutilizabil la evenimentul de lansare
În această secțiune, apelați fluxul de lucru reutilizabil pentru evenimentul de lansare.
Accesați Acțiuni și selectați Flux de lucru nou.
Alegeți configurați singur un flux de lucru.
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 .
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.
- Actualizați
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.
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.
Accesați Lansări.
Selectați Proiectează o nouă versiune.
Adăugați o etichetă de lansare, un titlu și alegeți Publicați versiunea.
Selectați Acțiuni pentru a vizualiza fluxul de lucru care rulează.
Alegeți fluxul de lucru care rulează pentru a vizualiza acțiunile pe măsură ce rulează.
Așteptați finalizarea fiecărei acțiuni.
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.
Accesați soluția ALMLab în mediul dvs. de dezvoltare și selectați Editare sau selectați numele afișat al soluției.
Selectați și vizualizați tabelul Cerere de pauză.
Selectați + Adăugare coloană și creați noua coloană așa cum se arată în ilustrația următoare.
Valorile câmpurilor actualizate:**
- Nume afișat: Aprobat
- Tip de date: Da/Nu
Selectați Terminat.
Selectează tabelul de salvare.
Reveniți la fila Acțiuni GitHub depozite, selectați Rulare flux de lucru și selectați butonul Rulare flux de lucru.
După 5-10 secunde, fluxul de lucru începe. Selectați fluxul de lucru în rulare pentru a-i monitoriza progresul.
După ce fluxul de lucru se termină, accesați ramura nouă selectând Cod , apoi Ramuri.
Selectați ramura pe care ați creat-o prin extinderea contribuirii și selectând Deschidere solicitare de extragere.
Adăugați un titlu (opțional), apoi selectați Creare solicitare de extragere.
După ce se actualizează conținutul, selectați fila Fișiere modificate .
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ă.
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.
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.
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!