az sf application

Zarządzanie aplikacjami uruchomionymi w klastrze Azure Service Fabric. Obsługa tylko aplikacji wdrożonych w usłudze ARM.

Polecenia

Nazwisko Opis Typ Stan
az sf application certificate

Zarządzanie certyfikatem aplikacji.

 Core ogólna dostępność
az sf application certificate add

Dodaj nowy certyfikat do Virtual Machine Scale Sets, które tworzą klaster do użycia przez hostowane aplikacje.

 Core ogólna dostępność
az sf application create

Utwórz nową aplikację w klastrze Azure Service Fabric.

 Core ogólna dostępność
az sf application delete

Usuń aplikację.

 Core ogólna dostępność
az sf application list

Wyświetlanie listy aplikacji danego klastra.

 Core ogólna dostępność
az sf application show

Pokaż właściwości aplikacji w klastrze Azure Service Fabric.

 Core ogólna dostępność
az sf application update

Aktualizowanie aplikacji Azure Service Fabric. Umożliwia to aktualizowanie parametrów aplikacji i/lub uaktualnianie wersji typu aplikacji, co spowoduje wyzwolenie uaktualnienia aplikacji.

 Core ogólna dostępność

az sf application create

Utwórz nową aplikację w klastrze Azure Service Fabric.

az sf application create --application-name --name
                         --application-type-name --type-name
                         --application-type-version --version
                         --cluster-name
                         --resource-group
                         [--acquire-policy-token]
                         [--application-parameters --parameters]
                         [--change-reference]
                         [--max-nodes --maximum-nodes]
                         [--min-nodes --minimum-nodes]
                         [--package-url]

Przykłady

Utwórz aplikację "testApp" z parametrami. Typ aplikacji "TestAppType" w wersji "v1" powinien już istnieć w klastrze, a parametry aplikacji powinny być zdefiniowane w manifeście aplikacji.

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

Utwórz aplikację "testApp" i wersję typu aplikacji przy użyciu podanego adresu URL pakietu.

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

Parametry wymagane

--application-name --name

Określ nazwę aplikacji.

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

Określ nazwę typu aplikacji.

--application-type-version --version

Określ wersję typu aplikacji.

--cluster-name -c

Określ nazwę klastra, jeśli nie zostanie podana, będzie taka sama jak nazwa grupy zasobów.

--resource-group -g

Określ nazwę grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--application-parameters --parameters

Określ parametry aplikacji jako pary klucz/wartość. Te parametry muszą istnieć w manifeście aplikacji. na przykład: --application-parameters param1=value1 param2=value2.

--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--max-nodes --maximum-nodes

Określ maksymalną liczbę węzłów, na których ma być umieszczana aplikacja. Wartość tego parametru musi być nieujemną liczbą całkowitą. Wartość domyślna to 0, co wskazuje, że aplikacja może zostać umieszczona w dowolnej liczbie węzłów w klastrze.

--min-nodes --minimum-nodes

Określ minimalną liczbę węzłów, w których usługa Fabric będzie rezerwować pojemność dla tej aplikacji. Nie oznacza to, że aplikacja ma zagwarantowane posiadanie replik na wszystkich tych węzłach. Wartość tego parametru musi być nieujemną liczbą całkowitą. Wartość domyślna dla tej wartości to zero, co oznacza, że żadna pojemność nie jest zarezerwowana dla aplikacji.

--package-url

Określ adres URL pliku sfpkg pakietu aplikacji.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az sf application delete

Usuń aplikację.

az sf application delete --application-name --name
                         --cluster-name
                         --resource-group
                         [--acquire-policy-token]
                         [--change-reference]

Przykłady

Usuń aplikację.

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

Parametry wymagane

--application-name --name

Określ nazwę aplikacji.

--cluster-name -c

Określ nazwę klastra, jeśli nie zostanie podana, będzie taka sama jak nazwa grupy zasobów.

--resource-group -g

Określ nazwę grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az sf application list

Wyświetlanie listy aplikacji danego klastra.

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

Przykłady

Wyświetlanie listy aplikacji dla danego klastra.

az sf application list -g testRG -c testCluster

Parametry wymagane

--cluster-name -c

Określ nazwę klastra, jeśli nie zostanie podana, będzie taka sama jak nazwa grupy zasobów.

--resource-group -g

Określ nazwę grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az sf application show

Pokaż właściwości aplikacji w klastrze Azure Service Fabric.

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

Przykłady

Pobierz aplikację.

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

Parametry wymagane

--application-name --name

Określ nazwę aplikacji.

--cluster-name -c

Określ nazwę klastra, jeśli nie zostanie podana, będzie taka sama jak nazwa grupy zasobów.

--resource-group -g

Określ nazwę grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az sf application update

Aktualizowanie aplikacji Azure Service Fabric. Umożliwia to aktualizowanie parametrów aplikacji i/lub uaktualnianie wersji typu aplikacji, co spowoduje wyzwolenie uaktualnienia aplikacji.

az sf application update --application-name --name
                         --cluster-name
                         --resource-group
                         [--acquire-policy-token]
                         [--application-parameters --parameters]
                         [--application-type-version --version]
                         [--change-reference]
                         [--consider-warning-as-error --warning-as-error {false, true}]
                         [--failure-action {Manual, Rollback}]
                         [--force-restart {false, true}]
                         [--hc-retry-timeout --health-check-retry-timeout]
                         [--hc-stable-duration --health-check-stable-duration]
                         [--hc-wait-duration --health-check-wait-duration]
                         [--max-nodes --maximum-nodes]
                         [--max-unhealthy-apps]
                         [--max-unhealthy-parts]
                         [--max-unhealthy-reps]
                         [--max-unhealthy-servs]
                         [--min-nodes --minimum-nodes]
                         [--rep-check-timeout --replica-check-timeout]
                         [--service-type-health-policy-map]
                         [--ud-timeout --upgrade-domain-timeout]
                         [--upgrade-timeout]

Przykłady

Zaktualizuj parametry aplikacji i uaktualnij wartości zasad oraz wersję typu aplikacji do wersji 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 --replica-check-timeout 300 --force-restart

Zaktualizuj minimalną i maksymalną liczbę węzłów aplikacji.

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

Parametry wymagane

--application-name --name

Określ nazwę aplikacji.

--cluster-name -c

Określ nazwę klastra, jeśli nie zostanie podana, będzie taka sama jak nazwa grupy zasobów.

--resource-group -g

Określ nazwę grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--application-parameters --parameters

Określ parametry aplikacji jako pary klucz/wartość. Te parametry muszą istnieć w manifeście aplikacji. na przykład: --application-parameters param1=value1 param2=value2.

--application-type-version --version

Określ wersję typu aplikacji.

--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--consider-warning-as-error --warning-as-error

Wskazuje, czy zdarzenie kondycji ostrzeżenia ma być traktowane jako zdarzenie błędu podczas oceny kondycji.

Właściwość Wartość
Grupa parametrów: Upgrade description Arguments
Domyślna wartość: False
Dopuszczalne wartości: false, true
--failure-action

Określ akcję, która ma być wykonywana, jeśli monitorowane uaktualnienie zakończy się niepowodzeniem. Dopuszczalne wartości tego parametru to Wycofywanie lub Ręczne.

Właściwość Wartość
Grupa parametrów: Upgrade description Arguments
Dopuszczalne wartości: Manual, Rollback
--force-restart

Wskazuje, że host usługi uruchamia się ponownie, nawet jeśli uaktualnienie jest zmianą tylko w konfiguracji.

Właściwość Wartość
Domyślna wartość: False
Dopuszczalne wartości: false, true
--hc-retry-timeout --health-check-retry-timeout

Określ czas trwania w sekundach, po którym usługa Fabric ponawia próbę sprawdzenia kondycji, jeśli poprzednia kontrola kondycji zakończy się niepowodzeniem.

Właściwość Wartość
Grupa parametrów: Upgrade description Arguments
--hc-stable-duration --health-check-stable-duration

Określ czas trwania (w sekundach), przez który usługa Fabric czeka, aby sprawdzić, czy aplikacja jest stabilna przed przejściem do następnej domeny uaktualnienia lub ukończeniem uaktualnienia. Ten czas oczekiwania zapobiega niezkrytym zmianom kondycji bezpośrednio po wykonaniu kontroli kondycji.

Właściwość Wartość
Grupa parametrów: Upgrade description Arguments
--hc-wait-duration --health-check-wait-duration

Określ czas trwania w sekundach, przez który usługa Fabric czeka przed wykonaniem początkowej kontroli kondycji po zakończeniu uaktualniania w domenie uaktualnienia.

Właściwość Wartość
Grupa parametrów: Upgrade description Arguments
--max-nodes --maximum-nodes

Określ maksymalną liczbę węzłów, na których ma być umieszczana aplikacja. Wartość tego parametru musi być nieujemną liczbą całkowitą. Wartość domyślna to 0, co wskazuje, że aplikacja może zostać umieszczona w dowolnej liczbie węzłów w klastrze.

--max-unhealthy-apps

Określ maksymalny procent wystąpień aplikacji wdrożonych w węzłach w klastrze, które mają stan kondycji błędu przed wystąpieniem błędu kondycji aplikacji dla klastra. Dozwolone wartości to od 0 do 100.

Właściwość Wartość
Grupa parametrów: Upgrade description Arguments
--max-unhealthy-parts

Określ maksymalny procent partycji w złej kondycji na usługę dozwolony przez zasady kondycji dla domyślnego typu usługi do użycia na potrzeby monitorowanego uaktualnienia. Dozwolone wartości to od 0 do 100.

Właściwość Wartość
Grupa parametrów: Upgrade description Arguments
--max-unhealthy-reps

Określ maksymalny procent replik w złej kondycji na usługę dozwolony przez zasady kondycji domyślnego typu usługi do użycia na potrzeby monitorowanego uaktualnienia. Dozwolone wartości to od 0 do 100.

Właściwość Wartość
Grupa parametrów: Upgrade description Arguments
--max-unhealthy-servs

Określ maksymalny procent usług w złej kondycji dozwolony przez zasady kondycji dla domyślnego typu usługi do użycia na potrzeby monitorowanego uaktualnienia. Dozwolone wartości to od 0 do 100.

Właściwość Wartość
Grupa parametrów: Upgrade description Arguments
--min-nodes --minimum-nodes

Określ minimalną liczbę węzłów, w których usługa Fabric będzie rezerwować pojemność dla tej aplikacji. Nie oznacza to, że aplikacja ma zagwarantowane posiadanie replik na wszystkich tych węzłach. Wartość tego parametru musi być nieujemną liczbą całkowitą. Wartość domyślna dla tej wartości to zero, co oznacza, że żadna pojemność nie jest zarezerwowana dla aplikacji.

--rep-check-timeout --replica-check-timeout

Określ maksymalny czas (w sekundach), który usługa Fabric czeka na ponowne skonfigurowanie usługi w bezpiecznym stanie, jeśli nie jest jeszcze w bezpiecznym stanie, zanim usługa Fabric przejdzie do uaktualnienia.

Właściwość Wartość
Grupa parametrów: Upgrade description Arguments
--service-type-health-policy-map

Określ mapę zasad kondycji, które mają być używane dla różnych typów usług jako tabela skrótów w następującym formacie: {"ServiceTypeName": "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Na przykład: @{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }.

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

Określ maksymalny czas (w sekundach), który usługa Fabric trwa uaktualnianie pojedynczej domeny uaktualnienia. Po upływie tego okresu uaktualnianie zakończy się niepowodzeniem.

Właściwość Wartość
Grupa parametrów: Upgrade description Arguments
--upgrade-timeout

Określ maksymalny czas (w sekundach), który usługa Fabric trwa dla całego uaktualnienia. Po upływie tego okresu uaktualnianie zakończy się niepowodzeniem.

Właściwość Wartość
Grupa parametrów: Upgrade description Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False