az sf application

Toepassingen beheren die worden uitgevoerd op een Azure Service Fabric cluster. Ondersteunt alleen door ARM geïmplementeerde toepassingen.

Opdracht

az sf application certificate

Het certificaat van een toepassing beheren.

az sf application certificate add

Voeg een nieuw certificaat toe aan de Virtual Machine Scale Sets waar het cluster uit te maken is dat door gehoste toepassingen moet worden gebruikt.

az sf application create

Maak een nieuwe toepassing op een Azure Service Fabric cluster.

az sf application delete

Een toepassing verwijderen.

az sf application list

Lijst met toepassingen van een bepaald cluster.

az sf application show

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

az sf application update

Een Azure Service Fabric bijwerken. Hierdoor kunnen de toepassingsparameters worden bijgewerkt en/of kan de versie van het toepassingstype worden bijgewerkt waarmee een toepassingsupgrade wordt uitgevoerd.

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]
                         [--subscription]

Voorbeelden

Toepassing 'testApp' maken met parameters. Het toepassingstype 'TestAppType' versie 'v1' moet al bestaan 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 de versie van het app-type 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 wordt opgegeven, is dit hetzelfde als de naam van de resourcegroep.

--resource-group -g

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

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 een toepassing moet worden plaatsen. De waarde van deze parameter moet een niet-negatief geheel getal zijn. De standaardwaarde is 0, wat aangeeft dat de toepassing op een groot aantal knooppunten in het cluster kan worden geplaatst.

--min-nodes --minimum-nodes

Geef het minimum aantal knooppunten op waar Service Fabric capaciteit voor deze toepassing reserveert. Dit betekent niet dat de toepassing gegarandeerd replica's heeft op al deze knooppunten. 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 van het sfpkg-bestand van het toepassingspakket op.

--subscription

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

az sf application delete

Een toepassing verwijderen.

az sf application delete --application-name
                         --cluster-name
                         --resource-group
                         [--subscription]

Voorbeelden

Verwijder de toepassing.

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 wordt opgegeven, is dit hetzelfde als de naam van de resourcegroep.

--resource-group -g

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

Optionele parameters

--subscription

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

az sf application list

Lijst met toepassingen van een bepaald cluster.

az sf application list --cluster-name
                       --resource-group
                       [--query-examples]
                       [--subscription]

Voorbeelden

Lijst met toepassingen voor een bepaald cluster.

az sf application list -g testRG -c testCluster

Vereiste parameters

--cluster-name -c

Geef de naam van het cluster op. Als dit niet wordt opgegeven, is dit hetzelfde als de naam van de resourcegroep.

--resource-group -g

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

Optionele parameters

--query-examples

JMESPath-tekenreeks voor u aanbevelen. U kunt een van de query's kopiëren en deze na de parameter --query tussen dubbele aanhalingstekens plakken om de resultaten te bekijken. U kunt een of meer positionele trefwoorden toevoegen, zodat we suggesties kunnen geven op basis van deze sleutelwoorden.

--subscription

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

az sf application show

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

az sf application show --application-name
                       --cluster-name
                       --resource-group
                       [--query-examples]
                       [--subscription]

Voorbeelden

Toepassing op te halen.

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 wordt opgegeven, is dit hetzelfde als de naam van de resourcegroep.

--resource-group -g

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

Optionele parameters

--query-examples

JMESPath-tekenreeks voor u aanbevelen. U kunt een van de query's kopiëren en plakken na de parameter --query tussen dubbele aanhalingstekens om de resultaten te bekijken. U kunt een of meer positionele trefwoorden toevoegen, zodat we suggesties kunnen geven op basis van deze sleutelwoorden.

--subscription

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

az sf application update

Een Azure Service Fabric bijwerken. Hierdoor kunnen de toepassingsparameters worden bijgewerkt en/of kan de versie van het toepassingstype worden bijgewerkt waarmee een toepassingsupgrade wordt uitgevoerd.

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]
                         [--subscription]
                         [--ud-timeout]
                         [--upgrade-timeout]

Voorbeelden

Werk toepassingsparameters bij en werk beleidswaarden en de versie van het app-type 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

Werk de minimale en maximale knooppunten van de toepassing bij.

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 wordt opgegeven, is dit hetzelfde als de naam van de resourcegroep.

--resource-group -g

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

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

Geeft aan of een waarschuwingsgebeurtenis moet worden behandeld als een foutgebeurtenis tijdens de statusevaluatie.

geaccepteerde waarden: false, true
--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 een configuratiewijziging is.

geaccepteerde waarden: false, true
--hc-retry-timeout --health-check-retry-timeout

Geef de duur in seconden op waarna Service Fabric statuscontrole opnieuw ondergaat als de vorige statuscontrole mislukt.

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

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

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

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

--max-nodes --maximum-nodes

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

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

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

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

Geef het maximumaantal niet-held partities per service op dat door het statusbeleid is toegestaan voor het standaardservicetype dat moet worden gebruikt voor de bewaakte upgrade. Toegestane waarden zijn van 0 tot 100.

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

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

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

Geef het maximumaantal niet-ijde services op dat door het statusbeleid is toegestaan voor het standaardservicetype dat moet worden gebruikt voor de bewaakte upgrade. Toegestane waarden zijn van 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 heeft op al deze knooppunten. 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 dat Service Fabric wacht tot een service opnieuw wordt geconfigureerd in een veilige status( als deze nog niet in een veilige status is) voordat Service Fabric doorgaat 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 hashtabel in de volgende indeling: {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Bijvoorbeeld: @{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }.

--subscription

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

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

Geef de maximale tijd in seconden op die nodig Service Fabric upgrade van één upgradedomein duurt. Na deze periode mislukt de upgrade.

--upgrade-timeout

Geef de maximale tijd in seconden op die Service Fabric de hele upgrade duurt. Na deze periode mislukt de upgrade.