Daemons and Services/pl: what changed

Revision 4 to 5. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		Demony i usługi
2	2
3	3		## Czym są demony, usługi i agenci?
4	4
5	5		Demony (ang. deamons) Uniksa i usługi (ang. services) Windows to programy działające w całym systemie bez interakcji użytkownika; Agenci (ang. agents) MacOS to programy dla użytkowników (porównaj demony ogólnosystemowe), które mogą działać z interakcją użytkownika lub bez niej. Chociaż nazewnictwo jest różne, ich funkcja jest podobna: na przykład serwery www lub ftp są nazywane demonami pod Linuksem, a usługami pod Windows. Ponieważ nie wchodzą w bezpośrednią interakcję z użytkownikiem, na początku zamykają swoje deskryptory stdin, stdout i stderr.
6	6
7	7		Dzięki Free Pascal, Lazarus można pisać te demony/usługi niezależnie od platformy za pomocą pakietu Lazarus lazdaemon. Aby uniknąć konfliktów nazw z komponentami Delphi, klasy te nazywane są 'demonami' (daemons).
8	8
9	9		## Instalacja LazDaemon
10	10
11	11		Zanim zaczniesz, zainstaluj pakiet lazdaemon. Albo przez menu Pakiet -\> Instaluj/odinstaluj pakiety... i wybranie do z listy Pakietów do zainstalowania, albo przez otwarcie/instalację pliku lpk bezpośrednio ze cieżki z zainstalowanym Lazarusem: lazarus/components/daemon/lazdemon.lpk. Ten pakiet instaluje kilka nowych komponentów i elementów menu w IDE:
12	12
13	13		W menu Plik - Nowy...:, w oknie dialogowym pojawią się 3 nowe pozycje pod nagłówkiem: "Daemon (service) applications":
14	14
15	15		- Daemon (service) applications
16	16		- Daemon Module
17	17		- Daemon mapper
18	18
19	19		## Klasy
20	20
21	21		### TCustomDaemon
22	22
23	23		To jest potomek TDataModule, który wykonuje całą pracę. Może być kilka klas i/lub instancji TCustomDaemons działających w tym samym czasie i w tym samym procesie (wielowątkowym).
24	24
25	25		### TCustomDaemonApplication
26	26
27	27		To jest potomek klasy TCustomApplication, który tworzy TCustomDaemons. Nie wymaga on żadnych zmian. Działa w systemie Windows do momentu odebrania wywołania Stop lub w systemie Linux do sygnału TERM.
28	28
29	29		### TDaemonMapper
30	30
31	31		Ten składnik obsługuje rejestrację usługi. Każda jego instancja wymaga jednego wpisu we właściwości DaemonDefs.
32	32
33	33		## Demon - Krok po kroku
34	34
35	35		- Gdy demon jest uruchamiany, analizowane są parametry wiersza poleceń. Wstępnie zdefiniowane są:
36	36		- -i --install: zarejestruj demona. Nie ma to żadnego wpływu pod Uniksem.
37	37		- -u --uninstall: wyrejestruj demona. Nie ma to żadnego wpływu pod Uniksem.
38	38		- -r --run: uruchom demona. Windows zwykle robi to sam.
39	39		- Utwórz TDaemonMapper
40	40		- Utwórz jeden TCustomDaemon dla każdego wpisu DaemonDefs.
41	41		- instaluj, odinstaluj lub uruchom każdą instancję.
42	42		- jeśli działa: uruchom każdą instancję we własnym wątku, a następnie poczekaj na sygnał Stop/TERM.
43	43
44	44		## Metody demona
45	45
46	46		Start
47	47		Wywoływana, gdy demon powinien się uruchomić. Ta metoda musi natychmiast zwrócić wartość True.
48	48
49	49		Stop
50	50		Wywoływana, gdy demon powinien się zatrzymać. Ta metoda musi natychmiast zwrócić wartość True.
51	51
52	52		Shutdown
53	53		Wywoływana, gdy demon powinien zostać zabity. Ta metoda musi natychmiast zatrzymać demona i zwrócić wartość True. Nie jest to uruchamiane pod Linuksem. Linux po prostu zabija demona.
54	54
55	55		Pause
56	56		Wywoływana, gdy demon powinien się zatrzymać. Ta metoda musi natychmiast zwrócić wartość True. W Linuksie nie jest to uruchamiane, ponieważ jądro zatrzymuje całego demona na sygnał STOP i kontynuuje go na sygnał CONT.
57	57
58	58		Continue
59	59		Wywoływana, gdy demon powinien kontynuować pracę po przerwie. Ta metoda musi natychmiast zwrócić wartość True. W Linuksie nie jest to uruchamiane.
60	60
61	61		Install
62	62		Wywoływana, gdy demon jest zarejestrowany jako usługa systemu Windows. Ta metoda powinna zwrócić wartość True w przypadku powodzenia.
63	63
64	64		Uninstall
65	65		Wywoływana, gdy demon jest wyrejestrowany jako usługa systemu Windows. Ta metoda powinna zwrócić wartość True w przypadku powodzenia.
66	66
67	67		AfterUnInstall
68	68		Wywoływana po tym, jak demon został wyrejestrowany jako usługa systemu Windows. Ta metoda powinna zwrócić wartość True w przypadku powodzenia.
69	69
70	70		HandleCustomCode
71	71		Wywoływana, gdy do demona został wysłany specjalny sygnał. Ta metoda powinna zwrócić wartość True w przypadku powodzenia.
72	72
73	73		### Pierwsze kroki
74	74
75	75		Zanim będziesz mógł stworzyć aplikację Service lub Daemon, musisz najpierw upewnić się, że zainstalowałeś pakiet Lazarus Daemon "lazdemon".
76	76
77	77		## Przykład
78	78
79	79		W katalogu examples/cleandir/ znajduje się prosty przykład. Przeczytaj README.txt.
80	80
81	81		## Instalacja usługi
82	82
83	83		### Windows
84	84
85	85		Możesz zainstalować usługę, wykonując proces z parametrem Install. Menedżer usług Windows zrobi resztę za Ciebie. Możesz skonfigurować usługę i jej opcje za pomocą menedżera usług.
86	86
87	87		Zobacz także: [[ServiceManager/pl\|Menedżer usług]]
88	88
89	89		#### Kodowanie systemowe / UTF-8
90	90
91	91		Projekt LazDeamon działa z domyślną stroną kodową, a nie UTF-8. Tryb -dDisableUTF8RTL należy aktywować za pomocą opcji z menu Projekt -\> Opcje projektu... -\> Opcje kompilatora -\> Dodatki i wymuszenia -\> Użyj kodowania systemowego.
92	92
93	93		### Linux (tylko dla starszych wersji Debiana)
94	94
95	95		Pobierz, skonfiguruj i "Zapisz jako" - przykładowy skrypt znajdujący się w Web Archive: [1](https://web.archive.org/web/20130209102726/http://aurawin.com/lazarus/debian-service.sh) ( Oryginalny link jest martwy od dłuższego czasu).
96	96
97	97		- SVC_ALIAS to długi opis Twojej aplikacji
98	98		- SVC_FILENAME to rzeczywista nazwa pliku skompilowanej aplikacji usługi
99	99		- SVC_DIR to miejsce, w którym skopiowałeś aplikację usługi
100	100		- SVC_SERVICE_SCRIPT to ostateczna nazwa pliku service.sh stosowana w „Zapisz jako”, dostosowana do skryptu debian-service.sh.
101	101
102	102		Umieść swój skrypt w folderze /etc/init.d/
103	103
104	104		uruchom usługę, za pomocą komendy "sudo service Name_Of_Your_Script start"
105	105
106	106		> Note: sudo ma kilka odmian, np.:
107	107		>
108		-	~~> \~~
109		-	~~> `sudo -s #`\~~
110		-	~~> \~~
111		-	~~> `sudo -H #`\~~
112		-	~~> \~~
113		-	~~> `sudo -i #`\~~
114		-	~~> \~~
115		-	~~> `sudo su #`\~~
	108	+	> ```text
	109	+	> sudo -s #
	110	+	> sudo -H #
	111	+	> sudo -i #
	112	+	> sudo su #
	113	+	> ```
	114	+	>
116	115		> \
117	116		> `sudo sh #`
118	117
119	118		Aby automatycznie uruchomić usługę przy starcie, możesz spróbować update-rc.d, w przeciwnym razie będziesz potrzebować narzędzia innej firmy, które to zrobi.
120	119
121	120		Opcja 1
122	121
123	122		``` bash
124	123		sudo update-rc.d Name_Of_Your_Script defaults
125	124		```
126	125
127	126		Opcja 2
128	127
129	128		``` bash
130	129		sudo apt-get install chkconfig
131	130		sudo chkconfig --add Name_Of_Your_Script
132	131		sudo chkconfig --level 2345 Name_Of_Your_Script on
133	132		```
134	133
135	134		### systemd (Fedora, Debian, SLES12)
136	135
137	136		Obecne odmiany Linuksa odchodzą od uruchamiania różnych demonów na rzecz ujednoliconego modelu usług.
138	137
139	138		Fedora i SuSE Enterprise Linux Server 12 używają systemd, a polecenia uruchamiania/zatrzymywania usług są takie same jak w Debianie, ale istnieją różnice w plikach konfiguracyjnych.
140	139
141	140		- Z wiersza polecenia wykonaj: sudo gedit
142	141		- Kopiuj i wklej poniższy kod
143	142
144	143		``` ini
145	144		[Unit]
146	145		Description=Długi opis Twojej aplikacji
147	146		After=network.target
148	147
149	148		[Service]
150	149		Type=simple
151	150		ExecStart=pełna_ścieżka_i_nazwa_pliku -r
152	151		RemainAfterExit=yes
153	152		TimeoutSec=25
154	153
155	154		[Install]
156	155		WantedBy=multi-user.target
157	156		```
158	157
159	158		- Edytuj następujące wartości
160	159		- Description - Długi opis aplikacji serwisowej
161	160		- ExecStart — pełna ścieżka_i_nazwa_pliku to nazwa skompilowanej aplikacji usługi wraz z pełną ścieżką
162	161
163	162		- Zapisz jako okno dialogowe
164	163		- Przejdź do /lib/systemd/system/
165	164		- Nazwij plik nazwa_twojej_usługi.service
166	165
167	166		## Zobacz także
168	167
169	168		- [[ServiceManager/pl\|Menedżer usług]] Przykład dla modułu Free Pascal do zarządzania usługami Windows
170	169		- [[macOS daemons and agents]] - macOS natywnie używający launchd
171	170		- [[Office Automation]] - Interakcja z oprogramowaniem biurowym
172	171		- [Oswajanie demona: PDF autorstwa Michaëla Van Canneyt](https://www.freepascal.org/~michael/articles/daemons/daemons.pdf)
173	172		- [Przydatna dyskusja z małą działającą aplikacją demona](http://forum.lazarus.freepascal.org/index.php/topic,22983.msg152303.html#msg152303)
174	173		- [[Docker Containerization]] - Konteneryzacja jako sposób na łatwe tworzenie demonów / usług
175	174
176	175		---
177	176		From the Free Pascal wiki, page "Daemons and Services/pl", as it stood on 2022-01-09 after a change by Slawek, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).

Back to history