Kreator pakietów integracyjnych

Artykuł
11/06/2024

Kreator pakietów integracyjnych (Kreator adresów IP) umożliwia utworzenie nowego pakietu integracyjnego z istniejącego zestawu integracyjnego. Zestawy integracji można tworzyć przy użyciu Kreatora działań wiersza polecenia (CLIActivityWizard) lub zestawu SDK programu Orchestrator. Kreator adresów IP (IPWizard) pakuje zestawy, pliki zależne i wymagane metadane do .OIP pliku, który można wdrożyć za pośrednictwem programu Orchestrator Deployment Manager. Możesz tworzyć profesjonalne pakiety integracyjne z pełnymi znakami i ikonami niestandardowymi lub po prostu spakować działania wiersza polecenia, aby można je było łatwiej wdrożyć za pomocą Kreatora adresów IP.

Zdecyduj, kiedy utworzyć pakiet integracyjny

Ważne jest, aby zdecydować, czy należy używać działań indywidualnie z działaniami pakietu integracyjnego .NET zestawu narzędzi , czy lepiej utworzyć i wdrożyć wszystkie działania w pakiecie integracyjnym .

Jeśli masz tylko kilka działań lub gdy jesteś w fazie programowania i tworzysz wiele zmian w działaniu, wystarczy użyć zestawów z działaniami zestawu narzędzi .NET Integration Pack , aby wykonać te działania w elementach Runbook. Pakowanie, rejestrowanie, wdrażanie, odinstalowywanie i uaktualnianie pakietów integracyjnych wiąże się z dużym obciążeniem w procesie opracowywania.

Jeśli masz grupę działań do testowania lub jesteś dalej w cyklu programowania i chcesz przetestować cały kompletny proces instalacji lub uaktualnienia, tworzenie pakietu integracyjnego jest lepszym podejściem. Pakiet integracyjny zapewnia bardziej przyjazne środowisko użytkownika i pełne środowisko instalacji. Pakiety integracyjne umożliwiają również wdrażanie działań na wielu serwerach Runbook lub projektantach elementów Runbook w całej organizacji lub dla klientów zewnętrznych.

Tworzenie nowego pakietu integracyjnego

Kreator pakietów integracyjnych umożliwia tworzenie pakietów integracyjnych z istniejących zestawów zgodnych z programem Orchestrator i plików zależnych. Jeśli jeszcze nie utworzono zestawu zgodnego z programem Orchestrator, zobacz Kreator działania wiersza polecenia.

Uwaga

Zestaw narzędzi integracji nie zawiera już plików binarnych zestawu narzędzi XML (WiX) Instalatora Windows, który jest używany przez Kreatora adresów IP do tworzenia niestandardowych pakietów integracyjnych. Zainstaluj najnowszą wersję zestawu narzędzi WiX (wersja 3.11) przed użyciem Kreatora adresów IP.

Aby utworzyć nowy pakiet integracyjny, wykonaj następujące kroki:

Uruchom Kreatora pakietów integracyjnych. Wybierz pozycję Start Orchestrator Integration Pack Wizard (Uruchom > kreatora pakietu integracyjnego programu Orchestrator). Zostanie wyświetlona strona powitalna.
Jeśli masz istniejący pakiet integracyjny, który chcesz zaktualizować, wybierz pozycję Importuj pakiet integracyjny. Aby uzyskać więcej informacji, zobacz Aktualizowanie istniejącego pakietu integracyjnego. Aby utworzyć nowy pakiet integracyjny, wybierz przycisk Dalej.

Ważne

Jeśli chcesz uaktualnić istniejący adres IP, musisz wybrać pozycję Importuj pakiet integracyjny. Jeśli wybierzesz pozycję Dalej, utworzony adres IP będzie miał nowy unikatowy identyfikator produktu i nowe unikatowe identyfikatory dla wszystkich działań, nawet jeśli ponownie użyjesz poprzedniego zestawu i użyjesz tych samych nazw plików i produktów.

Na stronie Szczegóły produktu wprowadź lub zmodyfikuj informacje zgodnie z potrzebami, aby dostosować informacje o pakiecie integracyjnym. W poniższej tabeli opisano pola i ich opisy:

Nazwa pola	opis
Nazwa produktu	Nazwa adresu IP wyświetlanego w menedżerze wdrażania
Nazwa kategorii	Tekst wyświetlany jako tytuł kategorii dla adresu IP w okienku Działania w programie Runbook Designer
Firma	Nazwa firmy. Te informacje są wyświetlane w obszarze "Wydawca" w obszarze Dodawanie/usuwanie programów
Plik EULA	Plik tekstowy w formacie RTF z `.EULA` rozszerzeniem. Umowa LICENCYJNA jest wyświetlana użytkownikowi podczas rejestracji przy użyciu Menedżera wdrażania i wymaga akceptacji przed rejestracją.
Plik zasobu	Zestaw zawierający ikony i inne zasoby używane do udostępniania ikon kategorii i działań. Domyślnie używany jest standardowy plik zasobów zestawu narzędzi (Microsoft.SystemCenter.Orchestrator.Integration.Toolkit.Wizard.Images.dll)
Wersja	Numer wersji pakietu integracyjnego, który będzie wyświetlany w Menedżerze wdrażania i używany do określenia, czy adres IP jest uaktualnieniem.
Włączanie uaktualniania	Jeśli zaimportowano istniejący pakiet integracyjny, to pole wyboru jest zaznaczone domyślnie, włączając ten pakiet integracyjny w celu uaktualnienia istniejącej zainstalowanej wersji. Jeśli to pole wyboru zostanie usunięte, nowe identyfikatory produktów i działań zostaną utworzone dla adresu IP (nie spowoduje uaktualnienia istniejącej wersji). Jeśli chcesz włączyć instalację równoległą wielu wersji adresu IP, wyczyść to pole wyboru.
opis	Szczegółowy opis pakietu integracyjnego
Ikona kategorii	Zostanie wyświetlona domyślna ikona kategorii. Jeśli chcesz wybrać inną ikonę, wybierz przycisk Modyfikuj i wybierz nową ikonę, a następnie wybierz przycisk OK.

Po zakończeniu wprowadzania informacji o produkcie wybierz pozycję Dalej. Zostanie wyświetlona strona Działania. Na stronie Działania można odwoływać się do zestawu lub zestawów zawierających działania zdefiniowane za pomocą Kreatora działań wiersza polecenia lub utworzonego przy użyciu zestawu Orchestrator SDK.
Aby dodać nowe działanie do adresu IP, wybierz pozycję Dodaj.
Aby otworzyć i dodać plik zestawu, wybierz przycisk wielokropka (...) po prawej stronie pozycji Biblioteka. Przejdź do żądanego pliku zestawu, wybierz go i wybierz pozycję Otwórz. Nazwa pliku i ścieżka są wyświetlane w polu Biblioteka.
Aby wybrać działanie z zestawu, wybierz strzałkę listy rozwijanej Klasa i wybierz odpowiednią nazwę działania z listy. Nazwa i opis zdefiniowany w działaniu są wyświetlane w polach Nazwa wyświetlana i Opis .
W razie potrzeby zmodyfikuj nazwę wyświetlaną i opis działania.
Zostanie wyświetlona domyślna ikona działania. Jeśli wymagana jest inna ikona, wybierz pozycję Modyfikuj, wybierz inną ikonę w przeglądarce i wybierz przycisk OK.
Wybierz przycisk OK , aby zapisać definicję działania. Nazwa i opis działania są teraz wyświetlane na liście Działania.
Kontynuuj dodawanie działań do listy zgodnie z potrzebami. Po zakończeniu dodawania działań wybierz pozycję Dalej. Zostanie wyświetlona strona Zależności i Dołączone pliki.
Na tej stronie można zdefiniować listę dodatkowych plików, które mają być spakowane z pakietem integracyjnym. Te pliki mogą być dodatkowymi zestawami wymaganymi przez działania, skrypty, dokumentację lub inne pliki, które mają zostać wdrożone na serwerach Runbook i projektantach elementów Runbook wraz z działaniami. Wybierz pozycję Dodaj, wybierz potrzebne pliki, a następnie wybierz przycisk OK , aby dodać pliki do listy.
Po zakończeniu dodawania plików do listy wybierz pozycję Dalej. Zostanie wyświetlona strona Plik pakietu integracyjnego programu Orchestrator.
W podanym polu tekstowym wprowadź ścieżkę i nazwę pliku pakietu integracyjnego do utworzenia. Jeśli wprowadzisz nazwę pliku, która już istnieje, zostanie zastąpiona. Upewnij się, że masz wystarczający dostęp do zapisu w określonej ścieżce lub proces zakończy się niepowodzeniem. Jeśli nie określono żadnej ścieżki, plik OIP zostanie utworzony w folderze Dokumenty (C:\users\<your username>\Documents). Wybierz przycisk Dalej , aby rozpocząć tworzenie adresu IP.

Ważne

Znaki w nazwie pliku muszą być prawidłowe dla języka zainstalowanego w systemie operacyjnym.

Ważne

Określ nazwę pakietu integracyjnego, który nie jest wspólny, aby upewnić się, że nie jest zgodny z nazwą innego pakietu integracyjnego. Program Orchestrator nie może zainstalować dwóch pakietów integracyjnych o tej samej nazwie.
Po pomyślnym skompilowania adresu IP ostatnia strona kreatora wyświetli ścieżkę i nazwę pliku nowego pliku OIP. Wybierz przycisk Zakończ, aby zamknąć kreatora. Jeśli wystąpi błąd, możesz wybrać pozycję Wstecz i ponowić próbę procesu kompilacji.

Aby uzyskać informacje na temat wdrażania pakietu integracyjnego, zobacz artykuł How to add an Integration Pack (Jak dodać pakiet integracyjny).

Aktualizowanie istniejącego pakietu integracyjnego

Kreator pakietów integracyjnych programu Orchestrator umożliwia importowanie istniejącego pakietu integracyjnego, dzięki czemu można wprowadzać zmiany i ponownie pakować go jako nową wersję. Upewnij się, że zaznaczysz pole wyboru Włącz uaktualnienie . W przeciwnym razie zostanie utworzony nowy adres IP zamiast zastąpić lub uaktualnić poprzednią zainstalowaną wersję.

Przydatne porady dotyczące uaktualniania adresów IP

Aktualizowanie zestawów bazowych

Podczas tworzenia pakietu integracyjnego metadane dotyczące adresu IP są przechowywane w pakiecie, aby można je było odczytać przez kreatora podczas kolejnych uaktualnień. Podczas aktualizowania niektórych elementów, takich jak działania lub zestawy bazowe dla tych działań, należy ponownie skompilować adres IP. Jeśli jednak zmodyfikujesz ustawienia działania i wybierzesz nowy plik zestawu, spowoduje to zresetowanie pól na stronie Informacje o działaniu, co wymaga ponownego wprowadzenia informacji.

Ustawienia konfiguracji adresu IP można zachować podczas modyfikowania tylko zestawu. Zapisz nowy zestaw w tej samej ścieżce i nazwie pliku co poprzedni zestaw (który jest wyświetlany w polu Biblioteka okna dialogowego Informacje o aktywności).

Migracja pakietu integracyjnego QIK

Jeśli pakiet integracyjny został utworzony przy użyciu Kreatora QIK Opalis, musisz przekonwertować go, aby był zgodny z programem Orchestrator, zanim będzie można go zaimportować i używać przez program Orchestrator.

Przed przekonwertowaniem adresu IP należy wykonać następujące czynności:

Jeśli działania w adresie IP zostały utworzone przy użyciu Kreatora interfejsu wiersza polecenia QIK, należy wykonać kroki opisane w temacie Migracja działania interfejsu wiersza polecenia QIK, aby były zgodne z programem Orchestrator. Jeśli nie masz oddzielnej kopii zestawu zawierającego działania, najpierw musisz zainstalować adres IP na serwerze Opalis 6.3, a następnie zlokalizować zestaw w następującym katalogu: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Quick Integration Kit 3.
Jeśli działania w adresie IP zostały niestandardowe opracowane w języku C# przy użyciu interfejsu API Opalis, należy wykonać kroki opisane w temacie Migrowanie niestandardowych działań interfejsu API QIK, aby zapewnić ich zgodność z programem Orchestrator.

Uwaga

Działania oparte na języku Java korzystające z interfejsu API Opalis dla języka Java nie są już obsługiwane przez zestaw narzędzi Integration Toolkit ani przez program Orchestrator.
Jeśli adres IP zawiera pliki zależne lub inne dołączone, ten plik musi być dostępny do ponownego spakowania do nowego adresu IP. Jeśli nie masz oddzielnej kopii tych plików, najpierw musisz zainstalować adres IP na serwerze Opalis 6.3, a następnie zlokalizować pliki w następującym katalogu: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Bin.
Jeśli adres IP zawiera niestandardowy plik zasobów używany na potrzeby ikon działań i kategorii, ten plik musi być dostępny dla nowego adresu IP. Jeśli nie masz oddzielnej kopii tego pliku, najpierw musisz zainstalować adres IP na serwerze Opalis 6.3, a następnie zlokalizować plik w następującym katalogu: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions.
Jeśli adres IP używał standardowych ikon udostępnianych przez zestaw QIK dla ikon kategorii lub działań i chcesz nadal używać tych ikon zamiast używać nowych ikon dostępnych w programie Orchestrator, musisz uzyskać Opalis.QIK.Wizard.Images.dll plik i użyć go tak, jak w przypadku pliku zasobu niestandardowego. Jeśli nie masz oddzielnej kopii tego pliku, najpierw musisz zainstalować adres IP na serwerze Opalis 6.3, a następnie zlokalizować plik w następującym katalogu: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions.

Uwaga

W przypadku najłatwiejszego procesu konwersji należy umieścić wszystkie te pliki w lokalizacjach, w których znajdowały się, gdy adres IP został pierwotnie spakowany przed uruchomieniem Kreatora adresów IP. Kreator adresów IP odwołuje się do tych plików według oryginalnych ścieżek. Wybranie nowej ścieżki jest możliwe dla wszystkich plików, ale wybranie nowej ścieżki dla zestawów zawierających działania spowoduje zresetowanie niektórych szczegółów działania, co wymaga ponownego wprowadzenia informacji. Korzystając z oryginalnych ścieżek dla plików, istniejące informacje są po prostu ponownie używane bez konieczności ponownego wprowadzania.

Konwertowanie pakietu integracyjnego zgodnego z programem Opalis

Uruchamianie Kreatora pakietu integracyjnego
Wybierz pozycję Importuj pakiet integracyjny.
Wybierz istniejący plik OIP i wybierz pozycję Otwórz.
Zostanie wyświetlony komunikat ostrzegawczy wskazujący, że adres IP nie jest zgodny z programem Orchestrator. Wybierz przycisk OK.
Zmodyfikuj szczegóły produktu zgodnie z potrzebami, aby odzwierciedlić wszelkie zmiany. Numer wersji adresu IP jest automatycznie zwiększany, a pole wyboru "Uaktualnij" jest zaznaczone. Wybierz Dalej.
Na stronie Działania przejrzyj każde działanie i upewnij się, że informacje są poprawnie ukończone. Jeśli zestaw dla działania nie został zmigrowany lub nie znajduje się w tej samej lokalizacji, co podczas tworzenia adresu IP, pole Klasa będzie puste. Aby zapobiec konieczności ponownego wpisywania informacji, należy zastąpić zestaw przed uruchomieniem kreatora.
Po zakończeniu edytowania działań wybierz pozycję Dalej.
Upewnij się, że pliki zależne są nadal w tej samej lokalizacji, co pokazano, lub usuń je i dodaj nowe pliki zależne. Wybierz Dalej.
Wprowadź ścieżkę i nazwę pliku dla nowego pliku IP. Nie używaj tej samej nazwy co poprzedni adres IP, aby mieć pewność, że zachowasz kopię poprzedniego adresu IP. Wybierz pozycję Dalej , aby skompilować adres IP.

Masz teraz adres IP zgodny z programem Orchestrator i można go zarejestrować i wdrożyć przy użyciu programu Orchestrator Deployment Manager.

Pakiety integracyjne — znane problemy

Ograniczenie długości nazwy pliku

W przypadku dołączania zestawów w pakiecie integracyjnym są one automatycznie dodawane do rejestru przez instalatora. Ze względu na ograniczenie długości nazwy klucza rejestru łączna ścieżka i nazwa pliku zestawu nie mogą przekraczać 234 znaków. Biorąc pod uwagę domyślną ścieżkę, w której znajdują się zestawy w ramach adresu IP, maksymalna długość pliku dołączonego zestawu nie może przekraczać 80 znaków. Jeśli zestaw z nazwą pliku przekraczającą 80 znaków zostanie uwzględniony w instalacji, instalacja zakończy się niepowodzeniem.

Zasoby programu Orchestrator

Oprócz tej dokumentacji online udostępnionej dla programu System Center Orchestrator istnieje wiele zasobów, które mogą zawierać dodatkowe informacje na temat tworzenia elementów Runbook, korzystania z zestawu narzędzi Integration Toolkit i najlepszych rozwiązań.

Udostępnij za pośrednictwem