echo_supervisord_conf - Онлайн в облаке

ПРОГРАММА:

ИМЯ

echo_supervisord_conf - Документация по конфигурации супервизора

Supervisor - это система клиент / сервер, которая позволяет пользователям отслеживать и контролировать количество
процессов в UNIX-подобных операционных системах.

Он преследует те же цели, что и такие программы, как launchd, daemontools и runit. В отличие от
некоторые из этих программ не предназначены для использования вместо инициализации как "идентификатор процесса
1 ". Вместо этого он предназначен для управления процессами, связанными с проектом или
client, и он должен запускаться, как и любая другая программа, во время загрузки.

ДОКУМЕНТАЦИЯ

Создающий a Конфигурация Файл
После завершения установки Supervisor запустите echo_supervisord_conf, Это будет
распечатайте "образец" файла конфигурации Supervisor на стандартный вывод вашего терминала.

Как только вы увидите, что файл отражен на вашем терминале, повторно вызовите команду как
echo_supervisord_conf > /etc/supervisord.conf. Это не сработает, если у вас нет root
доступа.

Если у вас нет root-доступа или вы не хотите ставить supervisard.conf файл в
/ etc / supervisord.conf`, вы можете поместить его в текущий каталог (echo_supervisord_conf >
supervisard.conf) и начать руководитель с -c флаг, чтобы указать
расположение файла конфигурации.

Например, руководитель -c supervisard.conf, С использованием -c флаг на самом деле избыточен в
в этом случае, потому что руководитель ищет в текущем каталоге supervisard.conf
перед поиском файла в любом другом месте, но он будет работать.

Когда у вас есть файл конфигурации в вашей файловой системе, вы можете начать изменять его на свой
симпатия.

Конфигурация Файл
Файл конфигурации Supervisor обычно называется supervisard.conf, Используется
изоферменты печени руководитель и супервизорктл. Если какое-либо приложение запущено без -c
option (опция, которая используется, чтобы сообщить приложению имя файла конфигурации
явно), приложение будет искать файл с именем supervisard.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.

Файл Формат
supervisard.conf - это файл в стиле Windows INI (Python ConfigParser). В нем есть разделы (каждый
обозначается [заголовок]) и пары ключ / значение в разделах. Разделы и их
допустимые значения описаны ниже.

Окружающая среда Переменные
Переменные среды, которые присутствуют в среде в то время, когда руководитель is
Start может использоваться в файле конфигурации с использованием синтаксиса строкового выражения Python
% (ENV_X) с:

[программа: пример]
команда = / usr / bin / example --loglevel =% (ENV_LOGLEVEL) s

В приведенном выше примере выражение % (ENV_LOGLEVEL) с будет увеличено до значения
переменная окружения ЛОГИЧЕСКИЙ УРОВЕНЬ.

ПРИМЕЧАНИЕ:
В Supervisor 3.2 и более поздних версиях % (ENV_X) с выражения поддерживаются во всех вариантах. В
в предыдущих версиях некоторые параметры их поддерживают, но большинство - нет. Документацию для
каждый вариант ниже.

[unix_http_сервер] Раздел Настройки
Ассоциация supervisard.conf файл содержит раздел с именем [unix_http_сервер] под которым
параметры конфигурации для HTTP-сервера, который прослушивает сокет домена UNIX, должны быть
вставлен. Если в файле конфигурации нет [unix_http_сервер] раздел, домен UNIX
HTTP-сервер сокета не запускается. Допустимые значения конфигурации:
следующим образом.

[unix_http_сервер] Раздел Наши ценности
файл
Путь к сокету домена UNIX (например, /tmp/supervisord.sock) на котором руководитель будет
прослушивать запросы HTTP / XML-RPC. супервизорктл использует XML-RPC для связи с
руководитель через этот порт. Эта опция может включать значение % (здесь) s, который расширяет
в каталог, в котором руководитель файл конфигурации найден.

По умолчанию: Нет.

необходимые: Нет

Введенный: 3.0

CHMOD
Измените биты режима разрешений UNIX сокета домена UNIX на это значение в
запускать.

По умолчанию: 0700

необходимые: Нет

Введенный: 3.0

Чаун
Измените пользователя и группу файла сокета на это значение. Может быть именем пользователя UNIX
(например миро) или имя пользователя и группа UNIX, разделенные двоеточием (например, мир: колесо).

По умолчанию: Используйте имя пользователя и группу пользователя, который запускает супервизор.

необходимые: Нет

Введенный: 3.0

username
Имя пользователя, необходимое для аутентификации на этом HTTP-сервере.

По умолчанию: Имя пользователя не требуется.

необходимые: Нет

Введенный: 3.0

password
Пароль, необходимый для аутентификации на этом HTTP-сервере. Это может быть открытый текст
пароль, или может быть указан как хэш SHA-1, если перед ним стоит строка {ША}. Для
пример, {SHA}82ab876d1387bfafe46cc1c8a2ef074eae50cb1d это версия файла, хранящаяся в SHA.
пароль "пароль".

Обратите внимание, что хешированный пароль должен быть в шестнадцатеричном формате.

По умолчанию: Пароль не требуется.

необходимые: Нет

Введенный: 3.0

[unix_http_сервер] Раздел Пример
[unix_http_сервер]
файл = /tmp/supervisor.sock
чмод = 0777
chown = никто: nogroup
имя пользователя = пользователь
пароль = 123

[inet_http_сервер] Раздел Настройки
Ассоциация supervisard.conf файл содержит раздел с именем [inet_http_сервер] под которым
параметры конфигурации для HTTP-сервера, который прослушивает TCP (Интернет) сокет, должны
быть вставленным. Если в файле конфигурации нет [inet_http_сервер] раздел, inet HTTP
сервер не запускается. Допустимые значения конфигурации следующие.

[inet_http_сервер] Раздел Наши ценности
порт
Хост TCP: значение порта или (например, 127.0.0.1:9001) на котором супервизор будет слушать
Запросы HTTP / XML-RPC. супервизорктл будет использовать XML-RPC для связи с руководитель
через этот порт. Чтобы прослушивать все интерфейсы в машине, используйте : 9001 or *: 9001.

По умолчанию: По умолчанию нет.

необходимые: Да.

Введенный: 3.0

username
Имя пользователя, необходимое для аутентификации на этом HTTP-сервере.

По умолчанию: Имя пользователя не требуется.

необходимые: Нет

Введенный: 3.0

password
Пароль, необходимый для аутентификации на этом HTTP-сервере. Это может быть открытый текст
пароль, или может быть указан как хэш SHA-1, если перед ним стоит строка {ША}. Для
пример, {SHA}82ab876d1387bfafe46cc1c8a2ef074eae50cb1d это версия файла, хранящаяся в SHA.
пароль "пароль".

Обратите внимание, что хешированный пароль должен быть в шестнадцатеричном формате.

По умолчанию: Пароль не требуется.

необходимые: Нет

Введенный: 3.0

[inet_http_сервер] Раздел Пример
[inet_http_сервер]
порт = 127.0.0.1:9001
имя пользователя = пользователь
пароль = 123

[супервайзер] Раздел Настройки
Ассоциация supervisard.conf файл содержит раздел с именем [супервайзер] в каких глобальных настройках
связанный с руководитель процесс должен быть вставлен. Это следующие.

[супервайзер] Раздел Наши ценности
журнальный файл
Путь к журналу активности супервизора. Этот вариант может включать
ценностное % (здесь) s, который расширяется до каталога, в котором конфигурация супервизора
файл был найден.

По умолчанию: $ CWD / supervisord.log

необходимые: Нет

Введенный: 3.0

logfile_maxbytes
Максимальное количество байтов, которое может быть использовано файлом журнала активности до его использования.
повернутый (в значении можно использовать суффиксные множители, такие как «КБ», «МБ» и «ГБ»). Установленный
это значение равно 0, чтобы указать неограниченный размер журнала.

По умолчанию: 50MB

необходимые: Нет

Введенный: 3.0

logfile_backups
Количество хранимых резервных копий в результате ротации файла журнала активности. Если установлено
на 0, резервные копии не будут сохраняться.

По умолчанию: 10

необходимые: Нет

Введенный: 3.0

уровень журнала
Уровень ведения журнала, определяющий, что записывается в журнал активности супервизора. Один из
критической, ошибка, предупреждать, info, отлаживать, прослеживатьили болтовня. Обратите внимание, что на уровне журнала отлаживать,
файл журнала супервизора будет записывать вывод stderr / stdout его дочерних процессов
и расширенная информация об изменениях состояния процесса, которая полезна для отладки
процесс, который не запускается должным образом. См. Также: activity_log_levels.

По умолчанию: Информация

необходимые: Нет

Введенный: 3.0

pid-файл
Местоположение, в котором supervisord хранит свой файл pid. Этот вариант может включать
ценностное % (здесь) s, который расширяется до каталога, в котором конфигурация супервизора
файл был найден.

По умолчанию: $ CWD / supervisord.pid

необходимые: Нет

Введенный: 3.0

Umask
Маска супервизора.

По умолчанию: 022

необходимые: Нет

Введенный: 3.0

нодэмон
Если true, supervisord будет запускаться на переднем плане вместо демонизации.

По умолчанию: ложный

необходимые: Нет

Введенный: 3.0

Минфдс
Минимальное количество файловых дескрипторов, которые должны быть доступны, прежде чем супервизор сможет
начать успешно. Будет сделан вызов setrlimit, чтобы попытаться поднять мягкую и
жесткие ограничения процесса надзора для удовлетворения Минфдс. Жесткий предел может быть только
возникает, если супервизор запускается от имени пользователя root. supervisord широко использует файловые дескрипторы, и
войдет в режим сбоя, если его нельзя получить из ОС, поэтому полезно
возможность указать минимальное значение, чтобы гарантировать, что они не закончатся во время выполнения.
Этот параметр особенно полезен в Solaris, который имеет низкий лимит fd для каждого процесса на
по умолчанию.

По умолчанию: 1024

необходимые: Нет

Введенный: 3.0

минпроцессы
Минимальное количество дескрипторов процессов, которые должны быть доступны перед супервизором.
начнется успешно. Будет сделан вызов setrlimit, чтобы попытаться поднять мягкую
и жесткие ограничения процесса надзора для удовлетворения минпроцессы. Жесткий предел может
может быть поднят только в том случае, если supervisord запущен от имени пользователя root. супервизор перейдет в режим отказа
когда в ОС заканчиваются дескрипторы процесса, поэтому полезно убедиться, что достаточно
дескрипторы процессов доступны по руководитель запускать.

По умолчанию: 200

необходимые: Нет

Введенный: 3.0

ночистка
Запретить супервизору очистить существующие AUTO дочерние файлы журнала во время запуска.
Полезно для отладки.

По умолчанию: ложный

необходимые: Нет

Введенный: 3.0

дочерний каталог
Каталог, используемый для AUTO дочерние файлы журналов. Эта опция может включать значение
% (здесь) s, который расширяется до каталога, в котором руководитель файл конфигурации
был найден.

По умолчанию: значение Python tempfile.get_tempdir ()

необходимые: Нет

Введенный: 3.0

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

По умолчанию: не переключать пользователей

необходимые: Нет

Введенный: 3.0

каталог
После появления руководитель демонизирует, переключитесь в этот каталог. Этот вариант может включать
ценностное % (здесь) s, который расширяется до каталога, в котором руководитель конфигурация
файл был найден.

По умолчанию: не cd

необходимые: Нет

Введенный: 3.0

Strip_ansi
Удалите все escape-последовательности ANSI из дочерних файлов журнала.

По умолчанию: ложный

необходимые: Нет

Введенный: 3.0

охрана окружающей среды
Список пар ключ / значение в форме KEY = "val", KEY2 = "val2" который будет помещен в
руководитель процесс 'среда (и, как следствие, весь его дочерний процесс'
среды). Эта опция может включать значение % (здесь) s, который расширяется до
каталог, в котором был найден файл конфигурации супервизора. Ценности, содержащие
не буквенно-цифровые символы должны быть заключены в кавычки (например, KEY = "val: 123", KEY2 = "val, 456").
В противном случае указывать значения в кавычках необязательно, но рекомендуется. Чтобы избежать процентов
символов, просто используйте два. (например URI = "/ первое %% 20name") Внимание что подпроцессы будут
наследовать переменные среды оболочки, используемой для запуска руководитель кроме
переопределенные здесь и в пределах программы охрана окружающей среды вариант. Видеть
подпроцесс_среда.

По умолчанию: нет значений

необходимые: Нет

Введенный: 3.0

идентификатор
Строка идентификатора для этого процесса супервизора, используемая интерфейсом RPC.

По умолчанию: руководитель

необходимые: Нет

Введенный: 3.0

[супервайзер] Раздел Пример
[супервайзер]
файл журнала = /tmp/supervisord.log
logfile_maxbytes = 50 МБ
logfile_backups = 10
loglevel = информация
pidfile = /tmp/supervisord.pid
nodaemon = ложь
минфдс = 1024
минпрокс = 200
маска = 022
пользователь = миро
идентификатор = руководитель
каталог = / Tmp
nocleanup = правда
дочерний_каталог = / Tmp
strip_ansi = ложь
среда = KEY1 = "значение1", KEY2 = "значение2"

[супервизорктл] Раздел Настройки
Файл конфигурации может содержать настройки для супервизорктл интерактивная оболочка
программа. Эти варианты перечислены ниже.

[супервизорктл] Раздел Наши ценности
URL-адрес сервера
URL-адрес, который следует использовать для доступа к серверу супервизора, например
http://localhost: 9001. Для сокетов домена UNIX используйте
unix: ///absolute/path/to/file.sock.

По умолчанию: http://localhost: 9001

необходимые: Нет

Введенный: 3.0

username
Имя пользователя, передаваемое на сервер супервизора для использования при аутентификации. Это должно
быть таким же, как username из конфигурации сервера супервизора для порта или UNIX
сокет домена, к которому вы пытаетесь получить доступ.

По умолчанию: Нет имени пользователя

необходимые: Нет

Введенный: 3.0

password
Пароль для передачи серверу супервизора для использования при аутентификации. Это должно
быть открытой текстовой версией password из конфигурации сервера супервизора для
порт или сокет домена UNIX, к которому вы пытаетесь получить доступ. Это значение нельзя передать как
хеш SHA. В отличие от других паролей, указанных в этом файле, он должен быть указан в
открытый текст.

По умолчанию: Нет пароля

необходимые: Нет

Введенный: 3.0

подсказка
Строка, используемая как подсказка supervisorctl.

По умолчанию: руководитель

необходимые: Нет

Введенный: 3.0

файл_истории
Путь для использования в качестве Readline постоянный файл истории. Если вы включите эту функцию
выбрав путь, ваши команды supervisorctl будут сохранены в файле, и вы можете использовать
строка чтения (например, стрелка вверх) для вызова команд, которые вы выполнили в своем последнем supervisorctl
сессия.

По умолчанию: Нет файла

необходимые: Нет

Введенный: 3.0а5

[супервизорктл] Раздел Пример
[супервизорктл]
serverurl = unix: ///tmp/supervisor.sock
имя пользователя = Крис
пароль = 123
подсказка = mysupervisor

[программа: x] Раздел Настройки
Файл конфигурации должен содержать один или несколько программа разделы по заказу супервайзера
чтобы знать, какие программы следует запускать и контролировать. Значение заголовка - составное значение.
Это слово «программа», за которым сразу следует двоеточие, а затем имя программы. Заголовок
Значение [программа: foo] описывает программу с именем «foo». Имя используется
в клиентских приложениях, которые управляют процессами, которые создаются в результате этого
конфигурация. Ошибка при создании программа раздел, у которого нет имени. В
имя не должно включать символ двоеточия или скобку. Значение имени
используется как значение для % (имя_программы) s расширение строкового выражения внутри других значений
где указано.

ПРИМЕЧАНИЕ:
A [программа: x] раздел фактически представляет для руководителя "однородную группу процессов"
(по состоянию на 3.0). Члены группы определяются комбинацией Numprocs
и Имя процесса параметры в конфигурации. По умолчанию, если numprocs и
process_name остаются неизменными по сравнению с их значениями по умолчанию, группа, представленная
[программа: x] будет назван x и будет иметь единственный процесс с именем x в этом. Этот
обеспечивает небольшую обратную совместимость со старыми выпусками супервизора, которые
не рассматривать разделы программы как определения однородных групп процессов.

Но, например, если у вас есть [программа: foo] раздел с Numprocs 3 и
Имя процесса выражение % (имя_программы) s _% (номер_процесса) 02d, группа "foo" будет
содержат три процесса с именами фу_00, фу_01качества фу_02. Это дает возможность
запускать несколько очень похожих процессов, используя один [программа: x] раздел. Все
имена файлов журнала, все строки среды и команды программ также могут содержать
похожие строковые выражения Python, чтобы передавать немного разные параметры каждому
процесс.

[программа: x] Раздел Наши ценности
команду
Команда, которая будет запущена при запуске этой программы. Команда может быть либо
абсолютный (например, / путь / к / имени программы) или родственник (например, имя программы). Если это
родственник, окружение начальника $ PATH будет выполняться поиск исполняемого файла.
Программы могут принимать аргументы, например / путь / к / программе Foo бар. В командной строке можно использовать
двойные кавычки для группировки аргументов с пробелами в них для передачи программе, например
/ путь / к / программе / имени -p "фу бар". Обратите внимание, что значение команду может включать Python
строковые выражения, например / путь / к / имени программы --port = 80% (номер_процесса) 02d может расшириться
в / путь / к / имени программы --port = 8000 во время выполнения. Строковые выражения оцениваются
против словаря, содержащего ключи имя группы, имя_узла_хоста, номер_процесса,
имя_программы, здесь (каталог конфигурационного файла супервизора), и все
переменные среды supervisord с префиксом ЕНВ_. Контролируемые программы должны
сами не являются демонами, поскольку супервизор предполагает, что он несет ответственность за демонизацию своего
подпроцессы (см. отсутствие демонстрации_подпроцессов).

По умолчанию: По умолчанию нет.

необходимые: Да.

Введенный: 3.0

Имя процесса
Строковое выражение Python, которое используется для создания имени процесса супервизора для этого
процесс. Обычно вам не нужно беспокоиться об установке этого параметра, если вы не измените
Numprocs. Строковое выражение оценивается по словарю, который включает
имя группы, имя_узла_хоста, номер_процесса, имя_программыкачества здесь (справочник
файл конфигурации supervisord).

По умолчанию: % (имя_программы) s

необходимые: Нет

Введенный: 3.0

Numprocs
Supervisor запустит столько экземпляров этой программы, сколько указано в numprocs. Примечание
что если numprocs> 1, Имя процесса выражение должно включать % (process_num) s (или любой
другое допустимое строковое выражение Python, которое включает номер_процесса) внутри.

По умолчанию: 1

необходимые: Нет

Введенный: 3.0

numprocs_start
Целочисленное смещение, которое используется для вычисления числа, при котором Numprocs начинается.

По умолчанию: 0

необходимые: Нет

Введенный: 3.0

приоритет
Относительный приоритет программы в порядке запуска и остановки. Ниже
приоритеты указывают программы, которые запускаются первыми и завершают работу при запуске, а также когда
в различных клиентах используются агрегированные команды (например, «запустить все» / «остановить все»). Выше
приоритеты указывают программы, которые запускаются последними и завершаются первыми.

По умолчанию: 999

необходимые: Нет

Введенный: 3.0

автоматический старт
Если true, эта программа запустится автоматически при запуске супервизора.

По умолчанию: правда

необходимые: Нет

Введенный: 3.0

стартовые секунды
Общее количество секунд, в течение которых программа должна работать после запуска, чтобы
считать начало успешным (перенос процесса из ЗАПУСК заявить
БЕГ штат). Установлен в 0 чтобы указать, что программа не должна продолжать работу в течение какого-либо
определенное количество времени.

ПРИМЕЧАНИЕ:
Даже если процесс завершается с «ожидаемым» кодом выхода (см. коды выхода), начало
будет по-прежнему считаться неудачным, если процесс завершится быстрее, чем стартовые секунды.

По умолчанию: 1

необходимые: Нет

Введенный: 3.0

попытки
Количество последовательных попыток сбоя, которые руководитель позволит при попытке
запустить программу, прежде чем сдаться и поставить процесс на FATAL штат. Видеть
process_states для объяснения FATAL состоянии.

По умолчанию: 3

необходимые: Нет

Введенный: 3.0

автоперезапуск
Указывает, если руководитель должен автоматически перезапускать процесс, если он завершается, когда он
в БЕГ штат. Может быть одним из ложный, неожиданныйили правда. Если ложный, процесс
не будет перезапущен автоматически. Если неожиданный, процесс будет перезапущен, когда
программа завершается с кодом выхода, который не является одним из кодов выхода, связанных с этим
конфигурация процесса (см. коды выхода). если правда, процесс будет безоговорочно
перезапускается при выходе, независимо от кода выхода.

ПРИМЕЧАНИЕ:
автоперезапуск контролирует, есть ли руководитель автоматически перезапустит программу, если она завершится
после успешного запуска (процесс находится в БЕГ штат).

руководитель имеет другой механизм перезапуска, когда процесс запускается
(процесс находится в ЗАПУСК штат). Повторные попытки при запуске процесса
контролируется стартовые секунды и попытки.

По умолчанию: непредвиденный

необходимые: Нет

Введенный: 3.0

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

По умолчанию: 0,2

необходимые: Нет

Введенный: 3.0

стоп-сигнал
Сигнал, используемый для завершения программы при запросе остановки. Это может быть любой СРОК,
HUP, INT, QUIT, KILL, USR1 или USR2.

По умолчанию: СРОК

необходимые: Нет

Введенный: 3.0

стоп-ваитсек
Количество секунд ожидания, пока ОС вернет SIGCHILD в руководитель после
программе был отправлен стоп-сигнал. Если это количество секунд пройдет до того, как
руководитель получает SIGCHILD от процесса, руководитель попытается убить его
с финальным SIGKILL.

По умолчанию: 10

необходимые: Нет

Введенный: 3.0

стопасгрупп
Если true, флаг заставляет супервизор отправить сигнал остановки всей группе процессов.
и подразумевает килласгрупп правда. Это полезно для программ, таких как Flask при отладке.
режим, который не передает сигналы остановки своим детям, оставляя их сиротами.

По умолчанию: ложный

необходимые: Нет

Введенный: 3.0b1

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

По умолчанию: ложный

необходимые: Нет

Введенный: 3.0а11

пользователь
инструктировать руководитель использовать эту учетную запись пользователя UNIX в качестве учетной записи, которая запускает
программа. Пользователь может быть переключен только в том случае, если руководитель запускается от имени пользователя root. Если
руководитель невозможно переключиться на указанного пользователя, программа не запустится.

ПРИМЕЧАНИЕ:
Пользователь будет изменен с помощью УИП Только. Это не запускает оболочку входа в систему и
не изменяет переменные среды, такие как USER or ГЛАВНАЯ. Посмотреть
subprocess_environment для подробностей.

По умолчанию: Не переключать пользователей

необходимые: Нет

Введенный: 3.0

redirect_stderr
Если true, то вывод stderr процесса будет отправлен обратно в руководитель на его стандартном выходе
дескриптор файла (в терминах оболочки UNIX это эквивалент выполнения /программа
2> & 1).

ПРИМЕЧАНИЕ:
Не устанавливать redirect_stderr = правда в [прослушиватель событий: x] раздел. Слушатели событий
использование стандартный вывод и STDIN общаться с руководитель. Если STDERR перенаправлен,
Вывод из STDERR будет мешать протоколу слушателя событий.

По умолчанию: ложный

необходимые: Нет

Введенный: 3.0 заменяет 2.0 log_stdout и log_stderr

stdout_logfile
Поместите вывод stdout процесса в этот файл (и если redirect_stderr истинно, также поместите
stderr в этом файле). Если stdout_logfile не установлен или установлен на AUTO, руководитель
автоматически выберет местоположение файла. Если это установлено на NONE, руководитель будет
не создавать файл журнала. AUTO файлы журналов и их резервные копии будут удалены, когда руководитель
перезапускается. В stdout_logfile value может содержать строковые выражения Python, которые будут
оценивается по словарю, содержащему ключи имя группы, имя_узла_хоста,
номер_процесса, имя_программыкачества здесь (каталог конфигурационного файла супервизора).

ПРИМЕЧАНИЕ:
Два процесса не могут использовать один файл журнала (stdout_logfile)
при вращении (stdout_logfile_maxbytes) включен. Это приведет к созданию файла
поврежден.

По умолчанию: AUTO

необходимые: Нет

Введенный: 3.0 заменяет 2.0 журнальный файл

stdout_logfile_maxbytes
Максимальное количество байтов, которое может быть использовано stdout_logfile до того, как он будет повернут
(в значении могут использоваться суффиксные множители, такие как «КБ», «МБ» и «ГБ»). Установите это
значение 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). Должно быть целым числом (суффиксные множители, такие как «КБ», «МБ» и «ГБ»
можно использовать в значении). Если это значение равно 0, режим захвата процесса будет отключен.

По умолчанию: 0

необходимые: Нет

Введенный: 3.0 заменяет 2.0 logfile_backups

stdout_events_enabled
Если истина, события PROCESS_LOG_STDOUT будут испускаться, когда процесс записывает в свой
дескриптор файла stdout. События будут отправляться только в том случае, если дескриптор файла не
в режиме захвата в момент получения данных (см. capture_mode).

По умолчанию: 0

необходимые: Нет

Введенный: 3.0а7

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). Должно быть целым числом (суффиксные множители, такие как «КБ», «МБ» и «ГБ»
можно использовать в значении). Если это значение равно 0, режим захвата процесса будет отключен.

По умолчанию: 0

необходимые: Нет

Введенный: 3.0

stderr_events_enabled
Если истина, события PROCESS_LOG_STDERR будут испускаться, когда процесс записывает в свой
дескриптор файла stderr. События будут отправляться только в том случае, если дескриптор файла не
в режиме захвата в момент получения данных (см. capture_mode).

По умолчанию: ложный

необходимые: Нет

Введенный: 3.0а7

охрана окружающей среды
Список пар ключ / значение в форме KEY = "val", KEY2 = "val2" который будет помещен в
среда дочернего процесса. Строка окружения может содержать строку Python
выражения, которые будут оцениваться по словарю, содержащему имя группы,
имя_узла_хоста, номер_процесса, имя_программыкачества здесь (справочник руководителя
config файл). Значения, содержащие не буквенно-цифровые символы, должны быть заключены в кавычки (например,
KEY = "val: 123", KEY2 = "val, 456"). В противном случае цитирование значений необязательно, но
рекомендуется. Внимание что подпроцесс унаследует переменные среды
оболочка использовалась для запуска "супервизора", за исключением тех, которые здесь переопределены. Видеть
подпроцесс_среда.

По умолчанию: Без дополнительной среды

необходимые: Нет

Введенный: 3.0

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

По умолчанию: Нет chdir (наследовать супервизора)

необходимые: Нет

Введенный: 3.0

Umask
Восьмеричное число (например, 002, 022), представляющее маску процесса.

По умолчанию: Нет специальной маски umask (наследуется супервизора)

необходимые: Нет

Введенный: 3.0

URL-адрес сервера
URL-адрес, переданный в среде процессу подпроцесса как SUPERVISOR_SERVER_URL
(См. супервизор.childutils), чтобы подпроцесс мог легко взаимодействовать с
внутренний HTTP-сервер. Если предоставляется, он должен иметь тот же синтаксис и структуру, что и
[супервизорктл] одноименный вариант раздела. Если он установлен на АВТО или не установлен,
супервизор автоматически создаст URL-адрес сервера, отдавая предпочтение серверу
который прослушивает сокеты домена UNIX по сравнению с сокетом, который прослушивает интернет-сокет.

По умолчанию: АВТО

необходимые: Нет

Введенный: 3.0

[программа: x] Раздел Пример
[программа: кошка]
команда =/ bin / cat
имя_процесса =% (имя_программы) s
numprocs = 1
каталог =/ Tmp
umask = 022
Приоритет = 999
autostart = true
autorestart = неожиданно
startsecs = 10
startretries = 3
коды выхода = 0,2
stopignal = TERM
stopwaitsecs = 10
stopasgroup = false
killasgroup = ложь
user = chrism
redirect_stderr = ложь
stdout_logfile = / а / путь
stdout_logfile_maxbytes = 1 МБ
stdout_logfile_backups = 10
stdout_capture_maxbytes = 1 МБ
stdout_events_enabled = ложь
stderr_logfile = / а / путь
stderr_logfile_maxbytes = 1 МБ
stderr_logfile_backups = 10
stderr_capture_maxbytes = 1 МБ
stderr_events_enabled = ложь
environment = A = "1", B = "2"
serverurl = АВТО

[включают] Раздел Настройки
Ассоциация supervisard.conf файл может содержать раздел с именем [включают]. Если конфигурация
файл содержит [включают] раздел, он должен содержать единственный ключ с именем "files". В
значения в этом ключе указывают другие файлы конфигурации, которые будут включены в
конфигурации.

[включают] Раздел Наши ценности
файлов
Последовательность файловых глобусов, разделенных пробелами. Каждая файловая глобус может быть абсолютной или относительной.
Если глобус файла относительный, он считается относительно местоположения
файл конфигурации, который включает его. "Глоб" - это шаблон файла, который соответствует
указанный шаблон в соответствии с правилами, используемыми оболочкой Unix. Нет расширения тильды
сделано, но *, ?, и диапазоны символов, выраженные с помощью [] будут правильно сопоставлены.
Рекурсивные включения из включенных файлов не поддерживаются.

По умолчанию: По умолчанию нет (обязательно)

необходимые: Да.

Введенный: 3.0

[включают] Раздел Пример
[включают]
files = /an/absolute/filename.conf /an/absolute/*.conf foo.conf config ??. conf

[группа: x] Раздел Настройки
Часто бывает полезно сгруппировать «однородные» группы процессов (также известные как «программы») в единое целое.
«разнородная» группа процессов, поэтому ими можно управлять как единым целым с супервайзера.
различные интерфейсы контроллера.

Чтобы поместить программы в группу, чтобы вы могли рассматривать их как единое целое, определите [группа: x] .
в вашем файле конфигурации. Значение заголовка группы является составным. Это слово
«группа», за которым следует двоеточие, а затем имя группы. Значение заголовка [группа: foo]
описывает группу с именем «foo». Имя используется в клиентских приложениях
которые управляют процессами, созданными в результате этой конфигурации. Это
ошибка при создании группы раздел, у которого нет имени. Имя не должно содержать
двоеточие или скобка.

Для [группа: x], должно быть одно или несколько [программа: x] разделы в другом месте в вашем
файл конфигурации, и группа должна ссылаться на них по имени в программы значения.

Если «однородные» группы процессов (представленные разделами программы) поместить в
«гетерогенная» группа через [группа: x] раздела программы линии, однородные группы, которые
подразумевается, что раздел программы не будет существовать во время выполнения в супервизоре. Вместо этого все
процессы, принадлежащие каждой из однородных групп, будут помещены в
гетерогенная группа. Например, учитывая следующую конфигурацию группы:

[группа: foo]
программы = бар, баз
Приоритет = 999

Учитывая вышеизложенное, при запуске супервизора бар и Баз однородные группы не будут
существуют, и процессы, которые были бы в их подчинении, теперь будут перемещены в Foo
группа.

[группа: x] Раздел Наши ценности
программы
Список имен программ, разделенных запятыми. Перечисленные программы становятся участниками
группы.

По умолчанию: По умолчанию нет (обязательно)

необходимые: Да.

Введенный: 3.0

приоритет
Номер приоритета, аналогичный [программа: x] значение приоритета, присвоенное группе.

По умолчанию: 999

необходимые: Нет

Введенный: 3.0

[группа: x] Раздел Пример
[группа: foo]
программы = бар, баз
Приоритет = 999

[программа fcgi: x] Раздел Настройки
Супервайзер может управлять группами FastCGI процессы, которые все прослушивают один и тот же сокет.
До сих пор гибкость развертывания FastCGI была ограничена. Чтобы получить полный процесс
управления, вы могли использовать mod_fastcgi под Apache, но тогда вы застряли с Apache
неэффективная модель параллелизма одного процесса или потока на соединение. В добавление к
требуя большего количества ресурсов ЦП и памяти, модель процесса / потока для каждого соединения может быть
быстро насыщается медленным ресурсом, что препятствует обслуживанию других ресурсов. В
чтобы воспользоваться преимуществами новых событийно-управляемых веб-серверов, таких как lighttpd или nginx, которые
не включать встроенный диспетчер процессов, вам пришлось использовать скрипты, такие как cgi-fcgi или
spawn-fcgi. Их можно использовать вместе с менеджером процессов, например супервизором.
или daemontools, но требует, чтобы каждый дочерний процесс FastCGI был привязан к собственному сокету. В
Недостатки этого: излишне сложная конфигурация веб-сервера, некорректная
перезапускается и снижается отказоустойчивость. С меньшим количеством сокетов для настройки веб-сервер
конфигурации будут намного меньше, если группы процессов FastCGI могут совместно использовать сокеты. Общий
сокеты позволяют плавный перезапуск, потому что сокет остается связанным родительским процессом
пока перезапускается любой из дочерних процессов. Наконец, общие сокеты больше
отказоустойчивый, потому что, если данный процесс выходит из строя, другие процессы могут продолжать обслуживать
входящие соединения.

Благодаря встроенной поддержке создания FastCGI Supervisor дает вам лучшее из обоих миров.
Вы получаете полнофункциональное управление процессами с группами процессов FastCGI, разделяющих сокеты
без привязки к определенному веб-серверу. Это четкое разделение проблем,
позволяя веб-серверу и диспетчеру процессов делать то, что они умеют лучше всего.

ПРИМЕЧАНИЕ:
Менеджер сокетов в Supervisor изначально был разработан для поддержки процессов FastCGI.
но это не ограничивается FastCGI. Могут использоваться и другие протоколы без каких-либо специальных
конфигурация. Любая программа, которая может получить доступ к открытому сокету из файлового дескриптора (например,
сокет.fromfd в Python) можно использовать диспетчер сокетов. Супервайзер будет
автоматически создать сокет, привязать и прослушать, прежде чем разветвлять первого дочернего элемента в
группа. Сокет будет передан каждому потомку по номеру дескриптора файла. 0 (нуль).
Когда последний ребенок в группе выйдет из группы, Supervisor закроет сокет.

Все возможности доступны [программа: x] разделы также соблюдаются fcgi-программа
раздел.

[программа fcgi: x] Раздел Наши ценности
[программа fcgi: x] разделы имеют один ключ, который [программа: x] разделов нет.

гнездо
Сокет FastCGI для этой программы, доменный сокет TCP или UNIX. Для сокетов TCP,
используйте этот формат: tcp: // локальный: 9002. Для сокетов домена UNIX используйте
unix: ///absolute/path/to/file.sock. Строковые выражения оцениваются по
словарь, содержащий ключи «имя_программы» и «здесь» (каталог
файл конфигурации supervisord).

По умолчанию: По умолчанию нет.

необходимые: Да.

Введенный: 3.0

сокет_владелец
Для сокетов домена UNIX этот параметр может использоваться для указания пользователя и группы для
сокет FastCGI. Может быть имя пользователя UNIX (например, chrism) или имя пользователя и группа UNIX.
разделенные двоеточием (например, chrism: wheel).

По умолчанию: Использует пользователя и группу, заданные для программы fcgi

необходимые: Нет

Введенный: 3.0

режим_сокета
Для сокетов домена UNIX этот параметр может использоваться для указания режима разрешений.

По умолчанию: 0700

необходимые: Нет

Введенный: 3.0

Консультировать [программа: x] Раздел Настройки для других допустимых ключей измените указанные выше ограничения.
и дополнения.

[программа fcgi: x] Раздел Пример
[fcgi-program: fcgiprogramname]
команда = / usr / bin / example.fcgi
socket = unix: /// var / run / supervisor /% (имя_программы) s.sock
socket_owner = chrism
socket_mode = 0700
имя_процесса =% (имя_программы) s _% (номер_процесса) 02d
numprocs = 5
каталог =/ Tmp
umask = 022
Приоритет = 999
autostart = true
autorestart = неожиданно
startsecs = 1
startretries = 3
коды выхода = 0,2
stopignal = ВЫЙТИ
stopasgroup = false
killasgroup = ложь
stopwaitsecs = 10
user = chrism
redirect_stderr = правда
stdout_logfile = / а / путь
stdout_logfile_maxbytes = 1 МБ
stdout_logfile_backups = 10
stdout_events_enabled = ложь
stderr_logfile = / а / путь
stderr_logfile_maxbytes = 1 МБ
stderr_logfile_backups = 10
stderr_events_enabled = ложь
environment = 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 запись точка string который разрешается в вызываемый Python. По умолчанию
Значение supervisor.dispatchers: default_handler. Указание альтернативного результата
обработчик - это очень необычная вещь, которую нужно делать, и в результате, как его создать,
не задокументировано.

Консультировать [программа: x] Раздел Настройки для других допустимых ключей измените указанные выше ограничения.
и дополнения.

[прослушиватель событий: x] Раздел Пример
[прослушиватель событий: имя прослушивателя событий]
команда = / bin / eventlistener
имя_процесса =% (имя_программы) s _% (номер_процесса) 02d
numprocs = 5
events = PROCESS_STATE
buffer_size = 10
каталог =/ Tmp
umask = 022
приоритет = -1
autostart = true
autorestart = неожиданно
startsecs = 1
startretries = 3
коды выхода = 0,2
stopignal = ВЫЙТИ
stopwaitsecs = 10
stopasgroup = false
killasgroup = ложь
user = chrism
redirect_stderr = ложь
stdout_logfile = / а / путь
stdout_logfile_maxbytes = 1 МБ
stdout_logfile_backups = 10
stdout_events_enabled = ложь
stderr_logfile = / а / путь
stderr_logfile_maxbytes = 1 МБ
stderr_logfile_backups = 10
stderr_events_enabled = ложь
environment = A = "1", B = "2"
serverurl = АВТО

[rpcinterface: x] Раздел Настройки
Добавление rpcinterface: x настройки в файле конфигурации полезны только тем, кто
хотите расширить супервизор дополнительным настраиваемым поведением.

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

[rpcinterface: руководитель]
supervisor.rpcinterface_factory = supervisor.rpcinterface: make_main_rpcinterface

Ассоциация [rpcinterface: руководитель] . должен остаются в комплектации по стандарту
настройка супервизора для правильной работы. Если вы не хотите, чтобы руководитель что-либо делал,
еще не работает "из коробки", это все, что вам нужно знать об этом типе
.

Однако, если вы хотите добавить пространства имен интерфейса rpc для настройки супервизора, вы
может добавить дополнительные [rpcinterface: foo] разделы, где "foo" представляет пространство имен
интерфейс (из корневого веб-сайта) и значение, названное супервизор.rpcinterface_factory
- это вызываемый фабрикой объект, который должен иметь сигнатуру функции, которая принимает один
позиционный аргумент руководитель и столько аргументов ключевого слова, сколько требуется для выполнения
конфигурация. Любые дополнительные пары ключ / значение, определенные в [rpcinterface: x] раздел будет
передаваться в фабрику как аргументы ключевого слова.

Вот пример фабричной функции, созданной в __init__.py файл Python
пакет мой.пакет.

from my.package.rpcinterface import ДругойRPCInterface

def make_another_rpcinterface (супервизор, ** конфигурация):
retries = int (config.get ('retries', 0))
another_rpc_interface = Другой интерфейс RPC (супервизор, повторные попытки)
вернуть another_rpc_interface

И раздел в файле конфигурации, предназначенный для его настройки.

[rpcinterface: другой]
supervisor.rpcinterface_factory = my.package: make_another_rpcinterface
повторные попытки = 1

[rpcinterface: x] Раздел Наши ценности
супервизор.rpcinterface_factory
pkg_resources «точка входа», разделенное точками имя фабричной функции вашего интерфейса RPC.

По умолчанию: N /

необходимые: Нет

Введенный: 3.0

[rpcinterface: x] Раздел Пример
[rpcinterface: другой]
supervisor.rpcinterface_factory = my.package: make_another_rpcinterface
повторные попытки = 1

Словарь терминов
DAEMON Tools
A процесс контроль система by Диджей Бернштейн.

запуск программ
A процесс контроль система используемый by Apple как процесс 1 в Mac OS X.

запустить его A процесс контроль система.

Суперлэнс
Пакет, который предоставляет различные реализации прослушивателя событий, которые подключаются к
Супервизор, который может помочь контролировать использование памяти процессом и статус сбоя:
http://pypi.python.org/pypi/superlance.

Umask Аббревиатура от пользователь маска: устанавливает маску создания файлового режима для текущего процесса.
Читать http://en.wikipedia.org/wiki/Umask.

Используйте echo_supervisord_conf в Интернете с помощью сервисов onworks.net