Register-ServiceFabricApplicationType

  • Referencia
Módulo:
ServiceFabric

Registra un tipo de aplicación de 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

El cmdlet Register-ServiceFabricApplicationType registra un tipo de aplicación de Service Fabric. Obtenga más información sobre la implementación de aplicaciones de Service Fabric.

El paquete de aplicación puede existir en una ubicación relativa en el almacén de imágenes o puede ser un sfpkg archivo cargado previamente en una ubicación externa.

Cuando se usa la ruta de acceso relativa del almacén, el paquete de aplicación debe existir en el almacén de imágenes. El paquete se puede copiar en el almacén de imágenes con Copy-ServiceFabricApplicationPackage.

Cuando se usa un sfpkg archivo de un almacén externo, el aprovisionamiento debe proporcionar el URI de descarga en el que sfpkg se cargó anteriormente, así como la información de tipo de aplicación. El archivo sfpkg es un archivo ZIP que contiene el paquete de aplicación inicial y tiene la extensión ".sfpkg". En el archivo ZIP, el paquete de aplicación puede estar comprimido o no. La compresión del paquete de aplicación dentro del archivo ZIP se realiza en el código, el paquete y los paquetes de datos.

Para crear un sfpkg, comience con una carpeta que contenga el paquete de aplicación original. Si es necesario, comprima el paquete con Copy-ServiceFabricApplicationPackage con modificadores -CompressPackage y -SkipCopy. A continuación, use una utilidad para comprimir la carpeta con la extensión ".sfpkg". Por ejemplo, use ZipFile.CreateFromDirectory en la carpeta del paquete de aplicación.

Después de registrar un tipo de aplicación, puede usar el cmdlet New-ServiceFabricApplication para crear una instancia de aplicación. Use el cmdlet Start-ServiceFabricApplicationUpgrade para actualizar una aplicación existente.

Cuando el tipo de aplicación con la versión especificada ya no es necesario, puede anular el registro mediante el cmdlet Unregister-ServiceFabricApplicationType .

Para administrar clústeres de Service Fabric, inicie Windows PowerShell mediante la opción Ejecutar como administrador. Antes de realizar cualquier operación en un clúster de Service Fabric, establezca una conexión con el clúster mediante el cmdlet Connect-ServiceFabricCluster .

Ejemplos

Ejemplo 1: Registro de un tipo de aplicación con la ruta de acceso relativa del almacén de imágenes

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

Copy-ServiceFabricApplicationPackage copia el paquete de aplicación que se encuentra en la carpeta "c:\work\PersistentToDoListService" en el almacén de imágenes. El paquete se copia en la ruta de acceso relativa "PersistentToDoListService" en el almacén de imágenes.

El comando Register-ServiceFabricApplicationType registra el tipo de aplicación que se encuentra en la ruta de acceso relativa "PersistentToDoListService".

Ejemplo 2: Registro de un tipo de aplicación con la ruta de acceso relativa del almacén de imágenes asincrónica

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 copia el paquete de aplicación que se encuentra en la carpeta "c:\work\PersistentToDoListService" en el almacén de imágenes. El paquete de aplicación se copia en la ruta de acceso relativa "PersistentToDoListService" en el almacén de imágenes. El cmdlet usa la compresión para reducir el tamaño del paquete.

El comando Register-ServiceFabricApplicationType registra el tipo de aplicación que se encuentra en la ruta de acceso relativa "PersistentToDoListService". El registro se realiza de forma asincrónica y se devuelve en cuanto el clúster acepta el comando.

Get-ServiceFabricApplicationType obtiene los tipos de aplicación registrados en el clúster. Cada tipo de aplicación incluye el estado de registro. El cmdlet se puede usar para determinar cuándo se completa el registro.

Ejemplo 3: Registro de un tipo de aplicación para un paquete de aplicación grande con la ruta de acceso relativa del almacén de imágenes

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 copia el paquete de aplicación que se encuentra en la carpeta "c:\work\PersistentToDoListService" en el almacén de imágenes, en la ubicación relativa del almacén de imágenes "PersistentToDoListService". Dado que el paquete inicial es muy grande, el comando lo comprime e incluye un tiempo de espera mayor para permitir el tiempo suficiente para la copia.

El comando Register-ServiceFabricApplicationType registra el tipo de aplicación que se encuentra en la ruta de acceso relativa "PersistentToDoListService". El comando incluye un tiempo de espera mayor para permitir que el trabajo finalice incluso si el paquete de aplicación es grande.

Ejemplo 4: Registro de un tipo de aplicación desde un almacén externo

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

Registra el paquete de aplicación que se encuentra en el URI especificado. El paquete de aplicación debe haberse cargado previamente en esa ubicación y debe permitir el acceso DE LECTURA. Dado que el paquete puede ser grande, el comando especifica un tiempo de espera de aprovisionamiento grande.

Ejemplo 5: Registro de un tipo de aplicación desde un almacén externo asincrónico

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

Registra el paquete de aplicación que se encuentra en el URI especificado. El paquete de aplicación debe haberse cargado previamente en esa ubicación y debe permitir el acceso DE LECTURA. Dado que se especifica -Async, el comando devuelve tan pronto como el clúster lo acepta. Get-ServiceFabricApplicationType obtiene los tipos de aplicación registrados en el clúster que coinciden con el filtro. Cada tipo de aplicación incluye el estado de registro. El cmdlet se puede usar para seguir el progreso del registro y para determinar cuándo se completa el registro.

Ejemplo 6: Registro de un tipo de aplicación con la ruta de acceso relativa del almacén de imágenes y la limpieza automática de paquetes

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.

Parámetros

-ApplicationPackageCleanupPolicy

Determina la directiva de limpieza del paquete de aplicación que se usa para registrar el tipo de aplicación. Si no se limpia, los paquetes de aplicación consumen espacio en disco y pueden provocar errores. Este parámetro especifica cómo administrar el paquete de aplicación después de registrar correctamente el tipo de aplicación (aprovisionamiento correcto).

Cuando se establece en Automatic, el entorno de ejecución de Service Fabric determina cuándo se debe realizar la limpieza del paquete de aplicación. La implementación actual del entorno de ejecución elimina el paquete de aplicación después de registrar correctamente el tipo de aplicación. Si se produce un error en el registro, el paquete de aplicación no se elimina del almacén de imágenes.

Cuando se establece Manualen , el paquete de aplicación no se elimina del almacén de imágenes y los usuarios tienen que llamar explícitamente al cmdlet Remove-ServiceFabricApplicationPackage para quitarlo del almacén de imágenes.

Un clúster de Service Fabric se configura con una directiva de limpieza. Para usar la directiva del clúster, especifique Default la opción . La configuración del clúster CleanupApplicationPackageOnProvisionSuccess en Management la sección determina cómo debe producirse la limpieza. Si se establece en true, el tiempo de ejecución de Service Fabric elimina automáticamente los paquetes de aplicación después de aprovisionar correctamente. Si se establece en false, el paquete de aplicación no se elimina del almacén de imágenes. El valor predeterminado de esta configuración de clúster se ha establecido en false hasta v6.4, pero hay planes para establecerlo en true para futuras versiones.

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

-ApplicationPackageDownloadUri

Representa la ruta de acceso al sfpkg paquete de aplicación desde donde se puede descargar el paquete de aplicación mediante protocolos HTTP o HTTPS. Debe haber cargado el paquete previamente a esta ubicación externa. El URI debe permitir el acceso de lectura para que Service Fabric pueda descargar el archivo. El sfpkg archivo es un archivo ZIP que contiene el paquete de aplicación inicial. En el archivo ZIP, el paquete de aplicación puede estar comprimido o no. La compresión del paquete de aplicación dentro del archivo ZIP se realiza en el código, el paquete y los paquetes de datos. Esta compresión se puede lograr mediante Copy-ServiceFabricApplicationPackage con switch -CompressPackage. El archivo sfpkg debe tener la extensión ".sfpkg".

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

-ApplicationPathInImageStore

Especifica la ruta de acceso relativa del paquete de tipo de aplicación en el almacén de imágenes. El cmdlet Copy-ServiceFabricApplicationPackage especificó esta ruta de acceso cuando el paquete de aplicación se copió en el almacén de imágenes.

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

-ApplicationTypeName

Especifica el nombre del tipo de aplicación, tal como se define en el manifiesto de aplicación. El nombre del tipo de aplicación y la versión del tipo de aplicación identifican de forma única el tipo de aplicación. Esto es necesario al aprovisionar un sfpkg desde un almacén externo.

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

-ApplicationTypeVersion

Especifica la versión del tipo de aplicación, tal como se definió en el manifiesto de aplicación. El nombre del tipo de aplicación y la versión del tipo de aplicación identifican de forma única el tipo de aplicación. Esto es necesario al aprovisionar un sfpkg archivo de paquete de aplicación desde un almacén externo.

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

-Async

El comando devuelve tan pronto como el clúster acepte la solicitud de registro. Use el comando Get-ServiceFabricApplicationType para consultar el estado de la solicitud de registro. El uso de este modificador evita tener que proporcionar valores de -TimeoutSec grandes al registrar paquetes de aplicación de gran tamaño.

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

-TimeoutSec

Especifica el período de tiempo de espera, en segundos, para la operación.

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

Entradas

None

Salidas

System.Object