az sf application

  • Riferimento

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

Comandi

Nome Descrizione Tipo Stato
az sf application certificate

Gestire il certificato di un'applicazione.

 Memoria centrale Disponibilità generale
az sf application certificate add

Aggiungere un nuovo certificato al set di scalabilità di macchine virtuali che costituiscono il cluster da usare dalle applicazioni ospitate.

 Memoria centrale Disponibilità generale
az sf application create

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

 Memoria centrale Disponibilità generale
az sf application delete

Elimina un'applicazione.

 Memoria centrale Disponibilità generale
az sf application list

Elencare le applicazioni di un determinato cluster.

 Memoria centrale Disponibilità generale
az sf application show

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

 Memoria centrale Disponibilità generale
az sf application update

Aggiornare un'applicazione di Azure Service Fabric. In questo modo è possibile aggiornare i parametri dell'applicazione e/o aggiornare la versione del tipo di applicazione che attiverà un aggiornamento dell'applicazione.

 Memoria centrale Disponibilità generale

az sf application create

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

az sf application create --application-name
                         --application-type-name
                         --application-type-version
                         --cluster-name
                         --resource-group
                         [--application-parameters]
                         [--max-nodes]
                         [--min-nodes]
                         [--package-url]

Esempio

Creare l'applicazione "testApp" con i 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 application create -g testRG -c testCluster --application-name testApp --application-type-name TestAppType \
  --application-type-version v1 --application-parameters key0=value0

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

az sf 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.

--max-nodes --maximum-nodes

Specificare il numero massimo di nodi in cui inserire un'applicazione. Il valore di questo parametro deve essere un numero intero non negativo. Il valore predefinito è 0, che indica che l'applicazione può essere inserita in un numero qualsiasi di nodi nel cluster.

--min-nodes --minimum-nodes

Specificare il numero minimo di nodi in cui Service Fabric riserva la capacità per questa applicazione, ciò non significa che l'applicazione disponga di repliche in tutti i nodi. Il valore di questo parametro deve essere un numero intero non negativo. Il valore predefinito per questo valore è zero, il che significa che non è riservata alcuna capacità per l'applicazione.

--package-url

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

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 application delete

Elimina un'applicazione.

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

Esempio

Elimina un'applicazione.

az sf 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 application list

Elencare le applicazioni di un determinato cluster.

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

Esempio

Elencare le applicazioni per un determinato cluster.

az sf 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 application show

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

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

Esempio

Ottenere l'applicazione.

az sf 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 application update

Aggiornare un'applicazione di Azure Service Fabric. In questo modo è possibile aggiornare i parametri dell'applicazione e/o aggiornare la versione del tipo di applicazione che attiverà un aggiornamento dell'applicazione.

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

Esempio

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

az sf 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 i nodi minimo e massimo dell'applicazione.

az sf application update -g testRG -c testCluster --application-name testApp --minimum-nodes 1 --maximum-nodes 3

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.

--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-nodes --maximum-nodes

Specificare il numero massimo di nodi in cui inserire un'applicazione. Il valore di questo parametro deve essere un numero intero non negativo. Il valore predefinito è 0, che indica che l'applicazione può essere inserita in un numero qualsiasi di nodi nel cluster.

--max-porcent-unhealthy-apps --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-porcent-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-porcent-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-porcent-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.

--min-nodes --minimum-nodes

Specificare il numero minimo di nodi in cui Service Fabric riserva la capacità per questa applicazione, ciò non significa che l'applicazione disponga di repliche in tutti i nodi. Il valore di questo parametro deve essere un numero intero non negativo. Il valore predefinito per questo valore è zero, il che significa che non è riservata alcuna capacità per l'applicazione.

--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 tipi di servizio diversi come tabella hash nel formato seguente: {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Ad esempio: @{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }.

--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-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.