az sf application

參考

管理在 Azure Service Fabric 叢集上執行的應用程式。僅支援 ARM 部署的應用程式。

命令

名稱	Description	類型	狀態
az sf application certificate	管理應用程式的憑證。	核心	GA
az sf application certificate add	將新的憑證新增至組成裝載應用程式所要使用的叢集虛擬機器擴展集。	核心	GA
az sf application create	在 Azure Service Fabric 叢集上建立新的應用程式。	核心	GA
az sf application delete	刪除應用程式。	核心	GA
az sf application list	列出指定叢集的應用程式。	核心	GA
az sf application show	顯示 Azure Service Fabric 叢集上應用程式的屬性。	核心	GA
az sf application update	更新 Azure Service Fabric 應用程式。這可更新應用程式參數和/或升級將觸發應用程式升級的應用程式類型版本。	核心	GA

az sf application create

在 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]

範例

使用參數建立應用程式「testApp」。應用程式類型「TestAppType」版本「v1」應該已存在於叢集中，而且應用程式參數應該定義在應用程式資訊清單中。

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

使用提供的套件 URL 建立應用程式「testApp」和應用程式類型版本。

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

必要參數

--application-name --name

指定應用程式名稱。

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

指定應用程式類型名稱。

--application-type-version --version

指定應用程式類型版本。

--cluster-name -c

如果未指定，請指定叢集的名稱會與資源組名相同。

--resource-group -g

指定資源組名。您可以使用來設定預設群組 az configure --defaults group=<name> 。

選擇性參數

--application-parameters --parameters

將應用程式參數指定為索引鍵/值組。這些參數必須存在於應用程式資訊清單中。例如：--application-parameters param1=value1 param2=value2。

--max-nodes --maximum-nodes

指定要放置應用程式的節點數目上限。此參數的值必須是非負整數。預設值為 0，表示應用程式可以放在叢集中任意數目的節點上。

--min-nodes --minimum-nodes

指定 Service Fabric 會為此應用程式保留容量的節點數目下限，這並不表示應用程式保證在所有這些節點上都有複本。此參數的值必須是非負整數。預設值為零，這表示應用程式不會保留容量。

--package-url

指定應用程式套件 sfpkg 檔案的 URL。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az sf application delete

刪除應用程式。

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

範例

刪除應用程式。

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

必要參數

--application-name --name

指定應用程式名稱。

--cluster-name -c

如果未指定，請指定叢集的名稱會與資源組名相同。

--resource-group -g

指定資源組名。您可以使用來設定預設群組 az configure --defaults group=<name> 。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az sf application list

列出指定叢集的應用程式。

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

範例

列出指定叢集的應用程式。

az sf application list -g testRG -c testCluster

必要參數

--cluster-name -c

如果未指定，請指定叢集的名稱會與資源組名相同。

--resource-group -g

指定資源組名。您可以使用來設定預設群組 az configure --defaults group=<name> 。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az sf application show

顯示 Azure Service Fabric 叢集上應用程式的屬性。

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

範例

取得應用程式。

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

必要參數

--application-name --name

指定應用程式名稱。

--cluster-name -c

如果未指定，請指定叢集的名稱會與資源組名相同。

--resource-group -g

指定資源組名。您可以使用來設定預設群組 az configure --defaults group=<name> 。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az sf application update

更新 Azure Service Fabric 應用程式。這可更新應用程式參數和/或升級將觸發應用程式升級的應用程式類型版本。

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]

範例

將應用程式參數和應用程式類型版本更新為 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

更新應用程式最小和最大節點。

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

必要參數

--application-name --name

指定應用程式名稱。

--cluster-name -c

如果未指定，請指定叢集的名稱會與資源組名相同。

--resource-group -g

指定資源組名。您可以使用來設定預設群組 az configure --defaults group=<name> 。

選擇性參數

--application-parameters --parameters

將應用程式參數指定為索引鍵/值組。這些參數必須存在於應用程式資訊清單中。例如：--application-parameters param1=value1 param2=value2。

--application-type-version --version

指定應用程式類型版本。

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

指出是否要在健康情況評估期間將警告健康情況事件視為錯誤事件。

接受的值: false, true

預設值: False

--failure-action

指定受監視升級失敗時要採取的動作。此參數可接受的值為 Rollback 或 Manual。

接受的值: Manual, Rollback

--force-restart

表示即使升級是僅限設定的變更，服務主機仍會重新開機。

接受的值: false, true

預設值: False

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

指定持續時間，以秒為單位，之後 Service Fabric 會在先前的健康情況檢查失敗時重試健康情況檢查。

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

指定 Service Fabric 等候的持續時間，以秒為單位，以確認應用程式在移至下一個升級網域或完成升級之前是否穩定。此等候持續時間可防止在執行健康狀態檢查之後立即偵測到健康情況變更。

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

指定 Service Fabric 在升級網域完成升級之後，在執行初始健康狀態檢查之前，以秒為單位指定持續時間。

--max-nodes --maximum-nodes

指定要放置應用程式的節點數目上限。此參數的值必須是非負整數。預設值為 0，表示應用程式可以放在叢集中任意數目的節點上。

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

指定在叢集中節點部署之應用程式實例的最大百分比，這些實例在叢集的應用程式健康情況狀態發生錯誤之前，其健康情況狀態為錯誤。允許的值為 0 到 100。

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

針對要用於受監視升級的預設服務類型，指定健全狀況原則所允許之每個服務未連線資料分割的最大百分比。允許的值為 0 到 100。

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

針對預設服務類型，針對要用於受監視升級的預設服務類型，指定每個服務允許的未執行複本的最大百分比。允許的值為 0 到 100。

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

指定預設服務類型用於受監視升級之健康狀態原則所允許之未聯機服務的最大百分比。允許的值為 0 到 100。

--min-nodes --minimum-nodes

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

在 Service Fabric 繼續進行升級之前，指定 Service Fabric 等候服務重新設定為安全狀態的時間上限，如果尚未處於安全狀態，則為秒。

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

以下列格式指定用於不同服務類型之健康情況原則的對應：{「ServiceTypeName」：「MaxPercentUnhealthyPartitionsPerService，MaxPercentUnhealthyReplicasPerPartition，MaxPercentUnhealthyServices」}。例如：@{ 「ServiceTypeName01」 = 「5,10,5」;「ServiceTypeName02」 = 「5,5,5」 }。

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

指定 Service Fabric 升級單一升級網域所花費的時間上限，以秒為單位。在此期間之後，升級會失敗。

--upgrade-timeout

指定 Service Fabric 在整個升級時所花費的時間上限，以秒為單位。在此期間之後，升級會失敗。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

Share via

az sf application

命令

az sf application create

範例

必要參數

選擇性參數

az sf application delete

範例

必要參數

az sf application list

範例

必要參數

az sf application show

範例

必要參數

az sf application update

範例

必要參數

選擇性參數

意見反應

其他資源