Register-ServiceFabricApplicationType

  • Referência
Módulo:
ServiceFabric

Regista um tipo de aplicação de Tecido de Serviço.

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 Registo-ServiçoFabricApplicationType cmdlet regista um tipo de aplicação de Tecido de Serviço. Leia mais sobre a implementação da aplicação de Service Fabric.

O pacote de aplicações pode existir numa localização relativa na loja de imagens ou pode ser um sfpkg ficheiro previamente enviado para uma localização externa.

Ao utilizar o caminho relativo da loja, o pacote de aplicações deve existir na loja de imagens. O pacote pode ser copiado para a loja de imagens com Copy-ServiceFabricApplicationPackage.

Ao utilizar um sfpkg ficheiro a partir de uma loja externa, a disposição deve fornecer o download URI para onde o sfpkg foi previamente carregado, bem como as informações do tipo de aplicação. O sfpkg ficheiro é um zip que contém o pacote inicial de aplicação e tem a extensão ".sfpkg". Dentro do fecho, a embalagem de aplicação pode ser comprimida ou descomprimida. A compressão do pacote de aplicações dentro do fecho é feita em pacotes de código, pacote e dados.

Para criar uma sfpkgpasta que contenha o pacote de aplicações original. Se necessário, comprima o pacote com Copy-ServiceFabricApplicationPackage com interruptores -CompressPackage e -SkipCopy. Em seguida, utilize um utilitário para fechar a pasta com a extensão ".sfpkg". Por exemplo, utilize ZipFile.CreateFromDirect na pasta do pacote de aplicações.

Depois de registar um tipo de aplicação, pode utilizar o cmdlet New-ServiceFabricApplication para criar uma instância de aplicação. Utilize o cmdlet Start-ServiceFabricApplicationUpgrade para atualizar uma aplicação existente.

Quando o tipo de aplicação com a versão especificada já não for necessário, pode desregissi-lo utilizando o cmdlet Unregister-ServiceFabricApplicationType .

Para gerir os clusters de Tecido de Serviço, comece Windows PowerShell utilizando a opção Executar como administrador. Antes de efetuar qualquer operação num cluster de tecido de serviço, estabeleça uma ligação ao cluster utilizando o cmdlet Connect-ServiceFabricCluster .

Exemplos

Exemplo 1: Registar um tipo de aplicação com o caminho relativo da loja 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 aplicações encontrado na pasta "c:\work\PersistentToDoListService" para a loja de imagens. O pacote é copiado no caminho relativo "PersistentToDoListService" na loja de imagens.

Registo-ServiçoSFebricApplication O comando Tipo de aplicação regista o tipo de aplicação encontrado no caminho relativo "PersistenteToDoListService".

Exemplo 2: Registar um tipo de aplicação com async de caminho relativo de loja de imagem

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 aplicações encontrado na pasta "c:\work\PersistentToDoListService" para a loja de imagens. O pacote de aplicações é copiado no caminho relativo "PersistentToDoListService" na loja de imagens. O cmdlet utiliza compressão para reduzir o tamanho da embalagem.

Registo-ServiçoSFebricApplication O comando Tipo de aplicação regista o tipo de aplicação encontrado no caminho relativo "PersistenteToDoListService". O registo é feito como o async, e regressa assim que o comando é aceite pelo cluster.

Get-ServiceFabricApplicationType obtém os tipos de aplicação registados no cluster. Cada tipo de candidatura inclui o estado de registo. O cmdlet pode ser usado para determinar quando o registo termina.

Exemplo 3: Registar um tipo de aplicação para um grande pacote de aplicações com caminho relativo de loja de imagem

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 aplicações encontrado na pasta "c:\work\PersistentToDoListService" para a loja de imagens, na localização relativa da loja de imagens "PersistentToDoListService". Uma vez que o pacote inicial é muito grande, o comando comprime-o e inclui um tempo limite mais elevado para permitir tempo suficiente para a cópia.

Registo-ServiçoSFebricApplication O comando Tipo de aplicação regista o tipo de aplicação encontrado no caminho relativo "PersistenteToDoListService". O comando inclui um tempo limite mais elevado para permitir que o trabalho termine mesmo que o pacote de aplicação seja grande.

Exemplo 4: Registar um tipo de aplicação a partir 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

Regista o pacote de candidatura encontrado no URI especificado. O pacote de aplicações deve ter sido previamente carregado naquele local e deve permitir o acesso ao READ. Uma vez que a embalagem pode ser grande, o comando especifica um tempo limite de provisão grande.

Exemplo 5: Registar um tipo de aplicação a partir de uma loja externa async

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

Regista o pacote de candidatura encontrado no URI especificado. O pacote de aplicações deve ter sido previamente carregado naquele local e deve permitir o acesso ao READ. Porque -Async é especificado, o comando retorna assim que o cluster o aceitar. Get-ServiceFabricApplicationType obtém os tipos de aplicação registados no cluster que correspondem ao filtro. Cada tipo de candidatura inclui o estado de registo. O cmdlet pode ser usado para acompanhar o progresso do registo e para determinar quando o registo termina.

Exemplo 6: Registar um tipo de aplicação com o caminho relativo da loja 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 aplicações utilizado para o registo do tipo de aplicação. Se não forem limpos, os pacotes de aplicação consomem espaço em disco e podem levar a falhas. Este parâmetro especifica como gerir o pacote de aplicações depois de registar com sucesso o tipo de aplicação (provisão bem sucedida).

Quando definido para Automatic, o tempo de execução do Tecido de Serviço determina quando efetuar a limpeza do pacote de aplicações. A implementação atual do tempo de execução elimina o pacote de aplicações após registar com sucesso o tipo de aplicação. Se o registo falhar, o pacote de aplicações não será eliminado da loja de imagens.

Quando definido para Manual, o pacote de aplicações não é eliminado da loja de imagens e os utilizadores têm de ligar explicitamente para remove-lo do Remove-ServiceFabricApplicationPackage cmdlet para removê-lo da loja de imagens.

Um cluster de tecido de serviço é configurado com uma política de limpeza. Para utilizar a política do cluster, especifique Default a opção. O cluster config CleanupApplicationPackageOnProvisionSuccess na Management secção determina como deve ocorrer a limpeza. Se for definido como verdadeiro, as embalagens de aplicação são automaticamente eliminadas pelo tempo de execução do tecido de serviço após a prestação bem sucedida. Se for definido como falso, o pacote de aplicações não é eliminado da loja de imagens. O valor padrão deste cluster config foi definido como falso até v6.4, mas existem planos para defini-lo como verdadeiro para futuras versões.

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 aplicações a partir do local onde o pacote de aplicações pode ser descarregado usando protocolos HTTP ou HTTPS. A embalagem deve ter sido previamente enviada para este local externo. O URI deve permitir o acesso READ para que o Service Fabric possa descarregar o ficheiro. O sfpkg ficheiro é um zip que contém o pacote inicial de aplicação. Dentro do fecho, a embalagem de aplicação pode ser comprimida ou descomprimida. A compressão do pacote de aplicações dentro do fecho é feita em pacotes de código, pacote e dados. Esta compressão pode ser conseguida usando copy-ServiceFabricApplicationPackage com switch -CompressPackage. O sfpkg ficheiro 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 percurso relativo do pacote do tipo de aplicação na loja de imagens. Este caminho foi especificado pelo Copy-ServiceFabricApplicationPackage cmdlet quando o pacote de aplicações foi copiado para a loja 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 aplicação, tal como está definido no manifesto de aplicação. O nome do tipo de aplicação e a versão do tipo de aplicação identificam exclusivamente o tipo de aplicação. Isto é necessário quando se ademia uma sfpkg de uma loja externa.

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

-ApplicationTypeVersion

Especifica a versão tipo de aplicação, tal como foi definido no manifesto de aplicação. O nome do tipo de aplicação e a versão do tipo de aplicação identificam exclusivamente o tipo de aplicação. Isto é necessário ao fornecer um ficheiro de pacote de aplicações sfpkg a partir de uma loja externa.

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

-Async

O comando regressa assim que o pedido de registo for aceite pelo cluster. Utilize o comando Get-ServiceFabricApplicationType para consultar o estado do pedido de registo. A utilização deste interruptor evita ter de fornecer valores de timeoutSec grandes ao registar grandes pacotes de aplicações.

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

-TimeoutSec

Especifica o período de tempo de ício, 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