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

az sf application

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

Команды

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

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

 Core GA
az sf application certificate add

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

 Core GA
az sf application create

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

 Core GA
az sf application delete

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

 Core GA
az sf application list

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

 Core GA
az sf application show

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

 Core GA
az sf application update

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

 Core GA

az sf application create

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

az sf application create --application-name --name
                         --application-type-name --type-name
                         --application-type-version --version
                         --cluster-name
                         --resource-group
                         [--application-parameters --parameters]
                         [--max-nodes --maximum-nodes]
                         [--min-nodes --minimum-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>.

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

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.

--max-nodes --maximum-nodes

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

--min-nodes --minimum-nodes

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

--package-url

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

Глобальные параметры
--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 application delete

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

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

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

Свойство Значение
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 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

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

Свойство Значение
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 application show

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

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

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

Свойство Значение
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 application update

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

az sf application update --application-name --name
                         --cluster-name
                         --resource-group
                         [--application-parameters --parameters]
                         [--application-type-version --version]
                         [--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-nodes --maximum-nodes]
                         [--max-porcent-unhealthy-apps --max-unhealthy-apps]
                         [--max-porcent-unhealthy-partitions --max-unhealthy-parts]
                         [--max-porcent-unhealthy-replicas --max-unhealthy-reps]
                         [--max-porcent-unhealthy-services --max-unhealthy-servs]
                         [--min-nodes --minimum-nodes]
                         [--rep-check-timeout --replica-check-timeout --upgrade-replica-set-check-timeout]
                         [--service-type-health-policy-map --service-type-policy]
                         [--ud-timeout --upgrade-domain-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>.

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

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

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

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

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

Свойство Значение
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-nodes --maximum-nodes

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

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

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

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

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

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

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

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

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

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

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

--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"}. Например: @{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }.

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

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

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