Поделиться через

az sf managed-application

Управление приложениями, работающими в управляемом кластере Azure Service Fabric. Поддерживает только развернутые приложения ARM.

Команды

Имя Описание Тип Состояние
az sf managed-application create

Создайте управляемое приложение в управляемом кластере Azure Service Fabric.

 Core GA
az sf managed-application delete

Удаление управляемого приложения.

 Core GA
az sf managed-application list

Список управляемых приложений данного управляемого кластера.

 Core GA
az sf managed-application show

Отображение свойств управляемого приложения в управляемом кластере Azure Service Fabric.

 Core GA
az sf managed-application update

Обновите управляемое приложение Azure Service Fabric.

 Core GA

az sf managed-application create

Создайте управляемое приложение в управляемом кластере 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]

Примеры

Создайте управляемое приложение 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

Создайте приложение testApp и версию типа приложения, используя указанный URL-адрес пакета.

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

Необязательные параметры

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--application-parameters --parameters

Укажите параметры приложения в виде пар "ключ-значение". Эти параметры должны существовать в манифесте приложения. например: --application-parameters param1=value1 param2=value2=value2.

--package-url

Укажите URL-адрес файла sfpkg пакета приложения.

--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az sf managed-application delete

Удаление управляемого приложения.

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

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

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

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az sf managed-application show

Отображение свойств управляемого приложения в управляемом кластере Azure Service Fabric.

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

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az sf managed-application update

Обновите управляемое приложение Azure Service Fabric.

Это позволяет обновлять теги, параметры приложения, приложение UpgradePolicy и (или) обновление версии типа приложения, которая активирует обновление приложения.

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

Примеры

Обновите параметры приложения и значения политики обновления и версию типа приложения до версии 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 --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>.

Необязательные параметры

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--application-parameters --parameters

Укажите параметры приложения в виде пар "ключ-значение". Эти параметры должны существовать в манифесте приложения. например: --application-parameters param1=value1 param2=value2=value2.

--application-type-version --version

Укажите версию типа приложения.

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

Укажите длительность в секундах, чтобы дождаться закрытия экземпляра без отслеживания состояния, чтобы разрешить активные запросы на очистку. Это будет эффективно при закрытии экземпляра во время обновления приложения или кластера только для тех экземпляров, которые имеют ненулевое время задержки, настроенное в описании службы.

Свойство Значение
Parameter group: Upgrade description Arguments
--consider-warning-as-error --warning-as-error

Указывает, следует ли рассматривать событие работоспособности предупреждения как событие ошибки во время оценки работоспособности.

Свойство Значение
Parameter group: Upgrade description Arguments
Default value: False
Допустимые значения: false, true
--failure-action

Укажите действие, необходимое для выполнения, если отслеживаемое обновление завершается ошибкой. Допустимые значения для этого параметра — rollback или Manual.

Свойство Значение
Parameter group: Upgrade description Arguments
Допустимые значения: Manual, Rollback
--force-restart

Указывает, что узел службы перезапускается, даже если обновление является изменением только конфигурации.

Свойство Значение
Parameter group: Upgrade description Arguments
Default value: False
Допустимые значения: false, true
--hc-retry-timeout --health-check-retry-timeout

Укажите длительность в секундах, после чего Service Fabric повторяет проверку работоспособности, если предыдущая проверка работоспособности завершается ошибкой.

Свойство Значение
Parameter group: Upgrade description Arguments
--hc-stable-duration --health-check-stable-duration

Укажите длительность( в секундах), которую Service Fabric ожидает, чтобы убедиться, что приложение стабильно, прежде чем перейти к следующему домену обновления или завершить обновление. Эта длительность ожидания предотвращает незамеченные изменения работоспособности сразу после выполнения проверки работоспособности.

Свойство Значение
Parameter group: Upgrade description Arguments
--hc-wait-duration --health-check-wait-duration

Укажите длительность( в секундах), которую Service Fabric ожидает, прежде чем она выполнит начальную проверку работоспособности после завершения обновления домена обновления.

Свойство Значение
Parameter group: Upgrade description Arguments
--max-percent-unhealthy-apps --max-percent-unhealthy-deployed-applications --max-unhealthy-apps

Укажите максимальный процент экземпляров приложения, развернутых на узлах в кластере с состоянием работоспособности, прежде чем состояние работоспособности приложения для кластера будет ошибкой. Допустимые значения — это форма от 0 до 100.

Свойство Значение
Parameter group: Upgrade description Arguments
--max-percent-unhealthy-partitions --max-unhealthy-parts

Укажите максимальный процент незахозяйных секций для каждой службы, разрешенной политикой работоспособности для типа службы по умолчанию, используемого для отслеживаемого обновления. Допустимые значения : от 0 до 100.

Свойство Значение
Parameter group: Upgrade description Arguments
--max-percent-unhealthy-replicas --max-unhealthy-reps

Укажите максимальный процент несхелых реплик для каждой службы, разрешенной политикой работоспособности для типа службы по умолчанию, используемого для отслеживаемого обновления. Допустимые значения : от 0 до 100.

Свойство Значение
Parameter group: Upgrade description Arguments
--max-percent-unhealthy-services --max-unhealthy-servs

Укажите максимальный процент незаслеченных служб, разрешенных политикой работоспособности для типа службы по умолчанию, используемого для отслеживаемого обновления. Допустимые значения : от 0 до 100.

Свойство Значение
Parameter group: Upgrade description Arguments
--recreate-application

Определяет, следует ли повторно создать приложение при обновлении. Если значение=true, остальные параметры политики обновления не допускаются.

Свойство Значение
Parameter group: Upgrade description Arguments
Default value: False
Допустимые значения: false, true
--rep-check-timeout --replica-check-timeout --upgrade-replica-set-check-timeout

Укажите максимальное время в секундах, которое Service Fabric ожидает перенастройки службы в безопасное состояние, если оно еще не в безопасном состоянии, прежде чем Service Fabric продолжит обновление.

Свойство Значение
Parameter group: Upgrade description Arguments
--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.5".

Свойство Значение
Parameter group: Upgrade description Arguments
--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.

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

Укажите максимальное время( в секундах), необходимое Service Fabric для обновления одного домена обновления. После этого периода обновление завершается ошибкой.

Свойство Значение
Parameter group: Upgrade description Arguments
--upgrade-mode

Укажите режим, используемый для мониторинга работоспособности во время последовательного обновления. Значения отслеживаются и unmonitoredAuto.

Свойство Значение
Parameter group: Upgrade description Arguments
Допустимые значения: Monitored, UnmonitoredAuto
--upgrade-timeout

Укажите максимальное время( в секундах), которое Service Fabric занимает для всего обновления. После этого периода обновление завершается ошибкой.

Свойство Значение
Parameter group: Upgrade description Arguments
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False