Sdílet prostřednictvím

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

  • Článek

Průvodce integračním balíčkem (Průvodce IP sadou) umožňuje vytvořit nový integrační balíček z existujícího sestavení integrace. Sestavení integrace je možné vytvořit pomocí Průvodce aktivitou příkazového řádku (CLIActivityWizard) nebo pomocí sady Orchestrator SDK. PrůvodceIPWizard IP sadou zabalí sestavení, závislé soubory a požadovaná metadata do .OIP souboru, který je možné nasadit přes Správce nasazení nástroje Orchestrator. Můžete vytvářet profesionálně vypadající integrační balíčky s úplným brandingem 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.

Rozhodnutí 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 .NET toolkit, nebo je lepší vytvářet a nasazovat všechny aktivity v integračním balíčku.

Pokud máte jenom několik 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, nasazování, odinstalace a upgrade integračních balíčků se při vývoji účtují velké režijní náklady.

Pokud máte skupinu aktivit k otestování nebo jste dále ve vývojovém cyklu a chcete otestovat celý kompletní 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í prostředí instalace. Integrační balíčky také umožňují nasazení aktivit na několik serverů runbooků nebo návrhářů runbooků v rámci organizace nebo 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 z existujících sestavení kompatibilních s orchestratorem a závislých souborů. Pokud jste ještě nevytvořili sestavení kompatibilní s orchestratorem, přečtěte si Průvodce aktivitou příkazového řádku.

Poznámka:

Integrační sada nástrojů již neobsahuje binární soubory pro sadu nástrojů XML instalační služby systému Windows (WiX), kterou používá Průvodce IP sadou pro vytváření vlastních integračních balíčků. Před použitím Průvodce IP sadou nástrojů 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 Průvodce spuštěním >integračního balíčku orchestratoru. 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 naleznete 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 import integračního balíčku. Pokud vyberete Další, bude mít ip adresa, kterou vytvoříte, 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 zadejte nebo upravte informace podle potřeby tak, aby se přizpůsobily informace o integračním balíčku. Následující tabulka popisuje pole a jejich popisy:

    Název pole Popis
    Název produktu Název IP adresy, která se zobrazí ve Správci nasazení
    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 . EuLA se uživateli zobrazí během registrace pomocí Deployment Manageru a vyžaduje přijetí před registrací.
    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ů toolkit (Microsoft.SystemCenter.Orchestrator.Integration.Toolkit.Wizard.Images.dll).
    Verze Číslo verze integračního balíčku, které se zobrazí ve Správci nasazení a použije se k určení, jestli je IP adresa upgradem.
    Povolení upgradu 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 stávající nainstalovanou verzi. Pokud zaškrtnutí tohoto políčka zrušíte, vytvoří se nové ID produktů a aktivit pro IP adresu (neupgraduje stávající verzi). Pokud chcete povolit souběžnou instalaci více verzí IP adresy, zrušte zaškrtnutí tohoto políčka.
    Popis Podrobný popis integračního balíčku
    Ikona kategorie Zobrazí se výchozí ikona kategorie. Pokud chcete zvolit jinou ikonu, vyberte tlačítko Upravit a vyberte novou ikonu a pak vyberte OK.

  4. Po zadání informací 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 příkazového řádku nebo vytvořené 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čkou (...) napravo od knihovny. Přejděte k požadovanému souboru 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. U aktivity se zobrazí výchozí ikona aktivity. Pokud je požadovaná jiná ikona, vyberte Změnit, vyberte v prohlížeči jinou ikonu a vyberte OK.

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

  11. Podle potřeby pokračujte v přidávání aktivit do seznamu. Po dokončení přidávání aktivit 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 zabalit do integračního balíčku. Tyto soubory můžou být dodatečná sestavení vyžadovaná vašimi aktivitami, skripty, dokumentací nebo jinými soubory, které chcete nasadit na servery runbooků a návrháře runbooků 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ž budete hotovi s přidáváním souborů do seznamu, vyberte Další. Zobrazí se stránka Soubor integračního balíčku orchestratoru.

  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 nebo proces selže. Pokud není zadána žádná cesta, soubor OIP se vytvoří ve složce Dokumenty (C:\users\<your username>\Documents). Výběrem možnosti Další zahájíte vytváření IP adresy.

    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ý, aby se zajistilo, ž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 souboru OIP. Chcete-li průvodce ukončit, vyberte Dokončit. 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 Postup přidání integračního balíčku.

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

Průvodce integračním balíčkem orchestratoru umožňuje importovat existující integrační balíček, abyste mohli provádět změny a znovu ho zabalit jako novou verzi. Ujistěte se, že zaškrtnete 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 adres

Aktualizace podkladových sestavení

Při vytváření integračního balíčku se metadata o IP adrese ukládají v balíčku, aby ho průvodce mohl přečíst během další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 ale upravíte nastavení aktivity a vyberete nový soubor sestavení, obnoví se pole na stránce Informace o aktivitě a budete muset tyto informace zadat znovu.

Nastavení konfigurace PROTOKOLU IP můžete zachovat při úpravě pouze sestavení. Uložte nové sestavení do stejné cesty a názvu 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 vytvořili integrační balíček pomocí Průvodce opalis QIK, budete ho muset před importem a použitím nástroje Orchestrator převést tak, aby byl 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ů popsaných v migraci aktivity QIK CLI, aby byly kompatibilní s orchestratorem. Pokud nemáte samostatnou kopii sestavení obsahující aktivity, musíte 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 vlastní vyvinuty v jazyce C# pomocí rozhraní Opalis API, musíte postupovat podle kroků popsaných v tématu Migrace vlastních aktivit rozhraní QIK API, aby byly kompatibilní s orchestratorem.

    Poznámka:

    Aktivity založené na Javě využívající rozhraní Opalis API pro Javu už nejsou podporovány sadou Integration Toolkit ani orchestratorem.

  • Pokud vaše IP adresa obsahuje závislé nebo jiné zahrnuté soubory, musí být tento soubor 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 vyhledat 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ů používaný pro ikony aktivit a kategorií, musí být tento soubor dostupný pro novou IP adresu. Pokud nemáte samostatnou kopii tohoto souboru, musíte nejprve nainstalovat IP adresu na server Opalis 6.3 a pak soubor vyhledat 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 poskytované QIK pro ikony kategorií nebo aktivit a chcete pokračovat v používání těchto ikon místo nových ikon poskytovaných v Orchestratoru, budete muset soubor získat Opalis.QIK.Wizard.Images.dll a použít ho 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 vyhledat 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 umístit všechny tyto soubory do umístění, ve kterých byly, když byla IP adresa původně zabalena před spuštěním Průvodce IP adresou. Průvodce IP odkazuje na tyto soubory původními cestami. 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 se některé podrobnosti o aktivitě resetují, což vyžaduje opětovné zadání informací. Když použijete původní cesty k souborům, stávající informace se jednoduše znovu použijí, 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 pro 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 orchestratorem. 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 zaškrtne se políčko Upgradovat. Vyberte Další.

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

  7. Až budete hotovi s úpravami aktivit, vyberte Další.

  8. Ujistěte se, že závislé soubory jsou 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 nové IP adresy. Nepoužívejte stejný název jako předchozí IP adresa, abyste měli jistotu, že si zachováte kopii předchozí IP adresy. Vyberte Další a sestavte IP adresu.

    Teď máte IP adresu, která je kompatibilní s nástrojem Orchestrator a můžete ji 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. Kvůli omezení délky názvu klíče registru nemůže kombinovaná cesta a název souboru sestavení překročit 234 znaků. Vzhledem k výchozí cestě, kde jsou umístěna sestavení v rámci PROTOKOLU IP, nesmí maximální délka názvu souboru zahrnutého souboru sestavení překročit 80 znaků. Pokud je součástí instalace sestavení s názvem delším než 80 znaků, instalace selže.

Prostředky orchestratoru

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

Viz také