Compartir a través de

Register-ServiceFabricApplicationType

  • Referencia
Módulo:
ServiceFabric

Registra un tipo de aplicación de Service Fabric.

Sintaxis

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 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 archivo sfpkg cargado previamente en una ubicación externa.

Al usar 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.

Al usar un archivo sfpkg desde un almacén externo, el aprovisionamiento debe proporcionar el URI de descarga al lugar donde se cargó anteriormente el sfpkg, 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". Dentro del archivo ZIP, el paquete de aplicación se puede comprimir o descomprimir. 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 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.

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.

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 devuelve tan pronto como el clúster acepte 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.

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 READ. 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 READ. 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 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 usado 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 en tiempo de ejecución actual 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 en Manual, el paquete de aplicación no se elimina del almacén de imágenes y los usuarios tienen que llamar explícitamente a 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 opción. La configuración del clúster CleanupApplicationPackageOnProvisionSuccess en Management 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 la versión 6.4, pero hay planes para establecerlo en true para futuras versiones.

Tipo:ApplicationPackageCleanupPolicy
Valores aceptados:Invalid, Default, Automatic, Manual
Posición:Named
Valor predeterminado:Default
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ApplicationPackageDownloadUri

Representa la ruta de acceso al paquete de aplicación de sfpkg desde donde se puede descargar el paquete de aplicación mediante protocolos HTTP o HTTPS. El paquete debe haberse cargado previamente en esta ubicación externa. El URI debe permitir el acceso READ para que Service Fabric pueda descargar el archivo. El archivo sfpkg es un archivo ZIP que contiene el paquete de aplicación inicial. Dentro del archivo ZIP, el paquete de aplicación se puede comprimir o descomprimir. 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".

Tipo:Uri
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 especifica esta ruta de acceso cuando el paquete de aplicación se copió en el almacén de imágenes.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 archivo de paquete de aplicación sfpkg desde un almacén externo.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 aplicaciones grandes.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TimeoutSec

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

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

System.Object