Register-ServiceFabricApplicationType

Riferimento

Modulo:: ServiceFabric

Registra un tipo di applicazione di Service Fabric.

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

Determina i criteri di pulizia del pacchetto dell'applicazione utilizzato per la registrazione del tipo di applicazione. Se non è stata pulita, i pacchetti dell'applicazione utilizzano spazio su disco e possono causare errori. Questo parametro specifica come gestire il pacchetto dell'applicazione dopo aver registrato correttamente il tipo di applicazione (provisioning riuscito).

Se impostato su Automatic, il runtime di Service Fabric determina quando eseguire la pulizia del pacchetto dell'applicazione. L'implementazione di runtime corrente elimina il pacchetto dell'applicazione dopo aver registrato correttamente il tipo di applicazione. Se la registrazione non riesce, il pacchetto dell'applicazione non viene eliminato dall'archivio immagini.

Se impostato su Manual, il pacchetto dell'applicazione non viene eliminato dall'archivio immagini e gli utenti devono chiamare in modo esplicito il cmdlet Remove-ServiceFabricApplicationPackage per rimuoverlo dall'archivio immagini.

Un cluster di Service Fabric è configurato con un criterio di pulizia. Per usare i criteri del cluster, specificare Default l'opzione . La configurazione del cluster CleanupApplicationPackageOnProvisionSuccess nella Management sezione determina come deve essere eseguita la pulizia. Se impostato su true, i pacchetti dell'applicazione vengono eliminati automaticamente dal runtime di Service Fabric dopo il completamento del provisioning. Se impostato su false, il pacchetto dell'applicazione non viene eliminato dall'archivio immagini. Il valore predefinito di questa configurazione del cluster è stato impostato su false fino alla versione 6.4, ma prevede di impostarlo su true per le versioni future.

Type:	ApplicationPackageCleanupPolicy
Accepted values:	Invalid, Default, Automatic, Manual
Position:	Named
Default value:	Default
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationPackageDownloadUri

Rappresenta il percorso del pacchetto dell'applicazione sfpkg da cui è possibile scaricare il pacchetto dell'applicazione usando protocolli HTTP o HTTPS. È necessario tuttavia che il pacchetto sia stato precedentemente caricato in questa posizione esterna. L'URI deve inoltre consentire l'accesso in lettura affinché Service Fabric possa scaricare il file. Il sfpkg file è un file ZIP 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. Questa compressione può essere ottenuta usando Copy-ServiceFabricApplicationPackage con switch -CompressPackage. Il file sfpkg deve avere l'estensione sfpkg.

Type:	Uri
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationPathInImageStore

Specifica il percorso relativo del pacchetto del tipo di applicazione nell'archivio immagini. Questo percorso è stato specificato dal cmdlet Copy-ServiceFabricApplicationPackage quando il pacchetto dell'applicazione è stato copiato nell'archivio immagini.

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

-ApplicationTypeName

Specifica il nome del tipo di applicazione, come definito nel manifesto dell'applicazione. Il nome del tipo di applicazione e la versione del tipo di applicazione identificano in modo univoco il tipo di applicazione. Questa operazione è necessaria durante il provisioning di un sfpkg oggetto da un archivio esterno.

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

-ApplicationTypeVersion

Specifica la versione del tipo di applicazione, così come è stata definita nel manifesto dell'applicazione. Il nome del tipo di applicazione e la versione del tipo di applicazione identificano in modo univoco il tipo di applicazione. Questa operazione è necessaria durante il provisioning di un sfpkg file del pacchetto dell'applicazione da un archivio esterno.

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

-Async

Il comando restituisce non appena la richiesta di registrazione viene accettata dal cluster. Usare il comando Get-ServiceFabricApplicationType per eseguire una query sullo stato della richiesta di registrazione. L'uso di questa opzione evita di dover fornire valori -TimeoutSec di grandi dimensioni durante la registrazione di pacchetti di applicazioni di grandi dimensioni.

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

-TimeoutSec

Specifica il periodo di timeout, espresso in secondi, per l'operazione.

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

Input

None

Output

System.Object