az sf application

Odwołanie

Zarządzanie aplikacjami działającymi w klastrze usługi Azure Service Fabric. Obsługuje tylko wdrożone aplikacje usługi ARM.

Polecenia

az sf application certificate	Zarządzanie certyfikatem aplikacji.
az sf application certificate add	Dodaj nowy certyfikat do Virtual Machine Scale Sets, które tworzą klaster do użycia przez hostowane aplikacje.
az sf application create	Utwórz nową aplikację w klastrze usługi Azure Service Fabric.
az sf application delete	Usuń aplikację.
az sf application list	Wyświetlanie listy aplikacji danego klastra.
az sf application show	Pokaż właściwości aplikacji w klastrze usługi Azure Service Fabric.
az sf application update	Aktualizowanie aplikacji usługi Azure Service Fabric. Umożliwia to aktualizowanie parametrów aplikacji i/lub uaktualnianie wersji typu aplikacji, co spowoduje wyzwolenie uaktualnienia aplikacji.

az sf application create

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

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

Przykłady

Utwórz aplikację "testApp" przy użyciu parametrów. 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 polecenia az configure --defaults group=<name>.

Parametry opcjonalne

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

--max-nodes --maximum-nodes

Określ maksymalną liczbę węzłów, na których ma być umieszczana aplikacja. Wartość tego parametru musi być nie ujemną 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 Service 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ć nie ujemną 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.

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

--query

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

--subscription

Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

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

az sf application delete

Usuń aplikację.

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

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 polecenia az configure --defaults group=<name>.

Parametry globalne

--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

--query

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

--subscription

Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

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

az sf application list

Wyświetlanie listy aplikacji danego klastra.

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

Przykłady

Wyświetl listę 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 polecenia az configure --defaults group=<name>.

Parametry globalne

--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

--query

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

--subscription

Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

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

az sf application show

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

az sf application show --application-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 polecenia az configure --defaults group=<name>.

Parametry globalne

--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

--query

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

--subscription

Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

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

az sf application update

Aktualizowanie aplikacji usługi 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
                         --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]

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 --upgrade-replica-set-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 polecenia az configure --defaults group=<name>.

Parametry opcjonalne

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

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

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

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

akceptowane wartości: Manual, Rollback

--force-restart

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

akceptowane wartości: false, true

--hc-retry-timeout --health-check-retry-timeout

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

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

Określ czas trwania w sekundach, który Service Fabric czeka, aby sprawdzić, czy aplikacja jest stabilna przed przejściem do następnej domeny uaktualnienia lub ukończeniem uaktualnienia. Ten czas oczekiwania uniemożliwia niezakryte zmiany kondycji bezpośrednio po wykonaniu kontroli kondycji.

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

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

--max-nodes --maximum-nodes

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

Określ maksymalną wartość procentową 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.

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

Określ maksymalny procent nieutrzymanych partycji 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.

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

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

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

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

--min-nodes --minimum-nodes

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

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

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

Określ mapę zasad kondycji do użycia dla różnych typów usług jako tabelę 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 Service Fabric trwa uaktualnianie pojedynczej domeny uaktualnienia. Po upływie tego okresu uaktualnienie zakończy się niepowodzeniem.

--upgrade-timeout

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

Parametry globalne

--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

--query

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

--subscription

Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

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