Форматы и среда выполнения
Ansible выполняется локально на каждой выбранной ноде. Список серверов задаётся в Telepúrte; не переносите в такой файл внешнюю SSH-инвентаризацию в расчёте на отдельный управляющий Ansible-сервер.
Скрипт работает в контексте агента и его системных ограничений. Проверьте пользователя процесса и доступные права: выбор скрипта в панели не выдаёт root или sudo автоматически. У импортированной ноды требуется совместимая версия Axottle Agent с поддержкой скриптов.
Добавить материалы
В Плейбуки и расписания добавьте скрипт в каталог: загрузите файл или вставьте текст. Имя должно использовать латиницу, цифры, точку, дефис или подчёркивание и подходящее расширение. Скрипт — UTF-8 без нулевых символов. Затем создайте или откройте новую версию плейбука, добавьте действие Выполнить скрипт и выберите его. При необходимости прикрепите обычные файлы и набор окружения. Один файл каталога ограничен 1 МиБ. Входных файлов у шага может быть до восьми; суммарный объём скрипта и его входных файлов ограничен 2 МиБ. Имена входных файлов должны быть уникальными в рамках запуска.Пример Bash без изменения сервера
Сохраните какinspect.sh:
app.conf и набор переменных с DEPLOY_ENV=test. Прикрепите их к шагу и выполните на одной ноде. Скрипт печатает метку окружения, uptime и контрольную сумму переданного файла. Он не устанавливает app.conf в /etc: такое размещение нужно явно написать в сценарии или сделать типизированным действием.
Входные файлы находятся в каталоге, путь к которому задаёт TELEPURTE_FILES_DIR. Рабочий каталог запуска временный; не рассчитывайте на файлы от предыдущего исполнения. После завершения временные материалы удаляются.
Пример Ansible
Сохранитеinspect.yml:
ansible-playbook. Если его нет, результат будет ansible_unavailable; Telepúrte не устанавливает Ansible автоматически в ходе этого шага. Коллекции, утилиты и права для более сложного плейбука также подготовьте заранее.
Переменные окружения
Создайте именованный набор и добавьте пары имя/значение. Имена должны быть уникальными; поддерживаются до 64 переменных и до 32 КиБ набора. Системные имена, влияющие на запуск интерпретатора, и префиксLD_ запрещены. Не заменяйте PATH, BASH_ENV или TELEPURTE_FILES_DIR.
Значения передаются непосредственно в окружение процесса; .env на сервере не создаётся. Если приложение ожидает файл, добавьте его отдельно или явно создайте в скрипте с нужными правами.
Материалы хранятся зашифрованными. В выводе выполняется скрытие совпадающих значений окружения, но это не защита от всех способов вывода секрета: преобразованное, разбитое или закодированное значение может не совпасть. Не включайте set -x и не печатайте окружение целиком в сценариях с секретами.
Срок и результат
Скриптовое исполнение ограничено 15 минутами. В результат входят код завершения, код ошибки и ограниченный объединённый stdout/stderr. Сохранённый вывод может обрезаться; интерфейс показывает соответствующий признак. Длинный полный журнал храните там, где его предусмотрело ваше приложение, и не считайте короткий результат Telepúrte полным логом развёртывания.
Обычный запуск из интерфейса не включает автоматическую канарейку. Выбирайте сначала тестовую ноду; поэтапный rollout с порогом ошибок описан в заданиях.
