JobManagerTask interface

Pakiet:

@azure/batch

Zadanie Menedżera zadań jest uruchamiane automatycznie po utworzeniu zadania. Usługa Batch próbuje zaplanować zadanie Menedżera zadań przed innymi zadaniami w zadaniu. Podczas zmniejszania puli usługa Batch próbuje zachować węzły, w których zadania menedżera zadań są uruchamiane tak długo, jak to możliwe (czyli węzły obliczeniowe z uruchomioną "normalną" zadaniami są usuwane przed węzłami obliczeniowymi z uruchomionymi zadaniami Menedżera zadań). Gdy zadanie Menedżera zadań kończy się niepowodzeniem i musi zostać uruchomione ponownie, system próbuje zaplanować zadanie o najwyższym priorytetzie. Jeśli nie ma dostępnych bezczynnych węzłów obliczeniowych, system może zakończyć jedną z uruchomionych zadań w puli i zwrócić ją do kolejki, aby umożliwić ponowne uruchomienie zadania Menedżera zadań. Należy pamiętać, że zadanie Menedżera zadań w jednym zadaniu nie ma priorytetu nad zadaniami w innych zadaniach. W przypadku zadań obserwowane są tylko priorytety na poziomie zadania. Jeśli na przykład menedżer zadań w zadaniu o priorytecie 0 musi zostać uruchomiony ponownie, nie spowoduje to przesiedleń zadań o priorytecie 1. Usługa Batch ponowi próbę wykonania zadań po wyzwoleniu operacji odzyskiwania w węźle. Przykładowe operacje odzyskiwania obejmują (ale nie tylko) po ponownym uruchomieniu węzła w złej kondycji lub zniknięciu węzła obliczeniowego z powodu awarii hosta. Ponawianie prób z powodu operacji odzyskiwania jest niezależne i nie są liczone względem wartości maxTaskRetryCount. Nawet jeśli wartość maxTaskRetryCount wynosi 0, może wystąpić wewnętrzna ponowna próba spowodowana operacją odzyskiwania. W związku z tym wszystkie zadania powinny być idempotentne. Oznacza to, że zadania muszą tolerować przerwanie i ponowne uruchomienie bez spowodowania uszkodzenia lub zduplikowania danych. Najlepszym rozwiązaniem dla długotrwałych zadań jest użycie jakiejś formy tworzenia punktów kontrolnych.

Właściwości

allowLowPriorityNode	Czy zadanie Menedżera zadań może być uruchamiane w węźle obliczeniowym o niskim priorytcie. Wartością domyślną jest true.
applicationPackageReferences	Lista pakietów aplikacji wdrożonych przez usługę Batch w węźle obliczeniowym przed uruchomieniem wiersza polecenia. Pakiety aplikacji są pobierane i wdrażane w udostępnionym katalogu, a nie w katalogu roboczym Zadania. W związku z tym jeśli pakiet aplikacji, do których odwołuje się odwołanie, znajduje się już w węźle obliczeniowym i jest aktualny, nie jest on pobierany ponownie; używana jest istniejąca kopia w węźle obliczeniowym. Jeśli nie można zainstalować przywoływanego pakietu aplikacji, na przykład ze względu na to, że pakiet został usunięty lub ponieważ pobieranie nie powiodło się, zadanie kończy się niepowodzeniem.
authenticationTokenSettings	Ustawienia tokenu uwierzytelniania, którego zadanie może użyć do wykonywania operacji usługi Batch. Jeśli ta właściwość jest ustawiona, usługa Batch udostępnia zadanie z tokenem uwierzytelniania, który może służyć do uwierzytelniania operacji usługi Batch bez konieczności posiadania klucza dostępu do konta. Token jest dostarczany za pośrednictwem zmiennej środowiskowej AZ_BATCH_AUTHENTICATION_TOKEN. Operacje, które zadanie może wykonać przy użyciu tokenu, zależą od ustawień. Na przykład zadanie może zażądać uprawnień zadania w celu dodania innych zadań do zadania lub sprawdzenia stanu zadania lub innych zadań w ramach zadania.
commandLine	Wiersz polecenia zadania Menedżera zadań. Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzenie zmiennej środowiskowej. Jeśli chcesz skorzystać z takich funkcji, należy wywołać powłokę w wierszu polecenia, na przykład przy użyciu polecenia "cmd /c MyCommand" w systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux. Jeśli wiersz polecenia odnosi się do ścieżek plików, należy użyć ścieżki względnej (względem katalogu roboczego zadania) lub użyć zmiennej środowiskowej udostępnionej w usłudze Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).
constraints	Ograniczenia, które mają zastosowanie do zadania Menedżera zadań.
containerSettings	Ustawienia kontenera, w którym jest uruchamiane zadanie Menedżera zadań. Jeśli pula, która uruchomi to zadanie, ma ustawiony kontenerKonfiguracja, należy również ustawić tę opcję. Jeśli pula, która uruchomi to zadanie, nie ma ustawionego konteneraKonfiguracja, nie może być ustawiona. Po określeniu tej wartości wszystkie katalogi cyklicznie poniżej AZ_BATCH_NODE_ROOT_DIR (katalog główny katalogów Azure Batch w węźle) są mapowane na kontener, wszystkie zmienne środowiskowe zadania są mapowane do kontenera, a wiersz polecenia zadania jest wykonywany w kontenerze. Pliki utworzone w kontenerze poza AZ_BATCH_NODE_ROOT_DIR mogą nie zostać odzwierciedlone na dysku hosta, co oznacza, że interfejsy API plików usługi Batch nie będą mogły uzyskać dostępu do tych plików.
displayName	Nazwa wyświetlana zadania Menedżera zadań. Nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024.
environmentSettings	Lista ustawień zmiennych środowiskowych dla zadania Menedżera zadań.
id	Ciąg, który jednoznacznie identyfikuje zadanie Menedżera zadań w ramach zadania. Identyfikator może zawierać dowolną kombinację znaków alfanumerycznych, w tym łączników i podkreśleń, i nie może zawierać więcej niż 64 znaków.
killJobOnCompletion	Czy ukończenie zadania Menedżera zadań oznacza ukończenie całego zadania. Jeśli ma wartość true, gdy zadanie Menedżera zadań zakończy się, usługa Batch oznaczy zadanie jako ukończone. Jeśli jakiekolwiek zadania są nadal uruchomione w tej chwili (inne niż wydanie zadania), te zadania zostaną zakończone. Jeśli wartość false, ukończenie zadania Menedżera zadań nie ma wpływu na stan zadania. W takim przypadku należy użyć atrybutu onAllTasksComplete w celu zakończenia zadania lub jawnego zakończenia zadania przez klienta lub użytkownika. Przykładem jest utworzenie zestawu zadań przez Menedżera zadań, ale nie ma dalszej roli w ich wykonywaniu. Wartością domyślną jest true. Jeśli używasz atrybutów onAllTasksComplete i onTaskFailure, aby kontrolować okres istnienia zadania, a następnie używasz zadania Menedżera zadań tylko do utworzenia zadań zadania (nie do monitorowania postępu), należy ustawić wartość killJobOnCompletion na wartość false.
outputFiles	Lista plików przekazanych przez usługę Batch z węzła obliczeniowego po uruchomieniu wiersza polecenia. W przypadku zadań z wieloma wystąpieniami pliki zostaną przekazane tylko z węzła obliczeniowego, na którym jest wykonywane zadanie podstawowe.
requiredSlots	Liczba miejsc planowania, których zadanie wymaga uruchomienia. Wartość domyślna to 1. Zadanie można zaplanować tylko w węźle obliczeniowym, jeśli węzeł ma wystarczającą ilość dostępnych wolnych miejsc planowania. W przypadku zadań z wieloma wystąpieniami musi to być 1.
resourceFiles	Lista plików, które usługa Batch pobierze do węzła obliczeniowego przed uruchomieniem wiersza polecenia. Pliki wymienione w tym elemecie znajdują się w katalogu roboczym zadania. Istnieje maksymalny rozmiar listy plików zasobów. Po przekroczeniu maksymalnego rozmiaru żądanie zakończy się niepowodzeniem, a kod błędu odpowiedzi to RequestEntityTooLarge. W takim przypadku należy zmniejszyć rozmiar kolekcji resourceFiles. Można to osiągnąć przy użyciu plików .zip, pakietów aplikacji lub kontenerów platformy Docker.
runExclusive	Czy zadanie Menedżera zadań wymaga wyłącznego użycia węzła obliczeniowego, w którym jest uruchamiany. Jeśli to prawda, żadne inne zadania nie będą uruchamiane w tym samym węźle tak długo, jak menedżer zadań jest uruchomiony. Jeśli wartość false, inne zadania mogą być uruchamiane jednocześnie z Menedżerem zadań w węźle obliczeniowym. Zadanie Menedżera zadań jest zwykle liczone względem współbieżnego limitu zadań węzła obliczeniowego, dlatego jest to istotne tylko wtedy, gdy węzeł obliczeniowy zezwala na wiele współbieżnych zadań. Wartością domyślną jest true.
userIdentity	Tożsamość użytkownika, w ramach której jest uruchamiane zadanie Menedżera zadań. W przypadku pominięcia zadanie jest uruchamiane jako użytkownik niebędący administratorem unikatowym dla zadania.

Szczegóły właściwości

allowLowPriorityNode

Czy zadanie Menedżera zadań może być uruchamiane w węźle obliczeniowym o niskim priorytcie. Wartością domyślną jest true.

allowLowPriorityNode?: boolean

Wartość właściwości

boolean

applicationPackageReferences

Lista pakietów aplikacji wdrożonych przez usługę Batch w węźle obliczeniowym przed uruchomieniem wiersza polecenia. Pakiety aplikacji są pobierane i wdrażane w udostępnionym katalogu, a nie w katalogu roboczym Zadania. W związku z tym jeśli pakiet aplikacji, do których odwołuje się odwołanie, znajduje się już w węźle obliczeniowym i jest aktualny, nie jest on pobierany ponownie; używana jest istniejąca kopia w węźle obliczeniowym. Jeśli nie można zainstalować przywoływanego pakietu aplikacji, na przykład ze względu na to, że pakiet został usunięty lub ponieważ pobieranie nie powiodło się, zadanie kończy się niepowodzeniem.

applicationPackageReferences?: ApplicationPackageReference[]

Wartość właściwości

ApplicationPackageReference[]

authenticationTokenSettings

Ustawienia tokenu uwierzytelniania, którego zadanie może użyć do wykonywania operacji usługi Batch. Jeśli ta właściwość jest ustawiona, usługa Batch udostępnia zadanie z tokenem uwierzytelniania, który może służyć do uwierzytelniania operacji usługi Batch bez konieczności posiadania klucza dostępu do konta. Token jest dostarczany za pośrednictwem zmiennej środowiskowej AZ_BATCH_AUTHENTICATION_TOKEN. Operacje, które zadanie może wykonać przy użyciu tokenu, zależą od ustawień. Na przykład zadanie może zażądać uprawnień zadania w celu dodania innych zadań do zadania lub sprawdzenia stanu zadania lub innych zadań w ramach zadania.

authenticationTokenSettings?: AuthenticationTokenSettings

Wartość właściwości

AuthenticationTokenSettings

commandLine

Wiersz polecenia zadania Menedżera zadań. Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzenie zmiennej środowiskowej. Jeśli chcesz skorzystać z takich funkcji, należy wywołać powłokę w wierszu polecenia, na przykład przy użyciu polecenia "cmd /c MyCommand" w systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux. Jeśli wiersz polecenia odnosi się do ścieżek plików, należy użyć ścieżki względnej (względem katalogu roboczego zadania) lub użyć zmiennej środowiskowej udostępnionej w usłudze Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

commandLine: string

Wartość właściwości

string

constraints

Ograniczenia, które mają zastosowanie do zadania Menedżera zadań.

constraints?: TaskConstraints

Wartość właściwości

TaskConstraints

containerSettings

Ustawienia kontenera, w którym jest uruchamiane zadanie Menedżera zadań. Jeśli pula, która uruchomi to zadanie, ma ustawiony kontenerKonfiguracja, należy również ustawić tę opcję. Jeśli pula, która uruchomi to zadanie, nie ma ustawionego konteneraKonfiguracja, nie może być ustawiona. Po określeniu tej wartości wszystkie katalogi cyklicznie poniżej AZ_BATCH_NODE_ROOT_DIR (katalog główny katalogów Azure Batch w węźle) są mapowane na kontener, wszystkie zmienne środowiskowe zadania są mapowane do kontenera, a wiersz polecenia zadania jest wykonywany w kontenerze. Pliki utworzone w kontenerze poza AZ_BATCH_NODE_ROOT_DIR mogą nie zostać odzwierciedlone na dysku hosta, co oznacza, że interfejsy API plików usługi Batch nie będą mogły uzyskać dostępu do tych plików.

containerSettings?: TaskContainerSettings

Wartość właściwości

TaskContainerSettings

displayName

Nazwa wyświetlana zadania Menedżera zadań. Nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024.

displayName?: string

Wartość właściwości

string

environmentSettings

Lista ustawień zmiennych środowiskowych dla zadania Menedżera zadań.

environmentSettings?: EnvironmentSetting[]

Wartość właściwości

EnvironmentSetting[]

id

Ciąg, który jednoznacznie identyfikuje zadanie Menedżera zadań w ramach zadania. Identyfikator może zawierać dowolną kombinację znaków alfanumerycznych, w tym łączników i podkreśleń, i nie może zawierać więcej niż 64 znaków.

id: string

Wartość właściwości

string

killJobOnCompletion

Czy ukończenie zadania Menedżera zadań oznacza ukończenie całego zadania. Jeśli ma wartość true, gdy zadanie Menedżera zadań zakończy się, usługa Batch oznaczy zadanie jako ukończone. Jeśli jakiekolwiek zadania są nadal uruchomione w tej chwili (inne niż wydanie zadania), te zadania zostaną zakończone. Jeśli wartość false, ukończenie zadania Menedżera zadań nie ma wpływu na stan zadania. W takim przypadku należy użyć atrybutu onAllTasksComplete w celu zakończenia zadania lub jawnego zakończenia zadania przez klienta lub użytkownika. Przykładem jest utworzenie zestawu zadań przez Menedżera zadań, ale nie ma dalszej roli w ich wykonywaniu. Wartością domyślną jest true. Jeśli używasz atrybutów onAllTasksComplete i onTaskFailure, aby kontrolować okres istnienia zadania, a następnie używasz zadania Menedżera zadań tylko do utworzenia zadań zadania (nie do monitorowania postępu), należy ustawić wartość killJobOnCompletion na wartość false.

killJobOnCompletion?: boolean

Wartość właściwości

boolean

outputFiles

Lista plików przekazanych przez usługę Batch z węzła obliczeniowego po uruchomieniu wiersza polecenia. W przypadku zadań z wieloma wystąpieniami pliki zostaną przekazane tylko z węzła obliczeniowego, na którym jest wykonywane zadanie podstawowe.

outputFiles?: OutputFile[]

Wartość właściwości

OutputFile[]

requiredSlots

Liczba miejsc planowania, których zadanie wymaga uruchomienia. Wartość domyślna to 1. Zadanie można zaplanować tylko w węźle obliczeniowym, jeśli węzeł ma wystarczającą ilość dostępnych wolnych miejsc planowania. W przypadku zadań z wieloma wystąpieniami musi to być 1.

requiredSlots?: number

Wartość właściwości

number

resourceFiles

Lista plików, które usługa Batch pobierze do węzła obliczeniowego przed uruchomieniem wiersza polecenia. Pliki wymienione w tym elemecie znajdują się w katalogu roboczym zadania. Istnieje maksymalny rozmiar listy plików zasobów. Po przekroczeniu maksymalnego rozmiaru żądanie zakończy się niepowodzeniem, a kod błędu odpowiedzi to RequestEntityTooLarge. W takim przypadku należy zmniejszyć rozmiar kolekcji resourceFiles. Można to osiągnąć przy użyciu plików .zip, pakietów aplikacji lub kontenerów platformy Docker.

resourceFiles?: ResourceFile[]

Wartość właściwości

ResourceFile[]

runExclusive

Czy zadanie Menedżera zadań wymaga wyłącznego użycia węzła obliczeniowego, w którym jest uruchamiany. Jeśli to prawda, żadne inne zadania nie będą uruchamiane w tym samym węźle tak długo, jak menedżer zadań jest uruchomiony. Jeśli wartość false, inne zadania mogą być uruchamiane jednocześnie z Menedżerem zadań w węźle obliczeniowym. Zadanie Menedżera zadań jest zwykle liczone względem współbieżnego limitu zadań węzła obliczeniowego, dlatego jest to istotne tylko wtedy, gdy węzeł obliczeniowy zezwala na wiele współbieżnych zadań. Wartością domyślną jest true.

runExclusive?: boolean

Wartość właściwości

boolean

userIdentity

Tożsamość użytkownika, w ramach której jest uruchamiane zadanie Menedżera zadań. W przypadku pominięcia zadanie jest uruchamiane jako użytkownik niebędący administratorem unikatowym dla zadania.

userIdentity?: UserIdentity

Wartość właściwości

UserIdentity