az sf managed-application

  • Riferimento

Gestire le applicazioni in esecuzione in un cluster gestito di Azure Service Fabric. Supporta solo le applicazioni arm distribuite.

Comandi

Nome Descrizione Tipo Status
az sf managed-application create

Creare una nuova applicazione gestita in un cluster gestito di Azure Service Fabric.

 Memoria centrale Disponibilità generale
az sf managed-application delete

Eliminare un'applicazione gestita.

 Memoria centrale Disponibilità generale
az sf managed-application list

Elencare le applicazioni gestite di un determinato cluster gestito.

 Memoria centrale Disponibilità generale
az sf managed-application show

Visualizzare le proprietà di un'applicazione gestita in un cluster gestito di Azure Service Fabric.

 Memoria centrale Disponibilità generale
az sf managed-application update

Aggiornare un'applicazione gestita di Azure Service Fabric.

 Memoria centrale Disponibilità generale

az sf managed-application create

Creare una nuova applicazione gestita in un cluster gestito di Azure Service Fabric.

az sf managed-application create --application-name
                                 --application-type-name
                                 --application-type-version
                                 --cluster-name
                                 --resource-group
                                 [--application-parameters]
                                 [--package-url]
                                 [--tags]

Esempio

Creare un'applicazione gestita "testApp" con parametri. Il tipo di applicazione "TestAppType" versione "v1" deve già esistere nel cluster e i parametri dell'applicazione devono essere definiti nel manifesto dell'applicazione.

az sf managed-application create -g testRG -c testCluster --application-name testApp --application-type-name TestAppType \
  --application-type-version v1 --application-parameters key0=value0 --tags key1=value1

Creare l'applicazione "testApp" e la versione del tipo di app usando l'URL del pacchetto fornito.

az sf managed-application create -g testRG -c testCluster --application-name testApp --application-type-name TestAppType \
  --application-type-version v1 --package-url "https://sftestapp.blob.core.windows.net/sftestapp/testApp_1.0.sfpkg" \
    --application-parameters key0=value0

Parametri necessari

--application-name --name

Specificare il nome dell'applicazione.

--application-type-name --type-name

Specificare il nome del tipo di applicazione.

--application-type-version --version

Specificare la versione del tipo di applicazione.

--cluster-name -c

Specificare il nome del cluster, se non specificato sarà uguale al nome del gruppo di risorse.

--resource-group -g

Specificare il nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--application-parameters --parameters

Specificare i parametri dell'applicazione come coppie chiave/valore. Questi parametri devono esistere nel manifesto dell'applicazione. ad esempio: --application-parameters param1=value1 param2=value2.

--package-url

Specificare l'URL del file sfpkg del pacchetto dell'applicazione.

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az sf managed-application delete

Eliminare un'applicazione gestita.

az sf managed-application delete --application-name
                                 --cluster-name
                                 --resource-group

Esempio

Eliminare un'applicazione gestita.

az sf managed-application delete -g testRG -c testCluster --application-name testApp

Parametri necessari

--application-name --name

Specificare il nome dell'applicazione.

--cluster-name -c

Specificare il nome del cluster, se non specificato sarà uguale al nome del gruppo di risorse.

--resource-group -g

Specificare il nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az sf managed-application list

Elencare le applicazioni gestite di un determinato cluster gestito.

az sf managed-application list --cluster-name
                               --resource-group

Esempio

Elencare le applicazioni gestite per un determinato cluster gestito.

az sf managed-application list -g testRG -c testCluster

Parametri necessari

--cluster-name -c

Specificare il nome del cluster, se non specificato sarà uguale al nome del gruppo di risorse.

--resource-group -g

Specificare il nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az sf managed-application show

Visualizzare le proprietà di un'applicazione gestita in un cluster gestito di Azure Service Fabric.

az sf managed-application show --application-name
                               --cluster-name
                               --resource-group

Esempio

Ottenere un'applicazione gestita.

az sf managed-application show -g testRG -c testCluster --application-name testApp

Parametri necessari

--application-name --name

Specificare il nome dell'applicazione.

--cluster-name -c

Specificare il nome del cluster, se non specificato sarà uguale al nome del gruppo di risorse.

--resource-group -g

Specificare il nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az sf managed-application update

Aggiornare un'applicazione gestita di Azure Service Fabric.

Ciò consente di aggiornare i tag, i parametri dell'applicazione, il valore è l'applicazione UpgradePolicy e/o aggiornare la versione del tipo di applicazione che attiverà un aggiornamento dell'applicazione.

az sf managed-application update --application-name
                                 --cluster-name
                                 --resource-group
                                 [--application-parameters]
                                 [--application-type-version]
                                 [--close-duration]
                                 [--consider-warning-as-error {false, true}]
                                 [--failure-action {Manual, Rollback}]
                                 [--force-restart {false, true}]
                                 [--hc-retry-timeout]
                                 [--hc-stable-duration]
                                 [--hc-wait-duration]
                                 [--max-percent-unhealthy-apps]
                                 [--max-percent-unhealthy-partitions]
                                 [--max-percent-unhealthy-replicas]
                                 [--max-percent-unhealthy-services]
                                 [--recreate-application {false, true}]
                                 [--rep-check-timeout]
                                 [--service-type-health-policy-map]
                                 [--tags]
                                 [--ud-timeout]
                                 [--upgrade-mode {Monitored, UnmonitoredAuto}]
                                 [--upgrade-timeout]

Esempio

Aggiornare i parametri dell'applicazione e i valori dei criteri di upgreade e la versione del tipo di app alla versione 2.

az sf managed-application update -g testRG -c testCluster --application-name testApp --application-type-version v2 \
  --application-parameters key0=value0 --health-check-stable-duration 0 --health-check-wait-duration 0 --health-check-retry-timeout 0 \
    --upgrade-domain-timeout 5000 --upgrade-timeout 7000 --failure-action Rollback --upgrade-replica-set-check-timeout 300 --force-restart

Aggiornare il mapping dei criteri di integrità del tipo di servizio dell'applicazione gestita.

az sf managed-application update -g testRG -c testCluster --application-name testApp --service-type-health-policy-map  "ServiceTypeName01"="5,10,5" "ServiceTypeName02"="5,5,5"

Parametri necessari

--application-name --name

Specificare il nome dell'applicazione.

--cluster-name -c

Specificare il nome del cluster, se non specificato sarà uguale al nome del gruppo di risorse.

--resource-group -g

Specificare il nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--application-parameters --parameters

Specificare i parametri dell'applicazione come coppie chiave/valore. Questi parametri devono esistere nel manifesto dell'applicazione. ad esempio: --application-parameters param1=value1 param2=value2.

--application-type-version --version

Specificare la versione del tipo di applicazione.

--close-duration --instance-close-delay-duration --instance-close-duration

Specificare la durata in secondi, per attendere la chiusura di un'istanza senza stato, per consentire alle richieste attive di svuotare normalmente. Ciò sarebbe efficace quando l'istanza viene chiusa durante l'aggiornamento dell'applicazione/cluster, solo per le istanze con una durata di ritardo non zero configurata nella descrizione del servizio.

--consider-warning-as-error --warning-as-error

Indica se considerare un evento di integrità di avviso come evento di errore durante la valutazione dell'integrità.

Valori accettati: false, true
Valore predefinito: False
--failure-action

Specificare l'azione da eseguire se l'aggiornamento monitorato non riesce. I valori accettabili per questo parametro sono Rollback o Manual.

Valori accettati: Manual, Rollback
--force-restart

Indica che l'host del servizio viene riavviato anche se l'aggiornamento è una modifica di sola configurazione.

Valori accettati: false, true
Valore predefinito: False
--hc-retry-timeout --health-check-retry-timeout

Specificare la durata, in secondi, dopo la quale Service Fabric ritenta il controllo integrità se il controllo integrità precedente ha esito negativo.

--hc-stable-duration --health-check-stable-duration

Specificare la durata, in secondi, che Service Fabric attende per verificare che l'applicazione sia stabile prima di passare al dominio di aggiornamento successivo o completare l'aggiornamento. Questa durata di attesa impedisce modifiche non rilevate dell'integrità subito dopo l'esecuzione del controllo integrità.

--hc-wait-duration --health-check-wait-duration

Specificare la durata, in secondi, che Service Fabric attende prima di eseguire il controllo di integrità iniziale al termine dell'aggiornamento nel dominio di aggiornamento.

--max-percent-unhealthy-apps --max-percent-unhealthy-deployed-applications --max-unhealthy-apps

Specificare la percentuale massima delle istanze dell'applicazione distribuite nei nodi del cluster con uno stato di integrità di errore prima che lo stato di integrità dell'applicazione per il cluster sia errore. I valori consentiti sono compresi tra 0 e 100.

--max-percent-unhealthy-partitions --max-unhealthy-parts

Specificare la percentuale massima di partizioni nonhelthy per servizio consentite dai criteri di integrità per il tipo di servizio predefinito da usare per l'aggiornamento monitorato. I valori consentiti sono compresi tra 0 e 100.

--max-percent-unhealthy-replicas --max-unhealthy-reps

Specificare la percentuale massima di repliche nonhelthy per servizio consentite dai criteri di integrità per il tipo di servizio predefinito da usare per l'aggiornamento monitorato. I valori consentiti sono compresi tra 0 e 100.

--max-percent-unhealthy-services --max-unhealthy-servs

Specificare la percentuale massima di servizi nonhelthy consentiti dai criteri di integrità per il tipo di servizio predefinito da usare per l'aggiornamento monitorato. I valori consentiti sono compresi tra 0 e 100.

--recreate-application

Determina se l'applicazione deve essere ricreata in caso di aggiornamento. Se value=true, il resto dei parametri dei criteri di aggiornamento non è consentito.

Valori accettati: false, true
Valore predefinito: False
--rep-check-timeout --replica-check-timeout --upgrade-replica-set-check-timeout

Specificare il tempo massimo, in secondi, che Service Fabric attende che un servizio venga riconfigurato in uno stato sicuro, se non già in uno stato sicuro, prima che Service Fabric proceda con l'aggiornamento.

--service-type-health-policy-map --service-type-policy

Specificare la mappa dei criteri di integrità da usare per diversi tipi di servizio come coppie chiave/valore nel formato seguente: "ServiceTypeName"="MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices". ad esempio: --service-type-health-policy-map "ServiceTypeName01"="5,10,5" "ServiceTypeName02"="5,5,5".

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--ud-timeout --upgrade-domain-timeout

Specificare il tempo massimo, espresso in secondi, che Service Fabric richiede per aggiornare un singolo dominio di aggiornamento. Dopo questo periodo, l'aggiornamento non riesce.

--upgrade-mode

Specificare la modalità utilizzata per monitorare l'integrità durante un aggiornamento in sequenza. I valori sono Monitored e UnmonitoredAuto.

Valori accettati: Monitored, UnmonitoredAuto
--upgrade-timeout

Specificare il tempo massimo, in secondi, richiesto da Service Fabric per l'intero aggiornamento. Dopo questo periodo, l'aggiornamento non riesce.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.