Průvodce integračním balíčkem

  • Článek

Důležité

Tato verze orchestratoru dosáhla konce podpory. Doporučujeme upgradovat na Orchestrator 2019.

Průvodce integračním balíčkem (Průvodce IP adresou) umožňuje vytvořit nový integrační balíček z existujícího sestavení integrace. Sestavení integrace lze vytvářet pomocí Průvodce aktivitou Command-Line (CLIActivityWizard) nebo pomocí sady Orchestrator SDK. Průvodce IP adresou (IPWizard) zabalí sestavení, závislé soubory a požadovaná metadata do .OIP souboru, který lze nasadit prostřednictvím Nástroje Orchestrator Deployment Manager. Můžete vytvořit profesionálně vypadající integrační balíčky s plnou značkou a vlastními ikonami nebo jednoduše zabalit aktivity příkazového řádku, aby je bylo možné snadněji nasadit pomocí Průvodce ip adresou.

Rozhodování o tom, kdy vytvořit integrační balíček

Je důležité se rozhodnout, jestli je vhodné používat aktivity jednotlivě s aktivitami integračního balíčku sady .NET Toolkit, nebo je lepší vytvořit a nasadit všechny aktivity v integračním balíčku.

Pokud máte jen málo aktivit nebo když jste ve fázi vývoje a vytváříte mnoho změn v aktivitě, měli byste k provádění těchto aktivit v runboocích použít pouze sestavení s aktivitami integračního balíčku Toolkit .NET . Balení, registrace, nasazení, odinstalace a upgrade integračních balíčků nese v procesu vývoje velkou režii.

Pokud máte skupinu aktivit, které chcete otestovat, nebo jste dále ve vývojovém cyklu a chcete otestovat celý proces instalace nebo upgradu, je lepším přístupem vytvoření integračního balíčku. Integrační balíček poskytuje uživatelsky přívětivější prostředí a kompletní instalační prostředí. Integrační balíčky také umožňují nasazení aktivit na více serverů runbooků nebo návrhářů runbooků v rámci organizace nebo u externích zákazníků.

Vytvoření nového integračního balíčku

Průvodce integračním balíčkem umožňuje vytvářet integrační balíčky ze stávajících sestavení kompatibilních s nástrojem Orchestrator a závislých souborů. Pokud jste ještě nevytvořili sestavení kompatibilní s orchestratorem, projděte si Průvodce aktivitou příkazového řádku.

Poznámka

Sada Integration Toolkit již neobsahuje binární soubory pro sadu nástrojů Windows Installer XML (WiX), která se používá průvodcem IP k vytváření vlastních integračních balíčků. Před použitím Průvodce ip adresou nainstalujte nejnovější verzi sady nástrojů WiX (v3.11).

Vytvoření nového integračního balíčku

  1. Spusťte Průvodce integračním balíčkem. Vyberte Spustit > Průvodce integračním balíčkem nástroje Orchestrator. Zobrazí se úvodní stránka.

  2. Pokud máte existující integrační balíček, který chcete aktualizovat, vyberte Importovat integrační balíček. Další informace najdete v tématu Aktualizace existujícího integračního balíčku. Pokud chcete vytvořit nový integrační balíček, vyberte Další.

    Důležité

    Pokud chcete upgradovat existující IP adresu, musíte vybrat Importovat integrační balíček. Pokud vyberete Další, ip adresa, kterou vytvoříte, bude mít nové jedinečné ID produktu a nová jedinečná ID pro všechny aktivity, i když znovu použijete předchozí sestavení a použijete stejný produkt a názvy souborů.

  3. Na stránce Podrobnosti o produktu podle potřeby zadejte nebo upravte informace o integračním balíčku. Následující tabulka popisuje pole a jejich popisy:

    Název pole Description
    Název produktu Název IP adresy, která se zobrazí v Deployment Manageru
    Název kategorie Text, který se zobrazí jako název kategorie pro IP adresu v podokně Aktivity v nástroji Runbook Designer
    Společnost Název vaší společnosti. Tyto informace se zobrazí v části Přidat nebo odebrat programy v části Vydavatel.
    Soubor EULA Textový soubor ve formátu RTF s příponou .EULA . Smlouva EULA se uživateli zobrazí při registraci pomocí Deployment Manageru a před registrací vyžaduje souhlas.
    Soubor prostředků Sestavení obsahující ikony a další prostředky používané k poskytování ikon kategorií a aktivit. Ve výchozím nastavení se používá standardní soubor prostředků Sady nástrojů (Microsoft.SystemCenter.Orchestrator.Integration.Toolkit.Wizard.Images.dll).
    Verze Číslo verze integračního balíčku, které se zobrazí v Deployment Manageru a použije se k určení, jestli je IP adresa upgrade.
    Povolit upgrade Pokud jste naimportovali existující integrační balíček, je toto políčko ve výchozím nastavení zaškrtnuté a umožníte tomuto integračnímu balíčku upgradovat existující nainstalovanou verzi. Pokud zaškrtnutí tohoto políčka zrušíte, vytvoří se pro IP adresu nová ID produktů a aktivit (stávající verze se neupgraduje). Pokud chcete povolit souběžnou instalaci více verzí ip adresy, zrušte zaškrtnutí tohoto políčka.
    Description Podrobný popis integračního balíčku
    Ikona kategorie Zobrazí se výchozí ikona kategorie. Pokud chcete zvolit jinou ikonu, vyberte tlačítko Změnit , vyberte novou ikonu a pak vyberte OK.

  4. Až zadáte informace o produktu, vyberte Další. Zobrazí se stránka Aktivity. Na stránce Aktivity budete odkazovat na sestavení nebo sestavení, která obsahují aktivity, které jste definovali pomocí Průvodce aktivitou Command-Line nebo vytvořili pomocí sady Orchestrator SDK.

  5. Pokud chcete do IP adresy přidat novou aktivitu, vyberte Přidat.

  6. Pokud chcete otevřít a přidat soubor sestavení, vyberte tlačítko se třemi tečky (...) napravo od knihovny. Vyhledejte požadovaný soubor sestavení, vyberte ho a vyberte Otevřít. Název souboru a cesta se zobrazí v poli Knihovna.

  7. Pokud chcete vybrat aktivitu ze sestavení, vyberte šipku rozevíracího seznamu Třída a v seznamu vyberte příslušný název aktivity. Název a popis definovaný v aktivitě se zobrazí v polích Zobrazovaný název a Popis .

  8. V případě potřeby upravte zobrazovaný název a popis aktivity.

  9. Pro aktivitu se zobrazí výchozí ikona aktivity. Pokud je požadovaná jiná ikona, vyberte Změnit, v prohlížeči vyberte jinou ikonu a vyberte OK.

  10. Výběrem OK uložte definici aktivity. Název a popis aktivity se teď zobrazí v seznamu Aktivity.

  11. Podle potřeby pokračujte v přidávání aktivit do seznamu. Až přidávání aktivit dokončíte, vyberte Další. Zobrazí se stránka Závislosti a zahrnuté soubory.

  12. Na této stránce můžete definovat seznam dalších souborů, které chcete s integračním balíčkem zabalit. Tyto soubory můžou být další sestavení vyžadovaná vašimi aktivitami, skripty, dokumentací nebo jinými soubory, které chcete nasadit na runbook servery a runbook Designer spolu s vašimi aktivitami. Vyberte Přidat, vyberte soubory, které potřebujete, a pak výběrem OK přidejte soubory do seznamu.

  13. Až přidávání souborů do seznamu dokončíte, vyberte Další. Zobrazí se stránka Soubor integračního balíčku nástroje Orchestrator.

  14. Do zadaného textového pole zadejte cestu a název souboru integračního balíčku, který se má vytvořit. Pokud zadáte název souboru, který už existuje, přepíše se. Ujistěte se, že máte dostatečný přístup k zápisu do zadané cesty, jinak proces selže. Pokud není zadána žádná cesta, soubor OIP se vytvoří ve složce Dokumenty (C:\users\<your username>\Documents). Vyberte Další a začněte vytvářet IP adresu.

    Důležité

    Znaky v názvu souboru musí být platné pro jazyk nainstalovaný ve vašem operačním systému.

    Důležité

    Zadejte název integračního balíčku, který není běžný, abyste zajistili, že neodpovídá názvu jiného integračního balíčku. Orchestrator nemůže nainstalovat dva integrační balíčky se stejným názvem.

  15. Po úspěšném sestavení IP adresy se na poslední stránce průvodce zobrazí cesta a název souboru nového OIP. Výběrem možnosti Dokončit průvodce ukončete. Pokud dojde k chybě, můžete vybrat Zpět a zkusit proces sestavení zopakovat.

    Informace o nasazení integračního balíčku najdete v článku Přidání integračního balíčku.

Aktualizace existujícího integračního balíčku

Průvodce integračním balíčkem nástroje Orchestrator umožňuje importovat existující integrační balíček, abyste mohli provádět změny a znovu ho zabalit jako novou verzi. Nezapomeňte zaškrtnout políčko Povolit upgrade , jinak se místo nahrazení nebo upgradu předchozí nainstalované verze vytvoří nová IP adresa.

Užitečné tipy pro upgrade IP adresy

Aktualizace podkladových sestavení

Když vytvoříte integrační balíček, metadata o IP adrese jsou uložena v balíčku, aby je průvodce mohl přečíst během následných upgradů. Při aktualizaci určitých položek, jako jsou aktivity nebo podkladová sestavení pro tyto aktivity, je nutné znovu sestavit IP adresu. Pokud však změníte nastavení aktivity a vyberete nový soubor sestavení, obnoví se pole na stránce Informace o aktivitě, což vyžaduje, abyste tyto informace zadali znovu.

Nastavení konfigurace IP adresy můžete zachovat i při úpravě pouze sestavení. Uložte nové sestavení na stejnou cestu a název souboru jako předchozí sestavení (které je zobrazeno v poli Knihovna v dialogovém okně Informace o aktivitě).

Migrace integračního balíčku QIK

Pokud jste integrační balíček vytvořili pomocí průvodce Opalis QIK, budete ho muset před importem a použitím nástroje Orchestrator převést na kompatibilní s nástrojem Orchestrator.

Před převodem IP adresy je nutné provést následující kroky:

  • Pokud se aktivity ve vaší IP adrese vytvořily pomocí Průvodce rozhraním příkazového řádku QIK, musíte postupovat podle kroků uvedených v tématu Migrace aktivity rozhraní příkazového řádku QIK , aby byly kompatibilní s nástrojem Orchestrator. Pokud nemáte samostatnou kopii sestavení obsahující aktivity, budete muset nejprve nainstalovat IP adresu na server Opalis 6.3 a pak najít sestavení v následujícím adresáři: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Quick Integration Kit 3.

  • Pokud byly aktivity ve vaší IP adrese vyvinuty na míru v jazyce C# pomocí rozhraní Opalis API, musíte postupovat podle kroků uvedených v tématu Migrace vlastních aktivit rozhraní API QIK , aby byly kompatibilní s orchestratorem.

    Poznámka

    Aktivity založené na javě pomocí rozhraní Opalis API pro Javu už nejsou podporovány sadou Integration Toolkit ani nástrojem Orchestrator.

  • Pokud vaše IP adresa obsahuje závislé nebo jiné zahrnuté soubory, musí být tyto soubory k dispozici pro opětovné zabalení do nové IP adresy. Pokud nemáte samostatnou kopii těchto souborů, musíte nejprve nainstalovat IP adresu na server Opalis 6.3 a pak najít soubory v následujícím adresáři: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Bin.

  • Pokud vaše IP adresa obsahuje vlastní soubor prostředků, který se používá pro ikony aktivit a kategorií, musí být tento soubor pro novou IP adresu dostupný. Pokud nemáte samostatnou kopii tohoto souboru, musíte nejprve nainstalovat IP adresu na server Opalis 6.3 a pak soubor najít v následujícím adresáři: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions.

  • Pokud vaše IP adresa používala standardní ikony, které poskytuje QIK pro ikony kategorií nebo aktivit, a chcete tyto ikony dál používat místo nových ikon poskytovaných v orchestratoru, budete muset získat Opalis.QIK.Wizard.Images.dll soubor a použít ho stejně jako vlastní soubor prostředků. Pokud nemáte samostatnou kopii tohoto souboru, musíte nejprve nainstalovat IP adresu na server Opalis 6.3 a pak soubor najít v následujícím adresáři: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions.

Poznámka

Pro nejjednodušší proces převodu byste měli před spuštěním Průvodce ip adresou umístit všechny tyto soubory do umístění, ve kterých byly při původním zabalení IP adresy. Průvodce IP adresou odkazuje na tyto soubory podle jejich původních cest. Výběr nové cesty je možný pro všechny soubory, ale výběr nové cesty pro sestavení obsahující aktivity způsobí, že některé podrobnosti aktivity se mají resetovat, což bude vyžadovat, abyste tyto informace zadali znovu. Při použití původních cest k souborům se stávající informace jednoduše znovu používají, aniž byste je museli znovu zadávat.

Převod integračního balíčku kompatibilního s Opalisem

  1. Spuštění Průvodce integračním balíčkem

  2. Vyberte Integrační balíček Import.

  3. Vyberte existující soubor OIP a vyberte Otevřít.

  4. Zobrazí se zpráva s upozorněním, že IP adresa není kompatibilní s nástrojem Orchestrator. Vyberte OK.

  5. Podle potřeby upravte podrobnosti o produktu tak, aby odrážely všechny změny. Číslo verze IP adresy se automaticky zvýší a políčko Upgradovat je zaškrtnuté. Vyberte Další.

  6. Na stránce Aktivity projděte jednotlivé aktivity a ujistěte se, že jsou informace správně dokončené. Pokud sestavení pro aktivitu nebylo migrováno nebo není ve stejném umístění, jako bylo při vytvoření IP adresy, bude pole Třída prázdné. Chcete-li zabránit opakovanému zadání informací, měli byste před spuštěním průvodce nahradit sestavení.

  7. Až dokončíte úpravy aktivit, vyberte Další.

  8. Ujistěte se, že jsou závislé soubory stále ve stejném umístění, jak je znázorněno, nebo je odeberte a přidejte nové závislé soubory. Vyberte Další.

  9. Zadejte cestu a název souboru pro nový soubor IP. Nepoužívejte stejný název jako předchozí IP adresu, abyste měli jistotu, že si zachováte kopii předchozí IP adresy. Vyberte Další a vytvořte IP adresu.

    Teď máte IP adresu, která je kompatibilní s nástrojem Orchestrator a dá se zaregistrovat a nasadit pomocí nástroje Orchestrator Deployment Manager.

Integrační balíčky – známé problémy

Omezení délky názvu souboru

Pokud do integračního balíčku zahrnete sestavení, instalační program je automaticky přidá do registru. Vzhledem k omezení délky názvu klíče registru nesmí kombinovaná cesta a název souboru sestavení překročit 234 znaků. Vzhledem k výchozí cestě, kam jsou umístěna sestavení v rámci IP adresy, nesmí maximální délka souboru zahrnutého sestavení překročit 80 znaků. Pokud je součástí instalace sestavení s názvem přesahujícím 80 znaků, instalace selže.

Prostředky nástroje Orchestrator

Kromě této online reference k nástroji System Center Orchestrator existuje mnoho zdrojů informací, které můžou poskytnout další informace o vytváření runbooků, používání integrační sady nástrojů a osvědčených postupech.

Viz také