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

O pacote do aplicativo pode existir em um local relativo no armazenamento de imagens ou pode ser um arquivo sfpkg carregado anteriormente em um local externo.

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

Ao usar um arquivo sfpkg de um armazenamento externo, a provisão 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 de aplicativo inicial e tem a extensão ".sfpkg". Dentro do zip, o pacote do aplicativo pode ser compactado ou descompactado. A compactação do pacote do aplicativo dentro do zip é feita em pacotes de código, pacote e dados.

Para criar um sfpkg, comece com uma pasta que contenha o pacote do aplicativo original. Se necessário, compacte o pacote com Copy-ServiceFabricApplicationPackage com switches -CompressPackage e -SkipCopy. Em seguida, use um utilitário para compactar 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á cancelar o registro 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 armazenamento 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 armazenamento de imagens. O pacote é copiado no caminho relativo "PersistentToDoListService" no armazenamento 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 armazenamento 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 armazenamento de imagens. O pacote do aplicativo é copiado no caminho relativo "PersistentToDoListService" no armazenamento 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 pedido inclui o estado de registo. O cmdlet pode ser usado para determinar quando o registro será concluído.

Exemplo 3: Registrar um tipo de aplicativo para um pacote de aplicativo grande com caminho relativo de armazenamento 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 armazenamento de imagens, no local relativo do armazenamento 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 mais alto para permitir que o trabalho seja concluído, mesmo que o pacote do aplicativo seja grande.

Exemplo 4: Registrar um tipo de aplicativo de uma loja externa

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 de aplicação deve ter sido previamente carregado nesse local e deve permitir o acesso READ. Como o pacote pode ser grande, o comando especifica um tempo limite de provisionamento grande.

Exemplo 5: Registrar um tipo de aplicativo de um armazenamento 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 de aplicação deve ter sido previamente carregado nesse local e deve permitir o acesso READ. 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 pedido inclui o estado de registo. O cmdlet pode ser usado para acompanhar o progresso do registro e determinar quando o registro será concluído.

Exemplo 6: Registrar um tipo de aplicativo com o caminho relativo do armazenamento 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 aplicativo usado para registrar o tipo de aplicativo. Se não forem limpos, os pacotes de aplicativos consomem espaço em disco e podem levar a falhas. Este parâmetro especifica como gerenciar o pacote do aplicativo depois de registrar com êxito o tipo de aplicativo (provisionamento bem-sucedido).

Quando definido como Automatic, o tempo de execução do Service Fabric determina quando executar a limpeza do pacote de aplicativos. A implementação de tempo de execução atual 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 armazenamento de imagens.

Quando definido como Manual, o pacote do aplicativo não é excluído do armazenamento 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 na seção Management determina como a limpeza deve ocorrer. Se definido como true, os pacotes de aplicativos são excluídos automaticamente pelo tempo de execução do service fabric após o provisionamento bem-sucedido. Se definido como false, o pacote do aplicativo não será excluído do armazenamento 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.

Tipo:ApplicationPackageCleanupPolicy
Valores aceites:Invalid, Default, Automatic, Manual
Position:Named
Default value:Default
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ApplicationPackageDownloadUri

Representa o caminho para o pacote de aplicativo sfpkg de onde o pacote de aplicativo pode ser baixado usando protocolos HTTP ou HTTPS. O pacote deve ter sido carregado anteriormente para este local externo. O URI deve permitir o acesso READ para que o Service Fabric possa baixar o arquivo. O arquivo sfpkg é um zip que contém o pacote de aplicativo inicial. Dentro do zip, o pacote do aplicativo pode ser compactado ou descompactado. A compactação do pacote do aplicativo 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
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ApplicationTypeName

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

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ApplicationTypeVersion

Especifica a versão do tipo de aplicativo, conforme foi 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 arquivo de pacote de aplicativo sfpkg de um armazenamento externo.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais: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. O uso dessa opção evita a necessidade de fornecer grandes valores de -TimeoutSec ao registrar pacotes de aplicativos grandes.

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TimeoutSec

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

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

Saídas

System.Object