Работа с экземплярами политик

Данный раздел описывает процесс работы с экземплярами политик автоматизации в системе. Работа осуществляется в разделе Автоматизация → Политики веб-интерфейса системы.

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

О политиках

Политика — это элемент схемы автоматизации, определяющий условия запуска действий над объектами системы и сами эти действия. В интерфейсе системы можно настроить экземпляры политик — конфигурации запусков политик, различающиеся способами, параметрами и расписанием запуска.

Перед настройкой экземпляров политик необходимо описать условия и действия для этих политик в схеме автоматизации.

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

Интерфейс раздела

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

  • Кнопка Добавить позволяет добавить новый экземпляр политики.

  • Поле Поиск предназначено для быстрого поиска экземпляров политик по наименованию, а также идентификаторам схемы автоматизации и политики.

Под панелью инструментов расположена область дополнительных действий. В этой области доступны следующие кнопки:

  • Добавить фильтр (plus) позволяет отфильтровать экземпляры политик по выбранным полям и значениям.

  • Сохраненные фильтры (save) позволяет создать шаблоны фильтров и выполнить поиск по ним.

В рабочей области отображается таблица имеющихся экземпляров политик. Таблица содержит следующие столбцы:

  • Наименование — название экземпляра политики.

  • Идентификатор — системный идентификатор экземпляра политики. Генерируется автоматически.

  • Статус синхронизации — статус обработки экземпляра сервисом автоматизации:

    • Успешно создана;

    • Успешно обновлена;

    • Ошибка создания;

    • Ошибка обновления;

    • Ошибка удаления.

  • Статус — текущий статус экземпляра политики:

    • Включена;

    • Выключена.

  • Дата создания — дата и время создания экземпляра политики.

  • Создал — идентификатор пользователя, создавшего экземпляр политики.

  • Идентификатор схемы автоматизации — идентификатор схемы автоматизации, в которой определена политика.

  • Идентификатор политики — идентификатор политики, для которой определен экземпляр.

  • Организация — тенант, к которому относится экземпляр политики.

    Действия при запуске экземпляра политики будут применены к объектам только того тенанта, к которому относится этот экземпляр.
  • Тип запуска — тип запуска политики:

    • Вручную;

    • По расписанию.

  • Периодичность запуска — периодичность запуска в виде cron-выражения.

    Чтобы составить cron-выражение, можно воспользоваться генератором, например, nettools.club/ru/crontools.

При работе с таблицей экземпляров политик доступны следующие операции:

  • Поиск экземпляров по полям Наименование, Идентификатор, Идентификатор схемы автоматизации, Идентификатор политики.

  • Фильтрация экземпляров по полям Наименование, Идентификатор, Статус, Идентификатор схемы автоматизации, Идентификатор политики и Тип запуска.

  • Сортировка экземпляров по полям Наименование, Идентификатор, Статус, Идентификатор схемы автоматизации, Идентификатор политики и Тип запуска.

  • Настройка отображения таблицы.

При выборе конкретного экземпляра в правой части рабочей области отображается его карточка с детальной информацией. Карточка экземпляра содержит следующие вкладки:

Работа с экземпляром политики

Доступные действия над экземпляром политики:

Создание экземпляра политики

Чтобы создать экземпляр политики:

  1. Перейдите в раздел Автоматизация → Политики. Система отобразит сведения об имеющихся экземплярах политик.

  2. Нажмите на кнопку Добавить. Отобразится окно создания экземпляра политики.

  3. Если требуется, введите человекочитаемое наименование экземпляра политики.

  4. Введите идентификатор схемы автоматизации, в которой определена необходимая политика.

  5. Введите идентификатор политики, для которой необходимо создать экземпляр.

  6. Выберите из выпадающего списка Идентификатор организации тенант, для объектов которого необходимо запускать политику.

  7. Выберите из выпадающего списка тип запуска экземпляра политики:

    • По расписанию;

    • Вручную.

  8. Если выбран тип запуска По расписанию, задайте периодичность запуска в виде cron-выражения.

    Чтобы составить cron-выражение, можно воспользоваться генератором, например, nettools.club/ru/crontools.
  9. Добавьте в таблицу Переменные идентификаторы и значения переменных, которые будут доступны в условиях политики посредством синтаксиса {context:<variable_id>}.

  10. Выберите из выпадающего списка статус экземпляра политики:

    • Включена;

    • Выключена.

  11. Нажмите на кнопку Добавить.

Если создание экземпляра политики завершится успешно, система отобразит соответствующее уведомление, и в поле Статус синхронизации с сервисом политик карточки нового экземпляра политики отобразится значение Успешно создана.

Если во время создания произойдет ошибка, то в поле Статус синхронизации с сервисом политик карточки нового экземпляра политики отобразится значение Ошибка создания, а в поле Детали — описание этой ошибки.

Просмотр экземпляра политики

Чтобы просмотреть экземпляр политики:

  1. Перейдите в раздел Автоматизация → Политики. Система отобразит сведения об имеющихся экземплярах политик.

  2. Нажмите на строку экземпляра в списке. Система отобразит в правой части экрана карточку этого экземпляра с подробной информацией о нем.

В верхней части карточки отображается название экземпляра политики. Справа от названия расположена кнопка more vertical, при нажатии на которую открывается выпадающее меню с действиями, доступными для выбранного экземпляра.

Карточка экземпляра политики содержит следующие вкладки:

Вкладка Параметры настройки

На вкладке Параметры настройки отображаются свойства и значения настроек экземпляра политики:

  • Идентификатор — системный идентификатор экземпляра политики.

  • Наименование — название экземпляра политики.

  • Идентификатор схемы автоматизации — идентификатор схемы автоматизации, в которой определена политика.

  • Идентификатор политики — идентификатор политики, для которой определен экземпляр.

  • Идентификатор организации — идентификатор тенанта, к которому относится экземпляр политики.

    Действия при запуске экземпляра политики будут применены к объектам только того тенанта, к которому относится этот экземпляр.
  • Статус — текущий статус экземпляра политики:

    • Включена;

    • Выключена.

  • Тип запуска — тип запуска политики:

    • Вручную;

    • По расписанию.

  • Периодичность запуска — периодичность запуска в виде cron-выражения.

    Чтобы составить cron-выражение, можно воспользоваться генератором, например, nettools.club/ru/crontools.
  • Переменные — идентификаторы и значения переменных, которые доступны в условиях политики посредством синтаксиса {context:<variable_id>}. Таблица содержит следующие столбцы:

    • Идентификатор — идентификатор переменной, который следует подставить вместо <variable_id> для обращения к ней.

    • Значение — значение переменной.

    Вы можете добавить переменные в таблицу. Для этого:

    1. Нажмите на кнопку plus square рядом с таблицей.

    2. Введите идентификатор переменной.

    3. Введите значение переменной.

    4. Нажмите на кнопку Сохранить (check). Система добавит переменную в таблицу и отобразит соответствующее уведомление.

  • Кнопка Запустить (play) позволяет запустить экземпляр политики вручную.

  • Статус синхронизации с сервисом политик — статус синхронизации экземпляра политики с сервисом автоматизации:

    • Успешно создана;

    • Успешно обновлена;

    • Ошибка создания;

    • Ошибка обновления;

    • Ошибка удаления.

  • Детали — описание ошибки синхронизации, если она произошла.

Вкладка История запусков

На вкладке История запусков отображается таблица Запуски. В этой таблице можно просмотреть время начала, окончания и статусы завершения запусков экземпляра политики.

Таблица содержит следующие столбцы:

  • Время начала — дата и время начала запуска экземпляра политики.

  • Время окончания — дата и время окончания запуска экземпляра политики.

  • Статус — статус запуска экземпляра политики:

    • Запущена — экземпляр запущен, но еще не завершен. Статус будет обновлен по окончании запуска.

    • Завершена — запуск завершен, информация о запуске доступна в поле Результат.

    • Прервана — запуск прерван, информация об ошибке доступна в поле Результат.

    • Ошибка — экземпляр не удалось запустить, информация об ошибке доступна в поле Результат.

    • Не определен — не удалось получить статус и результат запуска экземпляра политики.

  • Результат — текстовое описание результата запуска политики, включая описание ошибок, если они возникли.

Чтобы просмотреть детали запуска:

  1. Нажмите на кнопку more vertical напротив запуска, информацию о котором вы хотите просмотреть.

  2. Нажмите на кнопку Открыть (open). Система откроет карточку запуска.

    Вы также можете открыть список запусков политик, где выбран нужный запуск, в новой вкладке. Для этого нажмите на кнопку Открыть в новой вкладке (open new).

Вкладка История изменений

На вкладке История изменений отображается виджет, отображающий список событий аудита, связанных с экземпляром политики.

Вы можете ознакомиться с описанием виджета истории изменений в разделе Описания интерфейса.

Запуск экземпляра политики

Запуск экземпляра политики выполняется:

  • по расписанию, если задан тип запуска По расписанию и cron-выражение, определяющее это расписание;

  • вручную с помощью кнопки Запустить (play) на вкладке Параметры настройки карточки экземпляра политики.

    Вы можете запустить вручную в том числе экземпляр политики с типом запуска По расписанию.

При запуске экземпляра политики происходит обновление таблицы Запуски в карточке экземпляра:

  1. При запуске экземпляра политики в таблицу Запуски добавляется новая запись:

    • Время начала — дата и время запуска экземпляра политики.

    • Статус — Запущена.

  2. При завершении запуска экземпляра политики запись о нем в таблице Запуски обновляется:

    • Время окончания — дата и время окончания запуска экземпляра политики.

    • Статус — статус запуска политики: например, Завершена или Ошибка.

    • Результат — текстовое описание результата запуска политики, включая описание ошибок, если они возникли.

Изменение экземпляра политики

Чтобы изменить экземпляр политики:

  1. Перейдите в раздел Автоматизация → Политики. Система отобразит сведения об имеющихся экземплярах политик.

  2. Нажмите на строку экземпляра в списке. Система отобразит в правой части экрана карточку этого экземпляра с подробной информацией о нем.

  3. Выберите опцию Изменить в выпадающем меню кнопки действий more vertical в верхней части карточки. Отобразится окно редактирования экземпляра политики.

    При изменении экземпляра политики поля Идентификатор схемы автоматизации, Идентификатор политики и Идентификатор организации доступны только для чтения.
  4. Внесите изменения в требуемые поля экземпляра.

  5. Нажмите на кнопку Сохранить.

Если изменение экземпляра политики завершится успешно, система отобразит соответствующее уведомление, и в поле Статус синхронизации с сервисом политик карточки экземпляра политики отобразится значение Успешно обновлена.

Если во время изменения произойдет ошибка, то в поле Статус синхронизации с сервисом политик карточки экземпляра политики отобразится значение Ошибка обновления, а в поле Детали — описание этой ошибки.

Вы также можете редактировать поля экземпляра политики из его карточки. Для этого:

  1. Нажмите на строку экземпляра.

  2. Нажмите на кнопку edit для редактирования необходимого поля.

  3. Внесите изменения в поле экземпляра.

  4. Нажмите на кнопку Сохранить (check).

Синхронизация экземпляра политики с сервисом автоматизации

Вы можете вручную синхронизировать экземпляр политики с сервисом автоматизации, например, в случае сбоя системы, из-за которого произошла ошибка синхронизации.

Для синхронизации выполните следующие действия:

  1. Перейдите в раздел Автоматизация → Политики. Система отобразит сведения об имеющихся экземплярах политик.

  2. Нажмите на строку экземпляра в списке. Система отобразит в правой части экрана карточку этого экземпляра с подробной информацией о нем.

  3. Выберите опцию Синхронизировать в выпадающем меню кнопки действий more vertical в верхней части карточки.

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

Удаление экземпляра политики

Чтобы удалить экземпляр политики:

  1. Перейдите в раздел Автоматизация → Политики. Система отобразит сведения об имеющихся экземплярах политик.

  2. Нажмите на строку экземпляра в списке. Система отобразит в правой части экрана карточку этого экземпляра с подробной информацией о нем.

  3. Выберите опцию Удалить в выпадающем меню кнопки действий more vertical в верхней части карточки.

Если удаление экземпляра политики завершится успешно, система отобразит соответствующее уведомление, и экземпляр будет удален из списка раздела.

Если во время удаления произойдет ошибка, то экземпляр не будет удален из списка. В поле Статус синхронизации с сервисом политик карточки экземпляра отобразится значение Ошибка удаления, а в поле Детали — описание этой ошибки.

Была ли полезна эта страница?

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