Delen via

az sf managed-application

  • Referentie

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

Opdracht

Name Description Type Status
az sf managed-application create

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

 Basis GA
az sf managed-application delete

Een beheerde toepassing verwijderen.

 Basis GA
az sf managed-application list

Lijst met beheerde toepassingen van een bepaald beheerd cluster.

 Basis GA
az sf managed-application show

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

 Basis GA
az sf managed-application update

Een beheerde Azure Service Fabric-toepassing bijwerken.

 Basis GA

az sf managed-application create

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

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

Voorbeelden

Maak beheerde 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 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

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

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

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.

--package-url

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

--tags

Door spaties gescheiden tags: key[=value] [key[=value] ...]. Gebruik '' om bestaande tags te wissen.

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
standaardwaarde: 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 managed-application delete

Een beheerde toepassing verwijderen.

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

Voorbeelden

Beheerde toepassing verwijderen.

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

Lijst met beheerde toepassingen van een bepaald beheerd cluster.

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

Voorbeelden

Lijst met beheerde toepassingen voor een bepaald beheerd cluster.

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

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

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

Voorbeelden

Beheerde toepassing ophalen.

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

Een beheerde Azure Service Fabric-toepassing bijwerken.

Hierdoor kunnen de tags, de toepassingsparameters, de waarde de upgradepolicy van de toepassing worden bijgewerkt en/of de versie van het toepassingstype worden bijgewerkt die een upgrade van de toepassing activeert.

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]

Voorbeelden

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

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

Statusbeleidstoewijzing voor beheerde toepassingsservicetypen bijwerken.

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"

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.

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

Geef de duur in seconden op om te wachten voordat een staatloze instantie wordt gesloten, zodat de actieve aanvragen probleemloos kunnen worden leeglopen. Dit is effectief wanneer het exemplaar wordt gesloten tijdens de upgrade van de toepassing/het cluster, alleen voor exemplaren met een niet-nul vertragingsduur die is geconfigureerd in de servicebeschrijving.

--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
standaardwaarde: 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
standaardwaarde: 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-percent-unhealthy-apps --max-percent-unhealthy-deployed-applications --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-percent-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 van 0 tot 100.

--max-percent-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 van 0 tot 100.

--max-percent-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 van 0 tot 100.

--recreate-application

Bepaalt of de toepassing opnieuw moet worden gemaakt bij de update. Als value=true, zijn de rest van de upgradebeleidsparameters niet toegestaan.

geaccepteerde waarden: false, true
standaardwaarde: False
--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 sleutel-waardeparen in de volgende indeling: "ServiceTypeName"="MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices". bijvoorbeeld: --service-type-health-policy-map "ServiceTypeName01"="5,10,5" "ServiceTypeName02"="5,5,5".

--tags

Door spaties gescheiden tags: key[=value] [key[=value] ...]. Gebruik '' om bestaande tags te wissen.

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

Geef de modus op die wordt gebruikt voor het bewaken van de status tijdens een rolling upgrade. De waarden worden bewaakt en UnmonitoredAuto.

geaccepteerde waarden: Monitored, UnmonitoredAuto
--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
standaardwaarde: 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.