IKuznetsov: Новая страница: «Используйте удаленное управление конфигурацией, чтобы организовать несколько ЕдиныхАг...»

2025-09-04T02:25:12Z

Новая страница: «Используйте удаленное управление конфигурацией, чтобы организовать несколько ЕдиныхАг...»

Новая страница

Используйте удаленное управление конфигурацией, чтобы организовать несколько ЕдиныхАгентов или АктивныхШлюзов с помощью одной команды вместо того, чтобы выполнять одни и те же действия по одному (будь то во время установки, путем редактирования файлов конфигурации или с помощью инструмента командной строки <code>oneagentctl</code>).

При использовании удаленного управления конфигурацией действие по-прежнему выполняется на соответствующих хостах, но вы запускаете его и управляете им централизованно из раздела '''Состояние развертывания''' в веб-интерфейсе Ключ-АСТРОМ или через '''API''' Ключ-АСТРОМ.
{| class="wikitable"
|Прежде чем начать, ознакомьтесь с '''возможностями''' и '''ограничениями''', чтобы убедиться, что удаленное управление конфигурацией подходит для ваших потребностей и развертывания.
|}

== Возможности ==
Благодаря удаленному управлению конфигурацией вы можете с помощью одной команды выполнить любое из следующих действий на нескольких ЕдиныхАгентах или АктивныхШлюзах, которые соответствуют требованиям версии.

=== ЕдиныйАгент ===
{| class="wikitable"
!Действие
!Требуемая версия Ключ-АСТРОМ
!Требуемая версия ЕдиногоАгента
|-
|Назначение группы хостов
|1.252+
|1.237+
|-
|Назначение сетевой зоны
|1.252+
|1.237+
|-
|Назначение тега
|1.268+
|1.263+
|-
|Назначение права собственности
|1.268+
|1.263+
|}

=== АктивныйШлюз ===
{| class="wikitable"
!Действие
!Требуемая версия Ключ-АСТРОМ
!Требуемая версия АктивногоШлюза
|-
|Назначение группы АктивногоШлюза
|1.252+
|1.237+
|-
|Назначение сетевой зоны
|1.252+
|1.237+
|}
Удалённое управление конфигурацией работает для ЕдиныхАгентов в режимах '''Full-Stack''' и '''Infrastructure Monitoring''', а также для хостовых АктивныхШлюзов. ЕдиныйАгент и АктивныйШлюз должны взаимодействовать с вашей средой.

== Ограничения ==
Удаленное управление конфигурацией '''НЕ''' работает с:

* ЕдинымАгентом развернутом с помощью Ключ-АСТРОМ Operator
* ЕдинымАгентом только для приложений
* ЕдинымАгентом на Solaris
* Контейнерным АктивнымШлюзом

== Разрешения ==
Мы рекомендуем ограничить количество пользователей, которым разрешено использовать удалённое управление конфигурацией. Несколько пользователей, выполняющих настройку одновременно, могут не знать о действиях друг друга. Это относится как к веб-интерфейсу, так и к '''API'''. Разрешения '''IAM''' обеспечивают очень детальный контроль, позволяя избежать конфликтов между пользователями.

=== IAM-разрешения ===
Пользователи, осуществляющие удаленное управление конфигурацией, должны принадлежать к группе, привязанной к политике со следующими разрешениями IAM:

* <code>deployment:oneagents.network-zones:write</code>
* <code>deployment:oneagents.host-groups:write</code>
* <code>deployment:oneagents.host-tags:write</code>
* <code>deployment:oneagents.host-properties:write</code>

* <code>deployment:activegates.network-zones:write</code>
* <code>deployment:activegates.groups:write</code>

Используя разрешения '''IAM''', вы можете ограничить действия пользователя одним действием по настройке, например, изменить только назначение группы хостов ЕдиногоАгента.

=== Токены доступа ===
Для внесения изменений в конфигурацию с помощью '''API''' Ключ-АСТРОМ вам необходим [[токен доступа]] со следующими областями действия:

* '''Запись ЕдиныхАгентов''' (<code>oneAgents.write</code>) — для проверки полезной нагрузки, создания предварительного просмотра и запуска изменения конфигурации для ЕдиныхАгентов
* '''Запись АктивныхШлюзов''' (<code>activeGates.write</code>) — для проверки полезной нагрузки, создания предварительного просмотра и запуска изменения конфигурации для АктивныхШлюзов

== Операции веб-интерфейса ==
Рабочий процесс удаленной настройки веб-интерфейса Ключ-АСТРОМ аналогичен для ЕдиныхАгентов и АктивныхШлюзов.

=== Настроить ЕдиныеАгенты ===
Вы можете назначить следующее нескольким ЕдинымАгентам:

* Принимающая группа
* Сетевая зона
* Теги
* Характеристики

Чтобы обновить несколько ЕдиныхАгентов для любого из вышеперечисленных

# Перейдите в раздел '''Состояние развертывания > ЕдиныеАгенты'''.
# Отфильтруйте и выберите ЕдиныеАгенты, которые хотите настроить. Вы можете использовать поле выбора в заголовке таблицы, чтобы выбрать все отфильтрованные ЕдиныеАгенты, или выбрать их по отдельности. После выбора ЕдиныхАгентов в нижней части страницы появится панель редактирования.
# Выберите изменение конфигурации, которое вы хотите выполнить.
#* изменить группу хостов
#* изменить сетевую зону
#* изменить теги хоста
#* изменить свойства хоста
# Выберите действие '''Выполнить'''. <br />Это запустит мастер удалённого управления конфигурацией для внесения изменений в конфигурацию выбранных ЕдиныеАгенты. Изменения не будут сохранены, пока вы не нажмёте кнопку '''Применить изменения''' и не подтвердите все необходимые перезагрузки. До этого вы сможете изменить или отменить действие.
# Укажите, какие изменения вы хотите применить ко всем выбранным ЕдинымАгентам. В зависимости от выбранного действия вы можете:
#* Добавить или удалить назначение группы хостов
#* Добавить или удалить назначение сетевой зоны
#* Добавить или удалить теги хоста
#* Добавить или удалить свойства хоста
# Выберите '''Далее'''.
# Проверьте внесенные изменения.
# Выберите '''Применить изменения'''.
# Выберите '''Продолжить''', чтобы начать массовое действие.
#* ЕдиныйАгент будет перезапущен, чтобы применить изменения в назначениях зон сети, назначениях групп хостов и <code>Ключ-АСТРОМ версии 1.308+</code> теги и свойства.
#* При изменении назначения группы хостов необходимо вручную перезапустить процессы, внедрённые ЕдиныеАгенты. При изменении назначения сетевой зоны перезапуск внедрённых процессов не требуется.
# Во время выполнения массового действия строка состояния в верхней части страницы состояния развертывания информирует о ходе выполнения массового действия. Вы не сможете начать другое массовое действие, пока текущее не завершится.

Изменения сетевых зон и групп хостов могут вступить в силу в течение 10 минут. Удаление свойств хоста и тегов может занять до семи часов.

=== Настроить АктивныеШлюз ===
Нескольким АктивнымШлюзам можно назначить следующее:

* Группа АктивногоШлюза
* Сетевая зона

Чтобы обновить несколько АктивныхШлюзов для любого из вышеперечисленных

# Перейдите в раздел '''Состояние развертывания > АктивныеШлюзы'''.
# Отфильтруйте и выберите устройства АктивногоШлюза, которые вы хотите настроить. Вы можете использовать поле выбора в заголовке таблицы, чтобы выбрать все отфильтрованные устройства АктивногоШлюза, или выбрать каждое устройство по отдельности.
# После выбора АктивногоШлюза в нижней части страницы появится панель редактирования.
# Выберите изменение конфигурации, которое вы хотите выполнить.
#* изменить группу АктивногоШлюза
#* изменить сетевую зону
# Выберите конфигурацию, которую вы хотите выполнить, а затем выберите '''Выполнить действие'''. <br />Это запустит мастер удалённого управления конфигурацией для внесения изменений в конфигурацию выбранных вами устройств АктивногоШлюза. Изменения не будут сохранены, пока вы не нажмёте кнопку '''Применить изменения''' и не подтвердите все необходимые перезагрузки. До этого вы сможете изменить или отменить действие.
# Укажите, какие изменения вы хотите применить ко всем выбранным АктивнымШлюзам. В зависимости от выбранного действия вы можете:
#* Добавить или удалить назначение группы АктивногоШлюза
#* Добавить или удалить назначение сетевой зоны
# Выберите '''Далее'''.
# Проверьте внесенные изменения.
# Выберите '''Применить изменения''', чтобы запустить массовое действие.
# Во время выполнения массового действия панель в верхней части страницы состояния развертывания информирует о ходе выполнения. Не запускайте другое массовое действие, пока текущее не завершится. Перезапуск АктивногоШлюза не требуется для применения изменений.

Для вступления изменений в силу может потребоваться до '''10 минут'''.

== Операции API ==
'''API''' Ключ-АСТРОМ имеет набор конечных точек, которые позволяют управлять конфигурацией удаленно, безопасным и контролируемым образом.

=== Пример управления конфигурацией ЕдиногоАгента ===
Ниже приведен пример назначения нескольких ЕдиныхАгентов группе хостов с помощью '''API''' Ключ-АСТРОМ.

=== Фильтр ЕдиныхАгентов для настройки ===
Используйте [[ЕдиныйАгент на хосте|ЕдиныйАгент на конечной точке '''API''' хоста]], чтобы указать список ЕдиныхАгентов, для которых вы хотите изменить назначение хоста.

Вы можете использовать любое из доступных свойств ЕдиногоАгента в качестве критерия фильтрации. Например, чтобы получить список всех ЕдиныхАгентов, установленных в '''Windows''', выполните следующий запрос.
{| class="wikitable"
|curl --request GET \

--url '<nowiki>https://myenvironment.com/api/v2/oneagents?osType=WINDOWS</nowiki> \

--header 'Authorization: Api-Token <token>'
|}

=== Создать полезную нагрузку ===
В полезной нагрузке перечислены ЕдиныеАгенты, для которых вы выполните массовое действие, и подробности самого действия. Пример полезной нагрузки ниже приведёт к изменению назначения группы хостов <code>some-host-group</code> для трёх перечисленных ЕдиныхАгентов, идентифицированных по их идентификаторам хостов.
{| class="wikitable"
|{

"entities": ["HOST-0000000000000001", "HOST-0000000000000002", "HOST-0000000000000003"],

"operations": [

{

"operation": "SET",

"attribute": "hostGroup",

"value": "some-host-group"

}

]

}
|}

=== Проверить полезную нагрузку ===
Перед запуском задания конфигурации вы можете проверить созданную вами полезную нагрузку, выполнив следующий запрос. В приведённом ниже примере полезная нагрузка передаётся в запрос в виде файла <code>payload.json</code>.
{| class="wikitable"
|curl --request POST \

--url <nowiki>https://myenvironment.com/api/v2/oneagents/remoteConfigurationManagement/validator</nowiki> \

--header 'Authorization: Api-Token <token>' \

--header 'Content-Type: application/json' \

--data @payload.json
|}
Допустимая полезная нагрузка возвращает ответ <code>HTTP 204</code>. Недопустимая полезная нагрузка возвращает ответ с подробностями нарушения.

=== Создать предварительный просмотр ===
Вы можете создать предварительный просмотр перед внесением фактических изменений в конфигурацию. Предварительный просмотр предоставляет информацию о том, сколько объектов в настоящее время настроено так, как описано в полезной нагрузке, и сколько будет настроено таким образом после отправки запроса на реконфигурацию.
{| class="wikitable"
|Этап предварительного просмотра не поддерживается для тегов и свойств.
|}
Чтобы запустить предварительный просмотр, выполните следующий запрос:
{| class="wikitable"
|curl --request POST \

--url <nowiki>https://myenvironment.com/api/v2/oneagents/remoteConfigurationManagement/preview</nowiki> \

--header 'Authorization: Api-Token <token>' \

--header 'Content-Type: application/json' \

--data @payload.json
|}
Ответ содержит информацию о том, сколько ЕдиныхАгентов назначено группе хостов и сколько будет назначено группе хостов после завершения настройки.
{| class="wikitable"
|{

"previews": [

{

"operation": "SET",

"attribute": "hostgroup",

"existingEntitiesCount": 3,

"targetEntitiesCount": 6

}

]

}
|}

=== Выполнить массовую настройку ===
Чтобы запустить массовую настройку, выполните следующий запрос:
{| class="wikitable"
|curl --request POST \

--url <nowiki>https://myenvironment.com/api/v2/oneagents/remoteConfigurationManagement</nowiki> \

--header 'Authorization: Api-Token <token>' \

--header 'Content-Type: application/json' \

--data @payload.json
|}
Успешный запрос возвращает ответ <code>HTTP 201</code>. Это означает, что задание по настройке запущено. Изменение применяется не мгновенно. Каждый ЕдиныйАгент сначала выполняет настройку самостоятельно, а затем отправляет информацию в вашу среду, после чего кластер Ключ-АСТРОМ обновляет назначение группы хостов. Изменение может отразиться в вашей среде в течение '''10 минут'''.

Вы можете проверить изменение, запустив ЕдиныйАгент на запросе '''API''' хоста, отфильтрованном по группе хостов, в которую вы только что назначили свои хосты.
{| class="wikitable"
|curl --request GET \

--url '<nowiki>https://myenvironment.com/api/v2/oneagents?hostGroupName=some-host-group</nowiki> \

--header 'Authorization: Api-Token <token>'
|}
Ответ должен содержать три идентификатора хоста, которые вы добавили в задание по настройке.

Удаленное управление конфигурацией ЕдиногоАгента и АктивногоШлюза - История изменений

IKuznetsov: Новая страница: «Используйте удаленное управление конфигурацией, чтобы организовать несколько ЕдиныхАг...»