Configura l'accelerador ALM manualment (desactivat)

Nota

L'ALM Accelerator està obsolet i no s'afegeixen noves funcions. Els problemes ja no es revisen ni s'aborden.

Si identifiques un possible problema de seguretat, si us plau, informa'l al Microsoft Security Response Center.

Utilitza Pipelines a Power Platform per portar capacitats d'automatització ALM a Power Platform i als serveis Dynamics 365. Els pipelines es poden utilitzar amb integració de codi font o extendut per integrar-se amb Azure DevOps, GitHub i altres proveïdors.

Podeu configurar els components mitjançant ALM Accelerator for Power Platform l'aplicació d'administració adjunta o manualment. Aquest article us guia a través de la configuració manual de l'aplicació i s'estructura en set seccions:

Requisits previs

Abans d'instal·lar-lo ALM Accelerator for Power Platform, assegureu-vos que heu complert els requisits previs següents.

  • L'ALM Accelerator s'ha d'instal·lar en un entorn Power Platform que tingui una base de dades de Microsoft Dataverse. Tots els entorns que utilitzeu l'ALM Accelerator per implementar solucions també requereixen una base de Dataverse dades.

    Nota

    L'accelerador ALM no és compatible amb Dataverse for Teams. Tant l'aplicació ALM Accelerator com els pipelines associats suposen que utilitzeu la versió completa de Dataverse en tots els entorns.

    Us recomanem que instal·leu l'accelerador ALM al mateix entorn que altres solucions del kit d'inici de CoE. Obteniu més informació sobre com determinar la millor estratègia per a la vostra organització:

  • L'ALM Accelerator utilitza Azure DevOps per al control de versions i desplegaments. Si no tens una organització Azure DevOps, registra't gratuïtament per a fins a cinc usuaris al lloc Azure DevOps.

  • Per completar els passos d'aquesta secció, necessiteu els següents usuaris i permisos a Azure, Azure DevOps i Power Platform:

    • Un usuari amb llicència d'Azure amb permisos per crear i visualitzar grups de Microsoft Entra, crear registres d'aplicacions i concedir el consentiment de l'administrador per als registres d'aplicacions a Microsoft Entra ID
    • Un usuari llicenciat d'Azure DevOps amb permisos per crear i gestionar pipelines, connexions de serveis, repositoris i extensions
    • Un usuari amb llicència Power Platform amb permisos per crear usuaris de l'aplicació i atorgar-los permisos administratius

  • Els connectors següents han d'estar disponibles per utilitzar-los junts a l'entorn on s'importa l'accelerador ALM:

  • Instal·leu el Creator Kit a l'entorn on instal·leu l'ALM Accelerator.

Configuració fonamental

Els passos següents són generals per a la funcionalitat de l'ALM Accelerator i no són específics de cap projecte o solució.

Crea un registre d'aplicació al teu entorn Microsoft Entra

Crea un registre d'aplicació per a l'ALM Accelerator per atorgar a l'aplicació i als canals associats els permisos necessaris per realitzar operacions a Azure DevOps i Power Apps o Dataverse. Només cal que ho facis una vegada.

Els passos següents mostren com crear un registre d'aplicació única amb permisos tant per a Dataverse com per a Azure DevOps. Tanmateix, és possible que vulgueu crear registres d'aplicacions separats per dividir les responsabilitats. Hauries de tenir en compte com els registres d'aplicacions per separat afecten tant el manteniment com la seguretat abans de decidir una estratègia de registre d'aplicacions. ...

Crea el registre de l'aplicació

  1. Inicieu la sessió al portal d'Azure.

  2. Selecciona Microsoft Entra ID>App registrations.

  3. Seleccioneu + Registre nou i, a continuació, doneu un nom al registre, com ara ALMAcceleratorServicePrincipal.

  4. Deixeu totes les altres opcions amb els valors predeterminats i seleccioneu Registra.

Afegir permisos al registre de l'aplicació

  1. Al panell lateral esquerre, seleccioneu Permisos de l'API.

  2. Seleccioneu + Afegeix un permís.

  3. Selecciona Dynamics CRM, i després selecciona Permisos delegats i user_impersonation.

  4. Selecciona Afegeix permisos per afegir el permís de l'API Dynamics CRM user_impersonation al registre de l'aplicació.

  5. Seleccioneu + Afegeix un permís de nou.

  6. Seleccioneu la pestanya *API que utilitza la meva organització*. Cerqueu i seleccioneu *-Advisor* i, a continuació, seleccioneu *Permisos delegats* i *Analysis.All* (no cal el consentiment de l'administrador). PowerApps

    Aquest permís és necessari per executar anàlisis estàtiques a través del comprovador d'aplicacions.

  7. Seleccioneu Afegeix permisos per afegir el permís PowerApps-Advisor API Analysis.All al registre de l'aplicació.

  8. Seleccioneu + Afegeix un permís de nou.

  9. A la pestanya Microsoft APIs o a la pestanya APIs que utilitza la meva organització, selecciona Azure DevOps i després selecciona Permisos delegats i user_impersonation.

    Aquest permís és necessari per connectar-se a Azure DevOps a través del connector personalitzat de l'aplicació ALM Accelerator.

  10. Si has afegit el permís Azure DevOps des de la pestanya APIs que utilitza la meva organització, copia l'ID Application (client) per utilitzar-lo més endavant en aquest procediment.

    L'utilitzareu com a *ID de l'aplicació (client) de DevOps*, que és diferent de l'*ID de l'aplicació (client)* que copiareu més endavant en aquest procediment.

    Captura de pantalla de la finestra Sol·licita permisos d'API, amb la pestanya API que utilitza la meva organització i l'ID de l'aplicació (client) ressaltats.

    Si no trobes el permís de Azure DevOps a la pestanya APIs que utilitza la meva organització, segueix aquests passos per obtenir l'ID d'aplicació DevOps (client):

    1. Obriu una finestra privada del navegador i aneu a https://dev.azure.com/<your devops organization>/_apis.
    2. A la pàgina d'inici de sessió, copieu el valor del paràmetre client_id de l'URL.

    Captura de pantalla d'una pàgina d'inici de sessió d'una organització Azure DevOps, amb el paràmetre client_id a l'URL ressaltat.

  11. Selecciona Afegeix permisos per afegir el permís de l'API Azure DevOps user_impersonation al registre de l'aplicació.

  12. Seleccioneu Atorga el consentiment de l'administrador per al <teu inquilí>.

Configurar l'URI secreta del client i redirigir-la

  1. Al panell lateral esquerre, seleccioneu Certificats i secrets.

  2. Seleccioneu + Secret del client nou.

  3. Seleccioneu una data de caducitat i, a continuació, seleccioneu Afegeix.

  4. Copieu el valor secret del client Value per utilitzar-lo més tard. Aquest és l'únic moment en què podeu copiar el valor. Assegureu-vos de fer-ho abans de sortir de la pàgina.

  5. Al panell lateral esquerre, seleccioneu Visió general.

  6. Copieu l'ID de l'aplicació (client) i l'ID del directori (inquilí) .

  7. Seleccioneu Configura.

Dona permís de Power App Management al registre de la teva aplicació

Atorgueu permisos de *Power App Management* al registre de la vostra aplicació perquè els pipelines puguin dur a terme les accions necessàries als vostres entorns. ... Per fer-ho, executa el següent cmdlet PowerShell com a usuari interactiu que tingui privilegis administratius de Power Apps. Només cal que executeu aquesta ordre una vegada, després de crear el registre de l'aplicació.

Important

El cmdlet següent de PowerShell atorga al registre de l'aplicació permisos elevats com ara Power Platform Admin. És possible que les polítiques de seguretat de la vostra organització no permetin aquest tipus de permisos. Assegureu-vos que estiguin permesos abans de continuar. Si no estan permeses, certes capacitats no funcionaran a les pipelines de l'ALM Accelerator.

Install-Module -Name Microsoft.PowerApps.Administration.PowerShell
Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobber
New-PowerAppManagementApp -ApplicationId <the Application (client) ID you copied when you created the app registration>

Install Azure DevOps extensions

L'ALM Accelerator utilitza diverses extensions d'Azure DevOps, incloent-hi algunes extensions de tercers disponibles al mercat d'Azure DevOps. El lloc web de cada extensió de tercers i un enllaç al seu codi font es proporcionen a les instruccions següents. Apreneu a avaluar un editor d'extensions de Marketplace.

  1. Inicia sessió a Azure DevOps.

  2. Seleccioneu Configuració de l'organització.

  3. Seleccioneu Extensions generals>.

  4. Cerca i instal·la les extensions següents:

Clona les canals YAML de GitHub a la teva instància d'Azure DevOps

  1. Aneu a https://aka.ms/coe-alm-accelerator-templates-latest-release i copieu l'URL de la versió més recent.

  2. Inicia sessió a Azure DevOps.

  3. Crea un projecte o selecciona'n un d'existent.

  4. Selecciona Repos i després selecciona Import repository a la llista de repositoris.

  5. Enganxeu l'URL que heu copiat al pas 1 com a URL de clonació i, a continuació, seleccioneu Importa.

  6. Confirmeu que la branca predeterminada del repositori és main. Selecciona Repos i Branches i assegura't que la branca main estigui etiquetada com a predeterminada.

    Si no ho és, seleccioneu els tres punts verticals (⋮) corresponents a la branca principal i, al menú Més opcions , seleccioneu Defineix com a branca per defecte.

    Nota

    Aquest repositori és on s'executen les plantilles de la cadena de solucions i les cadenes d'exportació/importació. Més endavant, quan creeu les pipelines per a les vostres solucions, és possible que hàgiu de fer referència a aquest projecte i repositori específics si decidiu utilitzar un repositori diferent per al control de codi font de les vostres solucions.

Crear pipelines per a la importació, supressió i exportació de solucions

Crea pipelines d'importació, eliminació i exportació basats en el YAML al repositori d'Azure DevOps. Aquests pipelines s'executen quan utilitzeu l'aplicació per fer un commit d'una solució al Git, importar-ne una o suprimir-ne una.

Nota

Si espereu que totes les vostres exportacions realitzin les mateixes accions independentment de la solució per a la qual s'executa el pipeline, podeu crear un únic pipeline d'exportació tal com es descriu en aquesta secció. Tanmateix, és possible que necessiteu accions d'exportació diferents segons la solució. En aquest cas, podeu afegir el nom de la solució al pipeline export-solution-to-git, com ara export-solution-to-git-SampleSolution, perquè l'aplicació executi els vostres pipelines de solucions específics quan realitzeu les accions a l'aplicació.

La taula següent mostra la correspondència entre el fitxer YAML del repositori i el pipeline que l'acompanya.

Fitxer YAML Nom del pipeline
export-solution-to-git.yml export-solution-to-git
import-unmanaged-to-dev-environment.yml import-unmanaged-to-dev-environment
delete-unmanaged-solution-and-components.yml delete-unmanaged-solution-and-components

  1. A Azure DevOps, ves a Pipelines>Crea una nova Pipeline.

  2. Selecciona Azure Repos Git per al teu repositori de codi, i després apunta al repositori Azure DevOps que has creat i que has sembrat amb les plantilles de pipeline en els passos anteriors.

  3. A la pàgina Configura la teva pipeline, selecciona Existing Azure Pipelines YAML file i apunta a /Pipelines/export-solution-to-git.yml, /Pipelines/import-unmanaged-to-dev-environment.yml o /Pipelines/delete-unmanaged-solution-and-components.yml.

  4. Seleccioneu Continua i, a continuació, seleccioneu Desa.

  5. Seleccioneu el menú Més (…) al costat de Executa la canonada i, a continuació, seleccioneu Canvia el nom/Mou.

  6. Canvieu el nom del pipeline a export-solution-to-git, import-unmanaged-to-dev-environment o delete-unmanaged-solution-and-components, segons correspongui.

  7. Seleccioneu Desa.

Crear variables de pipeline d'exportació (opcional)

Podeu definir variables de canalització al canal export-solution-to-git per controlar quina informació es conserva al control de codi font. Per aplicar aquests paràmetres globalment, definiu les variables al vostre pipeline export-solution-to-git. Per aplicar la configuració a solucions específiques en l'exportació, creeu un pipeline d'exportació per a la vostra solució tal com es descriu a la nota de la secció anterior i definiu les variables en aquest pipeline.

Per assegurar-vos que els valors actuals de les variables d'entorn no es comprometin mai al control de codi font durant el procés d'exportació, creeu la variable DoNotExportCurrentEnvironmentVariableValues al vostre pipeline export-solution-to-git i definiu-ne el valor a True.

Important

Es recomana aquesta variable de canalització per poder utilitzar la funcionalitat de configuració de la implementació a l'ACcelerador d'ALM.

Per assegurar-vos que els valors de variables d'entorn predeterminades específiques s'estableixen durant l'exportació d'una solució, creeu la variable VerifyDefaultEnvironmentVariableValues al vostre pipeline export-solution-to-git i definiu-ne el valor a True. Definiu els valors de les variables d'entorn predeterminades a customDeploymentSettings.json tal com es descriu a la guia de configuració de la implementació.

  1. A Azure DevOps, selecciona Pipelines>Library>Crea un nou Grup de Variables.

  2. Anomeneu la nova variable group alm-accelerator-variable-group, exactament com s'indica aquí.

    Les canonades fan referència a aquest grup de variables específic, per la qual cosa s'ha de nomenar exactament com es mostra. Si decidiu utilitzar una convenció de nomenclatura diferent per al vostre grup de variables, heu de modificar parts de les canonades perquè facin referència al nom que feu servir.

  3. Afegiu les variables següents al grup de variables:

    Nom Descripció Valor
    AAdHost L'endpoint d'autorització de Microsoft Entra Per a núvols públics, feu servir login.microsoftonline.com. Per a núvols governamentals, feu servir l'URL d'autorització adequada.
    ProcessCanvasApps Si les aplicacions de llenç es desempaquetan durant l'exportació o es compacten durant les compilacions Si és Fals, les aplicacions de llenç no es desempaquetaran durant l'exportació ni es compactaran durant les compilacions. La funcionalitat de desempaquetament i empaquetament de l'aplicació Canvas està en versió prèvia i no es recomana el seu ús en entorns de producció en aquest moment. ... Tanmateix, no podeu veure el codi font del llenç al control de codi font tret que definiu aquesta variable com a True.

  4. (Opcional) Si feu servir l'automatització de proves de Canvas Studio a les vostres pipelines, afegiu les variables següents al grup de variables:

    Nom Valor
    TestAutomationLoginMethod CloudIdentity
    TestAutomationMakerPortalUrl L'URL del portal Power Apps maker, normalment *https://make.powerapps.com*
    TestAutomationUsername El compte d'usuari utilitzat per executar les proves automatitzades
    TestAutomationPassword La contrasenya del compte d'usuari utilitzat per executar les proves automatitzades

  5. (Opcional) Per defecte, les variables globals estan restringides i cal configurar l'accés per a cada canalització. Podeu simplificar això i permetre l'accés a qualsevol canalització. A Grup de variables (Canals>Biblioteca>alm-accelerator-variable-group), seleccioneu Permisos de canals al menú superior, seleccioneu (…) i, a continuació, seleccioneu Accés obert.

Establir permisos per al servei de compilació de projectes

Important

Azure DevOps conté diversos comptes de "Build Service", i pot ser confús si segueixes els passos d'aquesta secció. Pareu atenció als noms i al format especificats als passos 3 i 5. Potser haureu de cercar un compte concret si no es mostra a la llista inicial.

  1. A Azure DevOps, selecciona configuració del projecte.

  2. Seleccioneu Dipòsits>Seguretat.

  3. A Usuaris, cerqueu i seleccioneu Servei de creació de col·leccions de projectes (Nom de la vostra organització).

    Nota

    És possible que no vegeu el *Nom de la vostra organització* després de l'usuari del *Servei de compilació de col·leccions de projectes*. Pot ser només un identificador únic. En aquest cas, utilitzeu la funció de cerca per trobar l'usuari i, a continuació, seleccioneu-lo.

  4. Establiu els permisos següents per a l'usuari del servei de compilació:

    Permís Valor
    Col·labora Permet
    Col·laborar amb sol·licituds d'extracció Permet
    Crear una branca Permet
    Editar les normes Permet

  5. A Usuaris, cerqueu i seleccioneu Nom del vostre projecte Servei de compilació (Nom de la vostra organització).

  6. Establiu els mateixos valors que al pas 4.

  7. Seleccioneu Canalitzacions, seleccioneu els tres punts (…) a la cantonada superior dreta i, a continuació, seleccioneu Gestiona la seguretat.

  8. Establiu els permisos següents per a l'usuari Nom del vostre projecte Servei de compilació (Nom de la vostra organització) :

    Permís Valor
    Editar el pipeline de creació Permet
    Editar la qualitat de creació Permet
    Administrar la cua de creació Permet
    Substituir la validació de comprovació de la compilació Permet
    Actualitzar la informació de la compilació Permet
    Veure el pipeline de compilacions Permet
    Visualitzar les compilacions Permet

  9. Seleccioneu Configuració del projecte>Grups d'agents, seleccioneu Seguretat i, a continuació, seleccioneu Afegeix.

  10. Cerqueu i seleccioneu Nom del vostre projecte Servei de compilació (Nom de la vostra organització).

  11. Estableix el Rol com a Lector.

  12. Seleccioneu Afegeix.

  13. (Opcional) Per defecte, els permisos de la canalització per a cada repositori estan restringits i cal configurar-los individualment. Podeu simplificar això i permetre l'accés a qualsevol canalització. A Configuració del projecte>Repositoris, seleccioneu cada repositori per torns. Seleccioneu Seguretat al menú superior. Cerqueu el bloc Permisos de la canonada , seleccioneu (…) i, a continuació, seleccioneu Accés obert.

Configuració del projecte de desenvolupament

La secció següent us guiarà pels passos necessaris per configurar cadascun dels projectes de desenvolupament als quals doneu suport. En aquest context, un projecte de desenvolupament comprèn la infraestructura i la configuració que admet una gestió del cicle de vida de les aplicacions (ALM) saludable, inclosa la configuració de l'entorn que admet el procés ALM en si. Dataverse

Crea connexions de servei perquè Azure DevOps accedeixin a Power Platform

Cada entorn Dataverse — desenvolupament, validació, prova i producció — ha de tenir una connexió de servei Power Platform a Azure DevOps. Seguiu els passos següents per a cadascun dels vostres entorns.

Nota

Els usuaris de l'aplicació ALM Accelerator només veuen entorns en què tenen un rol d'usuari o d'administrador a la connexió de servei a Azure DevOps. Si treballen en entorns de desenvolupament personal, els creadors han de tenir un rol d'usuari o administrador a la connexió de servei per al seu entorn de desenvolupament personal. Les connexions de serveis d'entorn de validació, prova i producció, com ara el servei de compilació, només necessiten permisos concedits a les pipelines.

  1. Inicia sessió a Azure DevOps i després selecciona el teu projecte.

  2. Seleccioneu Configuració del projecte>Connexions de servei i, a continuació, seleccioneu Crea una connexió de servei.

  3. Cerqueu i seleccioneu el tipus de connexió de servei. Power Platform

  4. Seleccioneu Següent.

  5. Per a URL del servidor, introduïu l'URL de l'entorn; per exemple, https://myorg.crm.dynamics.com/.

    Important

    Heu d'incloure la barra inclinada (/) final a l'URL; és a dir, després de .com en aquest exemple.

  6. Per a Nom de la connexió del servei, introduïu la mateixa URL que heu introduït al pas 4, inclosa la barra inclinada d'entrenament (/).

  7. Introdueix l'ID de Inquiliner, Application (client) i Client Secret que vas copiar de Microsoft Entra quan vas crear el registre de l'aplicació.

  8. Seleccioneu Atorga permisos d'accés a totes les canonades.

  9. Seleccioneu Desa.

Les connexions de servei han de proporcionar permisos d'usuari a tots els usuaris en tots els entorns als quals els usuaris necessiten poder accedir des de l'aplicació (per exemple, entorns de fabricants).

  1. A la llista Connexions de servei , seleccioneu la connexió de servei que voleu compartir amb els usuaris.

  2. Seleccioneu Més (…) a la cantonada superior dreta i, a continuació, seleccioneu Seguretat.

  3. A la llista Grup o Usuari , seleccioneu l'usuari o grup al qual voleu proporcionar permisos d'usuari.

  4. Seleccioneu Usuari, seleccioneu una Funció i, a continuació, seleccioneu Afegeix.

Repetiu els passos d'aquesta secció per a cadascun dels vostres entorns de desenvolupament, validació, prova i producció.

Establir permisos perquè el servei de compilació del projecte utilitzi les connexions del servei

  1. A Azure DevOps, selecciona configuració del projecte>Connexions de servei.

  2. Seleccioneu (…) a la cantonada superior dreta, seleccioneu Seguretat i, a continuació, seleccioneu Afegeix.

  3. Cerqueu i seleccioneu Nom del vostre projecte Servei de compilació (Nom de la vostra organització).

  4. Definiu el Rol com a Administrador i, a continuació, seleccioneu Afegeix.

Crear un usuari de l'aplicació als teus Dataverse entorns

Crea un usuari d'aplicació als teus entorns per permetre que les canonades es connectin a Dataverse. Feu això en cada entorn on teniu previst utilitzar l'ALM Accelerator per implementar-lo.

  1. Inicieu la sessió al Centre d'administració del Power Platform.

  2. Seleccioneu el vostre entorn de desenvolupament i, a continuació, seleccioneu Configuració.

  3. Seleccioneu Usuaris i permisos>Usuaris d'aplicació.

  4. Seleccioneu + Nou usuari de l'aplicació.

  5. Seleccioneu + Afegeix una aplicació, seleccioneu el registre d'aplicació que heu creat anteriorment i, a continuació, seleccioneu Afegeix.

  6. Seleccioneu la Unitat de negoci.

  7. Seleccioneu la icona de llapis a la dreta de Rols de seguretat i, a continuació, seleccioneu els rols de seguretat per a l'usuari de l'aplicació.

    Us recomanem que doneu a l'usuari de l'aplicació privilegis de rol de seguretat d'administrador del sistema, de manera que l'usuari pugui realitzar les funcions necessàries a cada entorn.

  8. Seleccioneu Crea.

Repetiu aquests passos als vostres entorns de validació, prova i producció.

Configuració de la solució

Quan creeu una solució a Dataverse, heu de crear canalitzacions específicament per a aquesta solució. Els següents exemples de pipelines s'inclouen al directori Pipelines del repositori coe-alm-templates :

Els pipelines d'exemple proporcionen flexibilitat per a les organitzacions per emmagatzemar les seves plantilles de pipeline en un projecte o dipòsit diferent del YAML de pipeline de la solució específica. Seguiu els passos d'aquesta secció per configurar el pipeline de la solució. Repetiu aquests passos per a cada solució per a la qual utilitzeu l'ALM Accelerator per al control de codi font.

Important

El YAML per al vostre pipeline de solucions sempre s'emmagatzema al mateix repositori que feu servir per al control de codi font de la vostra solució. Tanmateix, les plantilles de la canonada, és a dir, la carpeta Pipeline\Templates, poden existir al mateix repositori que el YAML de la canonada de solucions o en un repositori o projecte separat.

Crear la compilació i els pipelines d'implementació de la solució

Els pipelines de solució s'utilitzen per compilar i implementar les solucions amb controlades d'origen als entorns de l'inquilí. Els exemples de pipelines assumeixen que només utilitzeu tres entorns: validació, prova i producció. Tanmateix, podeu crear tantes pipelines de solucions com calgui en funció de l'estratègia d'entorn de la vostra organització.

Les pipelines de desplegament d'exemple s'activen per canvis en una branca (és a dir, prova i producció) o com a part d'una política de branca a Azure DevOps (és a dir, validació). Més informació sobre com definir polítiques de branca per a la validació de sol·licituds d'extracció. També podeu executar pipelines manualment, sense un activador.

Segueix els passos d'aquesta secció per crear canals de desplegament a partir del canal de mostra YAML. La taula següent descriu la configuració de la canonada.

Important

El nom del pipeline ha de ser exactament com es mostra a la taula següent, amb el nom de la vostra solució en lloc de MyNewSolution.

Nom del fitxer YAML del pipeline Nom del pipeline Norma de branca habilitada Necessari
build-deploy-validation-LaMevaNovaSolució.yml desplegament-validació-LaMevaNovaSolució Sí Sí
build-deploy-test-LaMevaNovaSolució.yml deploy-test-MyNewSolution No Sí
build-deploy-prod-LaMevaNovaSolució.yml deploy-prod-LaMevaNovaSolució No No (Aneu a la secció següent)

Nota

Els passos següents creen pipelines de compilació i desplegament per als entorns de validació, prova i producció. Tanmateix, és possible que vulgueu compilar i implementar per a la validació i les proves i, a continuació, implementar els artefactes de la compilació de prova a la producció. Si aquest és el cas, seguiu els passos d'aquesta secció només per als vostres entorns de validació i prova. A continuació, aneu a Crear el pipeline de desplegament de la solució per configurar el pipeline de llançament.

Crea el fitxer de la canonada

  1. A Azure DevOps, ves al repositori que conté la carpeta pipelines que has compromès, i selecciona la carpeta Pipelines.

  2. Obriu una de les tres pipelines de desplegament d'exemple i copieu el YAML per utilitzar-lo a la nova pipeline.

  3. Anoteu el nom del dipòsit per utilitzar-lo al pipeline.

  4. Aneu al dipòsit que voleu utilitzar per al control d'origen de la solució.

  5. Crea una branca basada en la teva branca predeterminada i anomena-la amb el nom de la teva solució; per exemple, LaMevaNovaSolució.

    Aquesta branca esdevé la branca de la següent versió (v-next) de la vostra solució. Tot el treball de desenvolupament s'ha de ramificar des d'aquesta branca a la branca de treball personal d'un desenvolupador i després fusionar-lo amb la branca v-next per passar a la validació i les proves. Més endavant, quan una versió estigui a punt, la branca v-next es pot combinar amb la branca principal o per defecte.

  6. Seleccioneu Crea al menú superior i, a continuació, seleccioneu Carpeta.

  7. Doneu a la nova carpeta el mateix nom que la vostra solució.

  8. Doneu un nom al nou fitxer YAML del pipeline, com ara build-deploy-validation-SampleSolution.yml, build-deploy-test-SampleSolution.yml o build-deploy-prod-SampleSolution.yml.

  9. Seleccioneu Crea.

Actualitza i desa el fitxer

  1. Enganxeu el YAML que heu copiat al pas 2 de la secció anterior al nou fitxer de pipeline.

  2. Canvieu els valors següents al nou pipeline YAML:

    • Canvieu el nom>dels>repositoris pel nom del repositori que conté les plantilles del pipeline.

      En aquest exemple, el repositori s'anomena coe-alm-accelerator-templates i existeix al mateix projecte que el repositori MyNewSolution . Si el teu repositori de plantilles està en un projecte de Azure DevOps diferent, utilitza el format NomProjecte/NomReposo. També podeu especificar una branca per on resideixen les vostres plantilles utilitzant el paràmetre ref si cal.

    • Canvieu qualsevol valor que faci referència a SampleSolutionName pel nom únic de la vostra solució; per exemple, MyNewSolution.

  3. Per desar els canvis, seleccioneu Confirma.

  4. A Azure DevOps, ves a Pipelines i després selecciona Crea una nova pipeline.

  5. Selecciona Azure Repos Git per al teu repositori de codi.

  6. Seleccioneu el dipòsit de DevOps, que conté el YAML de pipeline d'implementació.

  7. A la pàgina Configura el teu pipeline, selecciona Existing Azure Pipelines YAML file, apunta al fitxer YAML del teu repositori que has creat abans, i després selecciona Continua.

  8. Seleccioneu Desa, seleccioneu (…) al costat de Executa la canonada i, a continuació, seleccioneu Canvia el nom/Mou.

  9. Canvieu el nom del pipeline a deploy-validation-MyNewSolution, deploy-test-MyNewSolution o deploy-prod-MyNewSolution, on MyNewSolution és el nom de la vostra solució.

  10. Seleccioneu Desa.

  11. Si el vostre nou pipeline no s'ha creat a la branca predeterminada del repositori: seleccioneu Edita al pipeline. Seleccioneu (…) a la cantonada superior dreta i, a continuació, seleccioneu Disparadors. Seleccioneu la pestanya YAMLS i, a continuació, seleccioneu Obtén fonts. Canvieu la branca predeterminada per a les compilacions manuals i programades perquè apunti a la branca de la vostra solució. Més informació sobre com configurar els activadors de la canonada.

  12. Repetiu els passos anteriors per crear una canonada de desplegament per a cadascun dels vostres entorns, fent referència a la canonada de desplegament d'exemple YAML del repositori coe-alm-accelerator-templates (deploy-validation-SampleSolution.yml, deploy-test-SampleSolution.yml i deploy-prod-SampleSolution.yml).

  13. Seleccioneu Desa i posa a la cua i, a continuació, Desa.

Crear el pipeline d'implementació de la solució (opcional)

Com s'ha esmentat anteriorment, els passos de la secció anterior creen pipelines que es compilen i es despleguen per a entorns de validació, prova i producció. Tanmateix, podeu crear un canal de desplegament de solucions separat si voleu compilar i desplegar només per a la validació i les proves i, a continuació, desplegar els artefactes de la compilació de prova a la producció.

Segueix els passos d'aquesta secció per crear un pipeline de desplegament de solucions a partir del pipeline de mostra YAML. La taula següent descriu la configuració de la canonada.

Important

El nom del pipeline ha de ser exactament com es mostra a la taula següent, amb el nom de la vostra solució en lloc de MyNewSolution.

Nom del fitxer YAML del pipeline Nom del pipeline Norma de branca habilitada
deploy-prod-LaMevaNovaSolució.yml deploy-prod-LaMevaNovaSolució No

  1. En Azure DevOps, ves al repositori que conté la carpeta pipelines que has compromès i selecciona la carpeta Pipelines.

  2. Obriu el canal de desplegament d'exemple deploy-prod-pipelineartifact-SampleSolution.yml i copieu el YAML per utilitzar-lo al vostre nou canal.

  3. Anoteu el nom del dipòsit per utilitzar-lo al pipeline.

  4. Aneu al dipòsit que voleu utilitzar per al control d'origen de la solució.

  5. Seleccioneu Crea al menú superior i, a continuació, seleccioneu Arxiu.

  6. Doneu un nom al nou fitxer YAML del pipeline; per exemple, deploy-prod-MyNewSolution.yml, on MyNewSolution és el nom de la vostra solució.

  7. Seleccioneu Crea.

  8. Enganxa el YAML que has copiat al pas 2 al nou fitxer de pipeline.

  9. Canvieu els valors següents al nou pipeline YAML:

    • Canvi Activador>Branques>Inclou a les branques en què els canvis haurien d'activar un desplegament a producció.

    • Canvieu el nom>dels>repositoris pel nom del repositori que conté les plantilles del pipeline.

      En aquest exemple, el repositori s'anomena coe-alm-accelerator-templates i existeix al mateix projecte que el repositori MyNewSolution . Si el teu repositori de plantilles està en un projecte de Azure DevOps diferent, utilitza el format NomProjecte/NomReposo. També podeu especificar una branca per on resideixen les vostres plantilles utilitzant el paràmetre ref si cal.

    • Actualitzeu Recursos>Canalitzacions>Font per especificar la canonada de compilació que conté els artefactes que aquesta canonada hauria de desplegar. En aquest cas, desplegareu els artefactes del pipeline de proves que heu creat anteriorment, que ha creat i desplegat la vostra solució a l'entorn de proves.

    • Canvieu qualsevol valor que faci referència a SampleSolutionName pel nom únic de la vostra solució; per exemple, MyNewSolution.

  10. Repetiu els passos de l'11 al 20 de la secció anterior per a deploy-validation-ALMAcceleratorSampleSolution i deploy-test-ALMAcceleratorSampleSolution, per crear un pipeline a partir del nou pipeline de producció YAML anomenat deploy-prod-ALMAcceleratorSampleSolution.

Defineix les variables de la canonada de desplegament

Per a cada canalització de desplegament que heu configurat anteriorment, heu de definir els valors de les variables EnvironmentName i ServiceConnection en funció de l'entorn on es desplega la canalització. També pots configurar la variable EnableFlows per desactivar els fluxos Power Automate com a part d'un desplegament.

Crear variables de connexió d'entorn i de servei (necessàries)

Cada canal de desplegament requereix la variable d'entorn EnvironmentName i la variable de connexió de servei ServiceConnection.

  • EnvironmentName especifica l'entorn Azure DevOps que s'està desplegant per permetre el seguiment de l'historial de desplegament i establir permisos i aprovacions per al desplegament en entorns específics. Establiu aquest valor a Validate, Test o Production, segons correspongui.

  • ServiceConnection especifica com es connecta el pipeline de desplegament Power Platform. Els valors permesos són els noms de les connexions de servei que heu creat anteriorment.

  1. Seleccioneu Edita a cadascun dels pipelines d'implementació.

  2. Seleccioneu Variables a la definició del pipeline de desplegament per obrir l'editor de variables.

  3. Per afegir una variable, seleccioneu (+). Introduïu el nom de la variable i el valor corresponent.

Repetiu aquests passos per crear les variables EnvironmentName i ServiceConnection .

Crear la variable EnableFlows (opcional)

Pots configurar el valor d'una variable de pipeline anomenada EnableFlows a False per saltar els passos que automàticament activen els fluxos Power Automate com a part d'un desplegament. El valor per defecte de la variable EnableFlows és True.

Establir polítiques de branca per a la validació de sol·licituds d'extracció

Crea una política de branca per executar el pipeline que has creat anteriorment quan es crea una sol·licitud d'extracció.

  1. A Azure DevOps, ves a Repos i després selecciona la carpeta Branches.

  2. Cerqueu la branca per a la qual voleu crear la política de sol·licitud d'extracció. Seleccioneu (…) a la dreta de la branca i, a continuació, seleccioneu Polítiques de branca.

  3. A la pàgina Normes de branca, aneu a Validació de la compilació.

  4. Seleccioneu + per afegir una norma de branca nova.

  5. A la llista Crea un pipeline , seleccioneu el pipeline que heu creat anteriorment.

  6. Especifiqueu un filtre de ruta si escau per assegurar-vos que només els canvis a la ruta especificada activin el pipeline per a la sol·licitud d'extracció.

  7. Definiu l'Activador en Automàtic.

  8. Definiu el Requisit de norma com a Necessari.

  9. Definiu Caducitat de la compilació en Immediatament.

  10. Establiu un Nom per mostrar per a la política de la vostra sucursal; per exemple, Validació de compilació de PR.

  11. Seleccioneu Desa.

Captura de pantalla de la selecció de la configuració d'una política de compilació de validació.

Establir permisos d'accés als recursos per a les pipelines

Les canonades necessiten accés als recursos necessaris, com ara repositoris, grups de variables i connexions de servei, per executar-se. Per permetre l'accés, teniu tres opcions.

Concedir accés durant la primera execució

Podeu permetre l'accés a un recurs necessari durant la primera execució del pipeline.

  1. Activa el pipeline i obre el pipeline executat a Azure DevOps.
  2. Seleccioneu Veure al bàner "cal permís".
  3. Seleccioneu Permís per a cada recurs necessari.

Donar permís explícit

Podeu donar permís explícit a un pipeline per accedir als repositoris necessaris.

  1. A Azure DevOps, obre configuració del projecte.
  2. Seleccioneu Repositoris i, a continuació, seleccioneu un repositori.
  3. Seleccioneu la pestanya Seguretat.
  4. Desplaceu-vos cap avall fins a Permisos de la canonada i seleccioneu +.
  5. Seleccioneu el pipeline al qual voleu donar accés al dipòsit.

Podeu donar permís explícit a un pipeline per accedir als grups de variables requerits.

  1. A Azure DevOps, selecciona Pipelines>Library i després selecciona un grup de variables.
  2. Seleccioneu Permisos de pipeline.
  3. Seleccioneu + i, a continuació, seleccioneu el pipeline al qual voleu donar accés al grup de variables.

Podeu donar permís explícit a una canonada per accedir a les connexions de servei necessàries.

  1. A Azure DevOps, obre configuració del projecte.
  2. Seleccioneu Connexions de servei i, a continuació, seleccioneu una connexió de servei.
  3. Seleccioneu Més accions (…) i, a continuació, seleccioneu Seguretat.
  4. Desplaceu-vos cap avall fins a Permisos de la canonada i seleccioneu +.
  5. Seleccioneu el pipeline al qual voleu donar accés a la connexió del servei.

Atorga accés a totes les canonades

Podeu permetre que tots els pipelines, tant els que teniu ara com els que creeu en el futur, accedeixin als repositoris necessaris.

  1. A Azure DevOps, obre configuració del projecte.
  2. Seleccioneu Repositoris i, a continuació, seleccioneu un repositori.
  3. Seleccioneu la pestanya Seguretat.
  4. Desplaceu-vos cap avall fins a Permisos de pipeline.
  5. Seleccioneu Més accions (…), seleccioneu Accés obert i, a continuació, confirmeu quan se us demani.

Podeu permetre que totes les pipelines accedeixin als grups de variables requerits.

  1. A Azure DevOps, selecciona Pipelines>Library i després selecciona un grup de variables.
  2. Seleccioneu Permisos de pipeline.
  3. Seleccioneu Més accions (…), seleccioneu Accés obert i, a continuació, confirmeu quan se us demani.

Podeu permetre que totes les canonades accedeixin a les connexions de servei necessàries.

  1. A Azure DevOps, obre configuració del projecte.
  2. Seleccioneu Connexions de servei i, a continuació, seleccioneu una connexió de servei.
  3. Seleccioneu Més accions (…) i, a continuació, seleccioneu Seguretat.
  4. Seleccioneu una connexió de servei, seleccioneu Més accions (…) i, a continuació, seleccioneu Seguretat.
  5. Desplaceu-vos cap avall fins a Permisos de pipeline.
  6. Seleccioneu Més accions (…), seleccioneu Accés obert i, a continuació, confirmeu quan se us demani.

Estableix l'abast de l'autorització de la tasca

L'abast d'autorització de feina es pot establir per a tota l'organització Azure DevOps o per a un projecte específic. Desactiva l'opció Limita l'abast d'autorització de la feina al projecte actual per a pipelines de llançament si tries un projecte Azure DevOps diferent per instal·lar les plantilles.

Per definir l'abast de l'autorització de treball a nivell d'organització per a tots els projectes

  1. A Azure DevOps, tria Configuració d'organització > Pipelines > Settings.
  2. Desactiveu l'opció *Limita l'abast de l'autorització de la tasca al projecte actual per a les pipelines de llançament*.

Crea una configuració de desplegament (opcional)

Cal crear diverses configuracions en un entorn de destinació després de desplegar una solució. Aquestes configuracions són específiques de l'entorn i inclouen referències de connexió, variables d'entorn i permisos per a grups de Microsoft Entra i equips de Dataverse, a més de compartir aplicacions de canvas i actualitzar la propietat de components de la solució com els fluxos de Power Automate. Juntament amb aquestes configuracions, un entorn de destinació sovint necessita dades de mostra o de configuració associades a taules de la solució per proporcionar una experiència ALM completa de principi a fi. Dataverse

Si la vostra solució requereix aquestes altres configuracions o dades, seguiu la guia de configuració de la implementació per configurar els vostres pipelines en funció dels entorns on els esteu implementant.

Importar la solució i configurar l'aplicació

Importa l'aplicació canvas ALM Accelerator al teu entorn Power Platform i després configura el connector personalitzat inclòs per a Azure DevOps.

Instal·leu l'accelerador ALM a Dataverse

  1. La solució ALM Accelerator depèn del Creator Kit. Instal·la el Kit de Creador ara.

  2. Descarrega l'últim fitxer de solucions gestionades des de GitHub. Desplaceu-vos cap avall fins a Actius i seleccioneu CenterofExcellenceALMAccelerator_<última versió>_managed.zip.

  3. Inicia sessió a Power Apps i després selecciona l'entorn on vols allotjar l'aplicació ALM Accelerator.

  4. Al panell lateral esquerre, seleccioneu Solucions.

  5. Seleccioneu Importa la solució>Navega i, a continuació, navegueu fins a la ubicació de la solució administrada que heu baixat i seleccioneu el fitxer.

  6. Seleccioneu Següent i, a continuació, torneu a seleccionar Següent.

  7. A la pàgina Connexions , seleccioneu o creeu una connexió per connectar la connexió CDS DevOps a Dataverse.

    Quan creïs una connexió per a HTTP amb Microsoft Entra, utilitza Microsoft Graph per a ambdós paràmetres.

  8. Seleccioneu Importa.

Configurar el connector personalitzat de DevOps

  1. Seleccioneu Dades>Connectors personalitzats>CustomAzureDevOps.

  2. Seleccioneu Editar. A la pàgina Seguretat , seleccioneu Edita i, a continuació, definiu els camps següents:

    Nom Valor
    Tipus d'autenticació OAuth 2.0
    Proveïdor d'identitat Azure Active Directory
    ID de client L'identificador de l'aplicació (client) que heu copiat quan vau crear el registre de l'aplicació
    Secret del client El valor del secret de l'aplicació (client) que heu copiat quan vau crear el registre de l'aplicació
    ID d'inquilí Deixeu el valor per defecte, comú
    URL del recurs L'identificador de l'aplicació DevOps (client) que heu copiat quan vau afegir permisos al registre de l'aplicació
    URL de redirecció Autogeneracions. Si veieu la casella de selecció "Actualitza a una URL de redirecció única" a sota d'"URL de redirecció", marqueu-la.

  3. Seleccioneu Actualitza el connector.

Afegeix l'"URL de redirecció" com a "URI de redirecció"

L'"URL de redirecció" generada automàticament de la secció anterior s'ha d'afegir com a "URI de redirecció" al registre de l'aplicació.

  1. Torna al registre de l'aplicació que has creat.

  2. Al panell lateral esquerre, seleccioneu Visió general.

  3. Seleccioneu Afegeix un URI de redirecció.

  4. Seleccioneu + Afegeix una plataforma i, a continuació, seleccioneu Web.

  5. Al quadre de text URI de redirecció , enganxeu l'"URL de redirecció" generada automàticament i copiada de la secció anterior.

  6. Seleccioneu Configura.

Prova el connector personalitzat

  1. Obriu el menú Prova.

  2. Seleccioneu Nova connexió i, a continuació, seguiu les instruccions per crear una connexió.

  3. A Power Apps, selecciona el teu entorn i després selecciona Dataverse>Custom Connectors>CustomAzureDevOps.

  4. Seleccioneu Edita, aneu a la pàgina Prova i, a continuació, cerqueu l'operació GetOrganizations .

  5. Seleccioneu Operació de prova.

  6. Confirma que l'estat Resposta retornat és 200 i que el Response Body és una representació JSON de la teva organització Azure DevOps.

    Captura de pantalla de la configuració de seguretat de proves per a un connector de Azure DevOps personalitzat.

Configurar els creadors per utilitzar l'aplicació ALM Accelerator

Segueix llegint

  • Last updated on