Register-ServiceFabricApplicationType

Sintassi

Register-ServiceFabricApplicationType
        [-ApplicationPathInImageStore] <String>
        [-ApplicationPackageCleanupPolicy <ApplicationPackageCleanupPolicy>]
        [-Async]
        [-TimeoutSec <Int32>]
        [<CommonParameters>]

Register-ServiceFabricApplicationType
        [-ApplicationPackageDownloadUri] <Uri>
        -ApplicationTypeName <String>
        -ApplicationTypeVersion <String>
        [-Async]
        [-TimeoutSec <Int32>]
        [<CommonParameters>]

Descrizione

Il cmdlet Register-ServiceFabricApplicationType registra un tipo di applicazione di Service Fabric. Altre informazioni sulla distribuzione di applicazioni di Service Fabric.

Il pacchetto dell'applicazione può esistere in un percorso relativo nell'archivio immagini o può essere un sfpkg file caricato in precedenza in un percorso esterno.

Quando si usa il percorso relativo dell'archivio, il pacchetto dell'applicazione deve esistere nell'archivio immagini. Il pacchetto può essere copiato nell'archivio immagini con Copy-ServiceFabricApplicationPackage.

Quando si usa un sfpkg file da un archivio esterno, il provisioning deve fornire l'URI di download in cui sfpkg è stato caricato in precedenza, nonché le informazioni sul tipo di applicazione. sfpkg è un file zip con estensione sfpkg che contiene il pacchetto dell'applicazione iniziale. All'interno, il pacchetto dell'applicazione può essere compresso o meno. La compressione del pacchetto dell'applicazione all'interno del file ZIP viene eseguita al codice, al pacchetto e ai pacchetti di dati.

Per creare un sfpkgoggetto , iniziare con una cartella contenente il pacchetto dell'applicazione originale. Se necessario, comprimere il pacchetto con Copy-ServiceFabricApplicationPackage con opzioni -CompressPackage e -SkipCopy. Usare quindi un'utilità per comprimere la cartella con l'estensione ".sfpkg". Ad esempio, usare ZipFile.CreateFromDirectory nella cartella del pacchetto dell'applicazione.

Dopo aver registrato un tipo di applicazione, è possibile usare il cmdlet New-ServiceFabricApplication per creare un'istanza dell'applicazione. Usare il cmdlet Start-ServiceFabricApplicationUpgrade per aggiornare un'applicazione esistente.

Quando il tipo di applicazione con la versione specificata non è più necessario, è possibile annullare la registrazione usando il cmdlet Unregister-ServiceFabricApplicationType .

Per gestire i cluster di Service Fabric, avviare Windows PowerShell usando l'opzione Esegui come amministratore. Prima di eseguire qualsiasi operazione in un cluster di Service Fabric, stabilire una connessione al cluster usando il cmdlet Connect-ServiceFabricCluster .

Esempio

Esempio 1: Registrare un tipo di applicazione con il percorso relativo dell'archivio immagini

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 il pacchetto dell'applicazione presente nella cartella "c:\work\PersistentToDoListService" nell'archivio immagini. Il pacchetto viene copiato nel percorso relativo "PersistentToDoListService" nell'archivio immagini.

Il comando Register-ServiceFabricApplicationType registra il tipo di applicazione trovato nel percorso relativo "PersistentToDoListService".

Esempio 2: Registrare un tipo di applicazione con il percorso relativo dell'archivio immagini asincrono

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 il pacchetto dell'applicazione presente nella cartella "c:\work\PersistentToDoListService" nell'archivio immagini. Il pacchetto dell'applicazione viene copiato nel percorso relativo "PersistentToDoListService" nell'archivio immagini. Il cmdlet usa la compressione per ridurre le dimensioni del pacchetto.

Il comando Register-ServiceFabricApplicationType registra il tipo di applicazione trovato nel percorso relativo "PersistentToDoListService". Il registro viene eseguito in modo asincrono e viene restituito non appena il comando viene accettato dal cluster.

Get-ServiceFabricApplicationType ottiene i tipi di applicazione registrati nel cluster. Ogni tipo di applicazione include lo stato di registrazione. Il cmdlet può essere usato per determinare al termine della registrazione.

Esempio 3: Registrare un tipo di applicazione per un pacchetto di applicazioni di grandi dimensioni con percorso relativo dell'archivio immagini

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 il pacchetto dell'applicazione trovato nella cartella "c:\work\PersistentToDoListService" nell'archivio immagini, nel percorso relativo dell'archivio immagini "PersistentToDoListService". Poiché il pacchetto iniziale è molto grande, il comando lo comprime e include un timeout superiore per consentire un tempo sufficiente per la copia.

Il comando Register-ServiceFabricApplicationType registra il tipo di applicazione trovato nel percorso relativo "PersistentToDoListService". Il comando include un timeout superiore per consentire il completamento del lavoro anche se il pacchetto dell'applicazione è di grandi dimensioni.

Esempio 4: Registrare un tipo di applicazione da un archivio esterno

PS C:\> Register-ServiceFabricApplicationType -ApplicationPackageDownloadUri "https://sftestresources.blob.core.windows.net:443/sfpkgholder/MyAppPackage.sfpkg" -ApplicationTypeName MyApp -ApplicationTypeVersion V1 -TimeoutSec 2700

Registra il pacchetto dell'applicazione trovato nell'URI specificato. Il pacchetto dell'applicazione deve essere stato caricato in precedenza in tale posizione e deve consentire l'accesso in lettura. Poiché il pacchetto può essere di grandi dimensioni, il comando specifica un timeout di provisioning di grandi dimensioni.

Esempio 5: Registrare un tipo di applicazione da un archivio esterno asincrono

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 il pacchetto dell'applicazione trovato nell'URI specificato. Il pacchetto dell'applicazione deve essere stato caricato in precedenza in tale posizione e deve consentire l'accesso in lettura. Poiché viene specificato -Async, il comando restituisce non appena il cluster lo accetta. Get-ServiceFabricApplicationType ottiene i tipi di applicazione registrati nel cluster che corrispondono al filtro. Ogni tipo di applicazione include lo stato di registrazione. Il cmdlet può essere usato per seguire lo stato di avanzamento della registrazione e per determinare al termine della registrazione.

Esempio 6: Registrare un tipo di applicazione con il percorso relativo dell'archivio immagini e la pulizia automatica dei pacchetti

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.

Parametri

-ApplicationPackageCleanupPolicy

-ApplicationPackageDownloadUri

-ApplicationPathInImageStore

-ApplicationTypeName

-ApplicationTypeVersion

-Async

-TimeoutSec

Input

None

Output

System.Object

Collegamenti correlati

• Connect-ServiceFabricCluster
• Copy-ServiceFabricApplicationPackage
• Get-ServiceFabricClusterConnection
• Get-ServiceFabricApplicationType
• Unregister-ServiceFabricApplicationType
• New-ServiceFabricApplication
• Start-ServiceFabricApplicationUpgrade
• Remove-ServiceFabricApplicationPackage