Примечания к выпуску Community.Hrobot

Краткое описание выпуска

Выпуск с обновлениями для обслуживания.

Исправления ошибок

• Модули storagebox* — улучшена отчётность об ошибках, чтобы в сообщении всегда указывались метод и URL неудачного запроса (https://github.com/ansible-collections/community.hrobot/pull/190).

Краткое описание выпуска

Выпуск с обновлениями для обслуживания.

Исправления ошибок

• Удалён ненужный код совместимости с Python 2 (https://github.com/ansible-collections/community.hrobot/pull/187).

Краткое описание выпуска

Функциональный выпуск.

Незначительные изменения

• storagebox_subaccount — при поиске существующих учётных записей по имени пользователя выполняется фильтрация по имени пользователя (https://github.com/ansible-collections/community.hrobot/pull/182).
• storagebox_subaccount — для обновления домашнего каталога подучётной записи используется новое действие change_home_directory вместо ныне устаревшего способа с действием update_access_settings (https://github.com/ansible-collections/community.hrobot/pull/181).

Устаревшие возможности

• storagebox_subaccount — password_mode=set-to-random объявлен устаревшим и будет удалён в community.hrobot 3.0.0. Новый API Hetzner в любом случае его не поддерживает; его можно использовать только с устаревшим API (https://github.com/ansible-collections/community.hrobot/pull/183).

Краткое описание выпуска

Выпуск с обновлениями для обслуживания.

Исправления ошибок

• В большем числе мест избегается использование ansible.module_utils.six, чтобы исключить предупреждения об устаревании в ansible-core 2.20 (https://github.com/ansible-collections/community.hrobot/pull/179).

Краткое описание выпуска

Выпуск с обновлениями для обслуживания, в котором объявлена устаревшей поддержка старого API storage box.

Устаревшие возможности

• Модули storagebox* — членство в группе действий community.hrobot.robot (группа значений по умолчанию для модулей) объявлено устаревшим; модули будут исключены из этой группы в community.hrobot 3.0.0. Вместо неё используйте community.hrobot.api (https://github.com/ansible-collections/community.hrobot/pull/178).
• Модули storagebox* — начиная с community.hrobot 3.0.0 параметр hetzner_token станет обязательным для этих модулей (https://github.com/ansible-collections/community.hrobot/pull/178).
• Модули storagebox* — параметры hetzner_user и hetzner_pass для этих модулей объявлены устаревшими; их поддержка будет удалена в community.hrobot 3.0.0. Вместо них используйте hetzner_token (https://github.com/ansible-collections/community.hrobot/pull/178).
• storagebox_info — возвращаемые значения storageboxes[].login, storageboxes[].disk_quota, storageboxes[].disk_usage, storageboxes[].disk_usage_data, storageboxes[].disk_usage_snapshot, storageboxes[].webdav, storageboxes[].samba, storageboxes[].ssh, storageboxes[].external_reachability и storageboxes[].zfs объявлены устаревшими и будут удалены из community.routeros. Ознакомьтесь с документацией, чтобы узнать их новые имена в соответствии с новым API (https://github.com/ansible-collections/community.hrobot/pull/178).
• storagebox_snapshot_info — возвращаемые значения snapshots[].timestamp, snapshots[].size, snapshots[].filesystem_size, snapshots[].automatic и snapshots[].comment объявлены устаревшими и будут удалены из community.routeros. Ознакомьтесь с документацией, чтобы узнать их новые имена в соответствии с новым API (https://github.com/ansible-collections/community.hrobot/pull/178).
• storagebox_snapshot_plan — возвращаемое значение plans[].month объявлено устаревшим, поскольку в новом API оно возвращает только null и не может быть установлено в любое другое значение (https://github.com/ansible-collections/community.hrobot/pull/178).
• storagebox_snapshot_plan_info — возвращаемое значение plans[].month объявлено устаревшим, поскольку в новом API оно возвращает только null и не может быть установлено в любое другое значение (https://github.com/ansible-collections/community.hrobot/pull/178).
• storagebox_subaccount — возвращаемые значения subaccount.homedirectory, subaccount.samba, subaccount.ssh, subaccount.external_reachability, subaccount.webdav, subaccount.readonly, subaccount.createtime и subaccount.comment объявлены устаревшими и будут удалены из community.routeros. Ознакомьтесь с документацией, чтобы узнать их новые имена в соответствии с новым API (https://github.com/ansible-collections/community.hrobot/pull/178).
• storagebox_subaccount_info — возвращаемые значения subaccounts[].accountid, subaccounts[].homedirectory, subaccounts[].samba, subaccounts[].ssh, subaccounts[].external_reachability, subaccounts[].webdav, subaccounts[].readonly, subaccounts[].createtime и subaccounts[].comment объявлены устаревшими и будут удалены из community.routeros. Ознакомьтесь с документацией, чтобы узнать их новые имена в соответствии с новым API (https://github.com/ansible-collections/community.hrobot/pull/178).

Краткое описание выпуска

Выпуск с обновлениями для обслуживания.

Исправления ошибок

• Исключено использование ansible.module_utils.six, чтобы избежать предупреждений об устаревании в ansible-core 2.20 (https://github.com/ansible-collections/community.hrobot/pull/177).

Краткое описание выпуска

Выпуск с обновлениями для обслуживания.

Исправления ошибок

• Исключено использование устаревших функций в ansible-core 2.20 (https://github.com/ansible-collections/community.hrobot/pull/174).

Краткое описание выпуска

Функциональный выпуск с исправлениями ошибок.

В этом выпуске добавлена поддержка нового API Hetzner для модулей storage box. Для работы с новым API необходимо использовать hetzner_token вместо hetzner_user/hetzner_password. Обратите внимание: старый API будет выведен из эксплуатации 30 июля 2025 года; после этого модули перестанут работать, если вы не укажете hetzner_token и не прекратите передавать hetzner_user/hetzner_password.

Незначительные изменения

• Добавлена новая группа действий (группа значений по умолчанию для модулей) community.hrobot.api, включающая все модули с поддержкой нового API Hetzner. Сейчас в неё входит только часть модулей storage box; на данный момент они поддерживают как группу действий community.hrobot.robot, так и новую группу community.hrobot.api, а в конечном итоге перестанут поддерживать группу действий community.hrobot.robot после того, как Hetzner удалит Robot API для storage box (https://github.com/ansible-collections/community.hrobot/pull/166, https://github.com/ansible-collections/community.hrobot/pull/167, https://github.com/ansible-collections/community.hrobot/pull/168, https://github.com/ansible-collections/community.hrobot/pull/169).
• storagebox — добавлена поддержка нового API Hetzner (https://github.com/ansible-collections/community.hrobot/pull/166).
• storagebox_info — добавлена поддержка нового API Hetzner (https://github.com/ansible-collections/community.hrobot/pull/166).
• storagebox_set_password — добавлена поддержка нового API Hetzner. Обратите внимание: новый API не поддерживает установку случайного пароля; при использовании нового API необходимо всегда указывать пароль (https://github.com/ansible-collections/community.hrobot/pull/168).
• storagebox_snapshot — добавлена поддержка нового API Hetzner (https://github.com/ansible-collections/community.hrobot/pull/168).
• storagebox_snapshot_info — добавлена поддержка нового API Hetzner (https://github.com/ansible-collections/community.hrobot/pull/168).
• storagebox_snapshot_plan — добавлена поддержка нового API Hetzner (https://github.com/ansible-collections/community.hrobot/pull/167).
• storagebox_snapshot_plan_info — добавлена поддержка нового API Hetzner (https://github.com/ansible-collections/community.hrobot/pull/167).
• storagebox_subaccount — password_mode больше не помечается как no_log (https://github.com/ansible-collections/community.hrobot/pull/168).
• storagebox_subaccount — добавлена поддержка нового API Hetzner. Обратите внимание: новый API не поддерживает установку случайного пароля; при создании storagebox с помощью нового API необходимо всегда указывать пароль (https://github.com/ansible-collections/community.hrobot/pull/168).
• storagebox_subaccount_info — добавлена поддержка нового API Hetzner (https://github.com/ansible-collections/community.hrobot/pull/168).

Исправления ошибок

• Плагин инвентаризации robot — при обработке параметров шаблонами больше не используется устаревший параметр (https://github.com/ansible-collections/community.hrobot/pull/165).

Известные проблемы

• Модули storagebox* — Robot API Hetzner для storage box объявлен устаревшим и будет выведен из эксплуатации 30 июля 2025 года. В настоящее время модули несовместимы с новым API. Мы постараемся адаптировать их к этому сроку, однако из-за различий между API использование и возвращаемые значения могут немного измениться. Для нового API необходимо зарегистрировать API-токен и передать его как hetzner_token (https://github.com/ansible-collections/community.hrobot/pull/166).

Краткое описание выпуска

Выпуск с исправлениями ошибок и новыми функциями. В него входят три новых модуля, поддерживающих оставшиеся возможности Hetzner Storage Boxes, которые ранее не охватывались.

Исправления ошибок

• storagebox — обеспечена правильная отправка изменений логических параметров в службу Robot (https://github.com/ansible-collections/community.hrobot/issues/160, https://github.com/ansible-collections/community.hrobot/pull/161).

Новые модули

• community.hrobot.storagebox_snapshot_info — получение сведений о снимках storage box.
• community.hrobot.storagebox_subaccount — создание, обновление или удаление подучётной записи для storage box.
• community.hrobot.storagebox_subaccount_info — получение сведений о подучётных записях storage box.

Краткое описание выпуска

Функциональный выпуск.

Новые модули

• community.hrobot.storagebox_snapshot — создание, обновление или удаление снимка storage box.

Краткое описание выпуска

Функциональный выпуск.

Новые модули

• community.hrobot.reset_info — получение сведений о средстве сброса выделенного сервера.

Краткое описание выпуска

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

Незначительные изменения

• Теперь у всех модулей и плагинов есть параметр rate_limit_retry_timeout, позволяющий настроить время ожидания при ошибках ограничения частоты запросов. По умолчанию модули ожидают бесконечно. Если задать значение 0, повторных попыток не будет (такое поведение было в предыдущих версиях); положительное значение задаёт максимальное время ожидания в секундах (https://github.com/ansible-collections/community.hrobot/pull/140).
• boot — теперь можно указывать открытые ключи SSH в authorized_keys. Отпечаток, необходимый для Robot API, будет извлечён автоматически (https://github.com/ansible-collections/community.hrobot/pull/134).
• v_switch — модуль теперь входит в группу действий community.hrobot.robot, хотя ранее в документации уже указывалось, что он является её частью (https://github.com/ansible-collections/community.hrobot/pull/136).

Устаревшие возможности

• boot — различные подопции arch объявлены устаревшими и будут удалены в community.hrobot 3.0.0 (https://github.com/ansible-collections/community.hrobot/pull/134).

Новые модули

• community.hrobot.storagebox — изменение базовой конфигурации storage box.
• community.hrobot.storagebox_info — получение сведений об одном или нескольких storage box.
• community.hrobot.storagebox_set_password — установка или сброс пароля для storage box.
• community.hrobot.storagebox_snapshot_plan — изменение планов создания снимков storage box.
• community.hrobot.storagebox_snapshot_plan_info — получение сведений о планах создания снимков storage box.

Краткое описание выпуска

Выпуск с обновлениями для обслуживания и обновлённой документацией.

Краткое описание выпуска

Выпуск с обновлениями для обслуживания и обновлённой документацией.

Краткое описание выпуска

Выпуск с исправлениями ошибок.

Исправления ошибок

• boot — при отправке нескольких authorized_key используется кодирование формы массива PHP (https://github.com/ansible-collections/community.hrobot/issues/112, https://github.com/ansible-collections/community.hrobot/pull/113).

Сводка выпуска

Новый мажорный выпуск 2.0.0.

Основные изменения

• Коллекция community.hrobot теперь зависит от коллекции community.library_inventory_filtering_v1. Эта вспомогательная коллекция предоставляет функциональность фильтрации хостов для плагинов инвентаризации. Если вы используете пакет Ansible community, в него входят обе коллекции, и вам не нужно выполнять никаких дополнительных действий. Если вы устанавливаете коллекцию с помощью ansible-galaxy collection install, она будет установлена автоматически. Если вы устанавливаете коллекцию, копируя её файлы в место, где их может найти ansible-core, например клонируя репозиторий git, необходимо также установить зависимость, если вы используете плагин инвентаризации (https://github.com/ansible-collections/community.hrobot/pull/101).

Незначительные изменения

• плагин инвентаризации robot — добавлена опция filter, позволяющая включать и исключать хосты на основе условий Jinja2 (https://github.com/ansible-collections/community.hrobot/pull/101).

Критические изменения / руководство по переносу

• плагин инвентаризации robot — filters больше не является псевдонимом simple_filters, а представляет собой новую отдельную опцию (https://github.com/ansible-collections/community.hrobot/pull/101).

Удалённые функции (ранее устаревшие)

• Коллекция больше не поддерживает выпуски Ansible, ansible-base и ansible-core, срок поддержки которых истёк на момент выпуска версии 2.0.0. Это означает, что Ansible 2.9, ansible-base 2.10, ansible-core 2.11, ansible-core 2.12 и ansible-core 2.13 больше не поддерживаются. Коллекция может по-прежнему работать с этими версиями, но в любой момент может перестать работать без предварительного уведомления, и это не будет считаться ошибкой (https://github.com/ansible-collections/community.hrobot/pull/101).

Сводка выпуска

Выпуск с исправлениями ошибок.

Исправления ошибок

• плагины инвентаризации — добавлена небезопасная оболочка, чтобы строки, не содержащие { или }, не помечались как небезопасные; это позволяет обойти ошибку в AWX (https://github.com/ansible-collections/community.hrobot/pull/102).

Сводка выпуска

Выпуск с исправлениями ошибок.

Исправления безопасности

• плагин инвентаризации robot — гарантировано, что все данные, полученные от сервера службы Hetzner Robot, помечаются как небезопасные, поэтому удалённое выполнение кода посредством получения текстов, которые могут обрабатываться как шаблоны, невозможно (https://www.die-welt.net/2024/03/remote-code-execution-in-ansible-dynamic-inventory-plugins/, https://github.com/ansible-collections/community.hrobot/pull/99).

Сводка выпуска

Выпуск с новыми функциями и обновлениями.

Незначительные изменения

• плагин инвентаризации robot — опция filters переименована в simple_filters. Старое имя продолжит работать до community.hrobot 2.0.0. Затем оно будет изменено, чтобы разрешить более сложную фильтрацию с использованием функциональности коллекции community.library_inventory_filtering_v1 (https://github.com/ansible-collections/community.hrobot/pull/94).

Устаревшие функции

• плагин инвентаризации robot — опция filters переименована в simple_filters. Старое имя перестанет работать в community.hrobot 2.0.0 (https://github.com/ansible-collections/community.hrobot/pull/94).

Сводка выпуска

Выпуск с обновлённой документацией и техническими улучшениями.

Исправления ошибок

• В сообщения об ошибках добавлено больше информации (если она доступна) (https://github.com/ansible-collections/community.hrobot/pull/89).

Сводка выпуска

Выпуск с обновлённой документацией и техническими улучшениями.

Начиная с этой версии, community.hrobot использует в документации новую семантическую разметку Ansible. Обратите внимание: если вы просматриваете документацию с помощью инструмента командной строки ansible-doc из ansible-core версии ниже 2.15, разметка отображается некорректно. В большинстве случаев её всё равно можно прочитать, но для отображения в соответствии с замыслом требуется ansible-core 2.15 или более поздней версии. Кроме того, можно просмотреть сайт документации devel с отрисованной HTML-версией документации последнего выпуска.

Известные проблемы

• В текстовом выводе ansible-doc для ansible-core версии ниже 2.15 разметка Ansible отображается в исходном виде. Если у вас возникли трудности с расшифровкой разметки документации, обновите ansible-core до версии 2.15 (или новее) либо прочитайте документацию в формате HTML на странице https://docs.ansible.com/ansible/devel/collections/community/hrobot/.

Сводка выпуска

Выпуск с новыми функциями, посвящёнными изменениям брандмауэра Hetzner.

Основные изменения

• firewall — Hetzner добавила поддержку правил исходящего трафика в брандмауэр. К сожалению, из-за этого изменения старые версии модуля брандмауэра всегда будут устанавливать пустой список правил исходящего трафика, не позволяя серверу отправлять пакеты (https://github.com/ansible-collections/community.hrobot/issues/75, https://github.com/ansible-collections/community.hrobot/pull/76).

Незначительные изменения

• firewall, firewall_info — добавлен вывод filter_ipv6 и rules.output для поддержки новых функций фильтрации IPv6 и правил исходящего трафика (https://github.com/ansible-collections/community.hrobot/issues/75, https://github.com/ansible-collections/community.hrobot/pull/76).
• firewall, firewall_info — добавлена опция server_number, которую можно использовать вместо server_ip для идентификации сервера. Hetzner объявила настройку брандмауэра с помощью server_ip устаревшей, поэтому поддержка server_ip в будущем будет прекращена (https://github.com/ansible-collections/community.hrobot/pull/77).

Сводка выпуска

Выпуск с новыми функциями.

Новые модули

• community.hrobot.v_switch — управление vSwitch Hetzner

Сводка выпуска

Выпуск с новыми функциями и улучшенной документацией.

Незначительные изменения

• Добавлена группа значений по умолчанию для модулей / группа действий community.hrobot.robot. Используйте её с group/community.hrobot.robot, чтобы задать параметры для всех модулей Hetzner Robot (https://github.com/ansible-collections/community.hrobot/pull/65).

Сводка выпуска

Выпуск с улучшением документации и техническими обновлениями.

Незначительные изменения

• Репозиторий коллекции соответствует спецификации REUSE, за исключением фрагментов журнала изменений (https://github.com/ansible-collections/community.hrobot/pull/60).

Сводка выпуска

Выпуск с небольшими исправлениями документации и техническими обновлениями.

Сводка выпуска

Выпуск с изменением способа указания лицензий и техническими обновлениями. Функциональных изменений нет.

Незначительные изменения

• Все лицензии на программное обеспечение теперь находятся в каталоге LICENSES/ в корне коллекции. Кроме того, SPDX-License-Identifier: используется для указания применимой лицензии для каждого файла, который не создаётся автоматически (https://github.com/ansible-collections/community.hrobot/pull/52).

Сводка выпуска

Выпуск с новыми функциями.

Незначительные изменения

• плагин инвентаризации robot — разрешена подстановка шаблонов для hetzner_user и hetzner_password (https://github.com/ansible-collections/community.hrobot/pull/49).

Сводка выпуска

Технический выпуск.

Исправления ошибок

• Добавлен файл лицензии simplified_bsd.txt для утилит модулей robot и failover.

Сводка выпуска

Выпуск с новыми функциями и исправлениями ошибок.

Незначительные изменения

• Подготовлена коллекция для включения в среду выполнения (Execution Environment) путём объявления её зависимостей (https://github.com/ansible-collections/community.hrobot/pull/45).

Исправления ошибок

• плагин инвентаризации robot — устранён сбой, возникавший, если у сервера не задано ни имя, ни основной IP-адрес. Вместо этого в качестве имени используется номер сервера. Такое может происходить, если в списке серверов появляются неназванные резервирования стоек (https://github.com/ansible-collections/community.hrobot/issues/40, https://github.com/ansible-collections/community.hrobot/pull/47).

Сводка выпуска

Выпуск с обновлением документации.

Сводка выпуска

Выпуск с исправлениями ошибок.

Исправления ошибок

• boot — исправлена неправильная обработка авторизованных ключей SSH (https://github.com/ansible-collections/community.hrobot/issues/32, https://github.com/ansible-collections/community.hrobot/pull/33).

Сводка выпуска

Технический выпуск.

Незначительные изменения

• Общий код поддержки HTTP для модулей — исправлено использование fetch_url с учётом изменений в последней ветке devel ansible-core (https://github.com/ansible-collections/community.hrobot/pull/30).

Сводка выпуска

Выпуск с новыми функциями и несколькими новыми модулями.

Незначительные изменения

• Вместо внутренних module_utils ansible-core используются эквивалентные общедоступные API, доступные начиная как минимум с Ansible 2.9 (https://github.com/ansible-collections/community.hrobot/pull/18).
• firewall — параметр whitelist_hos переименован в allowlist_hos, старое имя сохранено в качестве псевдонима (https://github.com/ansible-collections/community.hrobot/pull/15).
• firewall, firewall_info — добавлено возвращаемое значение allowlist_hos, содержащее то же значение, что и whitelist_hos. Старое имя whitelist_hos со временем будет удалено (https://github.com/ansible-collections/community.hrobot/pull/15).
• утилиты модулей robot — добавлен параметр allow_empty_result для plugin_open_url_json и fetch_url_json (https://github.com/ansible-collections/community.hrobot/pull/16).

Новые модули

• community.hrobot.boot — настройка конфигурации загрузки
• community.hrobot.reset — сброс выделенного сервера
• community.hrobot.reverse_dns — создание или удаление записи обратного DNS для IP-адреса
• community.hrobot.server — обновление информации о сервере
• community.hrobot.server_info — получение информации об одном или нескольких серверах
• community.hrobot.ssh_key — добавление, удаление или обновление ключа SSH
• community.hrobot.ssh_key_info — получение информации о ключах SSH

Сводка выпуска

Выпуск с исправлением ошибок, сокращающий количество HTTPS-запросов, выполняемых модулями и плагинами.

Исправления ошибок

• robot — принудительно включена базовая HTTP-аутентификация, чтобы сократить количество HTTPS-запросов (https://github.com/ansible-collections/community.hrobot/pull/9).

Сводка выпуска

Выпуск с новым плагином инвентаризации.

Новые плагины

Сводка выпуска

Коллекция community.hrobot продолжает работу над модулями Hetzner Robot, начатыми в community.general 1.2.0. Поэтому перечисленные здесь изменения относятся к модулям community.general.hetzner_*.

Критические изменения / руководство по переносу

• firewall — теперь требуется библиотека ipaddress (https://github.com/ansible-collections/community.hrobot/pull/2).