Register-ServiceFabricApplicationType

  • Referência
Módulo:
ServiceFabric

Registra um tipo de aplicativo do 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

O cmdlet Register-ServiceFabricApplicationType registra um tipo de aplicativo do Service Fabric. Leia mais sobre a implantação de aplicativos do Service Fabric.

O pacote de aplicativos pode existir em um local relativo no repositório de imagens ou pode ser um sfpkg arquivo carregado anteriormente em um local externo.

Ao usar o caminho relativo do repositório, o pacote de aplicativos deve existir no repositório de imagens. O pacote pode ser copiado para o repositório de imagens com Copy-ServiceFabricApplicationPackage.

Ao usar um sfpkg arquivo de um repositório externo, o provisionamento deve fornecer o URI de download para onde o sfpkg foi carregado anteriormente, bem como as informações de tipo de aplicativo. O sfpkg é um arquivo zip que contém o pacote de aplicativos inicial e tem a extensão ".sfpkg". Dentro do zip, o pacote de aplicativos pode estar compactado ou não. A compactação do pacote de aplicativos dentro do zip é feita em pacotes de código, pacote e dados.

Para criar um sfpkg, comece com uma pasta que contém o pacote de aplicativo original. Se necessário, compacte o pacote com Copy-ServiceFabricApplicationPackage com comutadores -CompressPackage e -SkipCopy. Em seguida, use um utilitário para fechar a pasta com a extensão ".sfpkg". Por exemplo, use ZipFile.CreateFromDirectory na pasta do pacote do aplicativo.

Depois de registrar um tipo de aplicativo, você pode usar o cmdlet New-ServiceFabricApplication para criar uma instância de aplicativo. Use o cmdlet Start-ServiceFabricApplicationUpgrade para atualizar um aplicativo existente.

Quando o tipo de aplicativo com a versão especificada não for mais necessário, você poderá cancelá-lo usando o cmdlet Unregister-ServiceFabricApplicationType .

Para gerenciar clusters do Service Fabric, comece Windows PowerShell usando a opção Executar como administrador. Antes de executar qualquer operação em um cluster do Service Fabric, estabeleça uma conexão com o cluster usando o cmdlet Connect-ServiceFabricCluster .

Exemplos

Exemplo 1: Registrar um tipo de aplicativo com o caminho relativo do repositório de imagens

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 o pacote de aplicativo encontrado na pasta "c:\work\PersistentToDoListService" para o repositório de imagens. O pacote é copiado no caminho relativo "PersistentToDoListService" no repositório de imagens.

O comando Register-ServiceFabricApplicationType registra o tipo de aplicativo encontrado no caminho relativo "PersistentToDoListService".

Exemplo 2: Registrar um tipo de aplicativo com o caminho relativo do repositório de imagens assíncrono

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 o pacote de aplicativo encontrado na pasta "c:\work\PersistentToDoListService" para o repositório de imagens. O pacote do aplicativo é copiado no caminho relativo "PersistentToDoListService" no repositório de imagens. O cmdlet usa compactação para reduzir o tamanho do pacote.

O comando Register-ServiceFabricApplicationType registra o tipo de aplicativo encontrado no caminho relativo "PersistentToDoListService". O registro é feito de forma assíncrona e retorna assim que o comando é aceito pelo cluster.

Get-ServiceFabricApplicationType obtém os tipos de aplicativo registrados no cluster. Cada tipo de aplicativo inclui o status de registro. O cmdlet pode ser usado para determinar quando o registro é concluído.

Exemplo 3: registrar um tipo de aplicativo para um pacote de aplicativo grande com o caminho relativo do repositório de imagens

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 o pacote de aplicativo encontrado na pasta "c:\work\PersistentToDoListService" para o repositório de imagens, no local relativo do repositório de imagens "PersistentToDoListService". Como o pacote inicial é muito grande, o comando compacta-o e inclui um tempo limite maior para permitir tempo suficiente para copiar.

O comando Register-ServiceFabricApplicationType registra o tipo de aplicativo encontrado no caminho relativo "PersistentToDoListService". O comando inclui um tempo limite maior para permitir que o trabalho seja concluído mesmo que o pacote do aplicativo seja grande.

Exemplo 4: registrar um tipo de aplicativo de um repositório externo

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

Registra o pacote de aplicativo encontrado no URI especificado. O pacote do aplicativo deve ter sido carregado anteriormente nesse local e deve permitir o acesso DE LEITURA. Como o pacote pode ser grande, o comando especifica um tempo limite de provisionamento grande.

Exemplo 5: Registrar um tipo de aplicativo de um repositório externo assíncrono

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 o pacote de aplicativo encontrado no URI especificado. O pacote do aplicativo deve ter sido carregado anteriormente nesse local e deve permitir o acesso DE LEITURA. Como -Async é especificado, o comando retorna assim que o cluster o aceita. Get-ServiceFabricApplicationType obtém os tipos de aplicativo registrados no cluster que correspondem ao filtro. Cada tipo de aplicativo inclui o status de registro. O cmdlet pode ser usado para acompanhar o progresso do registro e determinar quando o registro é concluído.

Exemplo 6: Registrar um tipo de aplicativo com o caminho relativo do repositório de imagens e a limpeza automática do pacote

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 a política de limpeza do pacote de aplicativos usado para registrar o tipo de aplicativo. Se não estiver limpo, os pacotes de aplicativos consumirão espaço em disco e podem levar a falhas. Esse parâmetro especifica como gerenciar o pacote de aplicativos depois de registrar com êxito o tipo de aplicativo (provisionamento bem-sucedido).

Quando definido como Automatic, o runtime do Service Fabric determina quando executar a limpeza do pacote do aplicativo. A implementação atual do runtime exclui o pacote do aplicativo depois de registrar com êxito o tipo de aplicativo. Se o registro falhar, o pacote do aplicativo não será excluído do repositório de imagens.

Quando definido como Manual, o pacote de aplicativos não é excluído do repositório de imagens e os usuários precisam chamar explicitamente o cmdlet Remove-ServiceFabricApplicationPackage para removê-lo do repositório de imagens.

Um cluster do Service Fabric é configurado com uma política de limpeza. Para usar a política do cluster, especifique Default a opção. A configuração de cluster CleanupApplicationPackageOnProvisionSuccess na Management seção determina como a limpeza deve ocorrer. Se definido como true, os pacotes de aplicativos serão excluídos automaticamente pelo runtime da malha de serviço após o provisionamento bem-sucedido. Se definido como false, o pacote do aplicativo não será excluído do repositório de imagens. O valor padrão dessa configuração de cluster foi definido como false até v6.4, mas há planos para defini-lo como true para versões futuras.

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 o caminho para o sfpkg pacote de aplicativos de onde o pacote de aplicativos pode ser baixado usando protocolos HTTP ou HTTPS. O pacote deve ter sido carregado anteriormente para esse local externo. O URI deve permitir o acesso de leitura para que o Service Fabric possa fazer o download do arquivo. O sfpkg arquivo é um zip que contém o pacote inicial do aplicativo. Dentro do zip, o pacote de aplicativos pode estar compactado ou não. A compactação do pacote de aplicativos dentro do zip é feita em pacotes de código, pacote e dados. Essa compactação pode ser obtida usando Copy-ServiceFabricApplicationPackage com switch -CompressPackage. O arquivo sfpkg deve ter a extensão ".sfpkg".

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

-ApplicationPathInImageStore

Especifica o caminho relativo do pacote de tipo de aplicativo no repositório de imagens. Esse caminho foi especificado pelo cmdlet Copy-ServiceFabricApplicationPackage quando o pacote do aplicativo foi copiado para o repositório de imagens.

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

-ApplicationTypeName

Especifica o nome do tipo de aplicativo, pois ele é definido no manifesto do aplicativo. O nome do tipo de aplicativo e a versão do tipo de aplicativo identificam exclusivamente o tipo de aplicativo. Isso é necessário ao provisionar um sfpkg de um repositório externo.

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

-ApplicationTypeVersion

Especifica a versão do tipo de aplicativo, como foi definida no manifesto do aplicativo. O nome do tipo de aplicativo e a versão do tipo de aplicativo identificam exclusivamente o tipo de aplicativo. Isso é necessário ao provisionar um sfpkg arquivo de pacote de aplicativo de um repositório externo.

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

-Async

O comando retorna assim que a solicitação de registro é aceita pelo cluster. Use o comando Get-ServiceFabricApplicationType para consultar o status da solicitação de registro. Usar essa opção evita a necessidade de fornecer valores grandes -TimeoutSec ao registrar pacotes de aplicativos grandes.

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

-TimeoutSec

Especifica o período de tempo limite, em segundos, para a operação.

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

Entradas

None

Saídas

System.Object