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

Управление приложением Azure Service Fabric с помощью Интерфейса командной строки Azure Service Fabric (sfctl)

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

Предпосылки

Обзор

Чтобы развернуть новое приложение, выполните следующие действия.

  1. Отправьте пакет приложения в хранилище образов Service Fabric.
  2. Предоставление типа приложения.
  3. Удалите содержимое хранилища изображений.
  4. Укажите и создайте приложение.
  5. Укажите и создайте сервисы.

Чтобы удалить существующее приложение, выполните следующие действия.

  1. Удалите приложение.
  2. Отменить предоставление связанного типа приложения.

Развертывание нового приложения

Чтобы развернуть новое приложение, выполните следующие задачи:

Отправка нового пакета приложения в хранилище образов

Перед созданием приложения отправьте пакет приложения в хранилище образов Service Fabric.

Например, если пакет приложения находится в каталоге app_package_dir , используйте следующие команды для отправки каталога:

sfctl application upload --path ~/app_package_dir

Для больших пакетов приложений можно указать --show-progress параметр для отображения хода отправки.

Настройка типа приложения

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

sfctl application provision --application-type-build-path app_package_dir

Значением application-type-build-path является имя каталога, в котором вы отправили пакет приложения.

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

Рекомендуется удалить пакет приложения после успешной регистрации приложения. Удаление пакетов приложений из хранилища образов освобождает системные ресурсы. Сохранение неиспользуемых пакетов приложений использует дисковое хранилище и приводит к проблемам с производительностью приложений.

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

sfctl store delete --content-path app_package_dir

content-path должно быть именем каталога, который вы отправили при создании приложения.

Создание приложения из типа приложения

После подготовки приложения используйте следующую команду для имени и создания приложения:

sfctl application create --app-name fabric:/TestApp --app-type TestAppType --app-version 1.0

app-name — это имя, которое вы хотите использовать для экземпляра приложения. Дополнительные параметры можно получить из ранее подготовленного манифеста приложения.

Имя приложения должно начинаться с префикса fabric:/.

Создание служб для нового приложения

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

sfctl service create --app-id TestApp --name fabric:/TestApp/TestSvc --service-type TestServiceType \
--stateless --instance-count 1 --singleton-scheme

Проверка развертывания и работоспособности приложений

Чтобы убедиться, что все в порядке, используйте следующие команды проверки системы:

sfctl application list
sfctl service list --application-id TestApp

Чтобы убедиться, что служба работоспособна, используйте аналогичные команды для получения работоспособности как службы, так и приложения:

sfctl application health --application-id TestApp
sfctl service health --service-id TestApp/TestSvc

Здоровые HealthState службы и приложения имеют значение Ok.

Удаление существующего приложения

Чтобы удалить приложение, выполните следующие задачи:

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

Чтобы удалить приложение, используйте следующую команду:

sfctl application delete --application-id TestEdApp

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

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

sfctl application unprovision --application-type-name TestAppType --application-type-version 1.0

Имя типа и версия типа должны соответствовать имени и версии в ранее подготовленном манифесте приложения.

Обновление приложения

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

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

sfctl application upload --path ~/app_package_dir_2
sfctl application provision --application-type-build-path app_package_dir_2
sfctl store delete --content-path app_package_dir_2

Затем рекомендуется выполнить отслеживаемое автоматическое обновление, запустите обновление, выполнив следующую команду:

sfctl application upgrade --app-id TestApp --app-version 2.0.0 --parameters "{\"test\":\"value\"}" --mode Monitored

Модернизации заменяют существующие параметры заданным набором. При необходимости параметры приложения должны передаваться в качестве аргументов в команду обновления. Параметры приложения должны быть закодированы как объект JSON.

Чтобы получить все указанные ранее параметры, можно использовать sfctl application info команду.

При выполнении обновления приложения состояние можно получить с помощью sfctl application upgrade-status команды.

Наконец, если обновление ещё не завершено и необходимо отменить его, можно использовать sfctl application upgrade-rollback для отката обновления.

Дальнейшие действия

  • Last updated on