Megosztás a következőn keresztül:

Csomagok telepítése a Package Deployer és a Windows PowerShell használatával

Feljegyzés

Az új és továbbfejlesztett Power Platform felügyeleti központ mostantól nyilvános előzetes verzióban érhető el! Az új felügyeleti központot úgy terveztük, hogy könnyebben használható legyen, feladatorientált navigációval, amely segít gyorsabban elérni bizonyos eredményeket. Új és frissített dokumentációt fogunk közzétenni, amint az új Power Platform felügyeleti központ általánosan elérhetővé válik.

A Microsoft Dynamics CRM Package Deployer lehetővé teszi rendszergazdák számára a csomagok központi telepítését környezetekbe.

Feljegyzés

A Package Deployer Dynamics 365 Customer Engagement (on-premises)-szervezetekkel is használható.

Egy „csomag” összetevői az alábbiak lehetnek:

  • Egy vagy több Dataverse megoldásfájl.

  • Egyszintű (flat) fájlok vagy a Configuration Migration eszközből exportált adatfájlok. A Configuration Migration eszközzel kapcsolatos további információért lásd: Konfigurációs adatok kezelése.

  • A csomag környezetbe való telepítése során vagy után futtatható egyedi kódok.

  • A csomagra jellemző egyedi HTML-tartalom, amely a csomag telepítésének elején vagy végén jeleníthető meg. Ez egy hasznos eszköz a csomagban telepített megoldások és fájlok leírására.

    A fejlesztők a Visual Studio alkalmazásban található csomagtelepítési sablon használatával hozhatnak létre csomagokat. További információ: Készítsen csomagokat a Package Deployer számára

    Egy csomag létrehozása után a CRM Package Deployer futtatásával vagy Windows PowerShell parancsmagok eszközzel való használatával telepítheti azt.

Fontos

Mielőtt importálna és lefuttatna egy csomagot egy termelési szervezetben, tesztelje le a csomagot egy termelésen kívüli szervezeten, amely a termelési szervezet pontos mása.

Egy csomag telepítése előtt mindig készítsen biztonsági másolatot a termelési szervezetről.


Csomagok telepítése a Package Deployer eszköz segítségével

A Package Deployer eszköz (packagedeployer.exe) segítségével a következő módon telepíthet csomagokat.

Csomagok telepítése CRM Package Deployer eszközzel

Használja a CRM Package Deployer eszközt a parancssorban

Csomagok telepítése a Package Deployer eszköz segítségével

A Package Deployer eszköz egyszerre csak egy csomagot tud feldolgozni. Azonban lehetővé teszi a felhasználó számára, hogy a Package Deployer eszköz tárjában elérhető több csomagból telepítő csomagot válasszon ki. Az eszközben található egyes képernyők és műveletek a csomagdefiníciótól függően eltérőek lehetnek. Nem szükséges telepítenie a Package Deployer eszközt. Elég ha letölti és futtatja.

  1. Szerezze be a telepíteni kívánt csomagot. A csomag mappák és fájlok gyűjteménye, amely saját Visual Studio-projektmappájában jön létre (<Project>\Bin\Debug) amikor a csomagprojektet felépíti a Visual Studio rendszerben. Másolja át hibakeresési mappájának tartalmából a következő elemeket:

    • <PackageName> mappa: Ez a mappa tartalmazza a megoldásokat, az importálási konfigurációt és a csomag tartalmát.

    • <PackageName>.dll: A szerelvény tartalmazza a csomag kódját. Alapértelmezés szerint a szerelvény neve megegyezik Visual Studio projektjének nevével.

      A csomagok Visual Studio használatával való létrehozásáról részletesebb információért lásd: Csomag létrehozása a Package Deployer eszközzel.

      Ehhez a témakörhöz, tételezzük fel, hogy a Visual Studio projekt hibakeresési mappájából (<Projekt>\Bin\Debug) a csomagmappa és a szerelvény át lett másolva a c:\DeployPackage mappába.

  2. A Package Deployer eszköz beszerzése. A Package Deployer eszköz NuGet-csomag formájában áll rendelkezésre. A Package Deployer használatához le kell töltenie és ki kell csomagolnia a helyi számítógépre a nuget.exe segítségével.

    Töltse le nuget.exe fájlt a https://www.nuget.org/downloads oldalról, és mentse el a számítógépére, pl. a d:\ meghajtóra. Ezután futtassa a következő parancsot a számítógépe parancssorából, és csomagolja ki a csomag tartalmát egy mappába, pl. a PD nevűbe:
    d:\nuget install Microsoft.CrmSdk.XrmTooling.PackageDeployment.Wpf -Version [VERSION] -O d:\PD

    Miután kicsomagolta a Package Deployer eszközt, keresse meg a(z) [ExtractedLocation]\tools mappában a Package Deployer.exe fájlt.

  3. Másolja át a csomagmappát és a szerelvényt a c:\DeployPackage mappából az [ExtractedLocation]\tools mappába.

  4. A fájlok átmásolása után, az eszköz futtatásához kattintson duplán a [ExtractedLocation]\tools mappában található PackageDeployer.exe fájlra.

  5. Az eszköz fő képernyőjén kattintson a Tovább gombra.

  6. A Csatlakozás a Microsoft Dynamics 365 for Customer Engagement alkalmazásokhoz képernyőn adja meg a hitelesítő adatokat annak érdekében, hogy csatlakozhasson azon Dynamics 365 kiszolgálóhoz, amelyen központilag telepíteni kívánja a csomagot. Ha több szervezete van, és ezek közül ki szeretné választani azt, ahol a csomagot telepíteni kívánja, akkor jelölje meg Az elérhető szervezetek listájának mindenkori megjelenítése jelölőmezőt. Kattintson a Bejelentkezés gombra.

  7. Ha több szervezete is van A Dynamics 365 kiszolgálóján, jelölje ki azt a Dynamics 365 alkalmazások szervezetet, amelyhez kapcsolódni kíván.

  8. Jelölje ki a telepíteni kívánt csomagot, majd kattintson a Tovább lehetőségre.

    Válassza ki a csomagot az Package Deployer eszközben.

  9. A következő képernyőkön kövesse az utasításokat a csomag telepítésének befejezéséhez.

    A képernyők a telepítésre kiválasztott csomag definíciója alapján jelennek meg. A Package Deployer eszközzel való teljes körű csomagtelepítéshez lásd a Unified Service Desk csomagok központi telepítéséről szóló témakört: Unified Service Desk alkalmazás központi telepítése a CRM szerverre a Package Deployer csomagtelepítővel

A Package Deployer használata a parancssorból

A rendszergazdák és a testreszabók a parancssorból is megadhatnak paramétereket (pl. régió nyelvi kódja) a packagedeployer.exe számára. Ezeket a paraméterek csak a Package Deployer eszköz parancssorból történő futtatása esetén konfigurálhatók.

Feljegyzés

Ez a funkció először a Dynamics CRM Online 2016 Update 0.1 szolgáltatásban jelent meg.

A rendelkezésre álló paraméterek megtalálhatók ebben a táblázatban.

Paraméter Description Alapértelmezett érték
RuntimePackageSettings Utasítja a packagedeployer.exe alkalmazást, hogy fogadjon el parancssori paramétereket, mint az LCID és a SkipChecks. Nem alkalmazható
LCID=localeID Megadja a területi azonosítót (például az 1033 az angol-Egyesült Államok, az 1036 a francia-Franciaország) a csomagban elérhető területi azonosítók közül. Ha nincs megadva, az alapértelmezett nyelvet használja az alkalmazás. Az alapértelmezett nyelv használata
SkipChecks = igaz/hamis Ezt a paramétert csak akkor használja, ha a célkörnyezet nem tartalmaz semmilyen más megoldást vagy testreszabást. Ha az értéke „igaz”, a megoldásimportálás kihagy néhány biztonsági ellenőrzést, így javítva az importálás teljesítményét. Hamis

A következő példa arra utasítja a CRM Package Deployer alkalmazást, hogy hagyjon ki néhány biztonsági ellenőrzést, és hogy a lengyel nyelvet importálja.

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

Feljegyzés

Használja a függőleges vonás karaktert (|) a paraméterek elválasztásához, ha a parancssorból futtatja a packagedeployer.exe alkalmazást, és több paramétert is megad.

További információk a packagedeployer.exe paramétereiről és a megadható értékekről: Csomagok létrehozása a CRM Package Deployer segítségével.

Csomagok telepítése a Windows PowerShell segítségével

A Package Deployer eszköz a Windows PowerShell alkalmazást is támogatja a csomagok telepítéséhez. További információk: Első lépések a csomagtelepítő modul használatával

A csomagtelepítés hibáinak elhárítása a naplófájlok segítségével

A Package Deployer eszköz naplózási támogatásával részletes információt kaphat az olyan hibákról, amelyek akkor lépnek fel, ha valaki az eszköz segítségével jelentkezik be a Microsoft Dynamics 365 for Customer Engagement-példányba és csomagokat központilag telepít. Alapértelmezés szerint az eszköz három naplófájlt generál, amelyek az alábbi útvonalon érhetők el az eszközt futtató számítógépen: c:\Users\<felhasználónév>\AppData\Roaming\Microsoft\Microsoft Dynamics CRM Package Deployer\<verziószám>. Egy másik mappa megadásához használja a -LogWriteDirectory PowerShell-parancsmag paramétert. További információ: Csomagok beolvasása parancsmag használatával

  • Login_ErrorLog.log: Információkat nyújt azokról a problémákról, amelyek akkor fordultak elő, amikor az eszközzel jelentkezett be a Dynamics 365 példányba. Ha a bejelentkezés során hiba lép fel, egy üzenet figyelmezteti erre az eszköz bejelentkezési képernyőjén, amely egy linket is tartalmaz a naplófájlhoz. Az üzenet jelzi, hogy hiba lépett fel a bejelentkezési kérelem feldolgozása közben, és a felhasználó megtekintheti a hibanaplót. Az üzenetben található linkre kattintva nyithatja meg a naplófájlt. A naplófájl akkor jön létre, amikor először merülnek fel bejelentkezési problémák az eszközzel kapcsolatban. Ezt követően folyamatosan naplózza a bejelentkezési hibákat, bármikor is lépnek fel.

  • PackageDeployer.log: Részletes információkat nyújt az eszközben a csomagok telepítése során végrehajtott egyes feladatokról. Az eszköz naplófájlját a képernyő alján található Naplófájl megjelenítése linken nézheti meg.

  • ComplexImportDetail.log: Részletes információkat nyújt az eszköz használatával az utolsó üzembe helyezés során importált adatokról. Valahányszor csomagot telepít az eszközzel, a naplófájl már meglevő adati átkerülnek az ugyanabban a mappában található ComplexImportDetail._old.log nevű fájlba, a ComplexImportDetail.log fájl pedig mindig a legutóbb végrehajtott importálás információit fogja tartalmazni.

Gyakorlati tanácsok a csomagok telepítéséhez

Csomagok központi telepítése során a Dynamics 365 rendszergazdáknak az alábbiakat kell kötelezően megtenniük:

  • Ragaszkodni egy aláírt csomagszerelvényt biztosításához, hogy később visszakövethessék a szerelményt egészen a forrásáig.

  • Előkészítő környezetben (lehetőleg az Üzemi példánnyal teljesen megegyező rendszerben) tesztelni a csomagot, mielőtt üzemi szerveren futtatnák.

  • A csomag telepítése előtt biztonsági másolatot készíteni az üzemi példányról.

Lásd még

Csomagok létrehozása a CRM-hez Package Deployer