Register-ServiceFabricApplicationType
Registra um tipo de aplicativo do Service Fabric.
Sintaxe
UseStoreRelativePath (Predefinição)
Register-ServiceFabricApplicationType
[-ApplicationPathInImageStore] <String>
[-ApplicationPackageCleanupPolicy <ApplicationPackageCleanupPolicy>]
[-Async]
[-TimeoutSec <Int32>]
[<CommonParameters>]
UseExternalSfpkg
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
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.
Propriedades dos parâmetros
| Tipo: | ApplicationPackageCleanupPolicy |
| Default value: | Default |
| Valores aceites: | Invalid, Default, Automatic, Manual |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
UseStoreRelativePath
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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".
Propriedades dos parâmetros
| Tipo: | Uri |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
UseExternalSfpkg
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
UseStoreRelativePath
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
UseExternalSfpkg
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
UseExternalSfpkg
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-TimeoutSec
Especifica o período de tempo limite, em segundos, para a operação.
Propriedades dos parâmetros
| Tipo: | Int32 |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.