Zarządzanie aplikacją usługi Azure Service Fabric przy użyciu interfejsu wiersza polecenia usługi Azure Service Fabric (sfctl)
Dowiedz się, jak tworzyć i usuwać aplikacje uruchomione w klastrze usługi Azure Service Fabric.
Wymagania wstępne
Zainstaluj interfejs wiersza polecenia usługi Service Fabric. Następnie wybierz klaster usługi Service Fabric. Aby uzyskać więcej informacji, zobacz Wprowadzenie do interfejsu wiersza polecenia usługi Service Fabric.
Przygotuj pakiet aplikacji usługi Service Fabric do wdrożenia. Aby uzyskać więcej informacji na temat tworzenia i tworzenia pakietu aplikacji, przeczytaj o modelu aplikacji usługi Service Fabric.
Omówienie
Aby wdrożyć nową aplikację, wykonaj następujące kroki:
- Przekaż pakiet aplikacji do magazynu obrazów usługi Service Fabric.
- Aprowizuj typ aplikacji.
- Usuń zawartość magazynu obrazów.
- Określ i utwórz aplikację.
- Określ i utwórz usługi.
Aby usunąć istniejącą aplikację, wykonaj następujące kroki:
- Usuń aplikację.
- Anulowanie aprowizacji 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 przekazano pakiet aplikacji.
Usuwanie pakietu aplikacji
Zaleca się usunięcie pakietu aplikacji po pomyślnym zarejestrowaniu aplikacji. Usuwanie 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ń 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ę zarówno usługi, jak 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 wcześniej aprowizacji manifestu aplikacji.
Uaktualnianie aplikacji
Po utworzeniu aplikacji możesz powtórzyć ten sam zestaw kroków, aby aprowizować drugą wersję aplikacji. Następnie z uaktualnieniem aplikacji usługi Service Fabric można przejść do uruchomienia 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ę przeprowadzenie monitorowanego automatycznego uaktualniania, 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 z określonym zestawem. 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 musi zostać anulowane, możesz użyć polecenia sfctl application upgrade-rollback , aby wycofać uaktualnienie.