Register-ServiceFabricApplicationType
Regista um tipo de aplicação de Tecido de Serviço.
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 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 sfpkg
pasta 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.
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 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".
Tipo: | Uri |
Position: | 0 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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.
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 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.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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.
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 de ício, 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