sfctl application
Tworzenie, usuwanie aplikacji i typów aplikacji oraz zarządzanie nimi.
Polecenia
Polecenie | opis |
---|---|
create | Tworzy aplikację usługi Service Fabric przy użyciu określonego opisu. |
delete | Usuwa istniejącą aplikację usługi Service Fabric. |
Wdrożony | Pobiera informacje o aplikacji wdrożonej w węźle usługi Service Fabric. |
wdrożona kondycja | Pobiera informacje o kondycji aplikacji wdrożonej w węźle usługi Service Fabric. |
wdrożona lista | Pobiera listę aplikacji wdrożonych w węźle usługi Service Fabric. |
zdrowie | Pobiera kondycję aplikacji usługi Service Fabric. |
informacje o | Pobiera informacje o aplikacji usługi Service Fabric. |
lista | Pobiera listę aplikacji utworzonych w klastrze usługi Service Fabric, które są zgodne z określonymi filtrami. |
ładowanie | Pobiera informacje o ładowaniu aplikacji usługi Service Fabric. |
manifest | Pobiera manifest opisujący typ aplikacji. |
aprowizowanie | Aprowizuje lub rejestruje typ aplikacji usługi Service Fabric w klastrze przy użyciu pakietu ".sfpkg" w sklepie zewnętrznym lub pakietu aplikacji w magazynie obrazów. |
report-health | Wysyła raport o kondycji aplikacji usługi Service Fabric. |
type | Pobiera listę typów aplikacji w klastrze usługi Service Fabric pasujących dokładnie do określonej nazwy. |
lista typów | Pobiera listę typów aplikacji w klastrze usługi Service Fabric. |
anulowanie aprowizacji | Usuwa lub wyrejestrowuje typ aplikacji usługi Service Fabric z klastra. |
uaktualnienie | Rozpoczyna uaktualnianie aplikacji w klastrze usługi Service Fabric. |
upgrade-resume | Wznawia uaktualnianie aplikacji w klastrze usługi Service Fabric. |
wycofywanie uaktualnienia | Rozpoczyna wycofywanie obecnie trwającego uaktualnienia aplikacji w klastrze usługi Service Fabric. |
stan uaktualnienia | Pobiera szczegóły dotyczące najnowszego uaktualnienia wykonanego w tej aplikacji. |
przekaż | Skopiuj pakiet aplikacji usługi Service Fabric do magazynu obrazów. |
sfctl application create
Tworzy aplikację usługi Service Fabric przy użyciu określonego opisu.
Argumenty
Argument | opis |
---|---|
--app-name [Wymagane] | Nazwa aplikacji, w tym schemat identyfikatora URI "fabric:". |
--app-type [Wymagane] | Nazwa typu aplikacji znaleziona w manifeście aplikacji. |
--app-version [Wymagane] | Wersja typu aplikacji zdefiniowana w manifeście aplikacji. |
--max-node-count | Maksymalna liczba węzłów, w których usługa Service Fabric zarezerwowa pojemność dla tej aplikacji. Należy pamiętać, że nie oznacza to, że usługi tej aplikacji zostaną umieszczone na wszystkich tych węzłach. |
--Metryki | Zakodowana w formacie JSON lista opisów metryk pojemności aplikacji. Metryka jest definiowana jako nazwa skojarzona z zestawem pojemności dla każdego węzła, na których istnieje aplikacja. |
--min-node-count | Minimalna liczba węzłów, w których usługa Service Fabric zarezerwowa pojemność dla tej aplikacji. Należy pamiętać, że nie oznacza to, że usługi tej aplikacji zostaną umieszczone na wszystkich tych węzłach. |
--Parametry | Zakodowana w formacie JSON lista przesłonięć parametrów aplikacji, które mają być stosowane podczas tworzenia aplikacji. |
--timeout -t | Wartość domyślna: 60. |
Argumenty globalne
Argument | opis |
---|---|
--debugować | Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. |
--help -h | Pokaż ten komunikat pomocy i zakończ pracę. |
--output -o | Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json. |
--zapytanie | Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów. |
--gadatliwy | Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania. |
sfctl application delete
Usuwa istniejącą aplikację usługi Service Fabric.
Aby można było usunąć aplikację, należy ją utworzyć. Usunięcie aplikacji spowoduje usunięcie wszystkich usług będących częścią tej aplikacji. Domyślnie usługa Service Fabric spróbuje zamknąć repliki usługi w sposób wdzięczny, a następnie usunąć usługę. Jeśli jednak usługa ma problemy z zamknięciem repliki bezpiecznie, operacja usuwania może zająć dużo czasu lub zablokować. Użyj opcjonalnej flagi ForceRemove, aby pominąć bezproblemową sekwencję zamknięcia i wymusić usunięcie aplikacji i wszystkich jej usług.
Argumenty
Argument | opis |
---|---|
--application-id [Wymagane] | Tożsamość aplikacji. Jest to zazwyczaj pełna nazwa aplikacji bez schematu identyfikatora URI "fabric:". Począwszy od wersji 6.0, nazwy hierarchiczne są rozdzielane znakiem "~". Jeśli na przykład nazwa aplikacji to "fabric:/myapp/app1", tożsamość aplikacji będzie miała wartość "myapp~app1" w wersji 6.0 lub nowszej oraz "myapp/app1" w poprzednich wersjach. |
--force-remove | Usuń aplikację usługi Service Fabric lub usługę w sposób wymuszony bez przechodzenia przez wdziękną sekwencję zamykania. Ten parametr może służyć do wymuszania usunięcia aplikacji lub usługi, dla której usunięcie przekracza limit czasu z powodu problemów z kodem usługi, który uniemożliwia bezproblemowe zamykanie replik. |
--timeout -t | Limit czasu serwera na potrzeby wykonywania operacji w sekundach. Ten limit czasu określa czas trwania, przez który klient chce poczekać na ukończenie żądanej operacji. Wartość domyślna tego parametru to 60 sekund. Wartość domyślna: 60. |
Argumenty globalne
Argument | opis |
---|---|
--debugować | Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. |
--help -h | Pokaż ten komunikat pomocy i zakończ pracę. |
--output -o | Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json. |
--zapytanie | Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów. |
--gadatliwy | Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania. |
wdrożona aplikacja sfctl
Pobiera informacje o aplikacji wdrożonej w węźle usługi Service Fabric.
To zapytanie zwraca informacje o aplikacji systemowej, jeśli podany identyfikator aplikacji jest przeznaczony dla aplikacji systemowej. Wyniki obejmują wdrożone aplikacje w stanach aktywnego, aktywowania i pobierania. To zapytanie wymaga, aby nazwa węzła odpowiadała węzłowi w klastrze. Zapytanie kończy się niepowodzeniem, jeśli podana nazwa węzła nie wskazuje żadnych aktywnych węzłów usługi Service Fabric w klastrze.
Argumenty
Argument | opis |
---|---|
--application-id [Wymagane] | Tożsamość aplikacji. Jest to zazwyczaj pełna nazwa aplikacji bez schematu identyfikatora URI "fabric:". Począwszy od wersji 6.0, nazwy hierarchiczne są rozdzielane znakiem "~". Jeśli na przykład nazwa aplikacji to "fabric:/myapp/app1", tożsamość aplikacji będzie miała wartość "myapp~app1" w wersji 6.0 lub nowszej oraz "myapp/app1" w poprzednich wersjach. |
--node-name [Wymagane] | Nazwa węzła. |
--include-health-state | Uwzględnij stan kondycji jednostki. Jeśli ten parametr ma wartość false lub nie zostanie określony, zwracany stan kondycji to "Nieznany". Po ustawieniu wartości true zapytanie przechodzi równolegle do węzła i usługi systemu kondycji przed scaleniem wyników. W związku z tym zapytanie jest droższe i może zająć więcej czasu. |
--timeout -t | Limit czasu serwera na potrzeby wykonywania operacji w sekundach. Ten limit czasu określa czas trwania, przez który klient chce poczekać na ukończenie żądanej operacji. Wartość domyślna tego parametru to 60 sekund. Wartość domyślna: 60. |
Argumenty globalne
Argument | opis |
---|---|
--debugować | Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. |
--help -h | Pokaż ten komunikat pomocy i zakończ pracę. |
--output -o | Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json. |
--zapytanie | Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów. |
--gadatliwy | Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania. |
sfctl application deployed-health
Pobiera informacje o kondycji aplikacji wdrożonej w węźle usługi Service Fabric.
Pobiera informacje o kondycji aplikacji wdrożonej w węźle usługi Service Fabric. Użyj elementu EventsHealthStateFilter, aby opcjonalnie filtrować kolekcję obiektów HealthEvent zgłoszonych w wdrożonej aplikacji na podstawie stanu kondycji. Użyj polecenia DeployedServicePackagesHealthStateFilter, aby opcjonalnie filtrować elementy podrzędne DeployedServicePackageHealth na podstawie stanu kondycji.
Argumenty
Argument | opis |
---|---|
--application-id [Wymagane] | Tożsamość aplikacji. Jest to zazwyczaj pełna nazwa aplikacji bez schematu identyfikatora URI "fabric:". Począwszy od wersji 6.0, nazwy hierarchiczne są rozdzielane znakiem "~". Jeśli na przykład nazwa aplikacji to "fabric:/myapp/app1", tożsamość aplikacji będzie miała wartość "myapp~app1" w wersji 6.0 lub nowszej oraz "myapp/app1" w poprzednich wersjach. |
--node-name [Wymagane] | Nazwa węzła. |
--deployed-service-packages-health-state-filter | Umożliwia filtrowanie obiektów stanu kondycji wdrożonego pakietu usługi zwróconych w wyniku wdrożonego zapytania kondycji aplikacji na podstawie ich stanu kondycji. Możliwe wartości tego parametru obejmują wartość całkowitą jednego z następujących stanów kondycji. Zwracane są tylko wdrożone pakiety usług zgodne z filtrem. Wszystkie wdrożone pakiety usług są używane do oceny zagregowanego stanu kondycji wdrożonej aplikacji. Jeśli nie zostanie określony, zwracane są wszystkie wpisy. Wartości stanu to wyliczenie oparte na flagach, więc wartość może być kombinacją tych wartości uzyskanych przy użyciu operatora bitowego OR. Jeśli na przykład podana wartość to 6, zwracany jest stan kondycji pakietów usługi z wartością HealthState ok (2) i Ostrzeżenie (4). - Wartość domyślna — wartość domyślna. Pasuje do dowolnego stanu kondycji. Wartość jest równa zero. - Brak — filtr, który nie jest zgodny z żadną wartością HealthState. Służy do zwracania żadnych wyników w danej kolekcji stanów. Wartość to 1. - Ok — filtr zgodny z danymi wejściowymi z wartością HealthState ok. Wartość to 2. - Ostrzeżenie — filtr zgodny z danymi wejściowymi z wartością HealthState Ostrzeżenie. Wartość to 4. - Błąd — filtr zgodny z danymi wejściowymi z wartością HealthState Error. Wartość to 8. - Wszystkie — filtr, który pasuje do danych wejściowych z dowolną wartością HealthState. Wartość to 65535. |
--events-health-state-filter | Umożliwia filtrowanie kolekcji obiektów HealthEvent zwracanych na podstawie stanu kondycji. Możliwe wartości tego parametru obejmują wartość całkowitą jednego z następujących stanów kondycji. Zwracane są tylko zdarzenia zgodne z filtrem. Wszystkie zdarzenia są używane do oceny zagregowanego stanu kondycji. Jeśli nie zostanie określony, zwracane są wszystkie wpisy. Wartości stanu to wyliczenie oparte na flagach, więc wartość może być kombinacją tych wartości uzyskanych przy użyciu operatora bitowego OR. Jeśli na przykład podana wartość to 6, zwracane są wszystkie zdarzenia z wartością HealthState ok (2) i Ostrzeżenie (4). - Wartość domyślna — wartość domyślna. Pasuje do dowolnego stanu kondycji. Wartość jest równa zero. - Brak — filtr, który nie jest zgodny z żadną wartością HealthState. Służy do zwracania żadnych wyników w danej kolekcji stanów. Wartość to 1. - Ok — filtr zgodny z danymi wejściowymi z wartością HealthState ok. Wartość to 2. - Ostrzeżenie — filtr zgodny z danymi wejściowymi z wartością HealthState Ostrzeżenie. Wartość to 4. - Błąd — filtr zgodny z danymi wejściowymi z wartością HealthState Error. Wartość to 8. - Wszystkie — filtr, który pasuje do danych wejściowych z dowolną wartością HealthState. Wartość to 65535. |
--exclude-health-statistics | Wskazuje, czy statystyki kondycji powinny być zwracane w ramach wyniku zapytania. Wartość false domyślnie. Statystyki pokazują liczbę jednostek podrzędnych w stanie kondycji Ok, Ostrzeżenie i Błąd. |
--timeout -t | Limit czasu serwera na potrzeby wykonywania operacji w sekundach. Ten limit czasu określa czas trwania, przez który klient chce poczekać na ukończenie żądanej operacji. Wartość domyślna tego parametru to 60 sekund. Wartość domyślna: 60. |
Argumenty globalne
Argument | opis |
---|---|
--debugować | Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. |
--help -h | Pokaż ten komunikat pomocy i zakończ pracę. |
--output -o | Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json. |
--zapytanie | Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów. |
--gadatliwy | Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania. |
sfctl application deployed-list
Pobiera listę aplikacji wdrożonych w węźle usługi Service Fabric.
Pobiera listę aplikacji wdrożonych w węźle usługi Service Fabric. Wyniki nie zawierają informacji o wdrożonych aplikacjach systemowych, chyba że jawnie wykonano zapytanie o identyfikator. Wyniki obejmują wdrożone aplikacje w stanach aktywnego, aktywowania i pobierania. To zapytanie wymaga, aby nazwa węzła odpowiadała węzłowi w klastrze. Zapytanie kończy się niepowodzeniem, jeśli podana nazwa węzła nie wskazuje żadnych aktywnych węzłów usługi Service Fabric w klastrze.
Argumenty
Argument | opis |
---|---|
--node-name [Wymagane] | Nazwa węzła. |
--continuation-token | Parametr tokenu kontynuacji służy do uzyskiwania następnego zestawu wyników. Token kontynuacji z niepustą wartością jest uwzględniany w odpowiedzi interfejsu API, gdy wyniki z systemu nie mieszczą się w jednej odpowiedzi. Po przekazaniu tej wartości do następnego wywołania interfejsu API interfejs API zwraca następny zestaw wyników. Jeśli nie ma dalszych wyników, token kontynuacji nie zawiera wartości. Wartość tego parametru nie powinna być zakodowana pod adresem URL. |
--include-health-state | Uwzględnij stan kondycji jednostki. Jeśli ten parametr ma wartość false lub nie zostanie określony, zwracany stan kondycji to "Nieznany". Po ustawieniu wartości true zapytanie przechodzi równolegle do węzła i usługi systemu kondycji przed scaleniem wyników. W związku z tym zapytanie jest droższe i może zająć więcej czasu. |
--max-results | Maksymalna liczba wyników, które mają być zwracane w ramach stronicowanych zapytań. Ten parametr definiuje górną granicę liczby zwróconych wyników. Zwrócone wyniki mogą być mniejsze niż określone maksymalne wyniki, jeśli nie mieszczą się w komunikacie zgodnie z maksymalnymi ograniczeniami rozmiaru komunikatu zdefiniowanymi w konfiguracji. Jeśli ten parametr ma wartość zero lub nie zostanie określony, zapytanie stronicowane zawiera jak najwięcej wyników, które mieszczą się w komunikacie zwrotnym. |
--timeout -t | Limit czasu serwera na potrzeby wykonywania operacji w sekundach. Ten limit czasu określa czas trwania, przez który klient chce poczekać na ukończenie żądanej operacji. Wartość domyślna tego parametru to 60 sekund. Wartość domyślna: 60. |
Argumenty globalne
Argument | opis |
---|---|
--debugować | Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. |
--help -h | Pokaż ten komunikat pomocy i zakończ pracę. |
--output -o | Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json. |
--zapytanie | Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów. |
--gadatliwy | Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania. |
sfctl application health
Pobiera kondycję aplikacji usługi Service Fabric.
Zwraca stan ciepła aplikacji usługi Service Fabric. Odpowiedzi zgłasza stan kondycji Ok, Błąd lub Ostrzeżenie. Jeśli jednostka nie zostanie znaleziona w magazynie kondycji, zwróci błąd.
Argumenty
Argument | opis |
---|---|
--application-id [Wymagane] | Tożsamość aplikacji. Jest to zazwyczaj pełna nazwa aplikacji bez schematu identyfikatora URI "fabric:". Począwszy od wersji 6.0, nazwy hierarchiczne są rozdzielane znakiem "~". Jeśli na przykład nazwa aplikacji to "fabric:/myapp/app1", tożsamość aplikacji będzie miała wartość "myapp~app1" w wersji 6.0 lub nowszej oraz "myapp/app1" w poprzednich wersjach. |
--deployed-applications-health-state-filter | Umożliwia filtrowanie obiektów stanu kondycji wdrożonych aplikacji zwróconych w wyniku zapytania kondycji aplikacji na podstawie ich stanu kondycji. Możliwe wartości tego parametru obejmują wartość całkowitą jednego z następujących stanów kondycji. Zostaną zwrócone tylko wdrożone aplikacje zgodne z filtrem. Wszystkie wdrożone aplikacje są używane do oceny zagregowanego stanu kondycji. Jeśli nie zostanie określony, zwracane są wszystkie wpisy. Wartości stanu to wyliczenie oparte na flagach, więc wartość może być kombinacją tych wartości uzyskanych przy użyciu operatora bitowego "OR". Jeśli na przykład podana wartość to 6, zwracany jest stan kondycji wdrożonych aplikacji z wartością HealthState ok (2) i Ostrzeżenie (4). - Wartość domyślna — wartość domyślna. Pasuje do dowolnego stanu kondycji. Wartość jest równa zero. - Brak — filtr, który nie jest zgodny z żadną wartością HealthState. Służy do zwracania żadnych wyników w danej kolekcji stanów. Wartość to 1. - Ok — filtr zgodny z danymi wejściowymi z wartością HealthState ok. Wartość to 2. - Ostrzeżenie — filtr zgodny z danymi wejściowymi z wartością HealthState Ostrzeżenie. Wartość to 4. - Błąd — filtr zgodny z danymi wejściowymi z wartością HealthState Error. Wartość to 8. - Wszystkie — filtr, który pasuje do danych wejściowych z dowolną wartością HealthState. Wartość to 65535. |
--events-health-state-filter | Umożliwia filtrowanie kolekcji obiektów HealthEvent zwracanych na podstawie stanu kondycji. Możliwe wartości tego parametru obejmują wartość całkowitą jednego z następujących stanów kondycji. Zwracane są tylko zdarzenia zgodne z filtrem. Wszystkie zdarzenia są używane do oceny zagregowanego stanu kondycji. Jeśli nie zostanie określony, zwracane są wszystkie wpisy. Wartości stanu to wyliczenie oparte na flagach, więc wartość może być kombinacją tych wartości uzyskanych przy użyciu operatora bitowego OR. Jeśli na przykład podana wartość to 6, zwracane są wszystkie zdarzenia z wartością HealthState ok (2) i Ostrzeżenie (4). - Wartość domyślna — wartość domyślna. Pasuje do dowolnego stanu kondycji. Wartość jest równa zero. - Brak — filtr, który nie jest zgodny z żadną wartością HealthState. Służy do zwracania żadnych wyników w danej kolekcji stanów. Wartość to 1. - Ok — filtr zgodny z danymi wejściowymi z wartością HealthState ok. Wartość to 2. - Ostrzeżenie — filtr zgodny z danymi wejściowymi z wartością HealthState Ostrzeżenie. Wartość to 4. - Błąd — filtr zgodny z danymi wejściowymi z wartością HealthState Error. Wartość to 8. - Wszystkie — filtr, który pasuje do danych wejściowych z dowolną wartością HealthState. Wartość to 65535. |
--exclude-health-statistics | Wskazuje, czy statystyki kondycji powinny być zwracane w ramach wyniku zapytania. Wartość false domyślnie. Statystyki pokazują liczbę jednostek podrzędnych w stanie kondycji Ok, Ostrzeżenie i Błąd. |
--services-health-state-filter | Umożliwia filtrowanie obiektów stanu kondycji usług zwróconych w wyniku zapytania kondycji usług na podstawie ich stanu kondycji. Możliwe wartości tego parametru obejmują wartość całkowitą jednego z następujących stanów kondycji. Zwracane są tylko usługi zgodne z filtrem. Wszystkie usługi są używane do oceny zagregowanego stanu kondycji. Jeśli nie zostanie określony, zwracane są wszystkie wpisy. Wartości stanu to wyliczenie oparte na flagach, więc wartość może być kombinacją tych wartości uzyskanych przy użyciu operatora bitowego "OR". Jeśli na przykład podana wartość to 6, zostanie zwrócony stan kondycji usług z wartością HealthState OK (2) i Ostrzeżenie (4). - Wartość domyślna — wartość domyślna. Pasuje do dowolnego stanu kondycji. Wartość jest równa zero. - Brak — filtr, który nie jest zgodny z żadną wartością HealthState. Służy do zwracania żadnych wyników w danej kolekcji stanów. Wartość to 1. - Ok — filtr zgodny z danymi wejściowymi z wartością HealthState ok. Wartość to 2. - Ostrzeżenie — filtr zgodny z danymi wejściowymi z wartością HealthState Ostrzeżenie. Wartość to 4. - Błąd — filtr zgodny z danymi wejściowymi z wartością HealthState Error. Wartość to 8. - Wszystkie — filtr, który pasuje do danych wejściowych z dowolną wartością HealthState. Wartość to 65535. |
--timeout -t | Limit czasu serwera na potrzeby wykonywania operacji w sekundach. Ten limit czasu określa czas trwania, przez który klient chce poczekać na ukończenie żądanej operacji. Wartość domyślna tego parametru to 60 sekund. Wartość domyślna: 60. |
Argumenty globalne
Argument | opis |
---|---|
--debugować | Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. |
--help -h | Pokaż ten komunikat pomocy i zakończ pracę. |
--output -o | Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json. |
--zapytanie | Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów. |
--gadatliwy | Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania. |
sfctl application info
Pobiera informacje o aplikacji usługi Service Fabric.
Zwraca informacje o aplikacji, która została utworzona lub w procesie tworzenia w klastrze usługi Service Fabric i której nazwa jest zgodna z nazwą określoną jako parametr. Odpowiedź zawiera nazwę, typ, stan, parametry i inne szczegóły dotyczące aplikacji.
Argumenty
Argument | opis |
---|---|
--application-id [Wymagane] | Tożsamość aplikacji. Jest to zazwyczaj pełna nazwa aplikacji bez schematu identyfikatora URI "fabric:". Począwszy od wersji 6.0, nazwy hierarchiczne są rozdzielane znakiem "~". Jeśli na przykład nazwa aplikacji to "fabric:/myapp/app1", tożsamość aplikacji będzie miała wartość "myapp~app1" w wersji 6.0 lub nowszej oraz "myapp/app1" w poprzednich wersjach. |
--exclude-application-parameters | Flaga określająca, czy parametry aplikacji zostaną wykluczone z wyniku. |
--timeout -t | Limit czasu serwera na potrzeby wykonywania operacji w sekundach. Ten limit czasu określa czas trwania, przez który klient chce poczekać na ukończenie żądanej operacji. Wartość domyślna tego parametru to 60 sekund. Wartość domyślna: 60. |
Argumenty globalne
Argument | opis |
---|---|
--debugować | Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. |
--help -h | Pokaż ten komunikat pomocy i zakończ pracę. |
--output -o | Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json. |
--zapytanie | Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów. |
--gadatliwy | Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania. |
lista aplikacji sfctl
Pobiera listę aplikacji utworzonych w klastrze usługi Service Fabric, które są zgodne z określonymi filtrami.
Pobiera informacje o aplikacjach, które zostały utworzone lub w procesie tworzenia w klastrze usługi Service Fabric i są zgodne z określonymi filtrami. Odpowiedź zawiera nazwę, typ, stan, parametry i inne szczegóły dotyczące aplikacji. Jeśli aplikacje nie mieszczą się na stronie, zostanie zwrócona jedna strona wyników, a także token kontynuacji, którego można użyć do pobrania następnej strony. Nie można jednocześnie określić parametrów ApplicationTypeName i ApplicationDefinitionKindFilter.
Argumenty
Argument | opis |
---|---|
--application-definition-kind-filter | Służy do filtrowania według parametru ApplicationDefinitionKind, który jest mechanizmem używanym do definiowania aplikacji usługi Service Fabric. - Wartość domyślna — wartość domyślna, która wykonuje tę samą funkcję, co wybranie pozycji "Wszystko". Wartość to 0. - Wszystkie — filtr, który pasuje do danych wejściowych z dowolną wartością ApplicationDefinitionKind. Wartość to 65535. - ServiceFabricApplicationDescription — filtr zgodny z wartością ApplicationDefinitionKind ServiceFabricApplicationDescription. Wartość to 1. - Compose — filtr zgodny z danymi wejściowymi za pomocą wartości ApplicationDefinitionKind Compose. Wartość to 2. |
--application-type-name | Nazwa typu aplikacji używana do filtrowania aplikacji do wykonywania zapytań. Ta wartość nie powinna zawierać wersji typu aplikacji. |
--continuation-token | Parametr tokenu kontynuacji służy do uzyskiwania następnego zestawu wyników. Token kontynuacji z niepustą wartością jest uwzględniany w odpowiedzi interfejsu API, gdy wyniki z systemu nie mieszczą się w jednej odpowiedzi. Po przekazaniu tej wartości do następnego wywołania interfejsu API interfejs API zwraca następny zestaw wyników. Jeśli nie ma dalszych wyników, token kontynuacji nie zawiera wartości. Wartość tego parametru nie powinna być zakodowana pod adresem URL. |
--exclude-application-parameters | Flaga określająca, czy parametry aplikacji zostaną wykluczone z wyniku. |
--max-results | Maksymalna liczba wyników, które mają być zwracane w ramach stronicowanych zapytań. Ten parametr definiuje górną granicę liczby zwróconych wyników. Zwrócone wyniki mogą być mniejsze niż określone maksymalne wyniki, jeśli nie mieszczą się w komunikacie zgodnie z maksymalnymi ograniczeniami rozmiaru komunikatu zdefiniowanymi w konfiguracji. Jeśli ten parametr ma wartość zero lub nie zostanie określony, zapytanie stronicowane zawiera jak najwięcej wyników, które mieszczą się w komunikacie zwrotnym. |
--timeout -t | Limit czasu serwera na potrzeby wykonywania operacji w sekundach. Ten limit czasu określa czas trwania, przez który klient chce poczekać na ukończenie żądanej operacji. Wartość domyślna tego parametru to 60 sekund. Wartość domyślna: 60. |
Argumenty globalne
Argument | opis |
---|---|
--debugować | Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. |
--help -h | Pokaż ten komunikat pomocy i zakończ pracę. |
--output -o | Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json. |
--zapytanie | Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów. |
--gadatliwy | Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania. |
ładowanie aplikacji sfctl
Pobiera informacje o ładowaniu aplikacji usługi Service Fabric.
Zwraca informacje o obciążeniu aplikacji, która została utworzona lub w procesie tworzenia w klastrze usługi Service Fabric i którego nazwa jest zgodna z nazwą określoną jako parametr. Odpowiedź zawiera nazwę, minimalne węzły, maksymalne węzły, liczbę węzłów, które zajmuje aplikacja, oraz informacje o metryce ładowania aplikacji.
Argumenty
Argument | opis |
---|---|
--application-id [Wymagane] | Tożsamość aplikacji. Jest to zazwyczaj pełna nazwa aplikacji bez schematu identyfikatora URI "fabric:". Począwszy od wersji 6.0, nazwy hierarchiczne są rozdzielane znakiem "~". Jeśli na przykład nazwa aplikacji to "fabric:/myapp/app1", tożsamość aplikacji będzie miała wartość "myapp~app1" w wersji 6.0 lub nowszej oraz "myapp/app1" w poprzednich wersjach. |
--timeout -t | Limit czasu serwera na potrzeby wykonywania operacji w sekundach. Ten limit czasu określa czas trwania, przez który klient chce poczekać na ukończenie żądanej operacji. Wartość domyślna tego parametru to 60 sekund. Wartość domyślna: 60. |
Argumenty globalne
Argument | opis |
---|---|
--debugować | Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. |
--help -h | Pokaż ten komunikat pomocy i zakończ pracę. |
--output -o | Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json. |
--zapytanie | Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów. |
--gadatliwy | Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania. |
sfctl application manifest
Pobiera manifest opisujący typ aplikacji.
Odpowiedź zawiera kod XML manifestu aplikacji jako ciąg.
Argumenty
Argument | opis |
---|---|
--application-type-name [Wymagane] | Nazwa typu aplikacji. |
--application-type-version [Wymagane] | Wersja typu aplikacji. |
--timeout -t | Limit czasu serwera na potrzeby wykonywania operacji w sekundach. Ten limit czasu określa czas trwania, przez który klient chce poczekać na ukończenie żądanej operacji. Wartość domyślna tego parametru to 60 sekund. Wartość domyślna: 60. |
Argumenty globalne
Argument | opis |
---|---|
--debugować | Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. |
--help -h | Pokaż ten komunikat pomocy i zakończ pracę. |
--output -o | Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json. |
--zapytanie | Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów. |
--gadatliwy | Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania. |
sfctl application provision (Aprowizuj aplikację sfctl)
Aprowizuje lub rejestruje typ aplikacji usługi Service Fabric w klastrze przy użyciu pakietu ".sfpkg" w sklepie zewnętrznym lub pakietu aplikacji w magazynie obrazów.
Aprowizuje typ aplikacji usługi Service Fabric w klastrze. Aprowizacja jest wymagana przed utworzeniem wystąpienia nowych aplikacji. Operację aprowizacji można wykonać w pakiecie aplikacji określonym przez parametr relativePathInImageStore lub przy użyciu identyfikatora URI zewnętrznego '.sfpkg'. Jeśli nie ustawiono opcji --external-provision, to polecenie będzie oczekiwać aprowizacji magazynu obrazów.
Argumenty
Argument | opis |
---|---|
--application-package-download-uri | Ścieżka do pakietu aplikacji ".sfpkg", z którego można pobrać pakiet aplikacji przy użyciu protokołów HTTP lub HTTPS. Tylko w przypadku magazynu zewnętrznego typu aprowizacji. Pakiet aplikacji może być przechowywany w magazynie zewnętrznym, który zapewnia operację GET w celu pobrania pliku. Obsługiwane protokoły to HTTP i HTTPS, a ścieżka musi zezwalać na dostęp do odczytu. |
--application-type-build-path | Tylko w przypadku magazynu obrazów typu aprowizacji. Ścieżka względna pakietu aplikacji w magazynie obrazów określonym podczas poprzedniej operacji przekazywania. |
--application-type-name | Tylko w przypadku magazynu zewnętrznego typu aprowizacji. Nazwa typu aplikacji reprezentuje nazwę typu aplikacji znalezionego w manifeście aplikacji. |
--application-type-version | Tylko w przypadku magazynu zewnętrznego typu aprowizacji. Wersja typu aplikacji reprezentuje wersję typu aplikacji znalezionego w manifeście aplikacji. |
--external-provision | Lokalizacja, z której można zarejestrować lub aprowizować pakiet aplikacji. Wskazuje, że aprowizacja dotyczy pakietu aplikacji, który został wcześniej przekazany do magazynu zewnętrznego. Pakiet aplikacji kończy się rozszerzeniem *.sfpkg. |
--no-wait | Wskazuje, czy aprowizacja powinna wystąpić asynchronicznie. Po ustawieniu wartości true operacja aprowizacji zwraca wartość, gdy żądanie zostanie zaakceptowane przez system, a operacja aprowizacji będzie kontynuowana bez żadnego limitu czasu. Wartość domyślna to false. W przypadku dużych pakietów aplikacji zalecamy ustawienie wartości true. |
--timeout -t | Wartość domyślna: 60. |
Argumenty globalne
Argument | opis |
---|---|
--debugować | Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. |
--help -h | Pokaż ten komunikat pomocy i zakończ pracę. |
--output -o | Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json. |
--zapytanie | Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów. |
--gadatliwy | Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania. |
sfctl application report-health
Wysyła raport o kondycji aplikacji usługi Service Fabric.
Zgłasza stan kondycji określonej aplikacji usługi Service Fabric. Raport musi zawierać informacje o źródle raportu o kondycji i właściwości, na której jest raportowany. Raport jest wysyłany do aplikacji bramy usługi Service Fabric, która przekazuje do magazynu kondycji. Raport może zostać zaakceptowany przez bramę, ale odrzucony przez magazyn kondycji po dodatkowej weryfikacji. Na przykład magazyn kondycji może odrzucić raport z powodu nieprawidłowego parametru, takiego jak nieaktualny numer sekwencji. Aby sprawdzić, czy raport został zastosowany w magazynie kondycji, uzyskaj kondycję aplikacji i sprawdź, czy raport jest wyświetlany.
Argumenty
Argument | opis |
---|---|
--application-id [Wymagane] | Tożsamość aplikacji. Jest to zazwyczaj pełna nazwa aplikacji bez schematu identyfikatora URI "fabric:". Począwszy od wersji 6.0, hierarchiczne nazwy są rozdzielane znakiem "~". Jeśli na przykład nazwa aplikacji to "fabric:/myapp/app1", tożsamość aplikacji będzie miała wartość "myapp~app1" w wersji 6.0+ i "myapp/app1" w poprzednich wersjach. |
--health-property [Required] | Właściwość informacji o kondycji. Jednostka może mieć raporty o kondycji dla różnych właściwości. Właściwość jest ciągiem, a nie stałym wyliczeniem, aby umożliwić reporterowi elastyczne kategoryzowanie warunku stanu wyzwalającego raport. Na przykład reporter o identyfikatorze SourceId "LocalWatchdog" może monitorować stan dostępnego dysku w węźle, dzięki czemu może zgłaszać właściwość "AvailableDisk" w tym węźle. Ten sam reporter może monitorować łączność węzła, dzięki czemu może zgłosić właściwość "Łączność" w tym samym węźle. W magazynie kondycji te raporty są traktowane jako oddzielne zdarzenia kondycji dla określonego węzła. Wraz z identyfikatorem SourceId właściwość jednoznacznie identyfikuje informacje o kondycji. |
--health-state [Wymagane] | Możliwe wartości to: "Invalid", "Ok", "Warning", "Error", "Unknown". |
--source-id [Wymagane] | Nazwa źródłowa identyfikująca składnik client/watchdog/system, który wygenerował informacje o kondycji. |
--opis | Opis informacji o kondycji. Reprezentuje on dowolny tekst używany do dodawania czytelnych informacji o raporcie. Maksymalna długość ciągu opisu wynosi 4096 znaków. Jeśli podany ciąg będzie dłuższy, zostanie on automatycznie obcięty. Po obcięciu ostatnie znaki opisu zawierają znacznik "[Obcięte]", a łączny rozmiar ciągu to 4096 znaków. Obecność znacznika wskazuje użytkownikom, że wystąpił obcięcie. Pamiętaj, że po obcięciu opis zawiera mniej niż 4096 znaków z oryginalnego ciągu. |
--bezpośredni | Flaga wskazująca, czy raport powinien być wysyłany natychmiast. Raport kondycji jest wysyłany do aplikacji bramy usługi Service Fabric, która przekazuje do magazynu kondycji. Jeśli ustawienie Natychmiastowe ma wartość true, raport jest wysyłany natychmiast z bramy HTTP do magazynu kondycji, niezależnie od ustawień klienta sieci szkieletowej używanych przez aplikację usługi HTTP Gateway. Jest to przydatne w przypadku raportów krytycznych, które powinny być wysyłane tak szybko, jak to możliwe. W zależności od czasu i innych warunków wysyłanie raportu może nadal zakończyć się niepowodzeniem, na przykład jeśli brama HTTP jest zamknięta lub komunikat nie dociera do bramy. Jeśli ustawienie Natychmiastowe ma wartość false, raport jest wysyłany na podstawie ustawień klienta kondycji z bramy HTTP. W związku z tym zostanie ona wsadowa zgodnie z konfiguracją HealthReportSendInterval. Jest to zalecane ustawienie, ponieważ umożliwia klientowi kondycji optymalizowanie komunikatów raportowania kondycji do magazynu kondycji oraz przetwarzania raportów o kondycji. Domyślnie raporty nie są wysyłane natychmiast. |
--remove-when-expired | Wartość wskazująca, czy raport jest usuwany z magazynu kondycji po wygaśnięciu. W przypadku ustawienia wartości true raport zostanie usunięty z magazynu kondycji po wygaśnięciu. Jeśli ustawiono wartość false, raport jest traktowany jako błąd po wygaśnięciu. Wartość tej właściwości jest domyślnie fałsz. W przypadku okresowego raportowania klientów należy ustawić wartość RemoveWhenExpired false (wartość domyślna). W ten sposób reporter ma problemy (np. zakleszczenie) i nie może zgłosić, jednostka jest oceniana z powodu błędu po wygaśnięciu raportu kondycji. Oznacza to, że jednostka jest w stanie Kondycja błędu. |
--sequence-number | Numer sekwencji tego raportu kondycji jako ciąg liczbowy. Numer sekwencji raportów jest używany przez magazyn kondycji do wykrywania nieaktualnych raportów. Jeśli nie zostanie określony, numer sekwencji jest generowany automatycznie przez klienta kondycji po dodaniu raportu. |
--timeout -t | Wartość domyślna: 60. |
--Ttl | Czas trwania, dla którego ten raport o kondycji jest prawidłowy. To pole używa formatu ISO8601 do określania czasu trwania. Gdy klienci będą okresowo raportować, powinni wysyłać raporty o wyższej częstotliwości niż czas wygaśnięcia. Jeśli klienci raportują o przejściu, mogą ustawić czas wygaśnięcia na nieskończoność. Po wygaśnięciu czasu wygaśnięcia zdarzenie kondycji zawierające informacje o kondycji zostanie usunięte ze sklepu kondycji, jeśli wartość RemoveWhenExpired ma wartość true lub zostanie obliczona w przypadku błędu, jeśli element RemoveWhenExpired ma wartość false. Jeśli nie zostanie określony, czas wygaśnięcia domyślnie ma wartość nieskończoną. |
Argumenty globalne
Argument | opis |
---|---|
--debugować | Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. |
--help -h | Pokaż ten komunikat pomocy i zakończ pracę. |
--output -o | Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json. |
--zapytanie | Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów. |
--gadatliwy | Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania. |
sfctl application type (typ aplikacji sfctl)
Pobiera listę typów aplikacji w klastrze usługi Service Fabric pasujących dokładnie do określonej nazwy.
Zwraca informacje o typach aplikacji, które są aprowizowania lub w procesie aprowizacji w klastrze usługi Service Fabric. Są to typy aplikacji, których nazwa jest zgodna dokładnie z określonym parametrem i które są zgodne z podanymi parametrami zapytania. Zwracane są wszystkie wersje typu aplikacji pasujące do nazwy typu aplikacji, a każda wersja jest zwracana jako jeden typ aplikacji. Odpowiedź zawiera nazwę, wersję, stan i inne szczegóły dotyczące typu aplikacji. Jest to zapytanie stronicowane, co oznacza, że jeśli nie wszystkie typy aplikacji mieszczą się na stronie, zostanie zwrócona jedna strona wyników, a także token kontynuacji, który może służyć do uzyskania następnej strony. Jeśli na przykład istnieje 10 typów aplikacji, ale strona pasuje tylko do pierwszych trzech typów aplikacji lub jeśli maksymalna liczba wyników jest ustawiona na 3, zostanie zwrócona trzy. Aby uzyskać dostęp do pozostałych wyników, pobierz kolejne strony przy użyciu zwróconego tokenu kontynuacji w następnym zapytaniu. Pusty token kontynuacji jest zwracany, jeśli nie ma żadnych kolejnych stron.
Argumenty
Argument | opis |
---|---|
--application-type-name [Wymagane] | Nazwa typu aplikacji. |
--application-type-version | Wersja typu aplikacji. |
--continuation-token | Parametr tokenu kontynuacji służy do uzyskiwania następnego zestawu wyników. Token kontynuacji z niepustą wartością jest uwzględniany w odpowiedzi interfejsu API, gdy wyniki z systemu nie mieszczą się w jednej odpowiedzi. Po przekazaniu tej wartości do następnego wywołania interfejsu API interfejs API zwraca następny zestaw wyników. Jeśli nie ma dalszych wyników, token kontynuacji nie zawiera wartości. Wartość tego parametru nie powinna być zakodowana pod adresem URL. |
--exclude-application-parameters | Flaga określająca, czy parametry aplikacji zostaną wykluczone z wyniku. |
--max-results | Maksymalna liczba wyników, które mają być zwracane w ramach stronicowanych zapytań. Ten parametr definiuje górną granicę liczby zwróconych wyników. Zwrócone wyniki mogą być mniejsze niż określone maksymalne wyniki, jeśli nie mieszczą się w komunikacie zgodnie z maksymalnymi ograniczeniami rozmiaru komunikatu zdefiniowanymi w konfiguracji. Jeśli ten parametr ma wartość zero lub nie zostanie określony, zapytanie stronicowane zawiera jak najwięcej wyników, które mieszczą się w komunikacie zwrotnym. |
--timeout -t | Limit czasu serwera na potrzeby wykonywania operacji w sekundach. Ten limit czasu określa czas trwania, przez który klient chce poczekać na ukończenie żądanej operacji. Wartość domyślna tego parametru to 60 sekund. Wartość domyślna: 60. |
Argumenty globalne
Argument | opis |
---|---|
--debugować | Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. |
--help -h | Pokaż ten komunikat pomocy i zakończ pracę. |
--output -o | Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json. |
--zapytanie | Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów. |
--gadatliwy | Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania. |
sfctl application type-list
Pobiera listę typów aplikacji w klastrze usługi Service Fabric.
Zwraca informacje o typach aplikacji, które są aprowizowania lub w procesie aprowizacji w klastrze usługi Service Fabric. Każda wersja typu aplikacji jest zwracana jako jeden typ aplikacji. Odpowiedź zawiera nazwę, wersję, stan i inne szczegóły dotyczące typu aplikacji. Jest to zapytanie stronicowane, co oznacza, że jeśli nie wszystkie typy aplikacji mieszczą się na stronie, zostanie zwrócona jedna strona wyników, a także token kontynuacji, który może służyć do uzyskania następnej strony. Jeśli na przykład istnieje 10 typów aplikacji, ale strona pasuje tylko do pierwszych trzech typów aplikacji lub jeśli maksymalna liczba wyników jest ustawiona na 3, zostanie zwrócona trzy. Aby uzyskać dostęp do pozostałych wyników, pobierz kolejne strony przy użyciu zwróconego tokenu kontynuacji w następnym zapytaniu. Pusty token kontynuacji jest zwracany, jeśli nie ma żadnych kolejnych stron.
Argumenty
Argument | opis |
---|---|
--application-type-definition-kind-filter | Służy do filtrowania według parametru ApplicationTypeDefinitionKind, który jest mechanizmem używanym do definiowania typu aplikacji usługi Service Fabric. - Wartość domyślna — wartość domyślna, która wykonuje tę samą funkcję, co wybranie pozycji "Wszystko". Wartość to 0. - Wszystkie — filtr zgodny z danymi wejściowymi z dowolną wartością ApplicationTypeDefinitionKind. Wartość to 65535. - ServiceFabricApplicationPackage — filtr zgodny z wartością ApplicationTypeDefinitionKind ServiceFabricApplicationPackage. Wartość to 1. - Compose — filtr zgodny z danymi wejściowymi za pomocą wartości ApplicationTypeDefinitionKind Compose. Wartość to 2. |
--continuation-token | Parametr tokenu kontynuacji służy do uzyskiwania następnego zestawu wyników. Token kontynuacji z niepustą wartością jest uwzględniany w odpowiedzi interfejsu API, gdy wyniki z systemu nie mieszczą się w jednej odpowiedzi. Po przekazaniu tej wartości do następnego wywołania interfejsu API interfejs API zwraca następny zestaw wyników. Jeśli nie ma dalszych wyników, token kontynuacji nie zawiera wartości. Wartość tego parametru nie powinna być zakodowana pod adresem URL. |
--exclude-application-parameters | Flaga określająca, czy parametry aplikacji zostaną wykluczone z wyniku. |
--max-results | Maksymalna liczba wyników, które mają być zwracane w ramach stronicowanych zapytań. Ten parametr definiuje górną granicę liczby zwróconych wyników. Zwrócone wyniki mogą być mniejsze niż określone maksymalne wyniki, jeśli nie mieszczą się w komunikacie zgodnie z maksymalnymi ograniczeniami rozmiaru komunikatu zdefiniowanymi w konfiguracji. Jeśli ten parametr ma wartość zero lub nie zostanie określony, zapytanie stronicowane zawiera jak najwięcej wyników, które mieszczą się w komunikacie zwrotnym. |
--timeout -t | Limit czasu serwera na potrzeby wykonywania operacji w sekundach. Ten limit czasu określa czas trwania, przez który klient chce poczekać na ukończenie żądanej operacji. Wartość domyślna tego parametru to 60 sekund. Wartość domyślna: 60. |
Argumenty globalne
Argument | opis |
---|---|
--debugować | Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. |
--help -h | Pokaż ten komunikat pomocy i zakończ pracę. |
--output -o | Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json. |
--zapytanie | Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów. |
--gadatliwy | Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania. |
sfctl application unprovision (Cofnij aprowizowanie aplikacji sfctl)
Usuwa lub wyrejestrowuje typ aplikacji usługi Service Fabric z klastra.
Tę operację można wykonać tylko wtedy, gdy wszystkie wystąpienia aplikacji typu aplikacji zostały usunięte. Po wyrejestrowanym typie aplikacji nie można utworzyć żadnych nowych wystąpień aplikacji dla tego określonego typu aplikacji.
Argumenty
Argument | opis |
---|---|
--application-type-name [Wymagane] | Nazwa typu aplikacji. |
--application-type-version [Wymagane] | Wersja typu aplikacji zdefiniowana w manifeście aplikacji. |
--async-parameter | Flaga wskazująca, czy nie aprowizacja powinna wystąpić asynchronicznie. Po ustawieniu wartości true operacja anulowania aprowizacji jest zwracana, gdy żądanie zostanie zaakceptowane przez system, a operacja anulowania aprowizacji będzie kontynuowana bez limitu czasu. Wartość domyślna to false. Zalecamy jednak ustawienie wartości true dla dużych pakietów aplikacji, które zostały aprowidowane. |
--timeout -t | Limit czasu serwera na potrzeby wykonywania operacji w sekundach. Ten limit czasu określa czas trwania, przez który klient chce poczekać na ukończenie żądanej operacji. Wartość domyślna tego parametru to 60 sekund. Wartość domyślna: 60. |
Argumenty globalne
Argument | opis |
---|---|
--debugować | Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. |
--help -h | Pokaż ten komunikat pomocy i zakończ pracę. |
--output -o | Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json. |
--zapytanie | Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów. |
--gadatliwy | Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania. |
uaktualnianie aplikacji sfctl
Rozpoczyna uaktualnianie aplikacji w klastrze usługi Service Fabric.
Sprawdza poprawność podanych parametrów uaktualniania aplikacji i rozpoczyna uaktualnianie aplikacji, jeśli parametry są prawidłowe. Pamiętaj, że opis uaktualnienia zastępuje istniejący opis aplikacji. Oznacza to, że jeśli parametry nie zostaną określone, istniejące parametry w aplikacjach zostaną zastąpione pustą listą parametrów. Spowoduje to użycie przez aplikację wartości domyślnej parametrów z manifestu aplikacji.
Argumenty
Argument | opis |
---|---|
--application-id [Wymagane] | Tożsamość aplikacji. Jest to zazwyczaj pełna nazwa aplikacji bez schematu identyfikatora URI "fabric:". Począwszy od wersji 6.0, nazwy hierarchiczne są rozdzielane znakiem "~". Jeśli na przykład nazwa aplikacji to "fabric:/myapp/app1", tożsamość aplikacji będzie miała wartość "myapp~app1" w wersji 6.0 lub nowszej oraz "myapp/app1" w poprzednich wersjach. |
--application-version [Wymagane] | Wersja typu aplikacji docelowej (znaleziono w manifeście aplikacji) dla uaktualnienia aplikacji. |
--parameters [Wymagane] | Zakodowana w formacie JSON lista przesłonięć parametrów aplikacji, które mają być stosowane podczas uaktualniania aplikacji. |
--default-service-health-policy | Specyfikacja zakodowana w formacie JSON zasad kondycji używana domyślnie do oceny kondycji typu usługi. |
--failure-action | Akcja do wykonania, gdy monitorowane uaktualnienie napotyka naruszenia zasad monitorowania lub zasad kondycji. |
--force-restart | Wymuszanie ponownego uruchamiania procesów podczas uaktualniania nawet wtedy, gdy wersja kodu nie uległa zmianie. |
--health-check-retry-timeout | Czas między próbami przeprowadzenia kontroli kondycji, jeśli aplikacja lub klaster nie są w dobrej kondycji. Ustawienie domyślne: PT0H10M0S. |
--health-check-stable-duration | Czas, przez jaki aplikacja lub klaster musi pozostać w dobrej kondycji, zanim uaktualnienie przejdzie do następnej domeny uaktualnienia. Ustawienie domyślne: PT0H2M0S. Po raz pierwszy jest interpretowany jako ciąg reprezentujący czas trwania ISO 8601. Jeśli to się nie powiedzie, zostanie ona zinterpretowana jako liczba reprezentująca łączną liczbę milisekund. |
--health-check-wait-duration | Czas oczekiwania po ukończeniu domeny uaktualnienia przed rozpoczęciem procesu kontroli kondycji. Domyślnie: 0 |
--max-unhealthy-apps | Maksymalna dozwolona wartość procentowa aplikacji wdrożonych w złej kondycji. Reprezentowane jako liczba z zakresu od 0 do 100. |
--tryb | Tryb używany do monitorowania kondycji podczas uaktualniania stopniowego. Wartość domyślna: NiemonitorowaneAuto. |
--replica-set-check-timeout | Maksymalny czas blokowania przetwarzania domeny uaktualnienia i zapobiegania utracie dostępności, gdy występują nieoczekiwane problemy. Mierzone w sekundach. |
--service-health-policy | Mapa zakodowana w formacie JSON z zasadami kondycji typu usługi na nazwę typu usługi. Mapa jest pusta jako domyślna. |
--timeout -t | Wartość domyślna: 60. |
--upgrade-domain-timeout | Czas ukończenia każdej domeny uaktualnienia przed wykonaniem funkcji FailureAction. Ustawienie domyślne: P10675199DT02H48M05.4775807S. Po raz pierwszy jest interpretowany jako ciąg reprezentujący czas trwania ISO 8601. Jeśli to się nie powiedzie, zostanie ona zinterpretowana jako liczba reprezentująca łączną liczbę milisekund. |
--upgrade-timeout | Czas ukończenia ogólnego uaktualnienia przed wykonaniem funkcji FailureAction. Ustawienie domyślne: P10675199DT02H48M05.4775807S. Po raz pierwszy jest interpretowany jako ciąg reprezentujący czas trwania ISO 8601. Jeśli to się nie powiedzie, zostanie ona zinterpretowana jako liczba reprezentująca łączną liczbę milisekund. |
--warning-as-error | Wskazuje, czy ostrzeżenia są traktowane z taką samą ważnością jak błędy. |
Argumenty globalne
Argument | opis |
---|---|
--debugować | Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. |
--help -h | Pokaż ten komunikat pomocy i zakończ pracę. |
--output -o | Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json. |
--zapytanie | Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów. |
--gadatliwy | Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania. |
sfctl application upgrade-resume
Wznawia uaktualnianie aplikacji w klastrze usługi Service Fabric.
Wznawia niemonitorowane ręczne uaktualnianie aplikacji usługi Service Fabric. Usługa Service Fabric uaktualnia jedną domenę uaktualnienia jednocześnie. W przypadku niemonitorowanych uaktualnień ręcznych po zakończeniu uaktualniania domeny usługi Service Fabric czeka na wywołanie tego interfejsu API przed przejściem do następnej domeny uaktualnienia.
Argumenty
Argument | opis |
---|---|
--application-id [Wymagane] | Tożsamość aplikacji. Jest to zazwyczaj pełna nazwa aplikacji bez schematu identyfikatora URI "fabric:". Począwszy od wersji 6.0, nazwy hierarchiczne są rozdzielane znakiem "~". Jeśli na przykład nazwa aplikacji to "fabric:/myapp/app1", tożsamość aplikacji będzie miała wartość "myapp~app1" w wersji 6.0 lub nowszej oraz "myapp/app1" w poprzednich wersjach. |
--upgrade-domain-name [Wymagane] | Nazwa domeny uaktualnienia, w której ma być wznowione uaktualnienie. |
--timeout -t | Limit czasu serwera na potrzeby wykonywania operacji w sekundach. Ten limit czasu określa czas trwania, przez który klient chce poczekać na ukończenie żądanej operacji. Wartość domyślna tego parametru to 60 sekund. Wartość domyślna: 60. |
Argumenty globalne
Argument | opis |
---|---|
--debugować | Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. |
--help -h | Pokaż ten komunikat pomocy i zakończ pracę. |
--output -o | Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json. |
--zapytanie | Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów. |
--gadatliwy | Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania. |
sfctl application upgrade-rollback
Rozpoczyna wycofywanie obecnie trwającego uaktualnienia aplikacji w klastrze usługi Service Fabric.
Rozpoczyna wycofywanie bieżącego uaktualnienia aplikacji do poprzedniej wersji. Ten interfejs API może służyć tylko do wycofania bieżącego uaktualnienia w toku, które jest stopniowe do nowej wersji. Jeśli aplikacja nie jest obecnie uaktualniana, użyj interfejsu API StartApplicationUpgrade, aby uaktualnić go do żądanej wersji, w tym wycofać poprzednią wersję.
Argumenty
Argument | opis |
---|---|
--application-id [Wymagane] | Tożsamość aplikacji. Jest to zazwyczaj pełna nazwa aplikacji bez schematu identyfikatora URI "fabric:". Począwszy od wersji 6.0, nazwy hierarchiczne są rozdzielane znakiem "~". Jeśli na przykład nazwa aplikacji to "fabric:/myapp/app1", tożsamość aplikacji będzie miała wartość "myapp~app1" w wersji 6.0 lub nowszej oraz "myapp/app1" w poprzednich wersjach. |
--timeout -t | Limit czasu serwera na potrzeby wykonywania operacji w sekundach. Ten limit czasu określa czas trwania, przez który klient chce poczekać na ukończenie żądanej operacji. Wartość domyślna tego parametru to 60 sekund. Wartość domyślna: 60. |
Argumenty globalne
Argument | opis |
---|---|
--debugować | Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. |
--help -h | Pokaż ten komunikat pomocy i zakończ pracę. |
--output -o | Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json. |
--zapytanie | Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów. |
--gadatliwy | Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania. |
sfctl application upgrade-status
Pobiera szczegóły dotyczące najnowszego uaktualnienia wykonanego w tej aplikacji.
Zwraca informacje o stanie najnowszego uaktualnienia aplikacji wraz ze szczegółami, które ułatwiają debugowanie problemów z kondycją aplikacji.
Argumenty
Argument | opis |
---|---|
--application-id [Wymagane] | Tożsamość aplikacji. Jest to zazwyczaj pełna nazwa aplikacji bez schematu identyfikatora URI "fabric:". Począwszy od wersji 6.0, nazwy hierarchiczne są rozdzielane znakiem "~". Jeśli na przykład nazwa aplikacji to "fabric:/myapp/app1", tożsamość aplikacji będzie miała wartość "myapp~app1" w wersji 6.0 lub nowszej oraz "myapp/app1" w poprzednich wersjach. |
--timeout -t | Limit czasu serwera na potrzeby wykonywania operacji w sekundach. Ten limit czasu określa czas trwania, przez który klient chce poczekać na ukończenie żądanej operacji. Wartość domyślna tego parametru to 60 sekund. Wartość domyślna: 60. |
Argumenty globalne
Argument | opis |
---|---|
--debugować | Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. |
--help -h | Pokaż ten komunikat pomocy i zakończ pracę. |
--output -o | Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json. |
--zapytanie | Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów. |
--gadatliwy | Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania. |
przekazywanie aplikacji sfctl
Skopiuj pakiet aplikacji usługi Service Fabric do magazynu obrazów.
Opcjonalnie wyświetl postęp przekazywania dla każdego pliku w pakiecie. Postęp przekazywania jest wysyłany do .stderr
Argumenty
Argument | opis |
---|---|
--path [Wymagane] | Ścieżka do lokalnego pakietu aplikacji. |
--kompresować | Dotyczy tylko pakietów aplikacji usługi Service Fabric. Utwórz nowy folder zawierający skompresowany pakiet aplikacji do lokalizacji domyślnej lub lokalizacji określonej przez parametr skompresowanej lokalizacji, a następnie przekaż nowo utworzony folder. Jeśli istnieje już skompresowany plik wygenerowany przez bibliotekę sfctl, zostanie zastąpiony, jeśli ta flaga jest ustawiona. Jeśli katalog nie jest pakietem aplikacji, zostanie zwrócony błąd. Jeśli jest to już skompresowany pakiet aplikacji, folder zostanie skopiowany w taki sposób, jak to jest. Domyślnie nowo utworzony skompresowany pakiet aplikacji zostanie usunięty po pomyślnym przekazaniu. Jeśli przekazywanie nie powiedzie się, ręcznie wyczyść skompresowany pakiet zgodnie z potrzebami. Usunięcie nie powoduje usunięcia żadnych pustych dirs, które mogły zostać utworzone, jeśli skompresowany parametr lokalizacji odwołuje się do katalogów nieistniejących. |
--compressed-location | Lokalizacja umieszczania skompresowanego pakietu aplikacji. Jeśli nie zostanie podana żadna lokalizacja, skompresowany pakiet zostanie umieszczony w nowo utworzonym folderze o nazwie sfctl_compressed_temp w katalogu nadrzędnym określonym w argumencie ścieżki. Jeśli na przykład argument ścieżki ma wartość C:/FolderA/AppPkg, skompresowany pakiet zostanie dodany do folderu C:/FolderA/sfctl_compressed_temp/AppPkg. |
--imagestore-string | Docelowy magazyn obrazów do przekazania pakietu aplikacji. Ustawienie domyślne: fabric:ImageStore. Aby przekazać dane do lokalizacji pliku, uruchom ten parametr za pomocą polecenia "file:". W przeciwnym razie wartość powinna być magazynem obrazów parametry połączenia, na przykład wartością domyślną. |
--keep-compressed | Czy zachować wygenerowany skompresowany pakiet po pomyślnym zakończeniu przekazywania. Jeśli nie zostanie ustawiona, po pomyślnym zakończeniu skompresowane pakiety aplikacji zostaną usunięte. Jeśli przekazywanie nie powiodło się, pakiet aplikacji będzie zawsze przechowywany w katalogu wyjściowym na potrzeby ponownego przekazywania. |
--show-progress | Pokaż postęp przekazywania plików dla dużych pakietów. |
--timeout -t | Łączny limit czasu w sekundach. Przekazywanie zakończy się niepowodzeniem i zwróci błąd po upływie limitu czasu przekazywania. Ten limit czasu dotyczy całego pakietu aplikacji, a limity czasu poszczególnych plików będą równe pozostałemu limitowi czasu. Limit czasu nie obejmuje czasu wymaganego do skompresowania pakietu aplikacji. Wartość domyślna: 300. |
Argumenty globalne
Argument | opis |
---|---|
--debugować | Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. |
--help -h | Pokaż ten komunikat pomocy i zakończ pracę. |
--output -o | Format danych wyjściowych. Dozwolone wartości: json, jsonc, table, tsv. Ustawienie domyślne: json. |
--zapytanie | Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów. |
--gadatliwy | Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania. |
Następne kroki
- Skonfiguruj interfejs wiersza polecenia usługi Service Fabric.
- Dowiedz się, jak używać interfejsu wiersza polecenia usługi Service Fabric przy użyciu przykładowych skryptów.