Partager via

Register-ServiceFabricApplicationType

  • Référence
Module:
ServiceFabric

Enregistre un type d’application Service Fabric.

Syntax

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

Description

L’applet de commande Register-ServiceFabricApplicationType inscrit un type d’application Service Fabric. En savoir plus sur le déploiement d’applications Service Fabric.

Le package d’application peut exister dans un emplacement relatif dans le magasin d’images ou être un sfpkg fichier précédemment chargé vers un emplacement externe.

Lorsque vous utilisez le chemin relatif du magasin, le package d’application doit exister dans le magasin d’images. Le package peut être copié dans le magasin d’images avec Copy-ServiceFabricApplicationPackage.

Lors de l’utilisation d’un sfpkg fichier à partir d’un magasin externe, l’approvisionnement doit fournir l’URI de téléchargement à l’emplacement où le sfpkg fichier a été précédemment chargé, ainsi que les informations de type d’application. sfpkg est un fichier zip qui contient le package d’application initial avec l’extension « .sfpkg ». Dans le fichier zip, le package d’application peut être compressé ou non compressé. La compression du package d’application à l’intérieur du fichier zip est effectuée au niveau du code, du package et des packages de données.

Pour créer un sfpkgdossier, commencez par un dossier qui contient le package d’application d’origine. Si nécessaire, compressez le package avec Copy-ServiceFabricApplicationPackage avec les commutateurs -CompressPackage et -SkipCopy. Ensuite, utilisez un utilitaire pour compresser le dossier avec l’extension « .sfpkg ». Par exemple, utilisez ZipFile.CreateFromDirectory dans le dossier du package d’application.

Après avoir inscrit un type d’application, vous pouvez utiliser l’applet de commande New-ServiceFabricApplication pour créer une instance d’application. Utilisez l’applet de commande Start-ServiceFabricApplicationUpgrade pour mettre à niveau une application existante.

Lorsque le type d’application avec la version spécifiée n’est plus nécessaire, vous pouvez l’annuler à l’aide de l’applet de commande Unregister-ServiceFabricApplicationType .

Pour gérer les clusters Service Fabric, démarrez Windows PowerShell à l’aide de l’option Exécuter en tant qu’administrateur. Avant d’effectuer une opération sur un cluster Service Fabric, établissez une connexion au cluster à l’aide de l’applet de commande Connect-ServiceFabricCluster .

Exemples

Exemple 1 : Inscrire un type d’application avec le chemin relatif du magasin d’images

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

Copy-ServiceFabricApplicationPackage copie le package d’application trouvé dans le dossier « c:\work\PersistentToDoListService » dans le magasin d’images. Le package est copié sur le chemin relatif « PersistentToDoListService » dans le magasin d’images.

La commande Register-ServiceFabricApplicationType inscrit le type d’application trouvé dans le chemin d’accès relatif « PersistentToDoListService ».

Exemple 2 : Inscrire un type d’application avec le chemin d’accès relatif au magasin d’images 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 copie le package d’application trouvé dans le dossier « c:\work\PersistentToDoListService » dans le magasin d’images. Le package d’application est copié sur le chemin relatif « PersistentToDoListService » dans le magasin d’images. L’applet de commande utilise la compression pour réduire la taille du package.

La commande Register-ServiceFabricApplicationType inscrit le type d’application trouvé dans le chemin d’accès relatif « PersistentToDoListService ». L’inscription est effectuée asynchrone et elle est retournée dès que la commande est acceptée par le cluster.

Get-ServiceFabricApplicationType obtient les types d’applications inscrits dans le cluster. Chaque type d’application inclut l’état de l’inscription. L’applet de commande peut être utilisée pour déterminer à quel moment l’inscription est terminée.

Exemple 3 : Inscrire un type d’application pour un package d’application volumineux avec le chemin relatif du magasin d’images

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 copie le package d’application trouvé dans le dossier « c:\work\PersistentToDoListService » dans le magasin d’images, à l’emplacement relatif du magasin d’images « PersistentToDoListService ». Étant donné que le package initial est très volumineux, la commande la compresse et inclut un délai d’expiration plus élevé pour permettre suffisamment de temps pour la copie.

La commande Register-ServiceFabricApplicationType inscrit le type d’application trouvé dans le chemin d’accès relatif « PersistentToDoListService ». La commande inclut un délai d’expiration plus élevé pour permettre la fin du travail même si le package d’application est volumineux.

Exemple 4 : Inscrire un type d’application à partir d’un magasin externe

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

Inscrit le package d’application trouvé à l’URI spécifié. Le package d’application doit avoir été précédemment chargé à cet emplacement et doit autoriser l’accès EN LECTURE. Étant donné que le package peut être volumineux, la commande spécifie un délai d’attente d’approvisionnement important.

Exemple 5 : Inscrire un type d’application à partir d’un magasin externe asynchrone

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

Inscrit le package d’application trouvé à l’URI spécifié. Le package d’application doit avoir été précédemment chargé à cet emplacement et doit autoriser l’accès EN LECTURE. Étant donné que -Async est spécifié, la commande retourne dès que le cluster l’accepte. Get-ServiceFabricApplicationType obtient les types d’application inscrits dans le cluster qui correspondent au filtre. Chaque type d’application inclut l’état de l’inscription. L’applet de commande peut être utilisée pour suivre la progression de l’inscription et déterminer à quel moment l’inscription est terminée.

Exemple 6 : Inscrire un type d’application avec le chemin relatif du magasin d’images et le nettoyage automatique des packages

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.

Paramètres

-ApplicationPackageCleanupPolicy

Détermine la stratégie de nettoyage du package d’application utilisé pour inscrire le type d’application. Si ce n’est pas le cas, les packages d’application consomment de l’espace disque et peuvent entraîner des défaillances. Ce paramètre spécifie comment gérer le package d’application après avoir correctement inscrit le type d’application (provisionnement réussi).

Lorsqu’il Automaticest défini sur , le runtime Service Fabric détermine quand effectuer le nettoyage du package d’application. L’implémentation actuelle du runtime supprime le package d’application après avoir correctement inscrit le type d’application. Si l’inscription échoue, le package d’application n’est pas supprimé du magasin d’images.

Lorsqu’il est défini Manualsur , le package d’application n’est pas supprimé du magasin d’images et les utilisateurs doivent appeler explicitement l’applet de commande Remove-ServiceFabricApplicationPackage pour la supprimer du magasin d’images.

Un cluster Service Fabric est configuré avec une stratégie de nettoyage. Pour utiliser la stratégie du cluster, spécifiez l’option Default . La configuration du cluster CleanupApplicationPackageOnProvisionSuccess sousManagement la section détermine la façon dont le nettoyage doit se produire. Si la valeur est true, les packages d’application sont automatiquement supprimés par le runtime Service Fabric après l’approvisionnement réussi. Si la valeur est false, le package d’application n’est pas supprimé du magasin d’images. La valeur par défaut de cette configuration de cluster a été définie sur false jusqu’à la version 6.4, mais il est prévu de la définir sur true pour les versions ultérieures.

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

-ApplicationPackageDownloadUri

Représente le chemin d’accès au sfpkg package d’application à partir duquel le package d’application peut être téléchargé à l’aide de protocoles HTTP ou HTTPS. Le package doit avoir été précédemment chargé dans cet emplacement externe. L’URI doit autoriser un accès en lecture pour que Service Fabric puisse télécharger le fichier. Le sfpkg fichier est un fichier zip qui contient le package d’application initial. Dans le fichier zip, le package d’application peut être compressé ou non compressé. La compression du package d’application à l’intérieur du fichier zip est effectuée au niveau du code, du package et des packages de données. Cette compression peut être obtenue à l’aide de Copy-ServiceFabricApplicationPackage avec switch -CompressPackage. Le fichier sfpkg doit avoir l’extension « .sfpkg ».

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

-ApplicationPathInImageStore

Spécifie le chemin d’accès relatif du package de type d’application dans le magasin d’images. Ce chemin d’accès a été spécifié par l’applet de commande Copy-ServiceFabricApplicationPackage lorsque le package d’application a été copié dans le magasin d’images.

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

-ApplicationTypeName

Spécifie le nom du type d’application, tel qu’il est défini dans le manifeste de l’application. Le nom du type d’application et la version du type d’application identifient de façon unique le type d’application. Cela est nécessaire lors de l’approvisionnement d’un sfpkg magasin externe.

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

-ApplicationTypeVersion

Spécifie la version du type d’application, telle qu’elle a été définie dans le manifeste de l’application. Le nom du type d’application et la version du type d’application identifient de façon unique le type d’application. Cela est nécessaire lors de l’approvisionnement d’un fichier de package d’application sfpkg à partir d’un magasin externe.

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

-Async

La commande retourne dès que la demande d’inscription est acceptée par le cluster. Utilisez la commande Get-ServiceFabricApplicationType pour interroger l’état de la demande d’inscription. L’utilisation de ce commutateur évite d’avoir à fournir des valeurs -TimeoutSec volumineuses lors de l’inscription de packages d’applications volumineux.

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

-TimeoutSec

Spécifie le délai d’expiration, en secondes, pour l’opération.

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

Entrées

None

Sorties

System.Object