Sdílet prostřednictvím

Nasazení balíčků pomocí nástroje CRM Package Deployer a prostředí Windows PowerShell

  • Článek

 

Publikováno: listopad 2016

Platí pro: Dynamics CRM 2015

Microsoft Dynamics CRM Package Deployer umožňuje správcům nasadit balíčky na instance Microsoft Dynamics CRM (místní edice) nebo Microsoft Dynamics CRM Online. „Balíček“ může být tvořen jakoukoli nebo všemi následujícími položkami:

  • Jeden nebo více souborů řešení aplikace Dynamics 365.

  • Ploché soubory nebo soubory exportovaných dat z nástroje Nástroj pro migraci konfigurace. Další informace o nástroji Nástroj pro migraci konfigurace naleznete v tématu Správa dat konfigurace.

  • Vlastní kód, který lze spustit během nebo po nasazení balíčku do aplikace Microsoft Dynamics 365.

  • Obsah HTML specifický pro balíček, který lze zobrazit na začátku a na konci procesu nasazení balíčku. To může být užitečné pro poskytnutí popisu řešení a souborů, které jsou nasazeny v balíčku.

Vývojáři vytváří balíčky pomocí šablony pro nasazení balíčku v aplikaci Microsoft Visual Studio.Další informace:MSDN: Vytvoření balíčků pro nástroj CRM Package Deployer

Po vytvoření balíčku jej lze nasadit buď spuštěním nástroje Nástroj pro nasazení balíčků CRM, nebo pomocí rutin prostředí Windows PowerShell pro nástroj.

V tomto tématu

Použití nástroje CRM Package Deployer k nasazení balíčků

Použití prostředí Windows PowerShell k nasazení balíčků

Řešení problémů s nasazením balíčků pomocí souborů protokolů

Osvědčené postupy pro nasazení balíčků

Použití nástroje CRM Package Deployer k nasazení balíčků

Nástroj Nástroj pro nasazení balíčků může zpracovat pouze jeden balíček najednou. Poskytuje však uživatelům možnost vybrat balíček k nasazení z několika balíčků, které jsou k dispozici v adresáři nástroje Nástroj pro nasazení balíčků. Některé obrazovky a akce v nástroji se liší v závislosti na definici balíčku. Nástroj Nástroj pro nasazení balíčků není třeba instalovat. Stačí jej stáhnout a spustit.

  1. Získejte balíček k nasazení. Balíček je kolekce souborů a složek vytvořená ve složce projektu aplikace Visual studio (<Projekt>\Bin\Debug) při sestavování projektu balíčku v aplikaci Visual Studio. Ze složky ladění projektu zkopírujte následující:

    • Složka <název balíčku>: Tato složka obsahuje řešení, konfiguraci importu a obsahu balíčku.

    • <název balíčku>.dll: Sestavení obsahuje kód vašeho balíčku. Výchozí název sestavení je stejný jako název projektu v Visual Studio.

    Podrobné informace o vytvoření balíčku pomocí aplikace Visual Studio naleznete v tématu MSDN: Vytvoření balíčku pro nástroj Package Deployer.

    K tomuto tématu předpokládejme, že složka balíčku a sestavení ze složky ladění projektu Visual Studio (<Projekt>\Bin\Debug) jsou zkopírovány do složky c:\DeployPackage.

  2. Stáhněte si balíček Microsoft Dynamics CRM SDK. Spusťte stažený spustitelný soubor a extrahujte obsah balíčku.

  3. Přejděte do složky SDK\Tools\PackageDeployer a zkopírujte složku balíčku a sestavení z c:\DeployPackage do složky SDK\Tools\PackageDeployer.

  4. Po zkopírování souborů spusťte nástroj dvojitým kliknutím na soubor PackageDeployer.exe ve složce SDK\Tools\PackageDeployer.

  5. Klikněte na tlačítko Pokračovat na hlavní obrazovce nástroje.

  6. Na obrazovce Připojit k aplikaci Microsoft Dynamics CRM zadejte přihlašovací údaje pro připojení k serveru Dynamics 365, na který chcete nasadit balíček. Pokud máte více organizací a chcete vybrat organizaci, do které chcete nasadit balíček, zaškrtněte políčko Vždy zobrazit seznam dostupných organizací. Klikněte na tlačítko Přihlášení.

  7. Pokud máte na svém serveru aplikace Dynamics 365 více organizací a zaškrtnete políčko Vždy zobrazit seznam dostupných organizací, na další obrazovce je možné zvolit organizaci, ke které se chcete připojit. Vyberte organizaci Dynamics 365, ke které se chcete připojit.

  8. Další obrazovka zobrazí výzvu k výběru balíčku pro nasazení. Vyberte název balíčku a klikněte na tlačítko Další.

    Výběr balíčku v nástroji Package Deployer

  9. Postupujte podle pokynů na následujících obrazovkách a dokončete nasazení balíčku.

    Obrazovky se zobrazí v závislosti na definici balíčku, který jste vybrali pro nasazení. Informace o uceleném nasazení balíčku s využitím nástroje Nástroj pro nasazení balíčků naleznete v tématu pro nasazení balíčků Unified Service Desk: Nasazení ukázkových aplikací Unified Service Desk na CRM Server pomocí nástroje Package Deployer

Použití prostředí Windows PowerShell k nasazení balíčků

Nástroj Nástroj pro nasazení balíčků také poskytuje podporu prostředí Windows PowerShell k nasazení balíčků.

Proveďte následující kroky pro použití rutin prostředí PowerShell k nasazení balíčků:

Předpoklady

Registrace rutin

Použití rutiny k získání balíčků

Použití rutiny pro připojení k serveru CRM

Použití rutiny k nasazení balíčků

Získání podrobné nápovědy k rutinám

Předpoklady

Zde jsou požadavky pro použití rutin prostředí PowerShell:

  • Pro nasazení balíčku s využitím prostředí PowerShell je vyžadováno prostředí PowerShell verze 3.0 nebo vyšší. Chcete-li zkontrolovat svou verzi prostředí PowerShell, otevřete okno prostředí PowerShell a spusťte následující příkaz: $Host

  • Nastavte zásady spouštění, aby byly spuštěny podepsané skripty prostředí PowerShell. Chcete-li to provést, otevřete okno prostředí PowerShell jako správce a spusťte následující příkaz: Set-ExecutionPolicy -ExecutionPolicy AllSigned

Registrace rutin

Musíte zaregistrovat rutiny prostředí Windows PowerShell pro nástroj Nástroj pro nasazení balíčků před jeho použitím. Registrace rutin:

  1. Pokud jste tak již neučinili, stáhněte balíček SDK aplikace Dynamics 365 z centra Stažení softwaru a spuštěním souboru balíčku extrahujte obsah balíčku. Předpokládejme, že jste extrahovali balíček do složky c:\CRM v počítači. Nástroj Nástroj pro nasazení balíčků a ostatní požadované soubory budou k dispozici v následujícím umístění: c:\CRM\SDK\Tools\PackageDeployer.

  2. Spusťte prostředí Windows PowerShell v počítači se zvýšenými oprávněními (jako správce).

  3. Při zobrazení výzvy v okně prostředí Windows PowerShell změňte adresář na složku prostředí Windows PowerShell ve složce PackageDeployer. V tomto případě:

    cd c:\CRM\SDK\Tools\PackageDeployer\PowerShell

  4. Spuštěním skriptu RegisterXRMTooling.ps1 proveďte registraci sestavení nástroje Package Deployer Windows PowerShell (soubor .dll) a nainstalujte modul snap-in prostředí Windows PowerShell pro nástroj Nástroj pro nasazení balíčků. Chcete-li to provést, zadejte následující příkaz a stiskněte klávesu ENTER:

    .\RegisterXRMTooling.ps1

  5. Přidejte modul snap-in prostředí Windows PowerShell pro nástroje XRM. Tím budou zaregistrovány následující rutiny: Get-CrmConnection a Get-CrmOrganizations.

    Add-PSSnapin Microsoft.Xrm.Tooling.Connector

  6. Přidejte modul snap-in prostředí Windows PowerShell pro nástroj Package Deployer. Tím budou zaregistrovány následující rutiny: Get-CrmPackages a Import-CrmPackage.

    Add-PSSnapin Microsoft.Xrm.Tooling.PackageDeployment

Nyní jste připraveni používat tyto rutiny prostředí Windows PowerShell. Chcete-li zobrazit seznam rutin, které jste zaregistrovali, spusťte při zobrazení výzvy následující příkaz v okně prostředí Windows PowerShell:

Get-Help “Crm”

Použití rutiny k získání balíčků

Dříve než můžete použít rutiny, ujistěte se, že jste zkopírovali balíček do složky PackageDeployer (v tomto případě c:\CRM\SDK\Tools\PackageDeployer). Balíček je kolekce souborů a složek vytvořená ve složce projektu aplikace Visual Studio (<Projekt>\Bin\Debug) při sestavování projektu v aplikaci Visual Studio. Zkopírujte celý obsah složky ladění projektu do složky PackageDeployer. Podrobné informace o vytvoření balíčku pomocí aplikace Visual Studio naleznete v tématu MSDN: Vytvoření balíčků pro nástroj CRM Package Deployer.

  1. V okně prostředí PowerShell použijte následující rutinu k navrácení seznamu balíčků, které jsou k dispozici pro import v zadaném adresáři (v tomto případě c:\CRM\SDK\Tools\PackageDeployer):

    Get-CrmPackages –PackageDirectory c:\CRM\SDK\Tools\PackageDeployer

  2. Pokud chcete informace o balíčku v adresáři, můžete použít rutinu Get-CrmPackages spolu s parametrem –PackageName k zadání názvu sestavení v adresáři, který obsahuje definici balíčku.

    Get-CrmPackages –PackageDirectory c:\CRM\SDK\Tools\PackageDeployer –PackageName SampleCRMPackage.dll

Použití rutiny pro připojení k serveru CRM

  1. Zadejte přihlašovací údaje pro připojení k aplikaci Microsoft Dynamics CRM Online nebo instanci aplikace Microsoft Dynamics CRM (místní edice). Po spuštění následujícího příkazu se zobrazí výzva k zadání vašeho uživatelského jména a hesla pro připojení k instanci aplikace Dynamics 365. Tyto údaje budou uloženy v proměnné $Cred a použity později pro připojení k serveru CRM.

    $Cred = Get-Credential

  2. Pomocí následujícího příkazu můžete vytvořit připojení k aplikaci Microsoft Dynamics CRM Online nebo instanci aplikace Microsoft Dynamics CRM (místní edice). Informace o připojení budou uloženy v proměnné $CRMConn:

    • Pokud se připojujete k instanci aplikace Microsoft Dynamics CRM (místní edice):

      $CRMConn = Get-CrmConnection -ServerUrl http://<your_CRM_Server> -OrganizationName <your_Org_Name> -Credential $Cred

    • Pokud se připojujete k serveru Microsoft Dynamics CRM Online:

      $CRMConn = Get-CrmConnection -DeploymentRegion NorthAmerica –OnlineType Office365 –OrganizationName <your_Org_Name> -Credential $Cred

      Poznámka

      Pro parametr DeploymentRegion jsou platné hodnoty NorthAmerica, EMEA a APAC. Pro parametr OnlineType jsou platné hodnoty Office365 a LiveID.

  3. Zadané přihlašovací údaje budou ověřeny při spuštění příkazu v kroku 2.

Použití rutiny k nasazení balíčků

Dále použijte informace o připojení k aplikaci CRM uložené v proměnné $CRMConn pro nasazení balíčků do instance aplikace Dynamics 365. Spusťte následující příkaz pro nasazení balíčku:

Import-CrmPackage –CrmConnection $CRMConn –PackageDirectory c:\CRM\SDK\Tools\PackageDeployer –PackageName SampleCRMPackage.dll –UnpackFilesDirectory c:\UnpackedFiles -Verbose

Poznámka

  • Parametry CrmConnection, PackageDirectory a PackageName jsou povinné.

  • U parametru PackageName je nutné zadat název sestavení, které obsahuje definici balíčku.

  • Parametr UnpackFilesDirectory není nutné zadat v případě, že balíček během svého nasazení nerozbaluje soubory. Při definování balíčku v aplikaci Visual Studio určete, zda mají být rozbaleny soubory pomocí parametru agentdesktopzipfile v souboru ImportConfig.xml.Další informace:MSDN: Vytvoření balíčků pro nástroj CRM Package Deployer

  • Parametr Verbose je nepovinný a slouží k zobrazení podrobného protokolu činností prováděných během procesu nasazení balíčku.

Získání podrobné nápovědy k rutinám

V okně prostředí PowerShell použijte rutinu Get-Help s názvem rutiny k zobrazení podrobné nápovědy pro rutinu. Chcete-li například získat podrobnou nápovědu pro rutinu Import-CrmPackage:

Get-Help Import-CrmPackage -full

Online nápovědy pro rutiny naleznete v tématu CRM PowerShell odkaz.

Řešení problémů s nasazením balíčků pomocí souborů protokolů

Nástroj Nástroj pro nasazení balíčků poskytuje podporu protokolování a umožňuje získat podrobné informace o chybách, které se mohou vyskytnout, pokud se někdo přihlásí k instanci aplikace Microsoft Dynamics CRM pomocí nástroje a provádí nasazení balíčků. Nástroj generuje tři soubory protokolu, které jsou k dispozici v následujícím umístění v počítači, kde jste spustili nástroj: c:\Users\<uživatelské_jméno>\AppData\Roaming\Microsoft\PackageDeployer\<verze>.

  • Login_ErrorLog.log: Poskytuje informace o problémech, k nimž došlo při použití nástroje pro přihlášení k instanci aplikace Dynamics 365. Pokud se vyskytnou nějaké problémy při přihlášení, zobrazí se zpráva na přihlašovací obrazovce nástroje s odkazem na tento soubor protokolu. Zpráva uvádí, že došlo k chybě při zpracování žádosti o přihlášení a uživatel může zobrazit protokol chyb. Kliknutím na odkaz v této zprávě můžete zobrazit soubor protokolu. Soubor protokolu je vytvořen, když v nástroji poprvé narazíte na jakýkoli problém s přihlášením. Poté se soubor protokolu používá k protokolování informací o problému s přihlášením vždy, když k němu dojde.

  • PackageDeployer.log: Poskytuje podrobné informace o jednotlivých úkolech provedených v nástroji během nasazování balíčků. Soubor protokolu můžete zobrazit z nástroje kliknutím na odkaz Zobrazit soubor protokolu v dolní části obrazovky.

  • ComplexImportDetail.log: Poskytuje podrobné informace o datech importovaných v posledním nasazení pomocí nástroje. Pokaždé, když pomocí tohoto nástroje nasadíte balíček, existující podrobnosti ze souboru protokolu jsou přesunuty do souboru s názvem ComplexImportDetail._old.log ve stejném adresáři a soubor ComplexImportDetail.log zobrazí informace o posledním importu provedeném pomocí nástroje.

Osvědčené postupy pro nasazení balíčků

Při nasazování balíčků musí správci aplikace Dynamics 365:

  • Trvat na sestavení podepsaného balíčku tak, aby mohli sledovat sestavení zpět k jeho zdroji.

  • Otestovat balíček na předprodukční instanci (nejlépe zrcadlový obraz produkční instance) před jeho spuštěním na produkčním serveru.

  • Zálohovat produkční instanci před nasazením balíčku.

Viz také

MSDN: Vytvoření balíčků pro nástroj CRM Package Deployer
Správa aplikace CRM 2015

© 2016 Microsoft Corporation. Všechna práva vyhrazena. Autorská práva