echo_supervisord_conf — Online w chmurze

PROGRAM:

IMIĘ

echo_supervisord_conf — Dokumentacja konfiguracji nadzorcy

Supervisor to system klient/serwer, który pozwala użytkownikom monitorować i kontrolować numer
procesów w systemach operacyjnych typu UNIX.

Dzieli niektóre z tych samych celów programów, takich jak launchd, daemontools i runit. w odróżnieniu
niektóre z tych programów nie mogą być uruchamiane jako substytut startowych jako „identyfikator procesu
1". Zamiast tego ma służyć do kontroli procesów związanych z projektem lub
klienta i ma uruchamiać się jak każdy inny program w czasie rozruchu.

DOKUMENTACJA

Tworzenie a systemu filet
Po zakończeniu instalacji nadzorcy uruchom echo_supervisord_conf. To będzie
wypisz "przykładowy" plik konfiguracyjny Supervisora ​​na standardowe wyjście twojego terminala.

Gdy zobaczysz plik odtworzony na twoim terminalu, ponownie wywołaj polecenie jako
echo_supervisord_conf > /etc/supervisord.conf. To nie zadziała, jeśli nie masz roota
dostęp.

Jeśli nie masz uprawnień administratora lub wolisz nie umieszczać kierownik.konf plik w
/etc/supervisord.conf`, możesz umieścić go w bieżącym katalogu (echo_supervisord_conf >
kierownik.konf) i start supervisord z -c flaga w celu określenia
lokalizacja pliku konfiguracyjnego.

Na przykład, supervisord -c kierownik.konf. Używając -c flaga faktycznie jest zbędna w
w tym przypadku, ponieważ supervisord przeszukuje bieżący katalog w poszukiwaniu kierownik.konf
zanim przeszuka inne lokalizacje pliku, ale zadziała.

Gdy masz już plik konfiguracyjny w swoim systemie plików, możesz zacząć modyfikować go do swojego
gust.

systemu filet
Plik konfiguracyjny nadzorcy nosi zwyczajową nazwę kierownik.konf. Jest używany przez
obie supervisord i przełożony. Jeśli któraś z aplikacji zostanie uruchomiona bez -c
opcja (opcja używana do wskazania aplikacji nazwy pliku konfiguracyjnego
jawnie), aplikacja będzie szukać pliku o nazwie kierownik.konf w ciągu
następujące lokalizacje, w określonej kolejności. Użyje pierwszego znalezionego pliku.

1. $CWD/supervisord.conf

2. $CWD/etc/supervisord.conf

3. /etc/supervisord.conf

4. ../etc/supervisord.conf (W stosunku do pliku wykonywalnego)

5. ../nadzorca.conf (W stosunku do pliku wykonywalnego)

UWAGA:
Niektóre dystrybucje mają pakiet Supervisor z własnymi dostosowaniami. Te
zmodyfikowane wersje Supervisora ​​mogą wczytać plik konfiguracyjny z innych lokalizacji
niż te opisane tutaj. Warto zauważyć, że znaleziono pakiety Ubuntu, które używają
/etc/supervisor/supervisord.conf.

filet utworzony
kierownik.konf jest plikiem w stylu Windows-INI (Python ConfigParser). Ma sekcje (każda
oznaczony przez a [nagłówek]) oraz pary klucz/wartość w sekcjach. Sekcje i ich
dopuszczalne wartości są opisane poniżej.

Środowisko Zmienne
Zmienne środowiskowe, które są obecne w środowisku w czasie, gdy supervisord is
Start może być użyty w pliku konfiguracyjnym przy użyciu składni wyrażeń łańcuchowych Pythona
%(ENV_X)s:

[program:przykład]
polecenie=/usr/bin/przykład --loglevel=%(ENV_LOGLEVEL)s

W powyższym przykładzie wyrażenie %(ENV_LOGLEVEL)s zostanie rozszerzony do wartości
zmienna środowiskowa POZIOM LOGI.

UWAGA:
W Supervisor 3.2 i nowszych: %(ENV_X)s wyrażenia są obsługiwane we wszystkich opcjach. w
wcześniejsze wersje, niektóre opcje je obsługują, ale większość nie. Zobacz dokumentację dla
każdą z poniższych opcji.

[unix_http_serwer] Sekcja Ustawienia
Połączenia kierownik.konf plik zawiera sekcję o nazwie [unix_http_serwer] pod którym
parametry konfiguracyjne dla serwera HTTP nasłuchującego na gnieździe domeny UNIX powinny być
włożona. Jeśli plik konfiguracyjny nie zawiera [unix_http_serwer] sekcja, domena UNIX
Serwer HTTP gniazda nie zostanie uruchomiony. Dopuszczalne wartości konfiguracyjne są następujące:
Następuje.

[unix_http_serwer] Sekcja Wartości
filet
Ścieżka do gniazda domeny UNIX (np. /tmp/supervisord.sock) na którym przełożony będzie
nasłuchuj żądań HTTP/XML-RPC. przełożony używa XML-RPC do komunikacji z
supervisord nad tym portem. Ta opcja może zawierać wartość %(tutaj)s, który rozszerza się
do katalogu, w którym supervisord znaleziono plik konfiguracyjny.

Domyślnie: Żaden.

Wymagane: Nie

wprowadzony: 3.0

chmod
Zmień bity trybu uprawnień UNIX gniazda domeny UNIX na tę wartość w
uruchomienie

Domyślnie: 0700

Wymagane: Nie

wprowadzony: 3.0

chown
Zmień użytkownika i grupę pliku gniazda na tę wartość. Może być nazwą użytkownika UNIX
(na przykład krzyżmo) lub nazwę użytkownika i grupę UNIX oddzieloną dwukropkiem (np krzyż: koło).

Domyślnie: Użyj nazwy użytkownika i grupy użytkownika, który rozpoczyna pracę nadzorczą.

Wymagane: Nie

wprowadzony: 3.0

nazwa użytkownika
Nazwa użytkownika wymagana do uwierzytelnienia na tym serwerze HTTP.

Domyślnie: Nie jest wymagana nazwa użytkownika.

Wymagane: Nie

wprowadzony: 3.0

password
Hasło wymagane do uwierzytelnienia na tym serwerze HTTP. To może być zwykły tekst
hasło lub może być określone jako skrót SHA-1, jeśli jest poprzedzone ciągiem {SHA}. Forum
przykład, {SHA}82ab876d1387bfafe46cc1c8a2ef074eae50cb1d jest przechowywaną w SHA wersją
hasło "hasło".

Pamiętaj, że haszowane hasło musi być w formacie szesnastkowym.

Domyślnie: Hasło nie jest wymagane.

Wymagane: Nie

wprowadzony: 3.0

[unix_http_serwer] Sekcja Przykład
[unix_http_serwer]
plik = /tmp/supervisor.sock
chmod = 0777
chown= nikt: brak grupy
nazwa użytkownika = użytkownik
hasło = 123

[inet_http_serwer] Sekcja Ustawienia
Połączenia kierownik.konf plik zawiera sekcję o nazwie [inet_http_serwer] pod którym
parametry konfiguracyjne dla serwera HTTP nasłuchującego na gnieździe TCP (internetowym) powinny
być wstawiony. Jeśli plik konfiguracyjny nie zawiera [inet_http_serwer] sekcja, inet HTTP
serwer nie zostanie uruchomiony. Dopuszczalne wartości konfiguracyjne są następujące.

[inet_http_serwer] Sekcja Wartości
Port
Host TCP:wartość portu lub (np. 127.0.0.1:9001) na którym przełożony będzie słuchał
Żądania HTTP/XML-RPC. przełożony użyje XML-RPC do komunikacji z supervisord
nad tym portem. Aby nasłuchiwać na wszystkich interfejsach urządzenia, użyj : 9001 or *:.

Domyślnie: Brak wartości domyślnej.

Wymagane: Tak.

wprowadzony: 3.0

nazwa użytkownika
Nazwa użytkownika wymagana do uwierzytelnienia na tym serwerze HTTP.

Domyślnie: Nie jest wymagana nazwa użytkownika.

Wymagane: Nie

wprowadzony: 3.0

password
Hasło wymagane do uwierzytelnienia na tym serwerze HTTP. To może być zwykły tekst
hasło lub może być określone jako skrót SHA-1, jeśli jest poprzedzone ciągiem {SHA}. Forum
przykład, {SHA}82ab876d1387bfafe46cc1c8a2ef074eae50cb1d jest przechowywaną w SHA wersją
hasło "hasło".

Pamiętaj, że haszowane hasło musi być w formacie szesnastkowym.

Domyślnie: Hasło nie jest wymagane.

Wymagane: Nie

wprowadzony: 3.0

[inet_http_serwer] Sekcja Przykład
[inet_http_serwer]
port = 127.0.0.1:9001
nazwa użytkownika = użytkownik
hasło = 123

[nadzorca] Sekcja Ustawienia
Połączenia kierownik.konf plik zawiera sekcję o nazwie [nadzorca] w jakich ustawieniach globalnych
związany z supervisord należy wstawić proces. Są to następujące.

[nadzorca] Sekcja Wartości
logfile
Ścieżka do dziennika aktywności procesu nadzorowanego. Ta opcja może obejmować
wartość %(tutaj)s, który rozwija się do katalogu, w którym nadzorowana konfiguracja
plik został znaleziony.

Domyślnie: $CWD/supervisord.log

Wymagane: Nie

wprowadzony: 3.0

plik dziennika_maxbajtów
Maksymalna liczba bajtów, które mogą być zużyte przez plik dziennika aktywności, zanim zostanie on
obrócony (w wartości można użyć mnożników sufiksów, takich jak „KB”, „MB” i „GB”). Ustawić
ta wartość wynosi 0, aby wskazać nieograniczony rozmiar dziennika.

Domyślnie: 50MB

Wymagane: Nie

wprowadzony: 3.0

kopie zapasowe pliku dziennika
Liczba kopii zapasowych do przechowywania wynikająca z rotacji plików dziennika aktywności. Jeśli ustawione
do 0, kopie zapasowe nie będą przechowywane.

Domyślnie: 10

Wymagane: Nie

wprowadzony: 3.0

poziom dziennika
Poziom rejestrowania, dyktujący, co jest zapisywane w dzienniku aktywności administratora. Jeden z
krytyczny, błąd, ostrzec, Informacje, debug, wyśledzićlub blather. Zwróć uwagę, że na poziomie dziennika debug,
plik dziennika administratora zarejestruje wyjście swoich procesów potomnych na stderr/stdout
i rozszerzone informacje o zmianach stanu procesu, które są przydatne do debugowania
proces, który nie uruchamia się prawidłowo. Zobacz też: Activity_log_levels.

Domyślnie: informacje

Wymagane: Nie

wprowadzony: 3.0

plik pid
Lokalizacja, w której nadzorca przechowuje swój plik pid. Ta opcja może obejmować
wartość %(tutaj)s, który rozwija się do katalogu, w którym nadzorowana konfiguracja
plik został znaleziony.

Domyślnie: $CWD/przełożony.pid

Wymagane: Nie

wprowadzony: 3.0

umaska
Umaska ​​procesu nadzorowanego.

Domyślnie: 022

Wymagane: Nie

wprowadzony: 3.0

Nodemon
Jeśli to prawda, superwizor rozpocznie pracę na pierwszym planie zamiast demonizować.

Domyślnie: fałszywy

Wymagane: Nie

wprowadzony: 3.0

umysły
Minimalna liczba deskryptorów plików, które muszą być dostępne przed wykonaniem przez administratora:
zacznij pomyślnie. Zostanie wykonane wezwanie do setrlimit, aby spróbować podbić miękkie i
twarde granice nadzorowanego procesu do spełnienia umysły. Twardy limit może być tylko
podniesiony, jeśli superwizor jest uruchomiony jako root. superwizor swobodnie używa deskryptorów plików i
wejdzie w tryb awarii, gdy nie można go uzyskać z systemu operacyjnego, więc warto być
w stanie określić minimalną wartość, aby upewnić się, że nie zabraknie ich podczas wykonywania.
Ta opcja jest szczególnie przydatna w systemie Solaris, który ma niski limit fd na proces o
domyślna.

Domyślnie: 1024

Wymagane: Nie

wprowadzony: 3.0

minproc
Minimalna liczba deskryptorów procesu, które muszą być dostępne przed przełożonym
rozpocznie się pomyślnie. Zostanie wykonane wywołanie setrlimit w celu podjęcia próby podbicia miękkiego
i twarde ograniczenia nadzorowanego procesu do spełnienia minproc. Twardy limit może
może zostać podniesiony tylko wtedy, gdy osoba nadzorująca jest uruchomiona jako root. nadzorca wejdzie w tryb awarii
kiedy system operacyjny zabraknie deskryptorów procesów, więc warto upewnić się, że jest wystarczająco dużo
deskryptory procesów są dostępne na supervisord uruchomienie

Domyślnie: 200

Wymagane: Nie

wprowadzony: 3.0

bez sprzątania
Uniemożliwić nadzorcy wyczyszczenie wszelkich istniejących AUTO podrzędne pliki dziennika w czasie uruchamiania.
Przydatne do debugowania.

Domyślnie: fałszywy

Wymagane: Nie

wprowadzony: 3.0

Childlogdir
Katalog używany do AUTO podrzędne pliki dziennika. Ta opcja może zawierać wartość
%(tutaj)s, który rozwija się do katalogu, w którym supervisord Plik konfiguracyjny
został znaleziony.

Domyślnie: wartość Pythona plik temp.get_tempdir()

Wymagane: Nie

wprowadzony: 3.0

użytkownik
Pouczać supervisord aby przełączyć użytkowników na to konto użytkownika UNIX przed wykonaniem jakichkolwiek czynności
znaczące przetwarzanie. Użytkownik może zostać przełączony tylko wtedy, gdy supervisord jest uruchamiany jako
użytkownik root. Jeśli supervisord nie można przełączyć użytkowników, nadal będzie kontynuowane, ale napisze a
zarejestruj wiadomość na krytyczny poziomie mówiącym, że nie może zrzucić uprawnień.

Domyślnie: nie przełączaj użytkowników

Wymagane: Nie

wprowadzony: 3.0

katalog
Kiedy supervisord demonizes, przejdź do tego katalogu. Ta opcja może obejmować
wartość %(tutaj)s, który rozwija się do katalogu, w którym supervisord konfiguracja
plik został znaleziony.

Domyślnie: nie cd

Wymagane: Nie

wprowadzony: 3.0

strip_ansi
Usuń wszystkie sekwencje specjalne ANSI z podrzędnych plików dziennika.

Domyślnie: fałszywy

Wymagane: Nie

wprowadzony: 3.0

środowisko
Lista par klucz/wartość w formularzu KLUCZ = "wartość", KLUCZ2 = "wartość 2" który zostanie umieszczony w
supervisord środowisko procesu (i w rezultacie cały proces potomny
środowiska). Ta opcja może zawierać wartość %(tutaj)s, który rozwija się do
katalog, w którym znaleziono nadzorowany plik konfiguracyjny. Wartości zawierające
znaki niealfanumeryczne należy cytować (np. KLUCZ = "wartość:123", KLUCZ2 = "wartość, 456").
W przeciwnym razie cytowanie wartości jest opcjonalne, ale zalecane. Aby uciec procent
znaków, po prostu użyj dwóch. (np URI="/pierwszy%%20nazwa") Note że podprocesy będą
odziedziczyć zmienne środowiskowe powłoki użytej do uruchomienia supervisord Z wyjątkiem
przesłonięte tutaj i w programie środowisko opcja. Widzieć
podproces_środowisko.

Domyślnie: brak wartości

Wymagane: Nie

wprowadzony: 3.0

identyfikator
Ciąg identyfikatora dla tego procesu nadzorcy, używany przez interfejs RPC.

Domyślnie: przełożony

Wymagane: Nie

wprowadzony: 3.0

[nadzorca] Sekcja Przykład
[nadzorca]
plik dziennika = /tmp/supervisord.log
logfile_maxbytes = 50 MB
logfile_backups=10
poziom logowania = informacja
pidfile = /tmp/nadzorca.pid
nodaemon = fałsz
Minfd = 1024
minproc = 200
umaska ​​= 022
użytkownik = krzyżmo
identyfikator = przełożony
katalog = / Tmp
nocleanup = prawda
katalog potomny = / Tmp
strip_ansi = fałsz
środowisko = KLUCZ1="wartość1",KLUCZ2="wartość2"

[nadzorca] Sekcja Ustawienia
Plik konfiguracyjny może zawierać ustawienia dla przełożony interaktywna powłoka
program. Te opcje są wymienione poniżej.

[nadzorca] Sekcja Wartości
adres serwera
Adres URL, który powinien być używany w celu uzyskania dostępu do serwera nadzorowanego, np.
http://localhost: 9001. W przypadku gniazd domeny UNIX użyj
unix:///absolute/ścieżka/do/pliku.sock.

Domyślnie: http://localhost: 9001

Wymagane: Nie

wprowadzony: 3.0

nazwa użytkownika
Nazwa użytkownika przekazywana do serwera nadzorczego w celu użycia podczas uwierzytelniania. To powinno
być takim samym jak nazwa użytkownika z konfiguracji serwera nadzorowanego dla portu lub UNIX
gniazdo domeny, do której próbujesz uzyskać dostęp.

Domyślnie: Brak nazwy użytkownika

Wymagane: Nie

wprowadzony: 3.0

password
Hasło do przekazania do serwera nadzorczego w celu użycia podczas uwierzytelniania. To powinno
być wersją tekstową password z konfiguracji serwera nadzorowanego dla
port lub gniazdo domeny UNIX, do którego próbujesz uzyskać dostęp. Ta wartość nie może być przekazana jako
skrót SHA. W przeciwieństwie do innych haseł określonych w tym pliku, należy je podać w
czysty tekst.

Domyślnie: Bez hasła

Wymagane: Nie

wprowadzony: 3.0

podpowiedź
Ciąg używany jako monit nadzorcy.

Domyślnie: nadzorca

Wymagane: Nie

wprowadzony: 3.0

plik_historii
Ścieżka do wykorzystania jako Czytaj linię trwały plik historii. Jeśli włączysz tę funkcję przez
wybierając ścieżkę, twoje polecenia nadzorcy zostaną zachowane w pliku i możesz użyć
readline (np. strzałka w górę), aby wywołać polecenia, które wykonałeś w swoim ostatnim przełożonymctl
sesja.

Domyślnie: Brak pliku

Wymagane: Nie

wprowadzony: 3.0a5

[nadzorca] Sekcja Przykład
[nadzorca]
serwerurl = unix:///tmp/supervisor.sock
nazwa użytkownika = chris
hasło = 123
monit = mój przełożony

[program:x] Sekcja Ustawienia
Plik konfiguracyjny musi zawierać jeden lub więcej program sekcje w kolejności dla przełożonego
wiedzieć, które programy powinien uruchamiać i kontrolować. Wartość nagłówka jest wartością złożoną.
Jest to słowo „program”, po którym następuje bezpośrednio dwukropek, a następnie nazwa programu. Nagłówek
wartość [program: foo] opisuje program o nazwie „foo”. Nazwa jest używana
w aplikacjach klienckich, które kontrolują powstające w wyniku tego procesy
konfiguracja. Błędem jest tworzenie program sekcja, która nie ma nazwy. ten
nazwa nie może zawierać dwukropka ani nawiasu. Wartość nazwy to
używana jako wartość dla %(nazwa_programu)s rozwijanie wyrażeń łańcuchowych w obrębie innych wartości
gdzie określono.

UWAGA:
A [program:x] sekcja faktycznie reprezentuje „jednorodną grupę procesów” dla przełożonego
(od 3.0). Członkowie grupy są definiowani przez kombinację numproc
i Nazwa procesu parametry w konfiguracji. Domyślnie, jeśli numprocs i
nazwa_procesu pozostają niezmienione w stosunku do wartości domyślnych, grupa reprezentowana przez
[program:x] zostanie nazwany x i będzie miał jeden proces o nazwie x w tym. To
zapewnia odrobinę wstecznej kompatybilności ze starszymi wydaniami nadzorcy, które nie:
nie traktuj sekcji programu jako jednorodnych definicji grup procesów.

Ale na przykład, jeśli masz [program: foo] sekcja z numproc z 3 i
Nazwa procesu wyrażenie %(nazwa programu)s_%(numer procesu)02d, grupa „foo” będzie
zawierać trzy procesy, nazwane foo_00, foo_01, foo_02. Dzięki temu jest to możliwe
rozpocząć wiele bardzo podobnych procesów za pomocą jednego [program:x] Sekcja. Wszystkie
nazwy plików dziennika, wszystkie ciągi środowiskowe i polecenia programów mogą również zawierać
podobne wyrażenia łańcuchowe Pythona, aby każdemu przekazać nieco inne parametry
proces.

[program:x] Sekcja Wartości
komenda
Polecenie, które zostanie uruchomione po uruchomieniu tego programu. Poleceniem może być albo
bezwzględny (np. /ścieżka/do/nazwa programu) lub względny (np. Nazwa programu). Jeśli to jest
względne, środowisko przełożonego $ PATH zostanie przeszukany plik wykonywalny.
Programy mogą przyjmować argumenty, np. /ścieżka/do/programu bla bar. Linia poleceń może używać
podwójne cudzysłowy do grupowania argumentów ze spacjami do przekazania do programu, np.
/ścieżka/do/programu/nazwa -p "bla bar". Zauważ, że wartość komenda może zawierać Pythona
wyrażenia tekstowe, np. /ścieżka/do/nazwa programu --port=80%(numer_procesu)02d może się rozwinąć
do /ścieżka/do/nazwa programu --port=8000 W czasie wykonywania. Wyrażenia łańcuchowe są oceniane
przeciwko słownikowi zawierającemu klawisze Nazwa grupy, nazwa_węzła_hosta, numer_procesu,
Nazwa programu, tutaj (katalog nadrzędnego pliku konfiguracyjnego) i wszystkie
zmienne środowiskowe przełożonego z prefiksem ENV_. Kontrolowane programy powinny
sami nie mogą być demonami, ponieważ nadzorca zakłada, że ​​jest odpowiedzialny za demonizowanie jego
podprocesy (zobacz nondemonizing_of_subprocesses).

Domyślnie: Brak wartości domyślnej.

Wymagane: Tak.

wprowadzony: 3.0

Nazwa procesu
Wyrażenie łańcuchowe Pythona, które jest używane do tworzenia nazwy procesu nadzorcy w tym celu
proces. Zwykle nie musisz się martwić o to ustawienie, chyba że zmienisz
numproc. Wyrażenie tekstowe jest oceniane na podstawie słownika, który zawiera
Nazwa grupy, nazwa_węzła_hosta, numer_procesu, Nazwa programu, tutaj (katalog
plik konfiguracyjny nadzorcy).

Domyślnie: %(nazwa_programu)s

Wymagane: Nie

wprowadzony: 3.0

numproc
Supervisor uruchomi tyle instancji tego programu, ile wskazuje numprocs. Notatka
że jeśli numprocs > 1, Nazwa procesu wyrażenie musi zawierać %(proces_num)s (lub dowolny
inne poprawne wyrażenie tekstowe Pythona, które zawiera numer_procesu) w nim.

Domyślnie: 1

Wymagane: Nie

wprowadzony: 3.0

numprocs_start
Przesunięcie całkowite używane do obliczenia liczby, przy której numproc Zaczyna się.

Domyślnie: 0

Wymagane: Nie

wprowadzony: 3.0

priorytet
Względny priorytet programu w kolejności uruchamiania i zamykania. Niżej
priorytety wskazują programy, które uruchamiają się jako pierwsze i zamykają jako ostatnie przy starcie i kiedy
Komendy agregujące są używane w różnych klientach (np. "start all"/"stop all"). Wyższy
priorytety wskazują programy, które uruchamiają się jako ostatnie, a zamykają jako pierwsze.

Domyślnie: 999

Wymagane: Nie

wprowadzony: 3.0

autostart
Jeśli tak, ten program zostanie uruchomiony automatycznie po uruchomieniu systemu nadzorowanego.

Domyślnie: prawdziwe

Wymagane: Nie

wprowadzony: 3.0

startsek
Całkowita liczba sekund, przez które program musi działać po uruchomieniu, aby
uznać start za udany (przesunięcie procesu z STARTOWY stan do
BIEGANIE Państwo). Ustawić 0 aby wskazać, że program nie musi działać przez żadne
określony czas.

UWAGA:
Nawet jeśli proces kończy się z "oczekiwanym" kodem zakończenia (zobacz kody wyjścia), początek
nadal będzie uważany za niepowodzenie, jeśli proces zakończy się szybciej niż startsek.

Domyślnie: 1

Wymagane: Nie

wprowadzony: 3.0

start-próby
Liczba prób niepowodzenia szeregowego, które supervisord pozwoli przy próbie
uruchom program przed zrezygnowaniem i wprowadzeniem procesu w FATAL stan. Widzieć
stany_procesu dla wyjaśnienia FATAL stan.

Domyślnie: 3

Wymagane: Nie

wprowadzony: 3.0

automatyczne ponowne uruchomienie
Określa, czy supervisord powinien automatycznie zrestartować proces, jeśli zakończy się, gdy jest
BIEGANIE Państwo. Może być jednym z fałszywy, niespodziewanylub prawdziwy. Jeśli fałszywy, proces
nie zostanie ponownie uruchomiony. Jeśli niespodziewany, proces zostanie uruchomiony ponownie, gdy
program kończy pracę z kodem zakończenia, który nie jest jednym z kodów zakończenia związanych z tym
konfiguracja procesu (patrz kody wyjścia). Jeśli prawdziwy, proces będzie bezwarunkowy
uruchamiany ponownie po wyjściu, bez względu na jego kod zakończenia.

UWAGA:
automatyczne ponowne uruchomienie kontroluje, czy supervisord automatycznie zrestartuje program, jeśli zakończy działanie
po pomyślnym uruchomieniu (proces jest w BIEGANIE stan).

supervisord ma inny mechanizm restartu na czas uruchamiania procesu
(proces jest w STARTOWY Państwo). Ponowne próby podczas uruchamiania procesu są
kontrolowany przez startsek i start-próby.

Domyślnie: niespodziewany

Wymagane: Nie

wprowadzony: 3.0

kody wyjścia
Lista "oczekiwanych" kodów wyjścia dla tego programu używanych z automatyczne ponowne uruchomienie, Jeśli
automatyczne ponowne uruchomienie parametr jest ustawiony na niespodziewany, a proces kończy się w inny sposób niż
w wyniku prośby przełożonego o zatrzymanie, supervisord zrestartuje proces, jeśli to
wyjścia z kodem wyjścia, który nie jest zdefiniowany na tej liście.

Domyślnie: 0,2

Wymagane: Nie

wprowadzony: 3.0

stopsygnał
Sygnał używany do kończenia programu w przypadku żądania zatrzymania. Może to być dowolny z TERMINÓW,
HUP, INT, WYJDŹ, ZABIJ, USR1 lub USR2.

Domyślnie: TERMIN

Wymagane: Nie

wprowadzony: 3.0

stopczekajsek
Liczba sekund oczekiwania, aż system operacyjny zwróci SIGCHILD do supervisord po
program otrzymał sygnał zatrzymania. Jeśli ta liczba sekund upłynie przed
supervisord otrzymuje SIGCHILD z procesu, supervisord spróbuje go zabić
z końcowym SIGKILLEM.

Domyślnie: 10

Wymagane: Nie

wprowadzony: 3.0

stopagrupa
Jeśli prawda, flaga powoduje, że nadzorca wysyła sygnał zatrzymania do całej grupy procesów
i implikuje grupa zabójców jest prawdziwy. Jest to przydatne w przypadku programów, takich jak Flask w debugowaniu
tryb, który nie wysyła sygnałów stop do swoich dzieci, pozostawiając je osieroconymi.

Domyślnie: fałszywy

Wymagane: Nie

wprowadzony: 3.0b1

grupa zabójców
Jeśli prawda, gdy uciekasz się do wysłania SIGKILL do programu, aby go zakończyć, wyślij go do jego
zamiast tego cała grupa procesów, dbająca również o jej dzieci, przydatne np. z
Programy w Pythonie używające wieloprocesowe.

Domyślnie: fałszywy

Wymagane: Nie

wprowadzony: 3.0a11

użytkownik
Pouczać supervisord aby używać tego konta użytkownika UNIX jako konta, na którym działa
program. Użytkownik może zostać przełączony tylko wtedy, gdy supervisord jest uruchamiany jako użytkownik root. Jeśli
supervisord nie można przełączyć na podanego użytkownika, program nie zostanie uruchomiony.

UWAGA:
Użytkownik zostanie zmieniony za pomocą setuid tylko. To nie uruchamia powłoki logowania i
nie zmienia zmiennych środowiskowych, takich jak USER or HOME. Zobaczyć
subprocess_environment, aby uzyskać szczegółowe informacje.

Domyślnie: Nie przełączaj użytkowników

Wymagane: Nie

wprowadzony: 3.0

przekierowanie_stderr
Jeśli prawda, spowoduje, że wyjście stderr procesu zostanie odesłane do supervisord na swoim stdout
deskryptor pliku (w terminologii powłoki UNIX jest to odpowiednik wykonywania /program
2> & 1).

UWAGA:
Nie ustawiaj przekierowanie_stderr=prawda w sposób [odbiornik zdarzeń:x] Sekcja. Słuchacze wydarzeń
posługiwać się stdout i stdin komunikować się z supervisord. Jeśli stderr jest przekierowany,
Wyjście z stderr zakłóci protokół nasłuchu zdarzeń.

Domyślnie: fałszywy

Wymagane: Nie

wprowadzony: 3.0, zastępuje 2.0 log_stdout i log_stderr

stdout_logfile
Umieść wyjście stdout procesu w tym pliku (a jeśli redirect_stderr jest prawdziwe, również umieść
wyjście stderr w tym pliku). Jeśli stdout_logfile jest rozbrojony lub ustawiony na AUTO, przełożony
automatycznie wybierze lokalizację pliku. Jeśli to jest ustawione na BRAK, przełożony będzie
nie tworzyć pliku dziennika. AUTO pliki dziennika i ich kopie zapasowe zostaną usunięte, gdy supervisord
uruchamia się ponownie. ten stdout_logfile wartość może zawierać wyrażenia łańcuchowe Pythona, które będą
oceniane na podstawie słownika zawierającego klucze Nazwa grupy, nazwa_węzła_hosta,
numer_procesu, Nazwa programu, tutaj (katalog nadzorowanego pliku konfiguracyjnego).

UWAGA:
Nie jest możliwe, aby dwa procesy współdzieliły jeden plik dziennika (stdout_logfile)
kiedy obrót (stdout_logfile_maxbytes) jest włączony. Spowoduje to powstanie pliku
bycie uszkodzonym.

Domyślnie: AUTO

Wymagane: Nie

wprowadzony: 3.0, zastępuje 2.0 logfile

stdout_logfile_maxbytes
Maksymalna liczba bajtów, które może zużyć stdout_logfile zanim zostanie obrócony
(W wartości można użyć mnożników sufiksów, takich jak „KB”, „MB” i „GB”). Ustaw to
wartość na 0, aby wskazać nieograniczony rozmiar dziennika.

Domyślnie: 50MB

Wymagane: Nie

wprowadzony: 3.0, zastępuje 2.0 plik dziennika_maxbajtów

stdout_logfile_backups
Liczba stdout_logfile kopie zapasowe do przechowywania wynikające z dziennika stdout procesu
rotacja plików. Jeśli jest ustawiony na 0, kopie zapasowe nie będą przechowywane.

Domyślnie: 10

Wymagane: Nie

wprowadzony: 3.0, zastępuje 2.0 kopie zapasowe pliku dziennika

stdout_capture_maxbytes
Maksymalna liczba bajtów zapisanych w celu przechwycenia FIFO, gdy proces jest w „trybie przechwytywania standardowego”
(patrz capture_mode). Powinna być liczbą całkowitą (mnożniki sufiksów, takie jak „KB”, „MB” i „GB”
można użyć w wartości). Jeśli ta wartość wynosi 0, tryb przechwytywania procesu będzie wyłączony.

Domyślnie: 0

Wymagane: Nie

wprowadzony: 3.0, zastępuje 2.0 kopie zapasowe pliku dziennika

stdout_events_enabled
Jeśli prawda, zdarzenia PROCESS_LOG_STDOUT będą emitowane, gdy proces zapisze do swojego
deskryptor pliku stdout. Zdarzenia będą emitowane tylko wtedy, gdy deskryptor pliku nie jest
w trybie przechwytywania w momencie otrzymania danych (patrz capture_mode).

Domyślnie: 0

Wymagane: Nie

wprowadzony: 3.0a7

stderr_logfile
Umieść wyjście stderr procesu w tym pliku, chyba że przekierowanie_stderr jest prawdziwy. Akceptuje
te same typy wartości co stdout_logfile i może zawierać te same wyrażenia łańcuchowe Pythona.

UWAGA:
Nie jest możliwe, aby dwa procesy współdzieliły jeden plik dziennika (stderr_logfile)
kiedy obrót (stderr_logfile_maxbytes) jest włączony. Spowoduje to powstanie pliku
bycie uszkodzonym.

Domyślnie: AUTO

Wymagane: Nie

wprowadzony: 3.0

stderr_logfile_maxbytes
Maksymalna liczba bajtów przed rotacją pliku dziennika dla stderr_logfile. Akceptuje
te same typy wartości co stdout_logfile_maxbytes.

Domyślnie: 50MB

Wymagane: Nie

wprowadzony: 3.0

stderr_logfile_backups
Liczba kopii zapasowych do przechowywania wynikająca z rotacji pliku dziennika stderr procesu.
Jeśli jest ustawiony na 0, kopie zapasowe nie będą przechowywane.

Domyślnie: 10

Wymagane: Nie

wprowadzony: 3.0

stderr_capture_maxbytes
Maksymalna liczba bajtów zapisanych w celu przechwycenia FIFO, gdy proces jest w „trybie przechwytywania stderr”
(patrz capture_mode). Powinna być liczbą całkowitą (mnożniki sufiksów, takie jak „KB”, „MB” i „GB”
można użyć w wartości). Jeśli ta wartość wynosi 0, tryb przechwytywania procesu będzie wyłączony.

Domyślnie: 0

Wymagane: Nie

wprowadzony: 3.0

stderr_events_enabled
Jeśli prawda, zdarzenia PROCESS_LOG_STDERR będą emitowane, gdy proces zapisze do swojego
deskryptor pliku stderr. Zdarzenia będą emitowane tylko wtedy, gdy deskryptor pliku nie jest
w trybie przechwytywania w momencie otrzymania danych (patrz capture_mode).

Domyślnie: fałszywy

Wymagane: Nie

wprowadzony: 3.0a7

środowisko
Lista par klucz/wartość w formularzu KLUCZ = "wartość", KLUCZ2 = "wartość 2" który zostanie umieszczony w
środowisko procesu potomnego. Ciąg środowiska może zawierać ciąg Pythona
wyrażenia, które zostaną ocenione względem słownika zawierającego Nazwa grupy,
nazwa_węzła_hosta, numer_procesu, Nazwa programu, tutaj (katalog przełożonego
plik konfiguracyjny). Wartości zawierające znaki niealfanumeryczne należy cytować (np.
KLUCZ = "wartość:123", KLUCZ2 = "wartość, 456"). W przeciwnym razie cytowanie wartości jest opcjonalne, ale
zalecane. Note że podproces odziedziczy zmienne środowiskowe z
shell używany do uruchamiania "supervisord" z wyjątkiem tych, które zostały tutaj przesłonięte. Widzieć
podproces_środowisko.

Domyślnie: Brak dodatkowego środowiska

Wymagane: Nie

wprowadzony: 3.0

katalog
Ścieżka do pliku reprezentująca katalog, do którego supervisord powinien tymczasowo chdir
przed wykonaniem dziecka.

Domyślnie: Brak chdir (nadzorcy dziedziczenia)

Wymagane: Nie

wprowadzony: 3.0

umaska
Liczba ósemkowa (np. 002, 022) reprezentująca umask procesu.

Domyślnie: Brak specjalnej umaski (dziedziczenie nadzorcy)

Wymagane: Nie

wprowadzony: 3.0

adres serwera
Adres URL przekazany w środowisku do procesu podprocesu jako SUPERVISOR_SERVER_URL
(Patrz opiekun.dzieci), aby podproces mógł łatwo komunikować się z
wewnętrzny serwer HTTP. Jeśli jest podany, powinien mieć taką samą składnię i strukturę jak
[nadzorca] opcja sekcji o tej samej nazwie. Jeśli jest ustawiony na AUTO lub nie jest ustawiony,
przełożony automatycznie skonstruuje adres URL serwera, dając pierwszeństwo serwerowi
który nasłuchuje na gniazdach domeny UNIX zamiast jednego, który nasłuchuje na gnieździe internetowym.

Domyślnie: AUTO

Wymagane: Nie

wprowadzony: 3.0

[program:x] Sekcja Przykład
[program:kot]
polecenie =/kosz/kot
nazwa_procesu=%(nazwa_programu)s
numerproc=1
katalog=/ Tmp
umaska=022
priority = 999
autostart = true
autorestart=nieoczekiwany
startsek=10
liczba prób=3
kody wyjścia=0,2
sygnał stopu = TERMIN
stopwaitsek=10
stopasgroup=false
killasgroup=fałsz
użytkownik=krzyżówka
redirect_stderr=fałsz
stdout_logfile=/a/ścieżka
stdout_logfile_maxbytes=1 MB
stdout_logfile_backups=10
stdout_capture_maxbytes=1 MB
stdout_events_enabled=fałsz
stderr_logfile=/a/ścieżka
stderr_logfile_maxbytes=1 MB
stderr_logfile_backups=10
stderr_capture_maxbytes=1 MB
stderr_events_enabled=fałsz
środowisko=A="1",B="2"
adres serwera=AUTO

[włączać] Sekcja Ustawienia
Połączenia kierownik.konf plik może zawierać sekcję o nazwie [włączać]. Jeśli konfiguracja
plik zawiera [włączać] sekcji, musi zawierać pojedynczy klucz o nazwie „pliki”. ten
wartości w tym kluczu określają inne pliki konfiguracyjne, które mają być uwzględnione w
konfiguracja.

[włączać] Sekcja Wartości
pliki
Oddzielona spacjami sekwencja globusów plików. Każdy glob plików może być bezwzględny lub względny.
Jeśli plik glob jest względny, jest uważany za względny w stosunku do lokalizacji
plik konfiguracyjny, który go zawiera. „Glob” to wzorzec pliku, który pasuje do
określony wzór zgodnie z regułami używanymi przez powłokę Unix. Nie ma ekspansji tyldy
gotowe, ale *, ?, a zakresy znaków wyrażone za pomocą [] zostaną prawidłowo dopasowane.
Dołączenia rekurencyjne z dołączonych plików nie są obsługiwane.

Domyślnie: Brak wartości domyślnej (wymagane)

Wymagane: Tak.

wprowadzony: 3.0

[włączać] Sekcja Przykład
[włączać]
pliki = /an/absolute/filename.conf /an/absolute/*.conf foo.conf config??.conf

[grupa:x] Sekcja Ustawienia
Często przydatne jest grupowanie „jednorodnych” grup procesów (inaczej „programów”) w jedną
„heterogeniczne” grupy procesów, dzięki czemu mogą być sterowane jako jednostka z Supervisora
różne interfejsy kontrolera.

Aby umieścić programy w grupie i traktować je jako całość, zdefiniuj a [grupa:x] Sekcja
w twoim pliku konfiguracyjnym. Wartość nagłówka grupy jest złożona. To jest słowo
„grupa”, po której następuje bezpośrednio dwukropek, a następnie nazwa grupy. Wartość nagłówka [grupa:foo]
opisuje grupę o nazwie „foo”. Nazwa jest używana w aplikacjach klienckich
które kontrolują procesy, które są tworzone w wyniku tej konfiguracji. To jest
błąd w tworzeniu grupa sekcja, która nie ma nazwy. Nazwa nie może zawierać
znak dwukropka lub znak nawiasu.

Dla [grupa:x], musi być jeden lub więcej [program:x] sekcje gdzie indziej w twoim
plik konfiguracyjny, a grupa musi odwoływać się do nich po nazwie w programów wartość.

Jeśli „jednorodne” grupy procesów (reprezentowane przez sekcje programu) są umieszczane w a
grupa „heterogeniczna” przez [grupa:x] Sekcje programów linia, jednorodne grupy, które
są dorozumiane, że sekcja programu nie będzie istniała w czasie wykonywania w module nadzorczym. Zamiast tego wszyscy
procesy należące do każdej z jednorodnych grup zostaną umieszczone w
heterogeniczna grupa. Na przykład, biorąc pod uwagę następującą konfigurację grupy:

[grupa:foo]
programy=bar,baz
priority = 999

Biorąc pod uwagę powyższe, podczas uruchamiania nadzorowanego, bar i baz jednorodne grupy nie będą
istnieją, a procesy, które byłyby pod nimi, zostaną teraz przeniesione do bla
grupa.

[grupa:x] Sekcja Wartości
programów
Lista nazw programów rozdzielonych przecinkami. Wymienione programy stają się członkami
z grupy.

Domyślnie: Brak wartości domyślnej (wymagane)

Wymagane: Tak.

wprowadzony: 3.0

priorytet
Numer priorytetu analogiczny do a [program:x] wartość priorytetu przypisana do grupy.

Domyślnie: 999

Wymagane: Nie

wprowadzony: 3.0

[grupa:x] Sekcja Przykład
[grupa:foo]
programy=bar,baz
priority = 999

[program-fcgi:x] Sekcja Ustawienia
Nadzorca może zarządzać grupami FastCGI procesy, które nasłuchują w tym samym gnieździe.
Do tej pory elastyczność wdrażania FastCGI była ograniczona. Aby uzyskać pełny proces
zarządzania, możesz użyć mod_fastcgi pod Apache, ale potem utknąłeś z Apache's
nieefektywny model współbieżności jednego procesu lub wątku na połączenie. Oprócz
wymagające więcej zasobów procesora i pamięci, proces/wątek na model połączenia może być
szybko nasycane przez powolny zasób, uniemożliwiając obsługę innych zasobów. w
aby skorzystać z nowszych serwerów opartych na zdarzeniach, takich jak lighttpd lub nginx, które
nie dołączaj wbudowanego menedżera procesów, musiałeś używać skryptów takich jak cgi-fcgi lub
spawn-fcgi. Mogą być używane w połączeniu z kierownikiem procesu, takim jak superwizor
lub demontools, ale wymagają, aby każdy proces potomny FastCGI był powiązany z własnym gniazdem. ten
Wadami tego są: niepotrzebnie skomplikowana konfiguracja serwera WWW, niewdzięczność
ponowne uruchomienie i zmniejszona tolerancja błędów. Mniejsza liczba gniazd do skonfigurowania, serwer WWW
konfiguracje są znacznie mniejsze, jeśli grupy procesów FastCGI mogą współużytkować gniazda. Wspólny
gniazda umożliwiają łagodne ponowne uruchamianie, ponieważ gniazdo pozostaje powiązane przez proces nadrzędny
podczas gdy którykolwiek z procesów podrzędnych jest restartowany. Wreszcie wspólne gniazda to więcej
odporny na błędy, ponieważ jeśli dany proces ulegnie awarii, inne procesy mogą nadal działać
połączenia przychodzące.

Dzięki zintegrowanej obsłudze odradzania FastCGI, Supervisor zapewnia to, co najlepsze z obu światów.
Otrzymujesz w pełni funkcjonalne zarządzanie procesami z grupami procesów FastCGI udostępniających gniazda
bez powiązania z konkretnym serwerem WWW. To czyste oddzielenie obaw,
pozwalając serwerowi WWW i menedżerowi procesów robić to, co robią najlepiej.

UWAGA:
Menedżer gniazd w programie Supervisor został pierwotnie opracowany do obsługi procesów FastCGI
ale nie ogranicza się to do FastCGI. Inne protokoły mogą być również używane bez specjalnych
konfiguracja. Dowolny program, który może uzyskać dostęp do otwartego gniazda z deskryptora pliku (np
w gniazdo.z fd w Pythonie) może używać menedżera gniazd. Przełożony będzie
automatycznie utworzy gniazdo, powiąże i nasłuchuje przed rozwidleniem pierwszego dziecka w a
Grupa. Gniazdo zostanie przekazane każdemu dziecku w deskryptorze pliku o numerze 0 (zero).
Kiedy ostatnie dziecko w grupie wyjdzie, Supervisor zamknie gniazdo.

Wszystkie opcje dostępne dla [program:x] sekcje są również przestrzegane przez program-fcgi
działy.

[program-fcgi:x] Sekcja Wartości
[program-fcgi:x] sekcje mają jeden klucz, który [program:x] sekcje nie mają.

gniazdo
Gniazdo FastCGI dla tego programu, gniazdo domeny TCP lub UNIX. Dla gniazd TCP,
użyj tego formatu: tcp://host lokalny:9002. W przypadku gniazd domeny UNIX użyj
unix:///absolute/ścieżka/do/pliku.sock. Wyrażenia łańcuchowe są oceniane względem a
słownik zawierający klucze "nazwa_programu" i "tutaj" (katalog
plik konfiguracyjny nadzorcy).

Domyślnie: Brak wartości domyślnej.

Wymagane: Tak.

wprowadzony: 3.0

właściciel_gniazda
W przypadku gniazd domeny UNIX ten parametr może służyć do określenia użytkownika i grupy dla
gniazdo FastCGI. Może być nazwą użytkownika UNIX (np. chrism) lub nazwą użytkownika i grupą UNIX
oddzielone dwukropkiem (np. krzyż:koło).

Domyślnie: Używa zestawu użytkownika i grupy dla programu fcgi

Wymagane: Nie

wprowadzony: 3.0

tryb_gniazda
W przypadku gniazd domeny UNIX ten parametr może służyć do określenia trybu uprawnień.

Domyślnie: 0700

Wymagane: Nie

wprowadzony: 3.0

Konsultować [program:x] Sekcja Ustawienia dla innych dozwolonych kluczy, dela powyższe ograniczenia
i dodatki.

[program-fcgi:x] Sekcja Przykład
[program-fcgi:nazwa programu fcgi]
polecenie=/usr/bin/przykład.fcgi
socket=unix:///var/run/supervisor/%(nazwa_programu)s.sock
socket_owner=krzyżowo
tryb_gniazda=0700
nazwa_procesu=%(nazwa_programu)s_%(numer_procesu)02d
numerproc=5
katalog=/ Tmp
umaska=022
priority = 999
autostart = true
autorestart=nieoczekiwany
startsek=1
liczba prób=3
kody wyjścia=0,2
stopsignal=WYJDŹ
stopasgroup=false
killasgroup=fałsz
stopwaitsek=10
użytkownik=krzyżówka
przekierowanie_stderr=prawda
stdout_logfile=/a/ścieżka
stdout_logfile_maxbytes=1 MB
stdout_logfile_backups=10
stdout_events_enabled=fałsz
stderr_logfile=/a/ścieżka
stderr_logfile_maxbytes=1 MB
stderr_logfile_backups=10
stderr_events_enabled=fałsz
środowisko=A="1",B="2"
adres serwera=AUTO

[odbiornik zdarzeń:x] Sekcja Ustawienia
Supervisor umożliwia tworzenie wyspecjalizowanych jednorodnych grup procesów („pule słuchaczy zdarzeń”):
zdefiniowane w pliku konfiguracyjnym. Pule te zawierają procesy, które mają na celu:
otrzymywać i odpowiadać na powiadomienia o zdarzeniach z systemu zdarzeń przełożonego. Zobacz wydarzenia dla
wyjaśnienie, jak działają zdarzenia i jak wdrażać programy, które można zadeklarować jako
słuchacze zdarzeń.

Pamiętaj, że wszystkie opcje dostępne dla [program:x] sekcje są respektowane przez eventlistener
działy z wyjątkiem dla stdout_capture_maxbytes i stderr_capture_maxbytes (słuchacze wydarzeń
nie może emitować zdarzeń komunikacyjnych procesu, patrz capture_mode).

[odbiornik zdarzeń:x] Sekcja Wartości
[odbiornik zdarzeń:x] sekcje mają kilka kluczy, które [program:x] sekcje nie mają.

Rozmiar bufora
Rozmiar bufora kolejki zdarzeń puli nasłuchiwania zdarzeń. Gdy bufor zdarzeń puli słuchaczy
jest przepełniony (co może się zdarzyć, gdy pula nasłuchiwania zdarzeń nie nadąża za wszystkimi
wysyłane do niego), najstarsze zdarzenie w buforze jest odrzucane.

wydarzenia
Rozdzielona przecinkami lista nazw typów zdarzeń, którymi ten słuchacz jest „zainteresowany”
otrzymywanie powiadomień dla (zobacz event_types, aby uzyskać listę poprawnych nazw typów zdarzeń).

procedura_obsługi_wyników
A pakiet_zasoby wejście punkt ciąg które rozwiązuje się do wywoływalnego Pythona. Domyślny
wartosc jest nadzorca.dyspozytorzy:domyślna_obsługa. Określanie alternatywnego wyniku
handler jest bardzo rzadką rzeczą do zrobienia, a w rezultacie, jak go stworzyć, jest
nieudokumentowane.

Konsultować [program:x] Sekcja Ustawienia dla innych dozwolonych kluczy, dela powyższe ograniczenia
i dodatki.

[odbiornik zdarzeń:x] Sekcja Przykład
[eventlistener:eventlistener]
polecenie=/bin/odbiornik zdarzeń
nazwa_procesu=%(nazwa_programu)s_%(numer_procesu)02d
numerproc=5
zdarzenia=PROCESS_STATE
rozmiar_bufora=10
katalog=/ Tmp
umaska=022
priorytet=-1
autostart = true
autorestart=nieoczekiwany
startsek=1
liczba prób=3
kody wyjścia=0,2
stopsignal=WYJDŹ
stopwaitsek=10
stopasgroup=false
killasgroup=fałsz
użytkownik=krzyżówka
redirect_stderr=fałsz
stdout_logfile=/a/ścieżka
stdout_logfile_maxbytes=1 MB
stdout_logfile_backups=10
stdout_events_enabled=fałsz
stderr_logfile=/a/ścieżka
stderr_logfile_maxbytes=1 MB
stderr_logfile_backups=10
stderr_events_enabled=fałsz
środowisko=A="1",B="2"
adres serwera=AUTO

[rpcinterfejs:x] Sekcja Ustawienia
Dodawanie rpinterfejs:x ustawienia w pliku konfiguracyjnym są przydatne tylko dla osób, które:
chcą rozszerzyć przełożonego o dodatkowe niestandardowe zachowania.

W przykładowym pliku konfiguracyjnym znajduje się sekcja o nazwie [rpcinterface:nadzorca].
Domyślnie wygląda to następująco.

[rpcinterface:nadzorca]
kierownik.rpcinterface_factory = kierownik.rpcinterface:make_main_rpcinterface

Połączenia [rpcinterface:nadzorca] Sekcja musi pozostają w konfiguracji dla standardu
konfiguracja przełożonego, aby działał poprawnie. Jeśli nie chcesz, aby przełożony cokolwiek zrobił to
nie robi już tego po wyjęciu z pudełka, to wszystko, co musisz wiedzieć o tym typie


Jeśli jednak chcesz dodać przestrzenie nazw interfejsu RPC w celu dostosowania nadzorcy, musisz:
może dodać dodatkowe [rpcinterfejs:foo] sekcje, gdzie "foo" reprezentuje przestrzeń nazw
interfejs (z katalogu głównego) i wartość nazwaną przez nadzorca.rpcinterface_factory
jest wywoływalną fabryką, która powinna mieć podpis funkcji akceptujący pojedynczy
argument pozycyjny supervisord i tyle argumentów słów kluczowych, ile potrzeba do wykonania
konfiguracja. Wszelkie dodatkowe pary klucz/wartość zdefiniowane w [rpcinterfejs:x] sekcja będzie
być przekazywane jako argumenty słów kluczowych do fabryki.

Oto przykład funkcji fabrycznej utworzonej w __init__.py plik Pythona
pakiet moja paczka.

z my.package.rpcinterface importuj inny interfejs RPC

def make_inny_rpcinterface(nadzorca, **config):
próby = int(config.get('powtórzenia', 0))
another_rpc_interface = Inny interfejs RPC (nadzorca, ponawianie prób)
zwróć inny_interfejs_rpc

I sekcja w pliku konfiguracyjnym przeznaczona do konfiguracji.

[rpcinterfejs:inny]
superwizor.rpcinterface_factory = mój.pakiet:make_another_rpcinterface
ponownych prób = 1

[rpcinterfejs:x] Sekcja Wartości
nadzorca.rpcinterface_factory
pakiet_zasoby kropkowana nazwa „punktu wejścia” do funkcji fabrycznej interfejsu RPC.

Domyślnie: N / A

Wymagane: Nie

wprowadzony: 3.0

[rpcinterfejs:x] Sekcja Przykład
[rpcinterfejs:inny]
superwizor.rpcinterface_factory = mój.pakiet:make_another_rpcinterface
ponownych prób = 1

Słownik
demontools
A wygląda tak kontrola system by DJ Bernstein.

uruchomiona
A wygląda tak kontrola system używany by Apple jako proces 1 w systemie Mac OS X.

Uruchom A wygląda tak kontrola system.

Superlanca
Pakiet, który zawiera różne implementacje nasłuchiwania zdarzeń, które podłącza się do
Nadzorca, który może pomóc monitorować wykorzystanie pamięci procesu i stan awarii:
http://pypi.python.org/pypi/superlance.

umaska Skrót od użytkownik maska: ustawia maskę tworzenia trybu pliku bieżącego procesu.
See http://en.wikipedia.org/wiki/Umask.

Użyj echo_supervisord_conf online za pomocą usług onworks.net