Udostępnij za pośrednictwem


sfctl replica

Zarządzaj replikami należącymi do partycji usługi.

Polecenia

Polecenie opis
Wdrożony Pobiera szczegóły repliki wdrożonej w węźle usługi Service Fabric.
wdrożona lista Pobiera listę replik wdrożonych w węźle usługi Service Fabric.
zdrowie Pobiera kondycję stanowej repliki usługi Service Fabric lub wystąpienia usługi bezstanowej.
informacje o Pobiera informacje o repliki partycji usługi Service Fabric.
lista Pobiera informacje o replikach partycji usługi Service Fabric.
remove Usuwa replikę usługi uruchomioną w węźle.
report-health Wysyła raport kondycji repliki usługi Service Fabric.
restart Uruchamia ponownie replikę usługi utrwalonej usługi uruchomionej w węźle.

wdrożona replika sfctl

Pobiera szczegóły repliki wdrożonej w węźle usługi Service Fabric.

Pobiera szczegóły repliki wdrożonej w węźle usługi Service Fabric. Informacje obejmują rodzaj usługi, nazwę usługi, bieżącą operację usługi, bieżącą datę rozpoczęcia operacji usługi, identyfikator partycji, identyfikator repliki/wystąpienia, zgłoszone obciążenie i inne informacje.

Argumenty

Argument opis
--node-name [Wymagane] Nazwa węzła.
--partition-id [Wymagane] Tożsamość partycji.
--replica-id [Wymagane] Identyfikator repliki.
--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 replica deployed-list

Pobiera listę replik wdrożonych w węźle usługi Service Fabric.

Pobiera listę zawierającą informacje o replikach wdrożonych w węźle usługi Service Fabric. Informacje obejmują identyfikator partycji, identyfikator repliki, stan repliki, nazwę usługi, nazwę typu usługi i inne informacje. Użyj parametrów zapytania PartitionId lub ServiceManifestName, aby zwrócić informacje o wdrożonych replikach pasujących do określonych wartości dla tych parametrów.

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.
--partition-id Tożsamość partycji.
--service-manifest-name Nazwa manifestu usługi zarejestrowanego jako część typu aplikacji w klastrze usługi Service Fabric.
--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.

kondycja repliki sfctl

Pobiera kondycję stanowej repliki usługi Service Fabric lub wystąpienia usługi bezstanowej.

Pobiera kondycję repliki usługi Service Fabric. Użyj elementu EventsHealthStateFilter, aby filtrować kolekcję zdarzeń kondycji zgłoszonych na podstawie stanu kondycji repliki.

Argumenty

Argument opis
--partition-id [Wymagane] Tożsamość partycji.
--replica-id [Wymagane] Identyfikator repliki.
--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.
--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 replica info

Pobiera informacje o repliki partycji usługi Service Fabric.

Odpowiedź zawiera identyfikator, rolę, stan, kondycję, nazwę węzła, czas pracy i inne szczegóły dotyczące repliki.

Argumenty

Argument opis
--partition-id [Wymagane] Tożsamość partycji.
--replica-id [Wymagane] Identyfikator repliki.
--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 replik sfctl

Pobiera informacje o replikach partycji usługi Service Fabric.

Punkt końcowy GetReplicas zwraca informacje o replikach określonej partycji. Odpowiedź zawiera identyfikator, rolę, stan, kondycję, nazwę węzła, czas pracy i inne szczegóły dotyczące repliki.

Argumenty

Argument opis
--partition-id [Wymagane] Tożsamość partycji.
--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.
--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 replica remove

Usuwa replikę usługi uruchomioną w węźle.

Ten interfejs API symuluje błąd repliki usługi Service Fabric przez usunięcie repliki z klastra usługi Service Fabric. Usunięcie zamyka replikę, przenosi replikę do roli Brak, a następnie usuwa wszystkie informacje o stanie repliki z klastra. Ten interfejs API testuje ścieżkę usuwania stanu repliki i symuluje trwałą ścieżkę raportu za pośrednictwem interfejsów API klienta. Ostrzeżenie — w przypadku użycia tego interfejsu API nie są wykonywane żadne kontrole bezpieczeństwa. Nieprawidłowe użycie tego interfejsu API może prowadzić do utraty danych w przypadku usług stanowych. Ponadto flaga forceRemove wpływa na wszystkie inne repliki hostowane w tym samym procesie.

Argumenty

Argument opis
--node-name [Wymagane] Nazwa węzła.
--partition-id [Wymagane] Tożsamość partycji.
--replica-id [Wymagane] Identyfikator repliki.
--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.

sfctl replica report-health

Wysyła raport kondycji repliki usługi Service Fabric.

Zgłasza stan kondycji określonej repliki 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 repliki 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, uruchom polecenie pobierz kondycję repliki i sprawdź, czy raport jest wyświetlany w sekcji HealthEvents.

Argumenty

Argument opis
--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".
--partition-id [Wymagane] Tożsamość partycji.
--replica-id [Wymagane] Tożsamość partycji.
--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.
--service-kind Rodzaj repliki usługi (bezstanowej lub stanowej), dla której zgłaszana jest kondycja. Poniżej przedstawiono możliwe wartości: "Bezstanowe", "Stanowe". Ustawienie domyślne: Stanowe.
--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.

ponowne uruchomienie repliki sfctl

Uruchamia ponownie replikę usługi utrwalonej usługi uruchomionej w węźle.

Uruchamia ponownie replikę usługi utrwalonej usługi uruchomionej w węźle. Ostrzeżenie — w przypadku użycia tego interfejsu API nie są wykonywane żadne kontrole bezpieczeństwa. Nieprawidłowe użycie tego interfejsu API może prowadzić do utraty dostępności dla usług stanowych.

Argumenty

Argument opis
--node-name [Wymagane] Nazwa węzła.
--partition-id [Wymagane] Tożsamość partycji.
--replica-id [Wymagane] Identyfikator repliki.
--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.

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.