Udostępnij za pośrednictwem

az sf application

  • Odwołanie

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

Polecenia

Nazwa Opis Typ Stan
az sf application certificate

Zarządzanie certyfikatem aplikacji.

 Podstawowe funkcje Ogólna dostępność
az sf application certificate add

Dodaj nowy certyfikat do zestawów skalowania maszyn wirtualnych tworzących klaster, który ma być używany przez hostowane aplikacje.

 Podstawowe funkcje Ogólna dostępność
az sf application create

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

 Podstawowe funkcje Ogólna dostępność
az sf application delete

Usuń aplikację.

 Podstawowe funkcje Ogólna dostępność
az sf application list

Wyświetlanie listy aplikacji danego klastra.

 Podstawowe funkcje Ogólna dostępność
az sf application show

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

 Podstawowe funkcje Ogólna dostępność
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.

 Podstawowe funkcje Ogólna dostępność

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

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

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, 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.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, 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ś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 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.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, 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.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, 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 ma być traktowane jako zdarzenie błędu podczas oceny kondycji.

Dopuszczalne wartości: false, true
Domyślna wartość: False
--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.

Dopuszczalne wartości: Manual, Rollback
--force-restart

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

Dopuszczalne wartości: false, true
Domyślna wartość: False
--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.

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

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

--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-porcent-unhealthy-apps --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.

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

Określ maksymalny procent niedotrzymanych 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 nieuprawionych 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

Określ minimalną liczbę węzłów, w których usługa 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ć 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 --upgrade-replica-set-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.

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

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 zajmuje usłudze Service Fabric uaktualnienie pojedynczej domeny uaktualnienia. Po upływie tego okresu uaktualnianie zakończy się niepowodzeniem.

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

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.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

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