Zarządzanie aplikacją usługi Azure Service Fabric przy użyciu interfejsu wiersza polecenia usługi Azure Service Fabric (sfctl)

  • Artykuł

Dowiedz się, jak tworzyć i usuwać aplikacje uruchomione w klastrze usługi Azure Service Fabric.

Wymagania wstępne

Omówienie

Aby wdrożyć nową aplikację, wykonaj następujące kroki:

  1. Przekaż pakiet aplikacji do magazynu obrazów usługi Service Fabric.
  2. Aprowizuj typ aplikacji.
  3. Usuń zawartość magazynu obrazów.
  4. Określ i utwórz aplikację.
  5. Określ i utwórz usługi.

Aby usunąć istniejącą aplikację, wykonaj następujące kroki:

  1. Usuń aplikację.
  2. Anuluj aprowizę skojarzonego typu aplikacji.

Wdrażanie nowej aplikacji

Aby wdrożyć nową aplikację, wykonaj następujące zadania:

Przekazywanie nowego pakietu aplikacji do magazynu obrazów

Przed utworzeniem aplikacji przekaż pakiet aplikacji do magazynu obrazów usługi Service Fabric.

Jeśli na przykład pakiet aplikacji znajduje się w app_package_dir katalogu, użyj następujących poleceń, aby przekazać katalog:

sfctl application upload --path ~/app_package_dir

W przypadku dużych pakietów aplikacji można określić --show-progress opcję wyświetlania postępu przekazywania.

Aprowizuj typ aplikacji

Po zakończeniu przekazywania aprowizuj aplikację. Aby aprowizować aplikację, użyj następującego polecenia:

sfctl application provision --application-type-build-path app_package_dir

Wartość parametru application-type-build-path to nazwa katalogu, w którym został przekazany pakiet aplikacji.

Usuwanie pakietu aplikacji

Zaleca się usunięcie pakietu aplikacji po pomyślnym zarejestrowaniu aplikacji. Usunięcie pakietów aplikacji z magazynu obrazów zwalnia zasoby systemowe. Przechowywanie nieużywanych pakietów aplikacji zużywa magazyn dysku i prowadzi do problemów z wydajnością aplikacji.

Aby usunąć pakiet aplikacji z magazynu obrazów, użyj następującego polecenia:

sfctl store delete --content-path app_package_dir

content-path musi być nazwą katalogu przekazanego podczas tworzenia aplikacji.

Tworzenie aplikacji na podstawie typu aplikacji

Po aprowizacji aplikacji użyj następującego polecenia, aby nazwać i utworzyć aplikację:

sfctl application create --app-name fabric:/TestApp --app-type TestAppType --app-version 1.0

app-name to nazwa, której chcesz użyć dla wystąpienia aplikacji. Dodatkowe parametry można pobrać z wcześniej zaaprowizowanego manifestu aplikacji.

Nazwa aplikacji musi zaczynać się od prefiksu fabric:/.

Tworzenie usług dla nowej aplikacji

Po utworzeniu aplikacji utwórz usługi na podstawie aplikacji. W poniższym przykładzie utworzymy nową usługę bezstanową na podstawie naszej aplikacji. Usługi, które można utworzyć na podstawie aplikacji, są definiowane w manifeście usługi w wcześniej aprowizacji pakietu aplikacji.

sfctl service create --app-id TestApp --name fabric:/TestApp/TestSvc --service-type TestServiceType \
--stateless --instance-count 1 --singleton-scheme

Weryfikowanie wdrożenia i kondycji aplikacji

Aby sprawdzić, czy wszystko jest w dobrej kondycji, użyj następujących poleceń dotyczących kondycji:

sfctl application list
sfctl service list --application-id TestApp

Aby sprawdzić, czy usługa jest w dobrej kondycji, użyj podobnych poleceń, aby pobrać kondycję usługi i aplikacji:

sfctl application health --application-id TestApp
sfctl service health --service-id TestApp/TestSvc

Usługi i aplikacje w dobrej kondycji Okmają HealthState wartość .

Usuwanie istniejącej aplikacji

Aby usunąć aplikację, wykonaj następujące zadania:

Usuwanie aplikacji

Aby usunąć aplikację, użyj następującego polecenia:

sfctl application delete --application-id TestEdApp

Anulowanie aprowizacji typu aplikacji

Po usunięciu aplikacji możesz anulować aprowizę typu aplikacji, jeśli nie jest już potrzebna. Aby cofnąć aprowizę typu aplikacji, użyj następującego polecenia:

sfctl application unprovision --application-type-name TestAppType --application-type-version 1.0

Nazwa typu i wersja typu muszą być zgodne z nazwą i wersją w manifeście aplikacji, która została wcześniej aprowizowana.

Uaktualnianie aplikacji

Po utworzeniu aplikacji możesz powtórzyć ten sam zestaw kroków, aby aprowizować drugą wersję aplikacji. Następnie przy uaktualnieniu aplikacji usługi Service Fabric można przejść do uruchamiania drugiej wersji aplikacji. Aby uzyskać więcej informacji, zobacz dokumentację dotyczącą uaktualnień aplikacji usługi Service Fabric.

Aby przeprowadzić uaktualnienie, najpierw zaaprowizuj następną wersję aplikacji przy użyciu tych samych poleceń co poprzednio:

sfctl application upload --path ~/app_package_dir_2
sfctl application provision --application-type-build-path app_package_dir_2
sfctl store delete --content-path app_package_dir_2

Zaleca się następnie przeprowadzenie monitorowanego uaktualnienia automatycznego, uruchomienie uaktualnienia przez uruchomienie następującego polecenia:

sfctl application upgrade --app-id TestApp --app-version 2.0.0 --parameters "{\"test\":\"value\"}" --mode Monitored

Uaktualnienia zastępują istniejące parametry przy użyciu dowolnego określonego zestawu. W razie potrzeby parametry aplikacji powinny być przekazywane jako argumenty do polecenia uaktualniania. Parametry aplikacji powinny być kodowane jako obiekt JSON.

Aby pobrać wszystkie wcześniej określone parametry, możesz użyć sfctl application info polecenia .

Gdy uaktualnienie aplikacji jest w toku, stan można pobrać przy użyciu sfctl application upgrade-status polecenia .

Na koniec, jeśli uaktualnienie jest w toku i należy je anulować, możesz użyć polecenia sfctl application upgrade-rollback , aby wycofać uaktualnienie.

Następne kroki