共用方式為

az sf managed-application

  • 參考

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

命令

名稱 Description 類型 狀態
az sf managed-application create

在 Azure Service Fabric 受控叢集上建立新的受控應用程式。

 核心 GA
az sf managed-application delete

刪除受控應用程式。

 核心 GA
az sf managed-application list

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

 核心 GA
az sf managed-application show

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

 核心 GA
az sf managed-application update

更新 Azure Service Fabric 受控應用程式。

 核心 GA

az sf managed-application create

在 Azure Service Fabric 受控叢集上建立新的受控應用程式。

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

範例

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

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

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

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

必要參數

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

--package-url

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

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「」 清除現有的標記。

全域參數
--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 managed-application delete

刪除受控應用程式。

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

範例

刪除受控應用程式。

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

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

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

範例

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

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

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

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

範例

取得受控應用程式。

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

更新 Azure Service Fabric 受控應用程式。

這允許更新標籤、應用程式參數、值是應用程式 UpgradePolicy 和/或升級將觸發應用程式升級的應用程式類型版本。

az sf managed-application update --application-name
                                 --cluster-name
                                 --resource-group
                                 [--application-parameters]
                                 [--application-type-version]
                                 [--close-duration]
                                 [--consider-warning-as-error {false, true}]
                                 [--failure-action {Manual, Rollback}]
                                 [--force-restart {false, true}]
                                 [--hc-retry-timeout]
                                 [--hc-stable-duration]
                                 [--hc-wait-duration]
                                 [--max-percent-unhealthy-apps]
                                 [--max-percent-unhealthy-partitions]
                                 [--max-percent-unhealthy-replicas]
                                 [--max-percent-unhealthy-services]
                                 [--recreate-application {false, true}]
                                 [--rep-check-timeout]
                                 [--service-type-health-policy-map]
                                 [--tags]
                                 [--ud-timeout]
                                 [--upgrade-mode {Monitored, UnmonitoredAuto}]
                                 [--upgrade-timeout]

範例

將應用程式參數和 upgreade 原則值和應用程式類型版本更新為 v2。

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

更新受控應用程式服務類型健全狀況原則對應。

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"

必要參數

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

指定應用程式類型版本。

--close-duration --instance-close-delay-duration --instance-close-duration

指定以秒為單位的持續時間，以等候無狀態實例關閉，以允許作用中要求正常清空。 當實例在應用程式/叢集升級期間關閉時，只有在服務描述中設定非零延遲持續時間的實例時才有效。

--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-percent-unhealthy-apps --max-percent-unhealthy-deployed-applications --max-unhealthy-apps

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

--max-percent-unhealthy-partitions --max-unhealthy-parts

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

--max-percent-unhealthy-replicas --max-unhealthy-reps

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

--max-percent-unhealthy-services --max-unhealthy-servs

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

--recreate-application

判斷應用程式是否應該在更新時重新建立。 如果 value=true，則不允許其餘的升級原則參數。

接受的值: false, true
預設值: False
--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」。 例如：--service-type-health-policy-map 「ServiceTypeName01」=「5,10,5」 「ServiceTypeName02」=「5,5,5」。

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「」 清除現有的標記。

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

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

--upgrade-mode

指定在輪流升級期間用來監視健康情況的模式。 值為 Monitored 和 UnmonitoredAuto。

接受的值: Monitored, UnmonitoredAuto
--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 來取得完整偵錯記錄。