Implementarea pachetelor utilizând Package Deployer și Windows PowerShell
Microsoft Dynamics CRM Package Deployer permite administratorilor să implementeze pachete într-un mediu.
Notă
Package deployer funcționează și cu organizații Dynamics 365 Customer Engagement (on-premises).
Un „pachet” poate consta în următoarele elemente:
Unul sau mai multe fișiere soluție Dataverse.
Fișiere plate sau fișiere de date exportate din instrumentul Configuration Migration. Pentru mai multe informații despre instrumentul Migrare configurare, consultați Gestionați-vă datele de configurare.
Codul particularizat care poate rula în timpul sau după ce pachetul este implementat în mediu.
Conținutul HTML specific pachetului care se poate afișa la începutul și la sfârșitul procesului de implementare a pachetului. Acesta poate fi util pentru a furniza o descriere a soluțiilor și fișierelor implementate în pachet.
Dezvoltatorii creează pachete folosind șablonul de implementare pachete din Visual Studio. Informații suplimentare: Creați pachete pentru Package Deployer
După crearea unui pachet, îl puteți implementa prin rularea CRM Package Deployer sau prin utilizarea de cmdleturi Windows PowerShell pentru instrument.
Important
Înainte de a importa și a rula un pachet la o organizație de producție, testați pachetul pe o organizație non-producție care este o imagine în oglindă a organizației de producție.
Faceți întotdeauna backup organizației de producție înainte de a implementa un pachet.
Implementarea pachetelor folosind instrumentul Package Deployer
Aveți posibilitatea să utilizați instrumentul Package Deployer (packagedeployer.exe) pentru a implementa pachete în modalitățile următoare.
Utilizați instrumentul CRM Package Deployer pentru a implementa pachete
Utilizați instrumentul CRM Package Deployer la linia de comandă
Utilizați instrumentul Package Deployer pentru a implementa pachete
Instrumentul Package Deployer poate procesa doar câte un singur pachet pe rând. Cu toate acestea, furnizează utilizatorilor abilitatea de a selecta un pachet de implementat din mai multe pachete disponibile în directorul de instrumente Package Deployer. Unele dintre ecranele și acțiunile din instrument diferă, în funcție de definiția pachetului. Nu trebuie să instalați instrumentul Package Deployer. Doar îl descărcați și îl rulați.
Obțineți pachetul de implementat. Un pachet este o colecție de fișiere și foldere creată în folderul dvs. de proiect Visual Studio (<Proiect>\Bin\Debug) când generați proiectul pachetului în Visual Studio. Copiați următoarele din folderul de depanare a proiectului:
Folderul <PackageName>: acest folder conține soluții, o configurare de import și conținutul pachetului dvs.
<PackageName>.dll: Această asamblare conține codul pentru pachetul dvs. În mod implicit, numele ansamblului este identic cu numele proiectului dvs. Visual Studio.
Pentru informații detaliate despre crearea unui pachet prin utilizarea Visual Studio, consultați Creați un pachet pentru instrumentul Package Deployer.
Pentru acest subiect, să presupunem că folderul pachetului și ansamblul din folderul de depanare a proiectului Visual Studio (<Project>\Bin\Debug) sunt copiate în folderul
c:\DeployPackage.
Obțineți instrumentul Package Deployer. Instrumentul Package Deployer este disponibil ca pachet NuGet. Pentru a utiliza Package Deployer, trebuie să-l descărcați și să-l extrageți pe computerul local, folosind nuget.exe.
Descărcați nuget.exe de la https://www.nuget.org/downloads și salvați-l în computerul dvs., de exemplu pe d:\. Apoi rulați următoarea comandă la promptul de comandă, pentru a extrage conținutul pachetului într-un folder, de exemplu PD, de pe computer:d:\nuget install Microsoft.CrmSdk.XrmTooling.PackageDeployment.Wpf -Version [VERSION] -O d:\PD
După ce ați extras instrumentul Package Deployer, navigați la folderul[ExtractedLocation]\toolspentru a găsi fișierul PackageDeployer.exe.Copiați folderul pachetului și ansamblul din
c:\DeployPackageîn folderul[ExtractedLocation]\tools.După ce fișierele sunt copiate, rulați instrumentul făcând dublu clic pe fișierul
PackageDeployer.exedin folderul[ExtractedLocation]\tools.Faceți clic pe Continuare pe ecranul principal al instrumentului.
În ecranul Conectare la Microsoft Dynamics 365 for Customer Engagement, furnizați detaliile de autentificare pentru a vă conecta la instanța Dynamics 365 Server pe care doriți să implementați pachetul. Dacă aveți mai multe organizații și doriți să selectați organizația unde doriți să implementați pachetul, bifați caseta de selectare Se afișează întotdeauna lista de organizații disponibile. Faceți clic pe Conectare.
Dacă aveți mai multe organizații pe Dynamics 365 Server, selectați o organizație de aplicații Dynamics 365 la care doriți să vă conectați.
Selectați pachetul de implementat și faceți clic pe Următorul.
Urmați instrucțiunile de pe ecranele ulterioare pentru a finaliza implementarea pachetului.
Ecranele apar în funcție de definiția pachetului selectat pentru implementare. Pentru o implementare de pachet complet, care utilizează instrumentul Package Deployer, consultați subiectul pentru implementarea de pachete Unified Service Desk: Implementați aplicații eșantion Unified Service Desk pe CRM Server utilizând Package Deployer
Utilizați instrumentul Package Deployer la linia de comandă
Administratorii de sistem și persoanele care realizează particularizări pot trece parametri, cum ar fi un cod de limbă regională, la packagedeployer.exe din linia de comandă. Acești parametri pot fi configurați doar prin rularea instrumentului Package Deployer la linia de comandă.
Notă
Această caracteristică a fost introdusă prima dată în Dynamics CRM Online 2016, actualizarea 0.1.
Parametrii disponibili se află în acest tabel.
| Parametru | Descriere | Valoare implicită |
|---|---|---|
| RuntimePackageSettings | Instruiește packagedeployer.exe să accepte parametri ai liniei de comandă, cum ar fi LCID și SkipChecks. | Nu se aplică |
| LCID=localeID | Precizează ID-ul setării regionale, cum ar fi 1033 pentru Engleză-Statele Unite sau 1036 pentru Franceză-Franța, de la ID-urile disponibile ale stărilor regionale din pachet. Dacă nu este specificată o limbă, se va utiliza limba implicită. | Utilizați limba implicită |
| SkipChecks=true/false | Utilizați acest parametru doar atunci când mediul țintă nu conține soluții sau particularizări. Când setat la adevărat, importul soluției va ocoli unele controale de securitate, iar acest lucru poate îmbunătăți performanța importului. | Fals |
Următorul exemplu instruiește CRM Package Deployer să omită unele verificări de siguranță și setează limba de import la poloneză.
packagedeployer.exe /Settings:"SkipChecks=true|lcid=1045"
Notă
Utilizați caracterul | pentru a separa parametrii atunci când rulați packagedeployer.exe în linia de comandă cu parametri multipli.
Pentru mai multe informații despre parametrii și valorile care pot fi transmise la packagedeployer.exe, consultați Crearea de pachete pentru CRM Package Deployer.
Utilizați Windows PowerShell pentru a implementa pachete
Instrumentul Package Deployer oferă și asistență Windows PowerShell pentru a implementa pachete. Informații suplimentare: Începeți să utilizați modulul de implementare a pachetelor
Depanarea problemelor de implementare a pachetelor folosind fișierele jurnal
Instrumentul Package Deployer oferă asistență la înregistrarea în jurnal, pentru a obține informații detaliate despre erorile care pot apărea atunci când cineva se conectează la instanța Microsoft Dynamics 365 for Customer Engagement folosind instrumentul și pachetele de implementare. În mod implicit, instrumentul generează trei fișiere jurnal care sunt disponibile în următoarea locație de pe computerul unde rulați instrumentul: c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dynamics CRM Package Deployer\<Versiune>. Pentru a specifica un alt folder, utilizați parametrul cmdletului PowerShell -LogWriteDirectory. Mai multe informații: Utilizarea cmdletului pentru a prelua pachete
Login_ErrorLog.log: furnizează informații despre problemele care au apărut atunci când utilizați instrumentul pentru a vă conecta la instanța Dynamics 365. Dacă există probleme în timpul conectării, va apărea un mesaj pe ecranul de conectare al instrumentului cu un link către acest fișier jurnal. Mesajul afirmă că a apărut o eroare în timpul procesării solicitării de conectare și utilizatorul poate vizualiza jurnalul de eroare. Puteti face clic pe linkul din mesaj pentru a vizualiza acest fișier jurnal. Fișierul jurnal este creat prima dată când întâmpinați probleme de conectare în cadrul instrumentului. Ulterior, fișierul jurnal este folosit pentru a înregistra informații despre o problemă de conectare, ori de câte ori apare una.PackageDeployer.log: oferă informații detaliate despre fiecare activitate efectuată în instrument în timpul implementării pachetelor. Puteți vedea fișierul jurnal din instrument făcând clic pe linkul Vizualizare fișier jurnal din partea de jos a ecranului.ComplexImportDetail.log: oferă informații detaliate despre datele importate în ultima implementare, utilizând instrumentul. De fiecare dată când implementați un pachet folosind acest instrument, detaliile existente din fișierul jurnal sunt mutate într-un fișier numit ComplexImportDetail._old.log din același director, iar fișierul ComplexImportDetail.log afișează informații despre cel mai recent import realizat utilizând instrumentul.
Cele mai bune practici pentru implementarea pachetelor
În timpul implementării pachetelor, administratorii Dynamics 365 trebuie să facă următoarele lucruri:
Să insiste pe o adunare de pachet semnat, astfel încât să poată urmări un ansamblu inapoi la sursa sa.
Să testeze pachetul pe o instanță pre-producție (preferabil o imagine în oglindă a instanței de producție), înainte de a-l rula pe un server de producție.
Să facă backup instanței de producție înainte de a implementa un pachet.