Delen via

az sf application

  • Referentie

Toepassingen beheren die worden uitgevoerd op een Azure Service Fabric-cluster. Alleen ondersteuning voor door ARM geïmplementeerde toepassingen.

Opdracht

Name Description Type Status
az sf application certificate

Het certificaat van een toepassing beheren.

 Basis GA
az sf application certificate add

Voeg een nieuw certificaat toe aan de virtuele-machineschaalsets waaruit het cluster bestaat dat moet worden gebruikt door gehoste toepassingen.

 Basis GA
az sf application create

Maak een nieuwe toepassing op een Azure Service Fabric-cluster.

 Basis GA
az sf application delete

Een toepassing verwijderen.

 Basis GA
az sf application list

Toepassingen van een bepaald cluster weergeven.

 Basis GA
az sf application show

De eigenschappen van een toepassing weergeven in een Azure Service Fabric-cluster.

 Basis GA
az sf application update

Een Azure Service Fabric-toepassing bijwerken. Hiermee kunt u de toepassingsparameters bijwerken en/of de versie van het toepassingstype bijwerken, waardoor een toepassingsupgrade wordt geactiveerd.

 Basis GA

az sf application create

Maak een nieuwe toepassing op een Azure Service Fabric-cluster.

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

Voorbeelden

Maak een toepassing 'testApp' met parameters. Het toepassingstype TestAppType versie v1 moet al aanwezig zijn in het cluster en de toepassingsparameters moeten worden gedefinieerd in het toepassingsmanifest.

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

Maak de toepassing testApp en app-typeversie met behulp van de opgegeven pakket-URL.

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

Vereiste parameters

--application-name --name

Geef de naam van de toepassing op.

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

Geef de naam van het toepassingstype op.

--application-type-version --version

Geef de versie van het toepassingstype op.

--cluster-name -c

Geef de naam van het cluster op als dit niet hetzelfde is als de naam van de resourcegroep.

--resource-group -g

Geef de naam van de resourcegroep op. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

--application-parameters --parameters

Geef de toepassingsparameters op als sleutel-waardeparen. Deze parameters moeten aanwezig zijn in het toepassingsmanifest. bijvoorbeeld: --application-parameters param1=value1 param2=value2.

--max-nodes --maximum-nodes

Geef het maximum aantal knooppunten op waarop u een toepassing wilt plaatsen. De waarde van deze parameter moet een niet-negatief geheel getal zijn. De standaardwaarde is 0, wat aangeeft dat de toepassing op een willekeurig aantal knooppunten in het cluster kan worden geplaatst.

--min-nodes --minimum-nodes

Geef het minimale aantal knooppunten op waar Service Fabric capaciteit voor deze toepassing reserveert. Dit betekent niet dat de toepassing gegarandeerd replica's op al deze knooppunten heeft. De waarde van deze parameter moet een niet-negatief geheel getal zijn. De standaardwaarde hiervoor is nul, wat betekent dat er geen capaciteit is gereserveerd voor de toepassing.

--package-url

Geef de URL op van het sfpkg-bestand van het toepassingspakket.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az sf application delete

Een toepassing verwijderen.

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

Voorbeelden

Toepassing verwijderen.

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

Vereiste parameters

--application-name --name

Geef de naam van de toepassing op.

--cluster-name -c

Geef de naam van het cluster op als dit niet hetzelfde is als de naam van de resourcegroep.

--resource-group -g

Geef de naam van de resourcegroep op. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az sf application list

Toepassingen van een bepaald cluster weergeven.

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

Voorbeelden

Toepassingen voor een bepaald cluster weergeven.

az sf application list -g testRG -c testCluster

Vereiste parameters

--cluster-name -c

Geef de naam van het cluster op als dit niet hetzelfde is als de naam van de resourcegroep.

--resource-group -g

Geef de naam van de resourcegroep op. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az sf application show

De eigenschappen van een toepassing weergeven in een Azure Service Fabric-cluster.

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

Voorbeelden

Toepassing ophalen.

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

Vereiste parameters

--application-name --name

Geef de naam van de toepassing op.

--cluster-name -c

Geef de naam van het cluster op als dit niet hetzelfde is als de naam van de resourcegroep.

--resource-group -g

Geef de naam van de resourcegroep op. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az sf application update

Een Azure Service Fabric-toepassing bijwerken. Hiermee kunt u de toepassingsparameters bijwerken en/of de versie van het toepassingstype bijwerken, waardoor een toepassingsupgrade wordt geactiveerd.

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]

Voorbeelden

Werk toepassingsparameters bij en werk beleidswaarden en app-typeversie bij naar v2.

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

Toepassingsminimum en maximumknooppunten bijwerken.

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

Vereiste parameters

--application-name --name

Geef de naam van de toepassing op.

--cluster-name -c

Geef de naam van het cluster op als dit niet hetzelfde is als de naam van de resourcegroep.

--resource-group -g

Geef de naam van de resourcegroep op. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

--application-parameters --parameters

Geef de toepassingsparameters op als sleutel-waardeparen. Deze parameters moeten aanwezig zijn in het toepassingsmanifest. bijvoorbeeld: --application-parameters param1=value1 param2=value2.

--application-type-version --version

Geef de versie van het toepassingstype op.

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

Hiermee wordt aangegeven of een waarschuwingsstatus gebeurtenis moet worden behandeld als een fout tijdens de statusevaluatie.

Geaccepteerde waarden: false, true
Default value: False
--failure-action

Geef de actie op die moet worden uitgevoerd als de bewaakte upgrade mislukt. De acceptabele waarden voor deze parameter zijn Terugdraaien of Handmatig.

Geaccepteerde waarden: Manual, Rollback
--force-restart

Geeft aan dat de servicehost opnieuw wordt opgestart, zelfs als de upgrade alleen een configuratiewijziging is.

Geaccepteerde waarden: false, true
Default value: False
--hc-retry-timeout --health-check-retry-timeout

Geef de duur op, in seconden, waarna Service Fabric de statuscontrole opnieuw probeert uit te proberen als de vorige statuscontrole mislukt.

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

Geef de duur op, in seconden, dat Service Fabric wacht om te controleren of de toepassing stabiel is voordat u naar het volgende upgradedomein gaat of de upgrade voltooit. Deze wachttijd voorkomt niet-gedetecteerde wijzigingen van de status direct nadat de statuscontrole is uitgevoerd.

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

Geef de duur in seconden op die Service Fabric wacht voordat de eerste statuscontrole wordt uitgevoerd nadat de upgrade op het upgradedomein is voltooid.

--max-nodes --maximum-nodes

Geef het maximum aantal knooppunten op waarop u een toepassing wilt plaatsen. De waarde van deze parameter moet een niet-negatief geheel getal zijn. De standaardwaarde is 0, wat aangeeft dat de toepassing op een willekeurig aantal knooppunten in het cluster kan worden geplaatst.

--max-porcent-unhealthy-apps --max-unhealthy-apps

Geef het maximumpercentage op van de toepassingsexemplaren die zijn geïmplementeerd op de knooppunten in het cluster met een status van een fout voordat de status van de toepassing voor het cluster een fout is. Toegestane waarden zijn 0 tot 100.

--max-porcent-unhealthy-partitions --max-unhealthy-parts

Geef het maximumpercentage op van de uitsplitsingspartities per service die door het statusbeleid zijn toegestaan voor het standaardservicetype dat moet worden gebruikt voor de bewaakte upgrade. Toegestane waarden zijn 0 tot 100.

--max-porcent-unhealthy-replicas --max-unhealthy-reps

Geef het maximumpercentage van de onhelthy replica's per service op dat is toegestaan door het statusbeleid voor het standaardservicetype dat moet worden gebruikt voor de bewaakte upgrade. Toegestane waarden zijn 0 tot 100.

--max-porcent-unhealthy-services --max-unhealthy-servs

Geef het maximumpercentage van de niet-opheffende services op die zijn toegestaan door het statusbeleid voor het standaardservicetype dat moet worden gebruikt voor de bewaakte upgrade. Toegestane waarden zijn 0 tot 100.

--min-nodes --minimum-nodes

Geef het minimale aantal knooppunten op waar Service Fabric capaciteit voor deze toepassing reserveert. Dit betekent niet dat de toepassing gegarandeerd replica's op al deze knooppunten heeft. De waarde van deze parameter moet een niet-negatief geheel getal zijn. De standaardwaarde hiervoor is nul, wat betekent dat er geen capaciteit is gereserveerd voor de toepassing.

--rep-check-timeout --replica-check-timeout --upgrade-replica-set-check-timeout

Geef de maximale tijd in seconden op die Service Fabric wacht totdat een service opnieuw wordt geconfigureerd in een veilige status, als deze nog niet in een veilige status is, voordat Service Fabric verdergaat met de upgrade.

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

Geef de kaart op van het statusbeleid dat moet worden gebruikt voor verschillende servicetypen als een hash-tabel in de volgende indeling: {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Bijvoorbeeld: @{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }.

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

Geef de maximale tijd in seconden op die Service Fabric nodig heeft om één upgradedomein bij te werken. Na deze periode mislukt de upgrade.

--upgrade-timeout

Geef de maximale tijd in seconden op die Service Fabric nodig heeft voor de volledige upgrade. Na deze periode mislukt de upgrade.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.