Partager via

Register-ServiceFabricApplicationType

  • Référence
Module:
ServiceFabric

Inscrit un type d’application Service Fabric.

Syntaxe

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 déploiement d’applications Service Fabric.

Le package d’application peut exister à un emplacement relatif dans le magasin d’images ou être un fichier sfpkg 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 fichier sfpkg à partir d’un magasin externe, l’approvisionnement doit fournir l’URI de téléchargement vers lequel le sfpkg a été précédemment chargé, ainsi que les informations de type d’application. Le fichier sfpkg est un fichier zip qui contient le package d’application initial et a l’extension . sfpkg ». À l’intérieur du fichier zip, le package d’application peut être compressé ou décompressé. La compression du package d’application à l’intérieur du zip est effectuée au niveau du code, du package et des packages de données.

Pour créer un sfpkg, commencez par un dossier qui contient le package d’application d’origine. Si nécessaire, compressez le package avec Copy-ServiceFabricApplicationPackage avec des 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 la cmdlet 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 le désinscrire à l’aide de '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.

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

Exemple 2 : Inscrire un type d’application avec le chemin d’accès relatif du 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.

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

Get-ServiceFabricApplicationType obtient les types d’application inscrits dans le cluster. Chaque type d’application inclut l’état d’inscription. L’applet de commande peut être utilisée pour déterminer quand 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.

commande Register-ServiceFabricApplicationType inscrit le type d’application trouvé dans le chemin 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 READ. É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 READ. É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 d’inscription. L’applet de commande peut être utilisée pour suivre la progression de l’inscription et déterminer quand 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. S’ils ne sont pas nettoyés, 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 est défini sur Automatic, 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 sur Manual, le package d’application n’est pas supprimé du magasin d’images et les utilisateurs doivent appeler explicitement Cmdlet Remove-ServiceFabricApplicationPackage pour le 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 Default option. La configuration du cluster CleanupApplicationPackageOnProvisionSuccess sous Management 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 futures versions.

Type:ApplicationPackageCleanupPolicy
Valeurs acceptées:Invalid, Default, Automatic, Manual
Position:Named
Valeur par défaut:Default
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ApplicationPackageDownloadUri

Représente le chemin d’accès au package d’application sfpkg à 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é vers cet emplacement externe. L’URI doit autoriser l’accès READ afin que Service Fabric puisse télécharger le fichier. Le fichier sfpkg est un fichier zip qui contient le package d’application initial. À l’intérieur du fichier zip, le package d’application peut être compressé ou décompressé. La compression du package d’application à l’intérieur du 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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ApplicationPathInImageStore

Spécifie le chemin 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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 de type d’application identifient de façon unique le type d’application. Cela est nécessaire lors de l’approvisionnement d’un sfpkg à partir d’un magasin externe.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 de 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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 de -TimeoutSec volumineuses lors de l’inscription de packages d’applications volumineux.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TimeoutSec

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

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

System.Object