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

az sf application

  • Ссылка

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

Команды

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

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

 Ядро ГА
az sf application certificate add

Добавьте новый сертификат в масштабируемые наборы виртуальных машин, составляющие кластер, который будет использоваться размещенными приложениями.

 Ядро ГА
az sf application create

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

 Ядро ГА
az sf application delete

Удаление приложения.

 Ядро ГА
az sf application list

Список приложений заданного кластера.

 Ядро ГА
az sf application show

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

 Ядро ГА
az sf application update

Обновите приложение Azure Service Fabric. Это позволяет обновлять параметры приложения и (или) обновлять версию типа приложения, которая активирует обновление приложения.

 Ядро ГА

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

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

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

--max-nodes --maximum-nodes

Укажите максимальное количество узлов, на которых нужно разместить приложение. Значение этого параметра должно быть неотрицательное целое число. Значение по умолчанию равно 0, указывающее, что приложение можно поместить на любое количество узлов в кластере.

--min-nodes --minimum-nodes

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

--package-url

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

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

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

--help -h

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

--only-show-errors

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

--output -o

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

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: 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
Default value: 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
Default value: 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
Default value: 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]

Примеры

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

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

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

--application-type-version --version

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

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

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

Допустимые значения: false, true
Default value: False
--failure-action

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

Допустимые значения: Manual, Rollback
--force-restart

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

Допустимые значения: false, true
Default value: 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

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

--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
Default value: json
--query

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

--subscription

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

--verbose

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