Deli putem

Primena paketa korišćenjem programa Package Deployer i Windows PowerShell

  • Članak

Microsoft Dynamics CRM Package Deployer omogućava administratorima primenu paketa u okruženju.

Belešku

Alatka Package Deployer takođe radi sa Dynamics 365 Customer Engagement (on-premises) organizacijama.

„Paket“ može da sadrži sledeće:

  • Jedna ili više datoteka Dataverse rešenja.

  • Obične datoteke ili izvezene datoteke podataka iz alatke Configuration Migration Tool. Više informacija o alatki Configuration Migration Tool potražite u odeljku Upravljanje podacima o konfiguraciji.

  • Prilagođeni kôd koji može da se pokreće tokom ili posle primene paketa u okruženju.

  • HTML sadržaj karakterističan za paket koji može biti prikazan na početku i na kraju procesa primene paketa. To može biti korisno za pružanje opisa rešenja i datoteka primenjenih u paketu.

    Programeri kreiraju pakete tako što koriste predložak za primenu paketa u Visual Studio. Još informacija: Kreiranje paketa za Package Deployer

    Kada paket bude kreiran, možete da ga primenite tako što ćete pokrenuti CRM Package Deployer ili tako što ćete upotrebiti PowerShell cmdlet komande za alatku.

Važno

Pre nego što uvezete i pokrenete paket u organizaciji za proizvodnju, testirajte paket na neprodukcionoj kopiji organizacije za proizvodnju.

Uvek napravite rezervnu kopiju organizacije za proizvodnju pre primene paketa.


Primena paketa pomoću alatke Package Deployer

Možete da koristite alatku Package Deployer (packagedeployer.exe) da biste primenili pakete na sledeće načine.

Koristite CRM Package Deployer alat za primenu paketa

Koristite CRM Package Deployer alat na komandnoj liniji

Koristite Package Deployer alatku za primenu paketa

Alatka Package Deployer može da obrađuje samo jedan po jedan paket. Međutim, on korisnicima omogućava da izaberu paket koji će primeniti sa liste paketa dostupnih u direktorijumu alatke Package Deployer. Pojedini prikazi i radnje u alatki se razlikuju u zavisnosti od definicije paketa. Ne morate da instalirate alatku Package Deployer. Jednostavno preuzmite i pokrenite.

  1. Preuzmite paket za primenu. Paket predstavlja kolekciju datoteka i fascikli koje se kreiraju u okviru vaše Visual Studio fascikle sa projektima (<Project>\Bin\Debug) kada pravite projekat paketa u sistemu Visual Studio. Kopirajte sledeće iz fascikle za otklanjanje grešaka u projektu:

    • <PackageName> folder: Ova fascikla sadrži rešenja, konfiguraciju uvoza i sadržaj za vaš paket.

    • <PackageName>.dll: Skupština sadrži kod za vaš paket. Podrazumevano ime sklopa je isto kao i ime vašeg Visual Studio projekta.

      Detaljne informacije o kreiranju paketa korišćenjem programa Visual Studio potražite na stranici Kreiranje paketa za alatku Package Deployer.

      Pretpostavimo u ovoj temi da se fascikla paketa i sklop iz Visual Studio fascikle za otklanjanje grešaka u projektu (<Project>\Bin\Debug) kopiraju u fasciklu c:\DeployPackage.

  2. Nabavite Package Deployer alatku. Alatka Package Deployer je dostupna kao NuGet paket. Da biste koristili Package Deployer, morate da ga preuzmete i izdvojite na lokalni računar koristeći nuget.exe.

    Preuzmite nuget.exe na lokaciji https://www.nuget.org/downloads i sačuvajte datoteku na svom računaru, npr. d:\. Zatim pokrenite sledeću komandu u komandnoj liniji da biste izdvojili sadržaj paketa u fasciklu na računaru, izgovorite PD:
    d:\nuget install Microsoft.CrmSdk.XrmTooling.PackageDeployment.Wpf -Version [VERSION] -O d:\PD

    Kada izdvojite alatku Package Deployer, idite do fascikle [ExtractedLocation]\tools da biste pronašli datoteku PackageDeployer.exe.

  3. Kopirajte fasciklu paketa i sklop iz fascikle c:\DeployPackage u fasciklu [ExtractedLocation]\tools.

  4. Kada se kopiranje datoteka završi, pokrenite alatku dvostrukim klikom na datoteku PackageDeployer.exe koja se nalazi u fascikli [ExtractedLocation]\tools.

  5. Na glavnom ekranu alatke kliknite na Nastavi.

  6. Na ekranu Povezivanje sa uslugom Microsoft Dynamics 365 for Customer Engagement, navedite detalje za potvrdu identiteta da biste se povezali sa platformom Dynamics 365 Server na kojoj želite da primenite paket. Ako imate više organizacija na istom CRM serveru, a želite da izaberete organizaciju u koju ćete primeniti paket, potvrdite izbor u polju Uvek prikaži listu dostupnih organizacija. Kliknite na dugme Prijavljivanje.

  7. Ako imate više organizacija na platformi Dynamics 365 Server, izaberite organizaciju Dynamics 365 aplikacija sa kojom želite da se povežete.

  8. Izaberite paket za primenu i kliknite na dugme Dalje.

    Izaberite svoj paket u Package Deployer alatu.

  9. Pratite uputstva na narednim ekranima da biste dovršili primenu svog paketa.

    Ekrani se pojavljuju na osnovu definicije paketa koji ste izabrali za primenu. Za potpunu primenu paketa za koju je potrebna alatka Package Deployer, pogledajte temu za primenu Unified Service Desk paketa: Primena primera Unified Service Desk aplikacija na CRM server pomoću alatke Package Deployer

Korišćenje Package Deployer alatke na komandnoj liniji

Administratori sistema i stručnjaci za prilagođavanje mogu da prosleđuju parametre, kao što je šifra regionalnog jezika, programu packagedeployer.exe iz komandne linije. Ovi parametri se mogu samo konfigurisati po pokretanju alatke Package Deployer na komandnoj liniji.

Belešku

Ova funkcija je prvi put uvedena u Dynamics CRM Online 2016 Update 0.1.

Dostupni parametri su u ovoj tabeli.

Parametar Opis Podrazumevana vrednost
RuntimePackageSettings Govori packagedeployer.exe da prihvati parametre komandne linije kao što su LCID i SkipChecks. Nije primenjivo
LCID=localeID Navodi ID lokalnog standarda, na primer 1033 za English-United States ili 1036 za French-France, iz dostupnih ID-ova lokalnog standarda u paketu. Ako nije naveden, podrazumevani jezik će se koristiti. Koristite podrazumevani jezik
SkipChecks=true/false Koristite samo taj parametar kada ciljno okruženje ne sadrži nijedno drugo rešenje niti prilagođavanja. Kada se postavi kao tačno, rešenje za uvoz će zaobići neke bezbednosne provere, što može da poboljša performanse uvoza. Netačno

Sledeći primer nalaže alatki CRM Package Deployer da zaobiđe neke bezbednosne provere i postavlja poljski kao jezik za uvoz.

packagedeployer.exe /Settings:"SkipChecks=true|lcid=1045"

Belešku

Koristite znak uspravne crte | da razdvojite parametre kada pokrećete packagedeployer.exe na komandnoj liniji sa više parametara.

Za još informacija o parametrima i vrednostima koje se mogu proslediti u packagedeployer.exe, pogledajte Kreirajte pakete za CRM Package Deployer.

Koristi Windows PowerShell za primenu paketa

Alatka Package Deployer takođe pruža Windows PowerShell podršku za primenu paketa. Još informacija: Počnite da koristite modul za primenu paketa

Rešavanje problema sa primenom paketa izdavanjem datoteka evidencije

Alatka Package Deployer pruža podršku za evidentiranje koja služi za dobijanje detaljnih informacija o greškama do kojih može doći kada se neko prijavi u instancu usluge Microsoft Dynamics 365 for Customer Engagement pomoću alatke i paketa za primenu. Podrazumevano, alat generiše tri datoteke dnevnika koje su dostupne na sledećoj lokaciji na računaru na kome pokrećete alat: c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dynamics CRM Package Deployer\<Version>. Da biste naveli drugu fasciklu, koriste PowerShell cmdlet parametar -LogWriteDirectory. Još informacija: Korišćenje cmdlet komandi za preuzimanje paketa

  • Login_ErrorLog.log: Pruža informacije o problemima koji su se pojavili kada koristite alat za prijavljivanje u Dynamics 365 instancu. Ako je tokom prijavljivanja bilo problema, pojaviće se poruka na ekranu alatke za prijavljivanje sa vezom do ove datoteke evidencije. U poruci se navodi da je došlo do greške prilikom obrade zahteva za prijavljivanje i da korisnik može da vidi evidenciju greške. Možete da kliknete na vezu u poruci da biste videli datoteku evidencije. Datoteka evidencije se kreira čim dođe do problema sa prijavljivanjem u alatku. Nakon toga, datoteka evidencije se koristi za evidentiranje informacija o problemima sa prijavljivanjem, kad god do njih dođe.

  • PackageDeployer.log: Pruža detaljne informacije o svakom zadatku koji se obavlja u alatu tokom raspoređivanja paketa. Možete da vidite datoteku evidencije iz alatke tako što ćete kliknuti na vezu Prikaži datoteku evidencije na dnu ekrana.

  • ComplexImportDetail.log: Pruža detaljne informacije o podacima uvezenim u poslednjem raspoređivanju pomoću alata. Svaki put kada primenjujete paket pomoću ove alatke, postojeći detalji iz datoteke evidencije se premeštaju u evidenciju pod nazivom ComplexImportDetail._old.log u istom direktorijumu, a datoteka ComplexImportDetail.log prikazuje informacije o najnovijim uvozima koji su izvršeni pomoću alatke.

Najbolja praksa za primenu paketa

Prilikom primene paketa, Dynamics 365 administratori moraju da:

  • Insistiraju da sklop paketa bude potpisan da bi mogli da ga prate natrag do izvora.

  • Testirajte paket na instanci za pretprodukciju (po mogućstvu neka to bude preslikana kopija proizvodne instance) pre nego što ga pokrenete na serveru za produkciju.

  • Napravite rezervnu kopiju proizvodne instance pre primene paketa.

Takođe pogledajte

Kreirajte pakete za CRM Package Deployer