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. Przeczytaj więcej na temat 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 przekazanym sfpkg wcześniej 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ą polecenia Copy-ServiceFabricApplicationPackage.

W przypadku korzystania z sfpkg pliku 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, który zawiera 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 jest wykonywana w kodzie, pakiecie i pakietach danych.

Aby utworzyć plik sfpkg, zacznij od folderu zawierającego oryginalny pakiet aplikacji. W razie potrzeby skompresuj pakiet za pomocą polecenia 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 polecenia 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ę.

Jeśli 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 Windows PowerShell przy użyciu opcji Uruchom jako administrator. Przed wykonaniem dowolnej operacji w klastrze usługi Service Fabric nawiąż 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

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". Rejestracja jest wykonywana asynchronizuj i jest zwracana natychmiast po zaakceptowaniu polecenia przez klaster.

Polecenie Get-ServiceFabricApplicationType pobiera typy aplikacji zarejestrowane w klastrze. Każdy typ aplikacji zawiera stan rejestracji. Polecenie cmdlet może służyć do określenia, kiedy rejestracja zakończy się.

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\PersistentToDoListService" do magazynu obrazów w magazynie obrazów "PersistentToDoListService". Ponieważ początkowy pakiet jest bardzo duży, polecenie je kompresuje i zawiera większy limit czasu, aby umożliwić wystarczająco dużo czasu na kopiowanie.

Register-ServiceFabricApplicationType polecenie rejestruje typ aplikacji znaleziony w ścieżce względnej "PersistentToDoListService". Polecenie zawiera większy 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

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ż parametr -Async jest określony, polecenie jest zwracane natychmiast po zaakceptowaniu go przez klaster. Polecenie Get-ServiceFabricApplicationType pobiera typy aplikacji zarejestrowane w klastrze, które pasują do filtru. 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 wyczyszczone, pakiety aplikacji zużywają miejsce na dysku i mogą prowadzić do błędów. Ten parametr określa sposób zarządzania pakietem aplikacji po pomyślnym zarejestrowaniu typu aplikacji (pomyślne aprowizowanie).

Po ustawieniu Automaticwartości na wartość ś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 Manualwartości na wartość pakiet 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 oczyszczania. Aby użyć zasad klastra, określ Default opcję. Konfiguracja klastra CleanupApplicationPackageOnProvisionSuccess w Management sekcji 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 wartości true dla przyszłych wersji.

Type:	ApplicationPackageCleanupPolicy
Accepted values:	Invalid, Default, Automatic, Manual
Position:	Named
Default value:	Default
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationPackageDownloadUri

Reprezentuje ścieżkę do sfpkg pakietu aplikacji, 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 jest wykonywana w kodzie, pakiecie i pakietach danych. Tę kompresję można osiągnąć przy użyciu polecenia Copy-ServiceFabricApplicationPackage z przełącznikiem -CompressPackage. Plik sfpkg musi mieć rozszerzenie ".sfpkg".

Type:	Uri
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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 obiektu sfpkg z magazynu zewnętrznego.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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 sfpkg pliku pakietu aplikacji z magazynu zewnętrznego.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Async

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

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeoutSec

Określa limit czasu dla operacji w sekundach.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Dane wejściowe

None

Dane wyjściowe

System.Object