Register-ServiceFabricApplicationType

Referenz

Modul:: ServiceFabric

Registriert einen Service Fabric-Anwendungstyp.

Syntax

Register-ServiceFabricApplicationType
        [-ApplicationPathInImageStore] <String>
        [-ApplicationPackageCleanupPolicy <ApplicationPackageCleanupPolicy>]
        [-Async]
        [-TimeoutSec <Int32>]
        [<CommonParameters>]

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

Beschreibung

Das Cmdlet Register-ServiceFabricApplicationType registriert einen Service Fabric-Anwendungstyp. Weitere Informationen zur Bereitstellung von Service Fabric-Anwendungen.

Das Anwendungspaket kann an einem relativen Speicherort im Bildspeicher vorhanden sein oder eine sfpkg datei sein, die zuvor an einen externen Speicherort hochgeladen wurde.

Bei Verwendung des relativen Speicherpfads muss das Anwendungspaket im Imagespeicher vorhanden sein. Das Paket kann mit Copy-ServiceFabricApplicationPackage in den Bildspeicher kopiert werden.

Wenn Sie eine sfpkg Datei aus einem externen Speicher verwenden, muss die Bereitstellung den Download-URI bereitstellen, an den die sfpkg zuvor hochgeladene Datei sowie die Anwendungstypinformationen übermittelt wurden. Die sfpkg-Datei ist eine ZIP-Datei, die das ursprüngliche Anwendungspaket enthält und die Erweiterung „.sfpkg“ aufweist. Das Anwendungspaket innerhalb der ZIP-Datei kann komprimiert oder unkomprimiert sein. Die Komprimierung des Anwendungspakets innerhalb der Zip-Datei erfolgt unter Code, Paket und Datenpaketen.

Zum Erstellen eines sfpkg, beginnen Sie mit einem Ordner, der das ursprüngliche Anwendungspaket enthält. Komprimieren Sie das Paket bei Bedarf mit Copy-ServiceFabricApplicationPackage mit Schaltern -CompressPackage und -SkipCopy. Verwenden Sie dann ein Hilfsprogramm, um den Ordner mit der Erweiterung ".sfpkg" zu zippen. Verwenden Sie beispielsweise ZipFile.CreateFromDirectory im Anwendungspaketordner.

Nachdem Sie einen Anwendungstyp registriert haben, können Sie das Cmdlet New-ServiceFabricApplication verwenden, um eine Anwendungsinstanz zu erstellen. Verwenden Sie das Cmdlet "Start-ServiceFabricApplicationUpgrade" , um eine vorhandene Anwendung zu aktualisieren.

Wenn der Anwendungstyp mit der angegebenen Version nicht mehr benötigt wird, können Sie die Registrierung mit dem Cmdlet "Unregister-ServiceFabricApplicationType " aufheben.

Um Service Fabric-Cluster zu verwalten, starten Sie Windows PowerShell mithilfe der Option "Als Administrator ausführen". Bevor Sie einen Vorgang in einem Service Fabric-Cluster ausführen, stellen Sie mithilfe des Cmdlets Connect-ServiceFabricCluster eine Verbindung mit dem Cluster her.

Beispiele

Beispiel 1: Registrieren eines Anwendungstyps mit relativem Bildspeicherpfad

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

Copy-ServiceFabricApplicationPackage kopiert das Anwendungspaket im Ordner "c:\work\PersistentToDoListService" in den Bildspeicher. Das Paket wird im relativen Pfad "PersistentToDoListService" im Bildspeicher kopiert.

Register-ServiceFabricApplicationType-Befehl registriert den Anwendungstyp im relativen Pfad "PersistentToDoListService".

Beispiel 2: Registrieren eines Anwendungstyps mit dem relativen Imagespeicher-relativen Pfad async

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 kopiert das Anwendungspaket im Ordner "c:\work\PersistentToDoListService" in den Bildspeicher. Das Anwendungspaket wird im relativen Pfad "PersistentToDoListService" im Imagespeicher kopiert. Das Cmdlet verwendet komprimierung, um die Paketgröße zu verringern.

Register-ServiceFabricApplicationType-Befehl registriert den Anwendungstyp im relativen Pfad "PersistentToDoListService". Die Registrierung erfolgt asynchron, und es wird zurückgegeben, sobald der Befehl vom Cluster akzeptiert wird.

Get-ServiceFabricApplicationType ruft die im Cluster registrierten Anwendungstypen ab. Jeder Anwendungstyp enthält den Registrierungsstatus. Das Cmdlet kann verwendet werden, um zu bestimmen, wann die Registrierung abgeschlossen ist.

Beispiel 3: Registrieren eines Anwendungstyps für ein großes Anwendungspaket mit relativem Imagespeicherpfad

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 kopiert das Anwendungspaket, das im Ordner "c:\work\PersistentToDoListService" im Imagespeicher gefunden wurde, am relativen Speicherort des Imagespeichers "PersistentToDoListService". Da das anfängliche Paket sehr groß ist, komprimiert der Befehl es und enthält ein höheres Timeout, um genügend Zeit für die Kopie zu ermöglichen.

Register-ServiceFabricApplicationType-Befehl registriert den Anwendungstyp im relativen Pfad "PersistentToDoListService". Der Befehl enthält ein höheres Timeout, damit die Arbeit abgeschlossen werden kann, auch wenn das Anwendungspaket groß ist.

Beispiel 4: Registrieren eines Anwendungstyps aus einem externen Speicher

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

Beispiel 5: Registrieren eines Anwendungstyps aus einem externen Speicher asynchron

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

Registriert das Anwendungspaket, das im angegebenen URI gefunden wurde. Das Anwendungspaket muss zuvor an diesem Speicherort hochgeladen worden sein und lesezugriff zulassen. Da "-Async" angegeben ist, wird der Befehl zurückgegeben, sobald der Cluster ihn akzeptiert. Get-ServiceFabricApplicationType ruft die im Cluster registrierten Anwendungstypen ab, die dem Filter entsprechen. Jeder Anwendungstyp enthält den Registrierungsstatus. Das Cmdlet kann verwendet werden, um dem Registrierungsfortschritt zu folgen und zu bestimmen, wann die Registrierung abgeschlossen ist.

Beispiel 6: Registrieren eines Anwendungstyps mit relativem Imagespeicherpfad und automatischer Paketbereinigung

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.

Parameter

-ApplicationPackageCleanupPolicy

Bestimmt die Bereinigungsrichtlinie des Anwendungspakets, das zum Registrieren des Anwendungstyps verwendet wird. Wenn sie nicht bereinigt werden, verbrauchen die Anwendungspakete Speicherplatz und können zu Fehlern führen. Dieser Parameter gibt an, wie das Anwendungspaket nach der erfolgreichen Registrierung des Anwendungstyps (erfolgreiche Bereitstellung) verwaltet wird.

Wenn dieser Wert auf Automatic"Service Fabric" festgelegt ist, wird bestimmt, wann die Bereinigung des Anwendungspakets ausgeführt werden soll. Die aktuelle Laufzeitimplementierung löscht das Anwendungspaket nach der erfolgreichen Registrierung des Anwendungstyps. Wenn die Registrierung fehlschlägt, wird das Anwendungspaket nicht aus dem Imagespeicher gelöscht.

Wenn sie festgelegt Manualist, wird das Anwendungspaket nicht aus dem Imagespeicher gelöscht, und die Benutzer müssen das Cmdlet Remove-ServiceFabricApplicationPackage explizit aufrufen, um es aus dem Imagespeicher zu entfernen.

Ein Service Fabric-Cluster ist mit einer Bereinigungsrichtlinie konfiguriert. Um die Richtlinie des Clusters zu verwenden, geben Sie die Option an Default . Die Clusterkonfiguration CleanupApplicationPackageOnProvisionSuccess unter Management Abschnitt bestimmt, wie die Bereinigung erfolgen soll. Wenn dieser Wert auf "true" festgelegt ist, werden die Anwendungspakete nach erfolgreicher Bereitstellung automatisch von der Dienst fabric-Laufzeit gelöscht. Wenn "false" festgelegt ist, wird das Anwendungspaket nicht aus dem Bildspeicher gelöscht. Der Standardwert dieser Clusterkonfiguration wurde auf "false" bis v6.4 festgelegt, aber für zukünftige Versionen gibt es Pläne, ihn auf "true" festzulegen.

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

-ApplicationPackageDownloadUri

Stellt den Pfad zum sfpkg Anwendungspaket dar, aus dem das Anwendungspaket mithilfe von HTTP- oder HTTPS-Protokollen heruntergeladen werden kann. Das Paket muss zuvor an diesen externen Speicherort hochgeladen worden sein. Der URI muss Lesezugriffe zulassen, damit die Datei von Service Fabric heruntergeladen werden kann. Die sfpkg Datei ist eine ZIP-Datei, die das ursprüngliche Anwendungspaket enthält. Das Anwendungspaket innerhalb der ZIP-Datei kann komprimiert oder unkomprimiert sein. Die Komprimierung des Anwendungspakets innerhalb der Zip-Datei erfolgt unter Code, Paket und Datenpaketen. Diese Komprimierung kann mithilfe von Copy-ServiceFabricApplicationPackage mit switch -CompressPackage erreicht werden. Die sfpkg-Datei muss die Erweiterung „.sfpkg“ aufweisen.

Type:	Uri
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationPathInImageStore

Gibt den relativen Pfad des Anwendungstyppakets im Imagespeicher an. Dieser Pfad wurde vom Cmdlet Copy-ServiceFabricApplicationPackage angegeben, als das Anwendungspaket in den Imagespeicher kopiert wurde.

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

-ApplicationTypeName

Gibt den Anwendungstypnamen an, wie er im Anwendungsmanifest definiert ist. Der Anwendungstypname und die Anwendungstypversion identifizieren den Anwendungstyp eindeutig. Dies ist erforderlich, wenn ein sfpkg externer Speicher bereitgestellt wird.

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

-ApplicationTypeVersion

Gibt die Anwendungstypversion an, wie sie im Anwendungsmanifest definiert wurde. Der Anwendungstypname und die Anwendungstypversion identifizieren den Anwendungstyp eindeutig. Dies ist erforderlich, wenn eine sfpkg Anwendungspaketdatei aus einem externen Speicher bereitgestellt wird.

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

-Async

Der Befehl gibt zurück, sobald die Registrierungsanforderung vom Cluster akzeptiert wird. Verwenden Sie den Befehl "Get-ServiceFabricApplicationType" , um den Status der Registrierungsanforderung abzufragen. Die Verwendung dieser Option verhindert, dass beim Registrieren großer Anwendungspakete große TimeoutSec-Werte bereitgestellt werden müssen.

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

-TimeoutSec

Gibt den Timeoutzeitraum in Sekunden für den Vorgang an.

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

Eingaben

None

Ausgaben

System.Object