Implementar paquets mitjançant el Package Deployer i el Windows PowerShell
El Microsoft Dynamics CRM Package Deployer permet que els administradors puguin implementar paquets a un entorn.
Nota
El Package Deployer també funciona amb organitzacions del Dynamics 365 Customer Engagement (on-premises).
Un "paquet" pot consistir en algun o tots els elements següents:
Un o més fitxers de la solució del Dataverse.
Fitxers plans o de dades exportades des de l'eina Migració de la configuració. Per obtenir més informació sobre l'eina Migració de la configuració, vegeu Administrar les vostres dades de configuració.
El codi personalitzat que es pot executar durant o després del paquet s'implementa en un entorn.
Contingut HTML específic pel paquet que es pot mostrar al principi i al final del procés d'implementació del paquet. Això pot ser útil per proporcionar una descripció de les solucions i fitxers que s'implementen en el paquet.
Els desenvolupadors creen paquets utilitzant la plantilla la implementació de paquets del Visual Studio. Més informació: Crear paquets per al Package Deployer
Després de crear un paquet, podeu implementar-lo executant el CRM Package Deployer o amb els cmdlets del Windows PowerShell per a l'eina.
Important
Abans d'importar i executar un paquet en una organització de producció, proveu el paquet en una organització que no sigui de producció i que sigui una imatge de rèplica de l'organització de producció.
Sempre feu una còpia de seguretat de l'organització de producció abans de distribuir un paquet.
Implementació de paquets mitjançant l'eina del Package Deployer
Podeu utilitzar l'eina del Package Deployer (packagedeployer.exe) per implementar paquets de la manera següent.
Ús de l'eina del CRM Package Deployer per implementar paquets
Ús de l'eina del CRM Package Deployer des de la línia d'ordres
Ús de l'eina del Package Deployer per implementar paquets
L'eina del Package Deployer només pot processar un paquet cada vegada. Tanmateix, proporciona als usuaris la capacitat de seleccionar un paquet per implementar des de múltiples paquets disponibles en el directori de l'eina del Package Deployer. Algunes de les pantalles i les accions de l'eina són diferents segons la definició de paquet. No cal que instal·leu l'eina del Package Deployer. Només descarregueu-la i executeu-la.
Obteniu el paquet que voleu implementar. Un paquet és una col·lecció de fitxers i carpetes que es crea a la carpeta de projecte de Visual Studio (<Projecte>\Bin\Debug) quan genereu el paquet del projecte a Visual Studio. Copieu el següent de la vostra carpeta de depuració de projecte:
Carpeta <PackageName>: aquesta carpeta conté les solucions, la configuració d'importació i el contingut del vostre paquet.
<PackageName>.dll: l'assemblatge conté el codi del vostre paquet. Per defecte, el nom de l'assemblatge és el mateix que el nom del projecte del Visual Studio.
Per obtenir informació detallada sobre la creació d'un paquet mitjançant l'ús del Visual Studio, vegeu Crear un paquet per a l'eina Package Deployer.
En aquest tema, assumim que la carpeta del paquet i l'assemblatge de la carpeta de depuració del projecte del Visual Studio (<Projecte>\Bin\Debug) s'han copiat a la carpeta
c:\DeployPackage.
Obtenir l'eina Package Deployer. L’eina Package Deployer està disponible en forma de Paquet NuGet. Per utilitzar el Package Deployer, heu de baixar-lo i extreure’l a l’ordinador local mitjançant nuget.exe.
Baixeu nuget.exe des de https://www.nuget.org/downloads i deseu-lo en un directori de l'ordinador, per exemple d:\. A continuació, heu d’executar l’ordre següent a l’indicador d’ordres per extreure el contingut del paquet a una carpeta, per exemple PD, del vostre ordinador:d:\nuget install Microsoft.CrmSdk.XrmTooling.PackageDeployment.Wpf -Version [VERSION] -O d:\PD
Després d’extreure l’eina Package Deployer, aneu a la carpeta[ExtractedLocation]\toolsper localitzar el fitxer PackageDeployer.exe.Copieu la carpeta del paquet i l'assemblatge del
c:\DeployPackagea la carpeta[ExtractedLocation]\tools.Quan tots els fitxers s'han copiat, executeu l'eina fent doble clic al fitxer
PackageDeployer.exea la carpeta[ExtractedLocation]\tools.Feu clic a Continua a la pantalla principal de l'eina.
A la pantalla Connectar-vos al Microsoft Dynamics 365 for Customer Engagement, proporcioneu els detalls d'autenticació per connectar-vos al Dynamics 365 Server on voleu implementar el paquet. Si teniu múltiples organitzacions i voleu seleccionar l'organització on voleu implementar el paquet, seleccioneu la casella Visualitza sempre la llista d'organitzacions disponibles. Feu clic a Inici de sessió.
Si teniu diverses organitzacions al Dynamics 365 Server, seleccioneu l'organització de les aplicacions del Dynamics 365 a la qual us voleu connectar.
Seleccioneu el paquet que s'ha d'implementar i feu clic a Endavant.
Seguiu les instruccions a les pantalles posteriors per completar la implementació del vostre paquet.
Les pantalles apareixen segons la definició del paquet que heu seleccionat per a la implementació. Per a una implementació de paquet integral que utilitzi l'eina Package Deployer, vegeu el tema sobre la implementació de paquets d'Unified Service Desk: Implementar aplicacions d'Unified Service Desk d'exemple al servidor del CRM utilitzant el Package Deployer
Ús de l'eina Package Deployer des de la línia d'ordres
Els administradors del sistema i els personalitzadors poden passar paràmetres, com ara un codi de llengua regional, a packagedeployer.exe des de la línia d'ordres. Aquests paràmetres només es poden configurar executant l'eina del Package Deployer des de la línia d'ordres.
Nota
Aquesta característica es va presentar per primera vegada al Dynamics CRM Online 2016 Update 0.1.
Aquesta taula conté els paràmetres disponibles.
| Paràmetre | Descripció | Valor per defecte |
|---|---|---|
| RuntimePackageSettings | Indica que packagedeployer.exe accepti els paràmetres de línia d'ordres, com ara LCID i SkipChecks. | No aplicable |
| LCID=localeID | Especifica l'identificador de configuració regional, com ara 1033 Anglès-Estats Units o 1036 Francès-França, dels identificadors de configuració regional del paquet. Si no s'especifica, es farà servir la llengua per defecte. | Utilitzar la llengua per defecte |
| SkipChecks=vertader/fals | Utilitzeu aquest paràmetre només quan l'entorn de destinació no contingui cap altra solució o personalització. Si està definit en cert, la importació de la solució prescindirà d'alguns controls de seguretat per millorar el rendiment de la importació. | Fals |
El següent exemple indica que el CRM Package Deployer ometi algunes comprovacions de seguretat i que estableixi la llengua d'importació en polonès.
packagedeployer.exe /Settings:"SkipChecks=true|lcid=1045"
Nota
Utilitzeu el caràcter de barra vertical | per separar els paràmetres quan executeu packagedeployer.exe a la línia d'ordres amb diversos paràmetres.
Per obtenir més informació sobre els paràmetres i els valors que es poden passar a packagedeployer.exe, consulteu Crear paquets per al CRM Package Deployer.
Utilitzar el Windows PowerShell per implementar paquets
L'eina Package Deployer també proporciona suport al Windows PowerShell per implementar paquets. Més informació: Introducció el mòdul d'implementació de paquets
Detectar problemes d'implementació de paquets mitjançant fitxers de registre
L'eina Package Deployer proporciona assistència de registre per obtenir informació detallada sobre els errors que es poden produir quan algú inicia sessió a la instància del Microsoft Dynamics 365 for Customer Engagement utilitzant l'eina i implementant els paquets. Per defecte, l'eina genera tres fitxers de registre que estan disponibles a la ubicació següent a l'ordinador on executeu l'eina: c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dynamics CRM Package Deployer\<Version>. Per especificar una carpeta diferent, utilitzeu el paràmetre cmdlet -LogWriteDirectory PowerShell. Més informació: Utilitzar el cmdlet per recuperar paquets
Login_ErrorLog.log: proporciona informació sobre els problemes que s'han produït en utilitzar l'eina per iniciar sessió a la instància del Dynamics 365. Si hi ha qualsevol problema durant l'inici de sessió, apareixerà un missatge a la pantalla d'inici de sessió de l'eina amb un enllaç a aquest fitxer de registre. El missatge manifesta que s'ha produït un error mentre es processava la sol·licitud d'inici de sessió i l'usuari pot veure el registre d'error. Podeu fer clic a l'enllaç del missatge per visualitzar aquest fitxer de registre. El fitxer de registre es crea la primera vegada que trobeu algun problema d'inici de sessió a l'eina. Posteriorment, el fitxer de registre s'utilitza per registrar informació sobre un problema d'inici de sessió, sempre que es produeixi.PackageDeployer.log: proporciona informació detallada sobre cada tasca realitzada en l'eina durant la implementació dels paquets. Podeu veure el fitxer de registre de l'eina fent clic a l'enllaç Visualitza el fitxer de registre a la part inferior de la pantalla.ComplexImportDetail.log: proporciona informació detallada sobre les dades importades a la darrera implementació utilitzant l'eina. Cada cop que implementeu un paquet utilitzant aquesta eina, els detalls existents de l'arxiu de registre es desplacen a un fitxer anomenat ComplexImportDetail._old.log en el mateix directori i l'arxiu ComplexImportDetail.log mostra informació sobre la darrera importació realitzada mitjançant l'eina.
Pràctiques recomanades per implementar paquets
Mentre implementen paquets, els administradors del Dynamics 365 han de fer el següent:
Insistir en una assemblea de paquets signats per tal que es pugui fer un seguiment fins al seu origen.
Provar el paquet en una instància de pre-producció (preferiblement una imatge mirall de la instància de producció) abans d'executar-lo en un servidor de producció.
Fer una còpia de seguretat de la instància de producció abans d'implementar un paquet.