Udostępnij przez

az sf managed-application

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

Polecenia

Nazwa Opis Typ Stan
az sf managed-application create

Utwórz nową aplikację zarządzaną w klastrze zarządzanym usługi Azure Service Fabric.

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

Usuwanie aplikacji zarządzanej.

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

Lista zarządzanych aplikacji danego klastra zarządzanego.

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

Pokaż właściwości aplikacji zarządzanej w klastrze zarządzanym usługi Azure Service Fabric.

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

Aktualizowanie aplikacji zarządzanej usługi Azure Service Fabric.

 Core ogólna dostępność

az sf managed-application create

Utwórz nową aplikację zarządzaną w klastrze zarządzanym usługi Azure Service Fabric.

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

Przykłady

Utwórz aplikację zarządzaną "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 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

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

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

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.

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

--package-url

Określ adres URL pliku sfpkg pakietu aplikacji.

--tags

Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

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

Usuwanie aplikacji zarządzanej.

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

Przykłady

Usuń aplikację zarządzaną.

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

Lista zarządzanych aplikacji danego klastra zarządzanego.

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

Przykłady

Wyświetlanie listy aplikacji zarządzanych dla danego klastra zarządzanego.

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

Pokaż właściwości aplikacji zarządzanej w klastrze zarządzanym usługi Azure Service Fabric.

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

Przykłady

Pobierz aplikację zarządzaną.

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

Zmiana powodująca niezgodność

Lista opcji została zmieniona, uruchom polecenie pomocy, aby wyświetlić dozwolone opcje

Aktualizowanie aplikacji zarządzanej usługi Azure Service Fabric.

Umożliwia to aktualizowanie tagów, parametrów aplikacji, aktualizacji aplikacjiPolicy i/lub uaktualniania wersji typu aplikacji, co spowoduje wyzwolenie uaktualnienia aplikacji.

az sf managed-application update --application-name --name
                                 --cluster-name
                                 --resource-group
                                 [--application-parameters --parameters]
                                 [--application-type-version --version]
                                 [--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]
                                 [--instance-close-delay-duration]
                                 [--max-unhealthy-apps]
                                 [--max-unhealthy-parts]
                                 [--max-unhealthy-reps]
                                 [--max-unhealthy-servs]
                                 [--recreate-application {false, true}]
                                 [--rep-check-timeout --replica-check-timeout]
                                 [--service-type-health-policy-map]
                                 [--tags]
                                 [--ud-timeout --upgrade-domain-timeout]
                                 [--upgrade-mode {Monitored, UnmonitoredAuto}]
                                 [--upgrade-timeout]
                                 [--warning-as-error {false, true}]

Przykłady

Zaktualizuj parametry aplikacji i uaktualnij wartości zasad oraz wersję typu aplikacji do wersji 2.

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 --replica-check-timeout 300 --force-restart

Zaktualizuj mapę zasad kondycji typu usługi zarządzanej aplikacji.

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"

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.

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

--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ść
Grupa parametrów: Upgrade description Arguments
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 Service 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 oczekiwania usługi Service Fabric, 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 oczekiwania usługi Service Fabric przed wykonaniem początkowej kontroli kondycji po zakończeniu uaktualniania w domenie uaktualnienia.

Właściwość Wartość
Grupa parametrów: Upgrade description Arguments
--instance-close-delay-duration

Określ czas trwania w sekundach, aby poczekać przed zamknięciem wystąpienia bezstanowego, aby umożliwić bezproblemowe opróżnianie aktywnych żądań. Byłoby to skuteczne, gdy wystąpienie jest zamykane podczas uaktualniania aplikacji/klastra, tylko w przypadku tych wystąpień, które mają niezerowy czas trwania opóźnienia skonfigurowany w opisie usługi.

Właściwość Wartość
Grupa parametrów: Upgrade description Arguments
--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
--recreate-application

Określa, czy aplikacja powinna zostać ponownie utworzona podczas aktualizacji. Jeśli parametr value=true, pozostałe parametry zasad uaktualniania są niedozwolone.

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

Określ maksymalny czas w sekundach oczekiwania usługi Service Fabric na ponowne skonfigurowanie usługi w bezpiecznym stanie, jeśli nie jest jeszcze w bezpiecznym stanie, zanim usługa Service Fabric przejdzie do uaktualnienia.

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

Określ mapę zasad kondycji do użycia dla różnych typów usług jako par klucz/wartość w następującym formacie: "ServiceTypeName"="MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices". na przykład: --service-type-health-policy-map "ServiceTypeName01"="5,10,5" "ServiceTypeName02"="5,5,5".

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

Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

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

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

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

Określ tryb używany do monitorowania kondycji podczas uaktualniania stopniowego. Wartości są monitorowane i NiemonitorowaneAuto.

Właściwość Wartość
Grupa parametrów: Upgrade description Arguments
Dopuszczalne wartości: Monitored, UnmonitoredAuto
--upgrade-timeout

Określ maksymalny czas w sekundach potrzebny na całe uaktualnienie usługi Service Fabric. Po upływie tego okresu uaktualnianie zakończy się niepowodzeniem.

Właściwość Wartość
Grupa parametrów: Upgrade description Arguments
--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
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