Udostępnij za pośrednictwem

Register-ServiceFabricApplicationType

  • Odwołanie
Moduł:
ServiceFabric

Rejestruje typ aplikacji usługi Service Fabric.

Składnia

Register-ServiceFabricApplicationType
        [-ApplicationPathInImageStore] <String>
        [-ApplicationPackageCleanupPolicy <ApplicationPackageCleanupPolicy>]
        [-Async]
        [-TimeoutSec <Int32>]
        [<CommonParameters>]
Register-ServiceFabricApplicationType
        [-ApplicationPackageDownloadUri] <Uri>
        -ApplicationTypeName <String>
        -ApplicationTypeVersion <String>
        [-Async]
        [-TimeoutSec <Int32>]
        [<CommonParameters>]

Opis

Polecenie cmdlet Register-ServiceFabricApplicationType rejestruje typ aplikacji usługi Service Fabric. Dowiedz się więcej o wdrażania aplikacji usługi Service Fabric.

Pakiet aplikacji może istnieć w lokalizacji względnej w magazynie obrazów lub może być plikiem sfpkg wcześniej przekazanym do lokalizacji zewnętrznej.

W przypadku korzystania ze ścieżki względnej magazynu pakiet aplikacji musi istnieć w magazynie obrazów. Pakiet można skopiować do magazynu obrazów za pomocą Copy-ServiceFabricApplicationPackage.

W przypadku korzystania z pliku sfpkg z magazynu zewnętrznego aprowizacja musi podać identyfikator URI pobierania, do którego sfpkg został wcześniej przekazany, a także informacje o typie aplikacji. Plik sfpkg jest plikiem zip zawierającym początkowy pakiet aplikacji i ma rozszerzenie ".sfpkg". Wewnątrz pliku zip pakiet aplikacji może być skompresowany lub nieskompresowany. Kompresja pakietu aplikacji wewnątrz pliku zip odbywa się w pakietach kodu, pakietu i danych.

Aby utworzyć sfpkg, zacznij od folderu zawierającego oryginalny pakiet aplikacji. W razie potrzeby skompresuj pakiet za pomocą Copy-ServiceFabricApplicationPackage z przełącznikami -CompressPackage i -SkipCopy. Następnie użyj narzędzia , aby spakować folder z rozszerzeniem ".sfpkg". Na przykład użyj ZipFile.CreateFromDirectory w folderze pakietu aplikacji.

Po zarejestrowaniu typu aplikacji możesz użyć polecenia cmdlet New-ServiceFabricApplication, aby utworzyć wystąpienie aplikacji. Użyj polecenia cmdlet Start-ServiceFabricApplicationUpgrade, aby uaktualnić istniejącą aplikację.

Gdy typ aplikacji z określoną wersją nie jest już potrzebny, możesz wyrejestrować go przy użyciu polecenia cmdlet Unregister-ServiceFabricApplicationType.

Aby zarządzać klastrami usługi Service Fabric, uruchom program Windows PowerShell przy użyciu opcji Uruchom jako administrator. Przed wykonaniem dowolnej operacji w klastrze usługi Service Fabric ustanów połączenie z klastrem przy użyciu polecenia cmdlet Connect-ServiceFabricCluster.

Przykłady

Przykład 1. Rejestrowanie typu aplikacji przy użyciu ścieżki względnej magazynu obrazów

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "c:\work\PersistentToDoListService" -ImageStoreConnectionString "file:C:\SfDevCluster\Data\ImageStoreShare" -ApplicationPackagePathInImageStore "PersistentToDoListService"
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListService"

Copy-ServiceFabricApplicationPackage kopiuje pakiet aplikacji znajdujący się w folderze "c:\work\PersistentToDoListService" do magazynu obrazów. Pakiet jest kopiowany w ścieżce względnej "PersistentToDoListService" w magazynie obrazów.

Register-ServiceFabricApplicationType polecenie rejestruje typ aplikacji znaleziony w ścieżce względnej "PersistentToDoListService".

Przykład 2. Rejestrowanie typu aplikacji przy użyciu ścieżki względnej magazynu obrazów asynchroniczne

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "c:\work\PersistentToDoListService" -ImageStoreConnectionString "fabric:ImageStore" -ApplicationPackagePathInImageStore "PersistentToDoListService" -CompressPackage
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListService" -Async
PS C:\> Get-ServiceFabricApplicationType

Copy-ServiceFabricApplicationPackage kopiuje pakiet aplikacji znajdujący się w folderze "c:\work\PersistentToDoListService" do magazynu obrazów. Pakiet aplikacji jest kopiowany w ścieżce względnej "PersistentToDoListService" w magazynie obrazów. Polecenie cmdlet używa kompresji, aby zmniejszyć rozmiar pakietu.

Register-ServiceFabricApplicationType polecenie rejestruje typ aplikacji znaleziony w ścieżce względnej "PersistentToDoListService". Rejestrowanie jest wykonywane asynchronizuj i jest zwracane natychmiast po zaakceptowaniu polecenia przez klaster.

Get-ServiceFabricApplicationType pobiera typy aplikacji zarejestrowanych w klastrze. Każdy typ aplikacji zawiera stan rejestracji. Za pomocą polecenia cmdlet można określić, kiedy rejestracja zostanie zakończona.

Przykład 3. Rejestrowanie typu aplikacji dla dużego pakietu aplikacji przy użyciu ścieżki względnej magazynu obrazów

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "c:\work\PersistentToDoListService" -ImageStoreConnectionString "fabric:ImageStore" -ApplicationPackagePathInImageStore "PersistentToDoListService" -CompressPackage -TimeoutSec 2700
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListService" -TimeoutSec 2700

Copy-ServiceFabricApplicationPackage kopiuje pakiet aplikacji znajdujący się w folderze "c:\work\PersistentToToDoListService" do magazynu obrazów w lokalizacji względnej magazynu obrazów "PersistentToDoListService". Ponieważ początkowy pakiet jest bardzo duży, polecenie kompresuje go i zawiera wyższy limit czasu, aby umożliwić wystarczającą ilość czasu na kopiowanie.

Register-ServiceFabricApplicationType polecenie rejestruje typ aplikacji znaleziony w ścieżce względnej "PersistentToDoListService". Polecenie zawiera wyższy limit czasu, aby umożliwić zakończenie pracy, nawet jeśli pakiet aplikacji jest duży.

Przykład 4. Rejestrowanie typu aplikacji z magazynu zewnętrznego

PS C:\> Register-ServiceFabricApplicationType -ApplicationPackageDownloadUri "https://sftestresources.blob.core.windows.net:443/sfpkgholder/MyAppPackage.sfpkg" -ApplicationTypeName MyApp -ApplicationTypeVersion V1 -TimeoutSec 2700

Rejestruje pakiet aplikacji znaleziony w określonym identyfikatorze URI. Pakiet aplikacji musi zostać wcześniej przekazany w tej lokalizacji i musi zezwalać na dostęp do odczytu. Ponieważ pakiet może być duży, polecenie określa duży limit czasu aprowizacji.

Przykład 5. Rejestrowanie typu aplikacji z asynchronicznego magazynu zewnętrznego

PS C:\> Register-ServiceFabricApplicationType -ApplicationPackageDownloadUri "https://sftestresources.blob.core.windows.net:443/sfpkgholder/MyAppPackage.sfpkg" -ApplicationTypeName MyApp -ApplicationTypeVersion V1 -Async
PS C:\> Get-ServiceFabricApplicationType -ApplicationTypeName MyApp -ApplicationTypeVersion V1

Rejestruje pakiet aplikacji znaleziony w określonym identyfikatorze URI. Pakiet aplikacji musi zostać wcześniej przekazany w tej lokalizacji i musi zezwalać na dostęp do odczytu. Ponieważ -Async jest określony, polecenie jest zwracane natychmiast po zaakceptowaniu go przez klaster. Get-ServiceFabricApplicationType pobiera typy aplikacji zarejestrowane w klastrze, który jest zgodny z filtrem. Każdy typ aplikacji zawiera stan rejestracji. Polecenie cmdlet może służyć do wykonywania postępów rejestracji i określania, kiedy rejestracja zostanie zakończona.

Przykład 6. Rejestrowanie typu aplikacji przy użyciu ścieżki względnej magazynu obrazów i automatycznego czyszczenia pakietów

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "c:\work\PersistentToDoListService"

PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListService" -ApplicationPackageCleanupPolicy Automatic

[Copy-ServiceFabricApplicationPackage](./Copy-ServiceFabricApplicationPackage.yml) copies the application package found in the "c:\work\PersistentToDoListService" folder to the image store. The package is copied at the relative path "PersistentToDoListService" in image store.

[Register-ServiceFabricApplicationType](./Register-ServiceFabricApplicationType.yml) command registers the application type found in the relative path "PersistentToDoListService" and deletes the application package "PersistentToDoListService" in the image store after successfully registering the application type. Deleting the application package from the image store after [Register-ServiceFabricApplicationType](./Register-ServiceFabricApplicationType.yml) command is recommended because it removes the temporary package as soon as it's not needed, which ensures that disk space is not consumed unnecessarily.

Parametry

-ApplicationPackageCleanupPolicy

Określa zasady oczyszczania pakietu aplikacji używanego do rejestrowania typu aplikacji. Jeśli nie zostanie wyczyszczona, pakiety aplikacji zużywają miejsce na dysku i mogą prowadzić do awarii. Ten parametr określa sposób zarządzania pakietem aplikacji po pomyślnym zarejestrowaniu typu aplikacji (pomyślne aprowizowanie).

Po ustawieniu wartości Automaticśrodowisko uruchomieniowe usługi Service Fabric określa, kiedy należy wykonać oczyszczanie pakietu aplikacji. Bieżąca implementacja środowiska uruchomieniowego usuwa pakiet aplikacji po pomyślnym zarejestrowaniu typu aplikacji. Jeśli rejestracja nie powiedzie się, pakiet aplikacji nie zostanie usunięty z magazynu obrazów.

Po ustawieniu wartości Manualpakiet aplikacji nie zostanie usunięty z magazynu obrazów, a użytkownicy muszą jawnie wywołać polecenie cmdlet Remove-ServiceFabricApplicationPackage, aby usunąć go z magazynu obrazów.

Klaster usługi Service Fabric jest skonfigurowany przy użyciu zasad czyszczenia. Aby użyć zasad klastra, określ opcję Default. Konfiguracja klastra CleanupApplicationPackageOnProvisionSuccess w sekcji Management określa sposób czyszczenia. W przypadku ustawienia wartości true pakiety aplikacji zostaną automatycznie usunięte przez środowisko uruchomieniowe usługi Service Fabric po pomyślnej aprowizacji. W przypadku ustawienia wartości false pakiet aplikacji nie zostanie usunięty z magazynu obrazów. Wartość domyślna tej konfiguracji klastra została ustawiona na wartość false do wersji 6.4, ale istnieją plany ustawienia jej wartości true dla przyszłych wersji.

Typ:ApplicationPackageCleanupPolicy
Dopuszczalne wartości:Invalid, Default, Automatic, Manual
Position:Named
Domyślna wartość:Default
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ApplicationPackageDownloadUri

Reprezentuje ścieżkę do pakietu aplikacji sfpkg, z którego można pobrać pakiet aplikacji przy użyciu protokołów HTTP lub HTTPS. Pakiet musi zostać wcześniej przekazany do tej lokalizacji zewnętrznej. Identyfikator URI musi zezwalać na dostęp do odczytu, aby usługa Service Fabric mogła pobrać plik. Plik sfpkg jest plikiem zip zawierającym początkowy pakiet aplikacji. Wewnątrz pliku zip pakiet aplikacji może być skompresowany lub nieskompresowany. Kompresja pakietu aplikacji wewnątrz pliku zip odbywa się w pakietach kodu, pakietu i danych. Tę kompresję można osiągnąć przy użyciu Copy-ServiceFabricApplicationPackage z przełącznikiem -CompressPackage. Plik sfpkg musi mieć rozszerzenie ".sfpkg".

Typ:Uri
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ApplicationPathInImageStore

Określa ścieżkę względną pakietu typu aplikacji w magazynie obrazów. Ta ścieżka została określona przez polecenie cmdlet Copy-ServiceFabricApplicationPackage podczas kopiowania pakietu aplikacji do magazynu obrazów.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ApplicationTypeName

Określa nazwę typu aplikacji, zgodnie z definicją w manifeście aplikacji. Nazwa typu aplikacji i wersja typu aplikacji jednoznacznie identyfikują typ aplikacji. Jest to konieczne w przypadku aprowizowania sfpkg z magazynu zewnętrznego.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ApplicationTypeVersion

Określa wersję typu aplikacji, zgodnie z definicją w manifeście aplikacji. Nazwa typu aplikacji i wersja typu aplikacji jednoznacznie identyfikują typ aplikacji. Jest to konieczne w przypadku aprowizowania pliku pakietu aplikacji sfpkg z magazynu zewnętrznego.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Async

Polecenie jest zwracane natychmiast po zaakceptowaniu żądania rejestracji przez klaster. Użyj polecenia Get-ServiceFabricApplicationType, aby wysłać zapytanie o stan żądania rejestracji. Użycie tego przełącznika pozwala uniknąć konieczności podawania dużych -TimeoutSec wartości podczas rejestrowania dużych pakietów aplikacji.

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TimeoutSec

Określa limit czasu dla operacji w sekundach.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

None

Dane wyjściowe

System.Object