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
                         [--acquire-policy-token]
                         [--application-parameters --parameters]
                         [--change-reference]
                         [--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>.

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

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

--application-parameters --parameters

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

--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

--max-nodes --maximum-nodes

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

--min-nodes --minimum-nodes

Укажите минимальное количество узлов, в которых служба 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
                         [--acquire-policy-token]
                         [--change-reference]

Примеры

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

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

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

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy 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

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

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

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

az sf application update

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

az sf application update --application-name --name
                         --cluster-name
                         --resource-group
                         [--acquire-policy-token]
                         [--application-parameters --parameters]
                         [--application-type-version --version]
                         [--change-reference]
                         [--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-unhealthy-apps]
                         [--max-unhealthy-parts]
                         [--max-unhealthy-reps]
                         [--max-unhealthy-servs]
                         [--min-nodes --minimum-nodes]
                         [--rep-check-timeout --replica-check-timeout]
                         [--service-type-health-policy-map]
                         [--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 --replica-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>.

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

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

--application-parameters --parameters

--application-type-version --version

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

--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

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

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

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

--failure-action

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

Свойство	Значение
Группа параметров:	Upgrade description Arguments
Допустимые значения:	Manual, Rollback

--force-restart

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

Свойство	Значение
Default value:	False
Допустимые значения:	false, true

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

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

Свойство	Значение
Группа параметров:	Upgrade description Arguments

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

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

Свойство	Значение
Группа параметров:	Upgrade description Arguments

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

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

Свойство	Значение
Группа параметров:	Upgrade description Arguments

--max-nodes --maximum-nodes

--max-unhealthy-apps

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

Свойство	Значение
Группа параметров:	Upgrade description Arguments

--max-unhealthy-parts

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

Свойство	Значение
Группа параметров:	Upgrade description Arguments

--max-unhealthy-reps

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

Свойство	Значение
Группа параметров:	Upgrade description Arguments

--max-unhealthy-servs

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

Свойство	Значение
Группа параметров:	Upgrade description Arguments

--min-nodes --minimum-nodes

--rep-check-timeout --replica-check-timeout

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

Свойство	Значение
Группа параметров:	Upgrade description Arguments

--service-type-health-policy-map

Укажите карту политики работоспособности для различных типов служб в виде хэш-таблицы в следующем формате: {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Например: @{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }.

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

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

Свойство	Значение
Группа параметров:	Upgrade description Arguments

--upgrade-timeout

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

Свойство	Значение
Группа параметров:	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

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

Обратная связь

Были ли сведения на этой странице полезными?