Це команда echo_supervisord_conf, яку можна запустити в постачальнику безкоштовного хостингу OnWorks за допомогою однієї з наших численних безкоштовних робочих станцій, таких як Ubuntu Online, Fedora Online, онлайн-емулятор Windows або онлайн-емулятор MAC OS
ПРОГРАМА:
ІМ'Я
echo_supervisord_conf - Документація з конфігурації супервізора
Супервізор — це система клієнт/сервер, яка дозволяє своїм користувачам контролювати й контролювати номер
процесів у UNIX-подібних операційних системах.
Він поділяє деякі з тих самих цілей програм, як launchd, daemontools і runit. На відміну від
деякі з цих програм не призначені для запуску як заміни ініціалізації як "ідентифікатор процесу
1". Натомість він призначений для керування процесами, пов'язаними з проектом або а
клієнта, і має запускатися, як і будь-яка інша програма під час завантаження.
ДОКУМЕНТАЦІЯ
створення a конфігурація філе
Після завершення встановлення Supervisor запустіть echo_supervisord_conf. Це буде
надрукуйте "зразок" конфігураційного файлу Supervisor у стандартному виведенні терміналу.
Як тільки ви побачите, що файл відображається у вашому терміналі, повторно викличте команду як
echo_supervisord_conf > /etc/supervisord.conf. Це не спрацює, якщо у вас немає root
доступ.
Якщо у вас немає root-доступу, або ви не хотіли б ставити файл supervisord.conf файл у
/etc/supervisord.conf`, ви можете розмістити його в поточному каталозі (echo_supervisord_conf >
supervisord.conf) і почніть керівник з -c прапорець, щоб вказати
розташування файлу конфігурації.
Наприклад, керівник -c supervisord.conf. Використання -c прапор фактично зайвий в
цей випадок, тому що керівник шукає в поточному каталозі a supervisord.conf
перш ніж він шукатиме будь-які інші місця для файлу, але він працюватиме.
Після того, як у вашій файловій системі є файл конфігурації, ви можете почати змінювати його до своєї
симпатія.
конфігурація філе
Конфігураційний файл Supervisor має умовну назву supervisord.conf. Його використовують
обидва керівник та supervisorctl. Якщо будь-яка програма запущена без файлу -c
параметр (опція, яка використовується, щоб повідомити програмі ім'я файлу конфігурації
явно), програма шукатиме файл з іменем supervisord.conf в
наступних місцях у зазначеному порядку. Він використовуватиме перший знайдений файл.
1. $CWD/supervisord.conf
2. $CWD/etc/supervisord.conf
3. /etc/supervisord.conf
4. ../etc/supervisord.conf (Відносно виконуваного файлу)
5. ../supervisord.conf (Відносно виконуваного файлу)
ПРИМІТКА:
Деякі дистрибутиви мають пакет Supervisor зі своїми власними налаштуваннями. Ці
змінені версії Supervisor можуть завантажувати файл конфігурації з інших місць
ніж описані тут. Зокрема, було виявлено, що пакунки Ubuntu використовують
/etc/supervisor/supervisord.conf.
філе сформований
supervisord.conf є файлом у стилі Windows INI (Python ConfigParser). Він має розділи (кожна
позначається а [заголовок]) і пари ключ/значення всередині розділів. Розділи та їх
допустимі значення описані нижче.
Навколишнє середовище Змінні
Змінні середовища, які присутні в середовищі в той момент керівник is
Start можна використовувати у файлі конфігурації за допомогою синтаксису рядкового виразу Python
%(ENV_X)s:
[програма:приклад]
команда=/usr/bin/example --loglevel=%(ENV_LOGLEVEL)s
У наведеному вище прикладі вираз %(ENV_LOGLEVEL)s буде розширено до значення
змінна середовища LOGLEVEL.
ПРИМІТКА:
У Supervisor 3.2 і пізніших версіях, %(ENV_X)s вирази підтримуються в усіх варіантах. в
попередні версії, деякі параметри підтримують їх, але більшість ні. Дивіться документацію для
кожен варіант нижче.
[unix_http_сервер] розділ Налаштування
Команда supervisord.conf файл містить розділ з ім [unix_http_сервер] під якою
параметри конфігурації для сервера HTTP, який прослуховує сокет домену UNIX, повинні бути
вставлено. Якщо файл конфігурації не містить [unix_http_сервер] розділ, домен UNIX
сокет HTTP-сервер не буде запущено. Допустимі значення конфігурації як
слід.
[unix_http_сервер] розділ Цінності
файл
Шлях до сокету домену UNIX (наприклад /tmp/supervisord.sock), на якому керівник буде
слухати запити HTTP/XML-RPC. supervisorctl використовує XML-RPC для зв’язку
керівник над цим портом. Цей параметр може включати значення %(тут)s, який розширюється
до каталогу, в якому керівник конфігураційний файл знайдено.
дефолт: Ні.
Вимагається: Ні.
Введений: 3.0
CHMOD
Змініть біти режиму дозволу UNIX сокету домену UNIX на це значення в
запуск
дефолт: 0700
Вимагається: Ні.
Введений: 3.0
Чаун
Змініть користувача та групу файлу сокета на це значення. Може бути ім'ям користувача UNIX
(напр хризм) або ім’я користувача та групу UNIX, розділені двокрапкою (наприклад chrism: колесо).
дефолт: Використовуйте ім'я користувача та групу користувача, який запускає supervisor.
Вимагається: Ні.
Введений: 3.0
ім'я користувача
Ім’я користувача, необхідне для автентифікації на цьому HTTP-сервері.
дефолт: Ім'я користувача не потрібно.
Вимагається: Ні.
Введений: 3.0
пароль
Пароль, необхідний для автентифікації на цьому HTTP-сервері. Це може бути чіткий текст
пароль або можна вказати як хеш SHA-1, якщо до нього стоїть рядок {SHA}. Форум
наприклад, {SHA}82ab876d1387bfafe46cc1c8a2ef074eae50cb1d є збереженою SHA версією файлу
пароль «пароль».
Зауважте, що хешований пароль має бути у шістнадцятковому форматі.
дефолт: Пароль не потрібен.
Вимагається: Ні.
Введений: 3.0
[unix_http_сервер] розділ Приклад
[unix_http_сервер]
файл = /tmp/supervisor.sock
chmod = 0777
chown= nobody:nogroup
ім'я користувача = користувач
password = 123
[inet_http_сервер] розділ Налаштування
Команда supervisord.conf файл містить розділ з ім [inet_http_сервер] під якою
параметри конфігурації для сервера HTTP, який прослуховує TCP (інтернет) сокет
бути вставлений. Якщо файл конфігурації не містить [inet_http_сервер] розділ, inet HTTP
сервер не буде запущено. Допустимі значення конфігурації наступні.
[inet_http_сервер] розділ Цінності
порт
Значення TCP host:port або (наприклад 127.0.0.1:9001), який керівник буде слухати
Запити HTTP/XML-RPC. supervisorctl використовуватиме XML-RPC для зв’язку керівник
над цим портом. Щоб прослуховувати всі інтерфейси в машині, використовуйте : 9001 or *:9001.
дефолт: Немає за замовчуванням.
Вимагається: Так.
Введений: 3.0
ім'я користувача
Ім’я користувача, необхідне для автентифікації на цьому HTTP-сервері.
дефолт: Ім'я користувача не потрібно.
Вимагається: Ні.
Введений: 3.0
пароль
Пароль, необхідний для автентифікації на цьому HTTP-сервері. Це може бути чіткий текст
пароль або можна вказати як хеш SHA-1, якщо до нього стоїть рядок {SHA}. Форум
наприклад, {SHA}82ab876d1387bfafe46cc1c8a2ef074eae50cb1d є збереженою SHA версією файлу
пароль «пароль».
Зауважте, що хешований пароль має бути у шістнадцятковому форматі.
дефолт: Пароль не потрібен.
Вимагається: Ні.
Введений: 3.0
[inet_http_сервер] розділ Приклад
[inet_http_сервер]
порт = 127.0.0.1:9001
ім'я користувача = користувач
password = 123
[керівник] розділ Налаштування
Команда supervisord.conf файл містить розділ з ім [керівник] в яких глобальних налаштуваннях
пов'язані з керівник слід вставити процес. Це такі.
[керівник] розділ Цінності
файл журналу
Шлях до журналу діяльності процесу супервізора. Цей варіант може включати
значення %(тут)s, який розгортається до каталогу, в якому знаходиться конфігурація супервізора
файл знайдено.
дефолт: $CWD/supervisord.log
Вимагається: Ні.
Введений: 3.0
logfile_maxbytes
Максимальна кількість байтів, які може бути використано файлом журналу активності до його використання
повернуто (у значенні можна використовувати суфіксальні множники, такі як "KB", "MB" і "GB"). Набір
це значення дорівнює 0, щоб вказати необмежений розмір журналу.
дефолт: 50MB
Вимагається: Ні.
Введений: 3.0
logfile_backups
Кількість резервних копій, які потрібно зберігати в результаті ротації файлу журналу активності. Якщо встановлено
до 0, резервні копії не зберігатимуться.
дефолт: 10
Вимагається: Ні.
Введений: 3.0
LogLevel
Рівень ведення журналу, який визначає, що записується в журнал діяльності супервізора. Один з
критичний, помилка, попереджати, інформація, відлагоджувати, простежуватиабо балачки. Зауважте, що на рівні журналу відлагоджувати,
файл журналу supervisord буде записувати вихідні дані stderr/stdout його дочірніх процесів
та розширена інформація про зміни стану процесу, корисна для налагодження a
процес, який не запускається належним чином. Дивіться також: activity_log_levels.
дефолт: інформація
Вимагається: Ні.
Введений: 3.0
pid-файл
Розташування, в якому супервізор зберігає свій файл pid. Цей варіант може включати
значення %(тут)s, який розгортається до каталогу, в якому знаходиться конфігурація супервізора
файл знайдено.
дефолт: $CWD/supervisord.pid
Вимагається: Ні.
Введений: 3.0
умаск
Umask процесу супервізора.
дефолт: 022
Вимагається: Ні.
Введений: 3.0
nodaemon
Якщо вірно, супервізор почне працювати на передньому плані замість демонізації.
дефолт: помилковий
Вимагається: Ні.
Введений: 3.0
minfds
Мінімальна кількість дескрипторів файлів, які мають бути доступні, перш ніж це зробить супервізор
почати успішно. Буде здійснено виклик setrlimit, щоб спробувати підняти soft and
жорсткі обмеження процесу супервізора, які необхідно задовольнити minfds. Жорстка межа може бути тільки
піднімається, якщо супервізор запускається як root. supervisord широко використовує дескриптори файлів, і
перейде в режим відмови, коли його неможливо отримати з ОС, тому це корисно
може вказати мінімальне значення, щоб гарантувати, що вони не закінчаться під час виконання.
Ця опція особливо корисна для Solaris, яка має низький ліміт fd для кожного процесу
за замовчуванням.
дефолт: 1024
Вимагається: Ні.
Введений: 3.0
minprocs
Мінімальна кількість дескрипторів процесів, які повинні бути доступні до супервізора
розпочнеться успішно. Для спроби підняти софт буде зроблено виклик setrlimit
і жорсткі обмеження процесу супервізора, які необхідно задовольнити minprocs. Жорстка межа може
піднімається, лише якщо супервізор запускається як root. супервізор перейде в режим відмови
коли в ОС закінчуються дескриптори процесів, тому корисно переконатися, що цього достатньо
дескриптори процесів доступні на керівник запуск
дефолт: 200
Вимагається: Ні.
Введений: 3.0
nocleanup
Заборонити супервізору очищати будь-які існуючі AUTO дочірні файли журналу під час запуску.
Корисно для налагодження.
дефолт: помилковий
Вимагається: Ні.
Введений: 3.0
childlogdir
Каталог, який використовується для AUTO дочірні файли журналу. Цей параметр може включати значення
%(тут)s, який розгортається до каталогу, у якому файл керівник файл конфігурації
був знайдений.
дефолт: значення Python tempfile.get_tempdir()
Вимагається: Ні.
Введений: 3.0
користувач
Інструктаж керівник щоб переключити користувачів на цей обліковий запис користувача UNIX, перш ніж виконувати будь-які дії
змістовна обробка. Користувача можна змінити, лише якщо керівник починається як
користувач root. Якщо керівник не можна змінити користувачів, він все одно продовжуватиметься, але буде записувати a
повідомлення журналу на критичний рівень, який каже, що він не може відмовитися від привілеїв.
дефолт: не змінювати користувачів
Вимагається: Ні.
Введений: 3.0
каталог
Коли керівник daemonizes, перейдіть до цього каталогу. Цей варіант може включати
значення %(тут)s, який розгортається до каталогу, у якому файл керівник конфігурація
файл знайдено.
дефолт: не CD
Вимагається: Ні.
Введений: 3.0
strip_ansi
Видаліть усі escape-послідовності ANSI з дочірніх файлів журналу.
дефолт: помилковий
Вимагається: Ні.
Введений: 3.0
навколишнє середовище
Список пар ключ/значення у формі KEY="val",KEY2="val2" які будуть розміщені в
керівник середовище процесу (і, як результат, у всьому його дочірньому процесі'
середовища). Цей параметр може включати значення %(тут)s, яка розширюється до
каталог, у якому знайдено файл конфігурації супервізора. Значення, що містять
Небуквенно-цифрові символи слід вводити в лапки (напр KEY="val:123",KEY2="val,456").
В іншому випадку введення значень в лапки необов’язкове, але рекомендоване. Щоб уникнути відсотків
символів, просто використовуйте два. (наприклад URI="/first%%20name") примітки що підпроцеси будуть
успадковувати змінні середовища оболонки, яка використовується для запуску керівник крім
перевизначені тут і в межах програми навколишнє середовище варіант. Подивитися
subprocess_environment.
дефолт: немає значень
Вимагається: Ні.
Введений: 3.0
ідентифікатор
Рядок ідентифікатора для цього процесу супервізора, який використовується інтерфейсом RPC.
дефолт: керівник
Вимагається: Ні.
Введений: 3.0
[керівник] розділ Приклад
[керівник]
файл журналу = /tmp/supervisord.log
logfile_maxbytes = 50 МБ
logfile_backups=10
loglevel = інформація
pidfile = /tmp/supervisord.pid
nodaemon = false
minfds = 1024
minprocs = 200
umask = 022
користувач = chrism
ідентифікатор = супервізор
каталог = / Tmp
nocleanup = правда
childlogdir = / Tmp
strip_ansi = false
середовище = KEY1="value1",KEY2="value2"
[supervisorctl] розділ Налаштування
Файл конфігурації може містити налаштування для supervisorctl інтерактивна оболонка
програма. Ці параметри наведено нижче.
[supervisorctl] розділ Цінності
serverurl
URL-адреса, яку слід використовувати для доступу до сервера супервізора, напр
http://localhost: 9001. Для сокетів домену UNIX використовуйте
unix:///absolute/path/to/file.sock.
дефолт: http://localhost: 9001
Вимагається: Ні.
Введений: 3.0
ім'я користувача
Ім’я користувача, яке потрібно передати серверу супервізора для використання під час аутентифікації. Це повинно
бути таким же, як ім'я користувача з конфігурації сервера супервізора для порту або UNIX
сокет домену, до якого ви намагаєтеся отримати доступ.
дефолт: Немає імені користувача
Вимагається: Ні.
Введений: 3.0
пароль
Пароль для передачі серверу супервізора для використання під час аутентифікації. Це повинно
бути відкритою версією пароль з конфігурації сервера супервізора для
порт або сокет домену UNIX, до якого ви намагаєтеся отримати доступ. Це значення не можна передати як
хеш SHA. На відміну від інших паролів, зазначених у цьому файлі, він повинен бути введений
чистий текст.
дефолт: Немає пароля
Вимагається: Ні.
Введений: 3.0
підказка
Рядок, який використовується як підказка supervisorctl.
дефолт: supervisor
Вимагається: Ні.
Введений: 3.0
файл_історії
Шлях для використання як читальна лінія постійний файл історії. Якщо ви увімкнете цю функцію за допомогою
вибравши шлях, ваші команди supervisorctl зберігатимуться у файлі, і ви можете використовувати
readline (наприклад, стрілка вгору), щоб викликати команди, які ви виконували в останньому supervisorctl
сесія
дефолт: Немає файлу
Вимагається: Ні.
Введений: 3.0a5
[supervisorctl] розділ Приклад
[supervisorctl]
serverurl = unix:///tmp/supervisor.sock
ім'я користувача = chris
password = 123
підказка = мій керівник
[програма:x] розділ Налаштування
Файл конфігурації повинен містити один або кілька програма розділів для нагляду
щоб знати, які програми він повинен запускати та контролювати. Значення заголовка є складеним значенням.
Це слово «програма», за яким слід двокрапка, а потім назва програми. Заголовок
Значення [програма:foo] описує програму з назвою "foo". Використовується назва
в клієнтських програмах, які керують процесами, що створюються в результаті цього
конфігурації. Створення a програма розділ, який не має назви. The
ім'я не повинно містити символу двокрапки або символу дужки. Значення імені є
використовується як значення для %(назва_програми)s розширення рядкового виразу в межах інших значень
де зазначено.
ПРИМІТКА:
A [програма:x] розділ фактично представляє "однорідну групу процесів" для керівника
(станом на 3.0). Члени групи визначаються комбінацією numprocs
та назва_процесу параметри в конфігурації. За замовчуванням, якщо numprocs і
process_name залишаються незмінними порівняно зі своїми значеннями за замовчуванням, група, представлена
[програма:x] буде названо x і матиме єдиний процес з назвою x у цьому. Це
забезпечує певну зворотну сумісність зі старими версіями супервізора, що й було
не розглядати розділи програми як однорідні визначення груп процесів.
Але, наприклад, якщо у вас є [програма:foo] розділ з а numprocs 3 і a
назва_процесу вираження %(назва_програми)s_%(process_num)02d, група "foo" буде
містять три процеси, іменовані foo_00, foo_01 та foo_02. Це дає можливість
запустити ряд дуже схожих процесів за допомогою одного [програма:x] розділ. всі
також можуть містити імена файлів журналу, усі рядки середовища та команди програм
подібні рядкові вирази Python, щоб передати дещо різні параметри кожному
процесу.
[програма:x] розділ Цінності
команда
Команда, яка буде запущена при запуску цієї програми. Команда може бути або
абсолютний (напр /шлях/до/назва програми) або родич (напр назва програми). Якщо це
родич, оточення керівника $ PATH буде здійснюватися пошук виконуваного файлу.
Програми можуть приймати аргументи, напр /шлях/до/програми Foo бар. Можна використовувати командний рядок
подвійні лапки для групування аргументів з пробілами для передачі програмі, напр
/шлях/до/програми/ім'я -p "фу бар". Зверніть увагу, що значення команда може включати Python
рядкові вирази, напр /шлях/до/назва програми --порт=80%(число_процесу)02d може розширитися
до /шлях/до/назва програми --порт=8000 під час виконання. Оцінюються рядкові вирази
проти словника, що містить ключі назва групи, ім'я_вузла хоста, номер_процесу,
назва_програми, тут (каталог конфігураційного файлу supervisord) і все
Змінні середовища супервізора з префіксом ENV_. Контрольовані програми повинні
самі не є демонами, оскільки супервізор вважає, що він відповідає за демонізацію його
підпроцеси (див. nondaemonizing_of_subprocesses).
дефолт: Немає за замовчуванням.
Вимагається: Так.
Введений: 3.0
назва_процесу
Рядковий вираз Python, який використовується для складання імені процесу супервізора для цього
процес. Зазвичай вам не потрібно турбуватися про налаштування, якщо ви не зміните це
numprocs. Рядковий вираз оцінюється щодо словника, який містить
назва групи, ім'я_вузла хоста, номер_процесу, назва_програми та тут (каталог
конфігураційний файл supervisord).
дефолт: %(назва_програми)s
Вимагається: Ні.
Введений: 3.0
numprocs
Супервізор запустить стільки екземплярів цієї програми, скільки названо numprocs. Примітка
що якщо numprocs > 1, то назва_процесу вираз має включати %(process_num)s (або будь-який інший
інший дійсний рядковий вираз Python, який включає номер_процесу) всередині нього.
дефолт: 1
Вимагається: Ні.
Введений: 3.0
numprocs_start
Ціле зміщення, яке використовується для обчислення числа, при якому numprocs починається
дефолт: 0
Вимагається: Ні.
Введений: 3.0
пріоритет
Відносний пріоритет програми в порядку запуску та завершення роботи. Нижній
Пріоритети вказують на програми, які запускаються першими і завершуються останніми при запуску і коли
агреговані команди використовуються в різних клієнтах (наприклад, "запустити все"/"зупинити все"). Вищий
Пріоритети вказують на програми, які запускаються останніми і завершуються першими.
дефолт: 999
Вимагається: Ні.
Введений: 3.0
автозапуск
Якщо значення true, ця програма запуститься автоматично, коли буде запущено supervisor.
дефолт: правда
Вимагається: Ні.
Введений: 3.0
startsecs
Загальна кількість секунд, протягом яких програма повинна працювати після запуску
вважати початок успішним (переміщення процесу з ПОЧАТОК держави до
РУНІНГ держава). Встановлений в 0 щоб вказати, що програмі не потрібно продовжувати працювати
конкретну кількість часу.
ПРИМІТКА:
Навіть якщо процес завершується з «очікуваним» кодом завершення (див коди виходу), початок
все одно вважатиметься невдалим, якщо процес завершиться швидше ніж startsecs.
дефолт: 1
Вимагається: Ні.
Введений: 3.0
почати спроби
Кількість спроб серійного збою керівник дозволить при спробі
запустіть програму перед тим, як відмовитися від процесу та запустити процес FATAL держава. Побачити
process_states для пояснення FATAL стан.
дефолт: 3
Вимагається: Ні.
Введений: 3.0
автоперезапуск
Вказує, якщо керівник повинен автоматично перезапустити процес, якщо він завершується
в РУНІНГ держава. Може бути одним із false, несподіванийабо правда. Якщо false, процес
не буде автоматично перезапущено. Якщо несподіваний, процес буде перезапущено, коли
програма виходить з кодом виходу, який не є одним із кодів виходу, пов’язаних із цим
конфігурація процесу (див коди виходу). Якщо правда, процес буде беззастережним
перезапускається, коли він виходить, незалежно від його коду виходу.
ПРИМІТКА:
автоперезапуск контролює чи керівник автоматично запустить програму, якщо вона завершить роботу
після його успішного запуску (процес знаходиться в РУНІНГ держава).
керівник має інший механізм перезапуску, коли процес запускається
(процес знаходиться в ПОЧАТОК держава). Повторні спроби під час запуску процесу
контролюється startsecs та почати спроби.
дефолт: несподівано
Вимагається: Ні.
Введений: 3.0
коди виходу
Список "очікуваних" кодів виходу для цієї програми, які використовуються з автоперезапуск, Якщо
автоперезапуск для параметра встановлено значення несподіваний, і процес завершується іншим способом, ніж
в результаті запиту керівника про зупинку, керівник перезапустить процес, якщо він
виходить із кодом виходу, який не визначений у цьому списку.
дефолт: 0,2
Вимагається: Ні.
Введений: 3.0
стоп-сигнал
Сигнал, що використовується для припинення програми, коли запитується зупинка. Це може бути будь-який з TERM,
HUP, INT, QUIT, KILL, USR1 або USR2.
дефолт: ТЕРМІН
Вимагається: Ні.
Введений: 3.0
секунди зупинки
Кількість секунд, протягом яких ОС поверне SIGCHILD керівник після
програмі надіслано сигнал зупинки. Якщо ця кількість секунд мине раніше
керівник отримує SIGCHILD від процесу, керівник спробує вбити його
з остаточним SIGKILL.
дефолт: 10
Вимагається: Ні.
Введений: 3.0
stopasgroup
Якщо значення має значення, прапор змушує супервізора надсилати сигнал зупинки всій групі процесів
і має на увазі killasgroup правда. Це корисно для програм, таких як Flask у налагодженні
режим, який не поширює сигнали зупинки своїм дітям, залишаючи їх сиротами.
дефолт: помилковий
Вимагається: Ні.
Введений: 3.0b1
killasgroup
Якщо вірно, вдаючись до відправки SIGKILL до програми, щоб завершити її, надішліть її до її
натомість ціла група процесів, піклуючись також про своїх дітей, корисна, наприклад, с
Використання програм на Python багатопроцесорний.
дефолт: помилковий
Вимагається: Ні.
Введений: 3.0a11
користувач
Інструктаж керівник використовувати цей обліковий запис користувача UNIX як обліковий запис, який запускає
програма. Користувача можна змінити, лише якщо керівник запускається як користувач root. Якщо
керівник не вдається перейти до вказаного користувача, програма не буде запущена.
ПРИМІТКА:
Користувача буде змінено за допомогою Сетуїд тільки Це не запускає оболонку входу та
не змінює змінні середовища, наприклад USER or ГОЛОВНА, Побачити
subprocess_environment для деталей.
дефолт: Не змінюйте користувачів
Вимагається: Ні.
Введений: 3.0
redirect_stderr
Якщо значення true, спричинити відправку результату процесу stderr назад керівник на його стандартний вихід
дескриптор файлу (в термінах оболонки UNIX це еквівалент виконання /Програма
2> & 1).
ПРИМІТКА:
Не встановлюйте redirect_stderr=true в [слухувач подій:x] розділ. Слухачі подій
використання stdout та stdin спілкуватися з керівник. Якщо stderr перенаправлено,
Вихід з stderr заважатиме протоколу прослуховування подій.
дефолт: помилковий
Вимагається: Ні.
Введений: 3.0, замінює 2.0 log_stdout та log_stderr
stdout_logfile
Помістіть вихідні дані процесу stdout в цей файл (і якщо redirect_stderr відповідає дійсності, також помістіть
stderr у цьому файлі). Якщо stdout_logfile не встановлено або встановлено на AUTO, керівник
автоматично вибере місце розташування файлу. Якщо це встановлено на NONE, керівник буде
не створювати файл журналу. AUTO файли журналу та їх резервні копії будуть видалені, коли керівник
перезапускається. The stdout_logfile value може містити рядкові вирази Python, які будуть
оцінюється щодо словника, який містить ключі назва групи, ім'я_вузла хоста,
номер_процесу, назва_програми та тут (каталог конфігураційного файлу supervisord).
ПРИМІТКА:
Два процеси не можуть спільно використовувати один файл журналу (stdout_logfile)
при обертанні (stdout_logfile_maxbytes) увімкнено. Це призведе до створення файлу
бути зіпсованим.
дефолт: AUTO
Вимагається: Ні.
Введений: 3.0, замінює 2.0 файл журналу
stdout_logfile_maxbytes
Максимальна кількість байтів, які можуть бути використані stdout_logfile перед поворотом
(у значенні можна використовувати суфіксні множники, такі як "KB", "MB" і "GB"). Встановіть це
значення до 0, щоб вказати необмежений розмір журналу.
дефолт: 50MB
Вимагається: Ні.
Введений: 3.0, замінює 2.0 logfile_maxbytes
stdout_logfile_backups
Кількість stdout_logfile резервні копії для збереження в результаті журналу стандартного виведення процесу
обертання файлів. Якщо встановлено значення 0, резервні копії не зберігатимуться.
дефолт: 10
Вимагається: Ні.
Введений: 3.0, замінює 2.0 logfile_backups
stdout_capture_maxbytes
Максимальна кількість байтів, записаних для захоплення FIFO, коли процес знаходиться в «режимі захоплення стандартного виведення»
(див. capture_mode). Повинно бути цілим числом (множники суфіксів, наприклад "KB", "MB" і "GB"
можна використовувати у значенні). Якщо це значення дорівнює 0, режим захоплення процесу буде вимкнено.
дефолт: 0
Вимагається: Ні.
Введений: 3.0, замінює 2.0 logfile_backups
stdout_events_enabled
Якщо значення true, події PROCESS_LOG_STDOUT будуть випромінюватися, коли процес записує його
дескриптор файлу stdout. Події відображатимуться, лише якщо дескриптор файлу не є
в режимі захоплення в момент отримання даних (див. capture_mode).
дефолт: 0
Вимагається: Ні.
Введений: 3.0a7
stderr_logfile
Помістіть вихід процесу stderr в цей файл, якщо redirect_stderr правда. Приймає
ті ж типи значень, що й stdout_logfile і може містити ті самі рядкові вирази Python.
ПРИМІТКА:
Два процеси не можуть спільно використовувати один файл журналу (stderr_logfile)
при обертанні (stderr_logfile_maxbytes) увімкнено. Це призведе до створення файлу
бути зіпсованим.
дефолт: AUTO
Вимагається: Ні.
Введений: 3.0
stderr_logfile_maxbytes
Максимальна кількість байтів перед обертанням файлу журналу для stderr_logfile. Приймає
ті ж типи значень, що й stdout_logfile_maxbytes.
дефолт: 50MB
Вимагається: Ні.
Введений: 3.0
stderr_logfile_backups
Кількість резервних копій, які потрібно зберігати в результаті ротації файлу журналу процесу stderr.
Якщо встановлено значення 0, резервні копії не зберігатимуться.
дефолт: 10
Вимагається: Ні.
Введений: 3.0
stderr_capture_maxbytes
Максимальна кількість байтів, записаних для захоплення FIFO, коли процес знаходиться в «режимі захоплення stderr»
(див. capture_mode). Повинно бути цілим числом (множники суфіксів, наприклад "KB", "MB" і "GB"
можна використовувати у значенні). Якщо це значення дорівнює 0, режим захоплення процесу буде вимкнено.
дефолт: 0
Вимагається: Ні.
Введений: 3.0
stderr_events_enabled
Якщо значення true, події PROCESS_LOG_STDERR будуть випромінюватися, коли процес записує його
дескриптор файлу stderr. Події відображатимуться, лише якщо дескриптор файлу не є
в режимі захоплення в момент отримання даних (див. capture_mode).
дефолт: помилковий
Вимагається: Ні.
Введений: 3.0a7
навколишнє середовище
Список пар ключ/значення у формі KEY="val",KEY2="val2" які будуть розміщені в
середовище дитячого процесу. Рядок середовища може містити рядок Python
вирази, які будуть оцінюватися щодо словника, що містить назва групи,
ім'я_вузла хоста, номер_процесу, назва_програми та тут (довідник керівника
конфігураційний файл). Значення, що містять небуквенно-цифрові символи, слід вводити в лапки (наприклад
KEY="val:123",KEY2="val,456"). В іншому випадку введення значень в лапки необов’язкове, але
рекомендується. примітки що підпроцес успадкує змінні середовища
оболонка раніше запускала "supervisord", за винятком тих, які перевизначені тут. Побачити
subprocess_environment.
дефолт: Без додаткового середовища
Вимагається: Ні.
Введений: 3.0
каталог
Шлях до файлу, що представляє каталог, до якого керівник повинен тимчасово chdir
перед виконанням дитини.
дефолт: Немає chdir (успадкувати керівника)
Вимагається: Ні.
Введений: 3.0
умаск
Вісімкове число (наприклад, 002, 022), що представляє маску процесу.
дефолт: Немає спеціальної umask (успадковує супервізор)
Вимагається: Ні.
Введений: 3.0
serverurl
URL-адреса, передана в середовищі до процесу підпроцесу як SUPERVISOR_SERVER_URL
(Див. supervisor.childutils), щоб дозволити підпроцесу легко взаємодіяти з
внутрішній HTTP-сервер. Якщо вказано, він повинен мати такий самий синтаксис і структуру, що й
[supervisorctl] однойменний варіант розділу. Якщо для цього параметра встановлено значення AUTO або не встановлено,
supervisor автоматично створить URL-адресу сервера, віддаючи перевагу серверу
який прослуховує сокети домену UNIX над тим, що прослуховує сокет Інтернету.
дефолт: АВТО
Вимагається: Ні.
Введений: 3.0
[програма:x] розділ Приклад
[програма:кішка]
command =/bin/cat
process_name=%(назва_програми)s
numprocs=1
каталог=/ Tmp
umask=022
priority = 999
автозапуск = істина
автоперезапуск = неочікуваний
початкові секунди=10
startretries=3
коди виходу=0,2
стопсигнал=ТЕРМІН
стоп-секунд = 10
stopasgroup=false
killasgroup=false
користувач=хризм
redirect_stderr=false
stdout_logfile=/a/шлях
stdout_logfile_maxbytes=1 МБ
stdout_logfile_backups=10
stdout_capture_maxbytes=1 МБ
stdout_events_enabled=false
stderr_logfile=/a/шлях
stderr_logfile_maxbytes=1 МБ
stderr_logfile_backups=10
stderr_capture_maxbytes=1 МБ
stderr_events_enabled=false
середовище=A="1",B="2"
serverurl=АВТОМАТИЧНО
[включати] розділ Налаштування
Команда supervisord.conf файл може містити розділ з іменем [включати]. Якщо конфігурація
файл містить файл [включати] розділ, він повинен містити один ключ під назвою «файли». The
значення в цьому ключі вказують інші файли конфігурації, які будуть включені в
configuration.
[включати] розділ Цінності
файли
Відокремлена пробілом послідовність файлів globs. Кожен файл glob може бути абсолютним або відносним.
Якщо файл glob відносний, він розглядається відносно розташування файлу
конфігураційний файл, який містить його. "Глоба" - це шаблон файлу, який відповідає a
зазначений шаблон відповідно до правил, які використовує оболонка Unix. Розширення тильди немає
зроблено, але *, ?, і діапазони символів, виражені за допомогою [] буде правильно підібрано.
Рекурсивні включення із включених файлів не підтримуються.
дефолт: за замовчуванням немає (обов'язково)
Вимагається: Так.
Введений: 3.0
[включати] розділ Приклад
[включати]
файли = /an/absolute/filename.conf /an/absolute/*.conf foo.conf config??.conf
[група:x] розділ Налаштування
Часто корисно згрупувати "однорідні" групи процесів (він же "програми") разом в a
"гетерогенну" групу процесів, щоб ними можна було керувати як одиницю від керівника
різноманітні інтерфейси контролера.
Щоб помістити програми в групу, щоб ви могли розглядати їх як одиницю, визначте a [група:x] розділ
у вашому конфігураційному файлі. Значення заголовка групи є складеним. Це слово
"група", за якою слід двокрапка, потім назва групи. Значення заголовка [група:foo]
описує групу з назвою "foo". Ім'я використовується в клієнтських програмах
які керують процесами, які створюються в результаті цієї конфігурації. Це є
помилка створення a група розділ, який не має назви. Ім’я не повинно містити a
символ двокрапки або символ дужки.
Для [група:x], має бути один або кілька [програма:x] розділи в інших місцях вашого
конфігураційного файлу, і група повинна посилатися на них за іменем у файлі програми value.
Якщо "однорідні" групи процесів (представлені розділами програми) поміщаються в a
«гетерогенна» група через [група:x] розділів програми лінії, однорідні групи, що
передбачені розділом програми, не буде існувати під час виконання в супервізорі. Натомість все
процеси, що належать кожній з однорідних груп, будуть поміщені в
гетерогенна група. Наприклад, враховуючи таку конфігурацію групи:
[група:foo]
програми=бар,баз
priority = 999
Враховуючи вищевикладене, під час запуску супервізора бар та Baz однорідних груп не буде
існують, і процеси, які були б під ними, тепер будуть переміщені в Foo
група.
[група:x] розділ Цінності
програми
Відокремлений комами список імен програм. Перелічені програми стають членами
групи.
дефолт: за замовчуванням немає (обов'язково)
Вимагається: Так.
Введений: 3.0
пріоритет
Пріоритетний номер, аналогічний a [програма:x] значення пріоритету, призначене групі.
дефолт: 999
Вимагається: Ні.
Введений: 3.0
[група:x] розділ Приклад
[група:foo]
програми=бар,баз
priority = 999
[fcgi-програма:x] розділ Налаштування
Керівник може керувати групами FastCGI процеси, які всі прослуховуються в одному сокеті.
До цього часу гнучкість розгортання FastCGI була обмеженою. Щоб отримати повний процес
управління, ви можете використовувати mod_fastcgi під Apache, але тоді ви застрягли з Apache
неефективна модель паралельності одного процесу або потоку на з'єднання. На додаток до
вимагаючи більше ресурсів ЦП і пам'яті, процес/потік на модель підключення може бути
швидко насичується повільним ресурсом, що перешкоджає обслуговуванню інших ресурсів. в
щоб скористатися перевагами нових веб-серверів, керованих подіями, таких як lighttpd або nginx, які
не включайте вбудований менеджер процесів, вам доводилося використовувати такі сценарії, як cgi-fcgi або
spawn-fcgi. Їх можна використовувати разом з менеджером процесів, таким як супервізор
або daemontools, але вимагають, щоб кожен дочірній процес FastCGI був прив'язаний до свого власного сокета. The
недоліками цього є: невиправдано складна конфігурація веб-сервера, невишуканість
перезапуску та зниження відмовостійкості. Веб-сервер із меншою кількістю сокетів для налаштування
конфігурації набагато менші, якщо групи процесів FastCGI можуть спільно використовувати сокети. Спільний
сокети дозволяють витончені перезапуски, оскільки сокет залишається прив’язаним до батьківського процесу
під час перезапуску будь-якого з дочірніх процесів. Нарешті, спільних розеток більше
відмовостійкість, тому що якщо даний процес дає збій, інші процеси можуть продовжувати працювати
вхідні з'єднання.
Завдяки інтегрованій підтримці створення FastCGI Supervisor надає вам найкраще з обох світів.
Ви отримуєте повнофункціональне керування процесами за допомогою груп процесів FastCGI, які спільно використовують сокети
без прив’язки до певного веб-сервера. Це чистий поділ турбот,
дозволяючи веб-серверу та менеджеру процесів робити те, що вони найкраще вміють.
ПРИМІТКА:
Менеджер сокетів у Supervisor спочатку був розроблений для підтримки процесів FastCGI
але це не обмежується FastCGI. Інші протоколи також можна використовувати без особливих умов
конфігурації. Будь-яка програма, яка може отримати доступ до відкритого сокета з дескриптора файлу (наприклад
з socket.fromfd в Python) можна використовувати менеджер сокетів. Супервайзер буде
автоматично створювати сокет, прив’язувати та слухати, перш ніж розділити першу дочірню частину в a
група. Сокет буде переданий кожній дитині за номером дескриптора файлу 0 (нуль)
Коли остання дитина в групі вийде, супервізор закриє розетку.
Усі доступні варіанти [програма:x] розділи також користуються повагою fcgi-програма
розділи.
[fcgi-програма:x] розділ Цінності
[fcgi-програма:x] розділи мають один ключ, який [програма:x] розділів не мають.
розетка
Сокет FastCGI для цієї програми, TCP або UNIX доменний сокет. Для сокетів TCP,
використовуйте цей формат: tcp://localhost:9002. Для сокетів домену UNIX використовуйте
unix:///absolute/path/to/file.sock. Рядкові вирази оцінюються відносно a
словник, що містить ключі «назва_програми» та «тут» (каталог файлу
конфігураційний файл supervisord).
дефолт: Немає за замовчуванням.
Вимагається: Так.
Введений: 3.0
socket_owner
Для сокетів домену UNIX цей параметр можна використовувати для визначення користувача та групи
сокет FastCGI. Може бути ім'ям користувача UNIX (наприклад, chrism) або ім'ям користувача та групою UNIX
розділені двокрапкою (наприклад, chrism:wheel).
дефолт: Використовує набір користувачів і груп для програми fcgi
Вимагається: Ні.
Введений: 3.0
socket_mode
Для сокетів домену UNIX цей параметр можна використовувати для визначення режиму дозволу.
дефолт: 0700
Вимагається: Ні.
Введений: 3.0
Консультувати [програма:x] розділ Налаштування для інших допустимих ключів дельта наведених вище обмежень
і доповнення.
[fcgi-програма:x] розділ Приклад
[fcgi-програма:fcgiprogramname]
команда=/usr/bin/example.fcgi
socket=unix:///var/run/supervisor/%(назва_програми)s.sock
socket_owner=хризм
socket_mode=0700
process_name=%(назва_програми)s_%(process_num)02d
numprocs=5
каталог=/ Tmp
umask=022
priority = 999
автозапуск = істина
автоперезапуск = неочікуваний
початкові секунди=1
startretries=3
коди виходу=0,2
stopsignal=ВИХІД
stopasgroup=false
killasgroup=false
стоп-секунд = 10
користувач=хризм
redirect_stderr=true
stdout_logfile=/a/шлях
stdout_logfile_maxbytes=1 МБ
stdout_logfile_backups=10
stdout_events_enabled=false
stderr_logfile=/a/шлях
stderr_logfile_maxbytes=1 МБ
stderr_logfile_backups=10
stderr_events_enabled=false
середовище=A="1",B="2"
serverurl=АВТОМАТИЧНО
[слухувач подій:x] розділ Налаштування
Supervisor дозволяє створювати спеціалізовані однорідні групи процесів ("пули слухачів подій").
визначено у файлі конфігурації. Ці пули містять процеси, які призначені для
отримувати сповіщення про події від системи подій керівника та відповідати на них. Дивіться події для
пояснення того, як працюють події та як реалізувати програми, які можна оголосити як
слухачі подій.
Зверніть увагу, що всі доступні варіанти [програма:x] розділи поважаються eventlistener
розділам крім та цінності stdout_capture_maxbytes та stderr_capture_maxbytes (слухачі події
не може видавати події комунікації процесу, див. capture_mode).
[слухувач подій:x] розділ Цінності
[слухувач подій:x] розділи мають кілька ключів, які [програма:x] розділів не мають.
розмір буфера
Розмір буфера черги подій пулу обробників подій. Коли буфер подій пулу слухачів
переповнено (як це може статися, коли пул прослуховувачів подій не може встигати з усіма
події, надіслані до нього), найстаріша подія в буфері відкидається.
Події
Відокремлений комами список імен типів подій, які "цікавлять" цього слухача
отримання сповіщень для (див. event_types для списку дійсних назв типів подій).
обробник_результату
A pkg_resources запис точка рядок який розв’язується до виклику Python. За замовчуванням
значення є supervisor.dispatchers:default_handler. Визначення альтернативного результату
Обробник – це дуже рідкісне завдання, і, як наслідок, як його створити
не документовано.
Консультувати [програма:x] розділ Налаштування для інших допустимих ключів дельта наведених вище обмежень
і доповнення.
[слухувач подій:x] розділ Приклад
[eventlistener:theeventlistenername]
command=/bin/eventlistener
process_name=%(назва_програми)s_%(process_num)02d
numprocs=5
події=PROCESS_STATE
buffer_size=10
каталог=/ Tmp
umask=022
пріоритет=-1
автозапуск = істина
автоперезапуск = неочікуваний
початкові секунди=1
startretries=3
коди виходу=0,2
stopsignal=ВИХІД
стоп-секунд = 10
stopasgroup=false
killasgroup=false
користувач=хризм
redirect_stderr=false
stdout_logfile=/a/шлях
stdout_logfile_maxbytes=1 МБ
stdout_logfile_backups=10
stdout_events_enabled=false
stderr_logfile=/a/шлях
stderr_logfile_maxbytes=1 МБ
stderr_logfile_backups=10
stderr_events_enabled=false
середовище=A="1",B="2"
serverurl=АВТОМАТИЧНО
[rpcinterface:x] розділ Налаштування
Додавання rpcinterface:x налаштування у файлі конфігурації корисні лише для людей, які
бажаєте розширити супервізор за допомогою додаткової настроюваної поведінки.
У прикладі конфігураційного файлу є розділ, який має назву [rpcinterface:супервізор].
За замовчуванням це виглядає наступним чином.
[rpcinterface:супервізор]
supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface
Команда [rpcinterface:супервізор] розділ повинен залишаються в конфігурації для стандарту
налаштування супервізора для належної роботи. Якщо ви не хочете, щоб супервізор щось робив
це все, що вам потрібно знати про цей тип
.
Однак, якщо ви хочете додати простори імен інтерфейсу rpc, щоб налаштувати супервізор, ви
можуть додати додаткові [rpcinterface:foo] розділи, де "foo" представляє простір імен
інтерфейс (з кореневого веб-сайту) і значення, назване by supervisor.rpcinterface_factory
є заводським викликом, який повинен мати сигнатуру функції, яка приймає одиночний
позиційний аргумент керівник і стільки аргументів ключових слів, скільки потрібно для виконання
конфігурації. Будь-які додаткові пари ключ/значення, визначені в межах [rpcinterface:x] розділ буде
передаватися як аргументи ключового слова на фабрику.
Ось приклад заводської функції, створеної в __init__.py файл Python
пакет мій.пакет.
з my.package.rpcinterface імпортувати AnotherRPCInterface
def make_another_rpcinterface(supervisord, **config):
повторює = int(config.get('повторити', 0))
another_rpc_interface = Інший інтерфейс RPCI (керівник, повторює спробу)
повернути other_rpc_interface
І розділ у файлі конфігурації призначений для його налаштування.
[rpcinterface:інший]
supervisor.rpcinterface_factory = my.package:make_another_rpcinterface
повторних спроб = 1
[rpcinterface:x] розділ Цінності
supervisor.rpcinterface_factory
pkg_resources "точка входу" до заводської функції інтерфейсу RPC.
дефолт: N / A
Вимагається: Ні.
Введений: 3.0
[rpcinterface:x] розділ Приклад
[rpcinterface:інший]
supervisor.rpcinterface_factory = my.package:make_another_rpcinterface
повторних спроб = 1
глосарій
демомонтоли
A процес контроль система by Діджей Bernstein.
запуск
A процес контроль система використовуваний by Apple як процес 1 під Mac OS X.
runit A процес контроль система.
Суперланс
Пакет, який надає різні реалізації прослуховування подій, які підключаються
Супервізор, який може допомогти відстежувати використання пам'яті процесом і стан збою:
http://pypi.python.org/pypi/superlance.
умаск Абревіатура від користувач маска: встановлює маску створення режиму файлу поточного процесу.
Читати http://en.wikipedia.org/wiki/Umask.
Використовуйте echo_supervisord_conf онлайн за допомогою служб onworks.net
