Distribuere pakker ved hjelp av Package Deployer og Windows PowerShell
Microsoft Dynamics CRM Package Deployer gjør at administratorer kan distribuere pakker i et miljø.
Merk
Package Deployer fungerer også med Dynamics 365 Customer Engagement (on-premises)-organisasjoner.
En pakke kan bestå av hvilken som helst av, eller alle, følgende:
Én eller flere løsningsfiler for Dataverse.
Flate filer eller eksporterte datafiler fra verktøyet for Configuration Migration. Hvis du vil ha mer informasjon om verktøyet for Configuration Migration, kan du se Håndtere konfigurasjonsdata.
Egendefinert kode som kan kjøres under distribusjon eller etter at pakken er distribuert til et miljø.
HTML-innhold spesifikt for pakken som kan vises ved start og slutt av pakkdistribusjon. Dette kan være nyttig for å gi en beskrivelse av løsninger og filer som distribueres i pakken.
Utviklere oppretter pakker ved å bruke pakkedistribusjonsmalen i Visual Studio. Mer informasjon: Opprette pakker for Package Deployer
Når en pakke er opprettet, kan du distribuere den ved å kjøre CRM Package Deployer eller ved å bruke Windows PowerShell-cmdleter for verktøyet.
Viktig
Før du importerer og kjører en pakke i en produksjonsorganisasjon, kan du teste pakken på et ikke-produksjonsspeilbilde av produksjonsorganisasjonen.
Sikkerhetskopier alltid produksjonsorganisasjonen før du distribuerer en pakke.
Distribuere pakker ved hjelp av Package Deployer-verktøyet
Du kan bruke Package Deployer-verktøyet (packagedeployer.exe) til å distribuere pakker på følgende måter.
Bruke CRM Package Deployer-verktøyet til å distribuere pakker
Bruke CRM Package Deployer-verktøyet på kommandolinjen
Bruke Package Deployer-verktøyet til å distribuere pakker
Package Deployer-verktøyet kan bare behandle én pakke om gangen. Den gir imidlertid brukere muligheten til å velge en pakke å distribuere fra flere pakker som er tilgjengelige i Package Deployer-verktøykatalogen. Noen av skjermbildene og handlingene i verktøyet avhenger av pakkedefinisjonen. Du behøver ikke å installere Package Deployer-verktøyet. Bare laste ned og kjøre det.
Få tak i pakken som skal distribueres. En pakke er en samling av filer og mapper som er opprettet i Visual studio-prosjektmappen (<Project>\Bin\Debug) ved bygging av pakkeprosjektet i Visual Studio. Kopier følgende fra prosjektets Debug-mappe:
<PackageName>-mappen: Denne mappen inneholder løsningene, importkonfigurasjonen og innholdet for pakken.
<PackageName>.dll: Samlingen inneholder koden for pakken. Som standard er navnet på samlingen er det samme som Visual Studio-prosjektnavnet.
Hvis du vil ha mer informasjon om hvordan du oppretter en pakke ved hjelp av Visual Studio, kan du se Opprette en pakke for Package Deployer-verktøyet.
La oss anta for dette emnet at pakkemappen og samlingen fra Visual Studio-prosjektets Debug-mappe (<Prosjekt>\Bin\Debug) kopieres til
c:\DeployPackage-mappen.
Anskaff Package Deployer-verktøyet. Verktøyet Package Deployer er tilgjengelig som en NuGet-pakke. Hvis du vil bruke Package Deployer, må du laste ned og pakke ut verktøyet til den lokale datamaskinen ved hjelp av nuget.exe.
Last ned nuget.exe fra https://www.nuget.org/downloads, og lagre filen på datamaskinen, for eksempel på d:\. Kjør deretter følgende kommando på kommandolinjen for å pakke ut innholdet i en mappe, for eksempel PD, på datamaskinen:d:\nuget install Microsoft.CrmSdk.XrmTooling.PackageDeployment.Wpf -Version [VERSION] -O d:\PD
Når du har pakket ut verktøyet Package Deployer, kan du gå til[ExtractedLocation]\tools-mappen for å finne filen PackageDeployer.exe.Kopier pakkemappen og samlingen fra
c:\DeployPackagetil[ExtractedLocation]\tools-mappen.Når filene er kopiert, kjører du verktøyet ved å dobbeltklikke
PackageDeployer.exe-filen i mappen[ExtractedLocation]\tools.Klikk Fortsett i hovedskjermbildet i verktøyet.
I skjermbildet Koble til Microsoft Dynamics 365 for Customer Engagement angir du godkjenningsdetaljer for å koble til Dynamics 365 server der du vil distribuere pakken. Hvis du har flere organisasjoner og vil velge organisasjonen der du vil distribuere pakken, marker du av for Vis alltid en liste over tilgjengelige organisasjoner. Klikk Logg på.
Hvis du har flere organisasjoner, velger du en Dynamics 365-apporganisasjon du vil koble til, på Dynamics 365 Server.
Velg pakken som skal distribueres, og klikk Neste.
Følg instruksjonene i de neste skjermbildene for å fullføre distribusjonen av pakken.
Skjermbildene som vises er basert på definisjonen for pakken du har valgt for distribusjon. For en pakke for ende-til-ende-distribusjon som bruker Package Deployer-verktøyet, kan du se emnet for distribusjon av Unified Service Desk-pakker: Distribuere Unified Service Desk-eksempelappen til CRM-serveren ved hjelp av Package Deployer
Bruke Package Deployer-verktøyet på kommandolinjen
Systemansvarlige og systemtilpassere kan sende parametere, for eksempel en lokal språkkode, til packagedeployer.exe fra kommandolinjen. Disse parameterne kan bare konfigureres ved å kjøre Package Deployer-verktøyet på kommandolinjen.
Merk
Denne funksjonen ble først innført i Dynamics CRM Online 2016 Update 0.1.
Tilgjengelige parametere finnes i denne tabellen.
| Parameter | Bekrivelse | Standardverdi |
|---|---|---|
| RuntimePackageSettings | Instruerer packagedeployer.exe til å godta kommandolinjeparametere som LCID og SkipChecks. | Ikke aktuelt |
| LCID=localeID | Angir ID-en for nasjonal innstilling, for eksempel 1033 for English-United States eller 1036 for French-France, fra tilgjengelige ID-er i pakken. Hvis den ikke er angitt, brukes standardspråket. | Bruk standardspråket |
| SkipChecks=true/false | Bruk bare denne parameteren når målmiljøet ikke inneholder andre løsninger eller tilpasninger. Når den er satt til sann, vil løsningsimporten hoppe over noen sikkerhetssjekker, som kan forbedre ytelsen til importen. | False |
Det følgende eksemplet angir at CRM Package Deployer skal omgå noen sikkerhetskontroller og angir språket som skal importeres, til polsk.
packagedeployer.exe /Settings:"SkipChecks=true|lcid=1045"
Merk
Bruke den loddrette streken | til å skille parameterne når du kjører packagedeployer.exe på kommandolinjen med flere parametere.
Hvis du vil ha mer informasjon om parametere og verdier som kan sendes til packagedeployer.exe, kan du see Opprette pakker for CRM Package Deployer.
Bruke Windows PowerShell til å distribuere pakker
Package Deployer-verktøyet har også Windows PowerShell-støtte for distribusjon av pakker. Mer informasjon: Kom i gang med å bruke pakkedistribusjonsmodulen
Feilsøke problemer med pakkedistribusjon ved hjelp av loggfiler
Package Deployer-verktøyet støtter logging for å få detaljert informasjon om feil som kan oppstå når noen logger på Microsoft Dynamics 365 for Customer Engagement-forekomsten ved hjelp av verktøyet og distribuerer pakker. Verktøyet genererer som standard tre loggfiler som er tilgjengelige på følgende plassering på datamaskinen der du kjører verktøyet: c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dynamics CRM Package Deployer\<Version>. Hvis du vil angi en annen mappe, kan du bruke -LogWriteDirectory PowerShell-cmdlet-parameteren. Mer informasjon: Bruke cmdletene til å hente pakker
Login_ErrorLog.log: Inneholder informasjon om problemene som oppstod da du brukte verktøyet til å logge på Dynamics 365-forekomsten. Hvis det er problemer under pålogging, vises en melding i påloggingsskjermbildet for verktøyet med en kobling til loggfilen. Meldingen angir at det oppstod en feil under behandling av påloggingsforespørselen og at brukeren kan vise feilloggen. Du kan klikke koblingen i meldingen for å vise loggfilen. Loggfilen opprettes første gang det oppstår påloggingsproblemer i verktøyet. Loggfilen brukes deretter til å logge informasjon om påloggingsproblemer når de oppstår.PackageDeployer.log: Inneholder detaljert informasjon om alle oppgaver som utføres i verktøyet under distribusjon av pakkene. Du kan vise loggfilen fra verktøyet ved å klikke koblingen Vis loggfil nederst på skjermen.ComplexImportDetail.log: Inneholder detaljert informasjon om dataene som ble importert i den siste distribusjonsjobben ved hjelp av verktøyet. Hver gang du distribuerer en pakke ved hjelp av verktøyet, flyttes de eksisterende detaljene fra loggfilen til en fil som heter ComplexImportDetail._old.log i samme mappe, og filen ComplexImportDetail.log viser informasjon om den siste importen som ble utført ved hjelp av verktøyet.
Gode fremgangsmåter for distribusjon av pakker
Under distribusjon av pakker må Dynamics 365-administratorer sørge for følgende:
Bruk en signert pakkesamling slik at samlingen kan spores tilbake til kilden.
Teste pakken i en før-produksjonsforekomst (fortrinnsvis et speilbilde av produksjonsforekomsten) før den kjøres på en produksjonsserver.
Sikkerhetskopiere produksjonsforekomsten før en pakkedistribusjon.