Compartilhar via

Register-ServiceFabricApplicationType

  • Referência
Módulo:
ServiceFabric

Registra um tipo de aplicativo do Service Fabric.

Sintaxe

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 implantação de aplicativo do Service Fabric.

O pacote de aplicativos pode existir em um local relativo no repositório de imagens ou pode ser um arquivo sfpkg 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 arquivo sfpkg 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 arquivo sfpkg é um zip que contém o pacote inicial do aplicativo e tem a extensão ".sfpkg". Dentro do zip, o pacote do aplicativo pode ser compactado ou descompactado. 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 contenha 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 de aplicativos.

Depois de registrar um tipo de aplicativo, você pode usar o cmdlet New-ServiceFabricApplication para criar uma instância do 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 cmdlet Unregister-ServiceFabricApplicationType.

Para gerenciar clusters do Service Fabric, inicie o 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 aplicativos encontrado na pasta "c:\work\PersistentToDoListService" para o repositório de imagens. O pacote é copiado no caminho relativo "PersistentToDoListService" no repositório de imagens.

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 aplicativos 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.

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 aplicativos 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 cópia.

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 se o pacote de aplicativos for 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 aplicativos 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 aplicativos 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 estiverem limpos, os pacotes de aplicativos consumirão espaço em disco e poderão causar 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 do aplicativo não é excluído do repositório de imagens e os usuários precisam chamar explicitamente 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 opção. A configuração do cluster CleanupApplicationPackageOnProvisionSuccess em Management seção determina como a limpeza deve ocorrer. Se definido como true, os pacotes de aplicativos serão excluídos automaticamente pelo runtime do service fabric 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 verdadeiro para versões futuras.

Tipo:ApplicationPackageCleanupPolicy
Valores aceitos:Invalid, Default, Automatic, Manual
Cargo:Named
Valor padrão:Default
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ApplicationPackageDownloadUri

Representa o caminho para o pacote de aplicativos sfpkg 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 baixar o arquivo. O arquivo sfpkg é um zip que contém o pacote inicial do aplicativo. Dentro do zip, o pacote do aplicativo pode ser compactado ou descompactado. 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".

Tipo:Uri
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 de aplicativos foi copiado para o repositório de imagens.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ApplicationTypeName

Especifica o nome do tipo de aplicativo, como 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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ApplicationTypeVersion

Especifica a versão do tipo de aplicativo, como ela 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 arquivo de pacote de aplicativo sfpkg de um repositório externo.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 grandes valores de -TimeoutSec ao registrar grandes pacotes de aplicativos.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TimeoutSec

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

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

System.Object