Daemons and Services/pl: what changed
Revision 2 to 3. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | Demony i usługi | |
| 2 | 2 | ||
| 3 | + | ## Contents | |
| 4 | + | ||
| 5 | + | * 1 Czym są demony, usługi i agenci? | |
| 6 | + | * 2 Instalacja LazDaemon | |
| 7 | + | * 3 Klasy | |
| 8 | + | * 3.1 TCustomDaemon | |
| 9 | + | * 3.2 TCustomDaemonApplication | |
| 10 | + | * 3.3 TDaemonMapper | |
| 11 | + | * 4 Demon - Krok po kroku | |
| 12 | + | * 5 Metody demona | |
| 13 | + | * 5.1 Pierwsze kroki | |
| 14 | + | * 6 Przykład | |
| 15 | + | * 7 Instalacja usługi | |
| 16 | + | * 7.1 Windows | |
| 17 | + | * 7.1.1 Kodowanie systemowe / UTF-8 | |
| 18 | + | * 7.2 Linux (tylko dla starszych wersji Debiana) | |
| 19 | + | * 7.3 systemd (Fedora, Debian, SLES12) | |
| 20 | + | * 8 Zobacz także | |
| 21 | + | ||
| 3 | 22 | ## Czym są demony, usługi i agenci? | |
| 4 | 23 | ||
| 5 | - | ||
| 24 | + | _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 | 25 | ||
| 7 | - | ||
| 26 | + | 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 | 27 | ||
| 9 | 28 | ## Instalacja LazDaemon | |
| 10 | 29 | ||
| 11 | - | ||
| 30 | + | 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 | 31 | ||
| 13 | - | ||
| 32 | + | W menu **Plik - Nowy...:** , w oknie dialogowym pojawią się 3 nowe pozycje pod nagłówkiem: **"Daemon (service) applications":** | |
| 14 | 33 | ||
| 15 | - | ||
| 16 | - | ||
| 17 | - | ||
| 34 | + | * Daemon (service) applications | |
| 35 | + | * Daemon Module | |
| 36 | + | * Daemon mapper | |
| 18 | 37 | ||
| 19 | 38 | ## Klasy | |
| 20 | 39 | ||
| 21 | 40 | ### TCustomDaemon | |
| 22 | 41 | ||
| 23 | - | ||
| 42 | + | 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 | 43 | ||
| 25 | 44 | ### TCustomDaemonApplication | |
| 26 | 45 | ||
| 27 | - | ||
| 46 | + | 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 | 47 | ||
| 29 | 48 | ### TDaemonMapper | |
| 30 | 49 | ||
| 31 | - | ||
| 50 | + | Ten składnik obsługuje rejestrację usługi. Każda jego instancja wymaga jednego wpisu we właściwości **DaemonDefs**. | |
| 32 | 51 | ||
| 33 | 52 | ## Demon - Krok po kroku | |
| 34 | 53 | ||
| 35 | - | ||
| 36 | - | ||
| 37 | - | ||
| 38 | - | ||
| 39 | - | ||
| 40 | - | ||
| 41 | - | ||
| 42 | - | ||
| 54 | + | * Gdy demon jest uruchamiany, analizowane są parametry wiersza poleceń. Wstępnie zdefiniowane są: | |
| 55 | + | * -i --install: zarejestruj demona. Nie ma to żadnego wpływu pod Uniksem. | |
| 56 | + | * -u --uninstall: wyrejestruj demona. Nie ma to żadnego wpływu pod Uniksem. | |
| 57 | + | * -r --run: uruchom demona. Windows zwykle robi to sam. | |
| 58 | + | * Utwórz TDaemonMapper | |
| 59 | + | * Utwórz jeden TCustomDaemon dla każdego wpisu _DaemonDefs_. | |
| 60 | + | * instaluj, odinstaluj lub uruchom każdą instancję. | |
| 61 | + | * jeśli działa: uruchom każdą instancję we własnym wątku, a następnie poczekaj na sygnał Stop/TERM. | |
| 43 | 62 | ||
| 44 | 63 | ## Metody demona | |
| 45 | 64 | ||
| 46 | - | ||
| 47 | - | ||
| 48 | - | ||
| 49 | - | ||
| 50 | - | ||
| 51 | - | ||
| 52 | - | ||
| 53 | - | ||
| 54 | - | ||
| 55 | - | ||
| 56 | - | ||
| 57 | - | ||
| 58 | - | ||
| 59 | - | ||
| 60 | - | ||
| 61 | - | ||
| 62 | - | ||
| 63 | - | ||
| 64 | - | ||
| 65 | - | ||
| 66 | - | ||
| 67 | - | ||
| 68 | - | ||
| 69 | - | ||
| 70 | - | ||
| 71 | - | ||
| 65 | + | Start | |
| 66 | + | Wywoływana, gdy demon powinien się uruchomić. Ta metoda musi natychmiast zwrócić wartość _True_. | |
| 67 | + | Stop | |
| 68 | + | Wywoływana, gdy demon powinien się zatrzymać. Ta metoda musi natychmiast zwrócić wartość _True_. | |
| 69 | + | Shutdown | |
| 70 | + | 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. | |
| 71 | + | Pause | |
| 72 | + | 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. | |
| 73 | + | Continue | |
| 74 | + | Wywoływana, gdy demon powinien kontynuować pracę po przerwie. Ta metoda musi natychmiast zwrócić wartość _True_. W Linuksie nie jest to uruchamiane. | |
| 75 | + | Install | |
| 76 | + | Wywoływana, gdy demon jest zarejestrowany jako usługa systemu Windows. Ta metoda powinna zwrócić wartość _True_ w przypadku powodzenia. | |
| 77 | + | Uninstall | |
| 78 | + | Wywoływana, gdy demon jest wyrejestrowany jako usługa systemu Windows. Ta metoda powinna zwrócić wartość _True_ w przypadku powodzenia. | |
| 79 | + | AfterUnInstall | |
| 80 | + | Wywoływana po tym, jak demon został wyrejestrowany jako usługa systemu Windows. Ta metoda powinna zwrócić wartość _True_ w przypadku powodzenia. | |
| 81 | + | HandleCustomCode | |
| 82 | + | Wywoływana, gdy do demona został wysłany specjalny sygnał. Ta metoda powinna zwrócić wartość _True_ w przypadku powodzenia. | |
| 72 | 83 | ||
| 73 | 84 | ### Pierwsze kroki | |
| 74 | 85 | ||
| 75 | - | ||
| 86 | + | Zanim będziesz mógł stworzyć aplikację Service lub Daemon, musisz najpierw upewnić się, że zainstalowałeś pakiet Lazarus Daemon "lazdemon". | |
| 76 | 87 | ||
| 77 | 88 | ## Przykład | |
| 78 | 89 | ||
| 79 | - | ||
| 90 | + | W katalogu examples/cleandir/ znajduje się prosty przykład. Przeczytaj README.txt. | |
| 80 | 91 | ||
| 81 | 92 | ## Instalacja usługi | |
| 82 | 93 | ||
| 83 | 94 | ### Windows | |
| 84 | 95 | ||
| 85 | - | ||
| 96 | + | 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 | 97 | ||
| 87 | 98 | Zobacz także: [[ServiceManager/pl|Menedżer usług]] | |
| 88 | 99 | ||
| 89 | 100 | #### Kodowanie systemowe / UTF-8 | |
| 90 | 101 | ||
| 91 | - | ||
| 102 | + | 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 | 103 | ||
| 93 | 104 | ### Linux (tylko dla starszych wersji Debiana) | |
| 94 | 105 | ||
| 95 | - | ||
| 106 | + | 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 | 107 | ||
| 97 | - | ||
| 98 | - | ||
| 99 | - | ||
| 100 | - | ||
| 108 | + | * SVC_ALIAS to długi opis Twojej aplikacji | |
| 109 | + | * SVC_FILENAME to rzeczywista nazwa pliku skompilowanej aplikacji usługi | |
| 110 | + | * SVC_DIR to miejsce, w którym skopiowałeś aplikację usługi | |
| 111 | + | * SVC_SERVICE_SCRIPT to ostateczna nazwa pliku service.sh stosowana w „Zapisz jako”, dostosowana do skryptu debian-service.sh. | |
| 101 | 112 | ||
| 102 | - | ||
| 113 | + | Umieść swój skrypt w folderze /etc/init.d/ | |
| 103 | 114 | ||
| 104 | - | ||
| 115 | + | uruchom usługę, za pomocą komendy "sudo service Name_Of_Your_Script start" | |
| 105 | 116 | ||
| 106 | - | ||
| 107 | - | ||
| 108 | - | ||
| 109 | - | ||
| 110 | - | ||
| 111 | - | ||
| 112 | - | ||
| 113 | - | ||
| 114 | - | ||
| 115 | - | ||
| 116 | - | ||
| 117 | - | ||
| 117 | + | [](</File:Note-icon.png>) | |
| 118 | 118 | ||
| 119 | - | ||
| 119 | + | **Uwaga:** sudo ma kilka odmian, np.: | |
| 120 | + | sudo -s # | |
| 121 | + | sudo -H # | |
| 122 | + | sudo -i # | |
| 123 | + | sudo su # | |
| 124 | + | sudo sh # | |
| 120 | 125 | ||
| 121 | - | ||
| 126 | + | 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. | |
| 122 | 127 | ||
| 123 | - | ||
| 128 | + | Opcja 1 | |
| 129 | + | ``` | |
| 124 | 130 | sudo update-rc.d Name_Of_Your_Script defaults | |
| 125 | 131 | ``` | |
| 126 | 132 | ||
| 127 | - | ||
| 128 | - | ||
| 129 | - | ||
| 133 | + | Opcja 2 | |
| 134 | + | ``` | |
| 130 | 135 | sudo apt-get install chkconfig | |
| 131 | - | ||
| 132 | - | ||
| 136 | + | sudo chkconfig --add Name_Of_Your_Script | |
| 137 | + | sudo chkconfig --level 2345 Name_Of_Your_Script on | |
| 133 | 138 | ``` | |
| 134 | 139 | ||
| 135 | 140 | ### systemd (Fedora, Debian, SLES12) | |
| 136 | 141 | ||
| 137 | - | ||
| 142 | + | Obecne odmiany Linuksa odchodzą od uruchamiania różnych demonów na rzecz ujednoliconego modelu usług. | |
| 138 | 143 | ||
| 139 | - | ||
| 144 | + | 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 | 145 | ||
| 141 | - | ||
| 142 | - | ||
| 146 | + | * Z wiersza polecenia wykonaj: sudo gedit | |
| 147 | + | * Kopiuj i wklej poniższy kod | |
| 143 | 148 | ||
| 144 | - | ||
| 149 | + | ``` | |
| 145 | 150 | [Unit] | |
| 146 | - | ||
| 147 | - | ||
| 148 | - | ||
| 149 | - | ||
| 150 | - | ||
| 151 | - | ||
| 152 | - | ||
| 153 | - | ||
| 154 | - | ||
| 155 | - | ||
| 156 | - | ||
| 151 | + | Description=Długi opis Twojej aplikacji | |
| 152 | + | After=network.target | |
| 153 | + | ||
| 154 | + | [Service] | |
| 155 | + | Type=simple | |
| 156 | + | ExecStart=pełna_ścieżka_i_nazwa_pliku -r | |
| 157 | + | RemainAfterExit=yes | |
| 158 | + | TimeoutSec=25 | |
| 159 | + | ||
| 160 | + | [Install] | |
| 161 | + | WantedBy=multi-user.target | |
| 157 | 162 | ``` | |
| 158 | 163 | ||
| 159 | - | ||
| 160 | - | ||
| 161 | - | ||
| 164 | + | * Edytuj następujące wartości | |
| 165 | + | * Description - Długi opis aplikacji serwisowej | |
| 166 | + | * ExecStart — pełna ścieżka_i_nazwa_pliku to nazwa skompilowanej aplikacji usługi wraz z pełną ścieżką | |
| 162 | 167 | ||
| 163 | - | ||
| 164 | - | ||
| 165 | - | ||
| 168 | + | * Zapisz jako okno dialogowe | |
| 169 | + | * Przejdź do /lib/systemd/system/ | |
| 170 | + | * Nazwij plik nazwa_twojej_usługi.service | |
| 166 | 171 | ||
| 167 | 172 | ## Zobacz także | |
| 168 | 173 | ||
| 169 | - | ||
| 170 | - | ||
| 171 | - | ||
| 172 | - | ||
| 173 | - | ||
| 174 | - | ||
| 174 | + | * [[ServiceManager/pl|Menedżer usług]] Przykład dla modułu Free Pascal do zarządzania usługami Windows | |
| 175 | + | * [[macOS daemons and agents]] \- macOS natywnie używający launchd | |
| 176 | + | * [[Office Automation]] \- Interakcja z oprogramowaniem biurowym | |
| 177 | + | * [Oswajanie demona: PDF autorstwa Michaëla Van Canneyt](<https://www.freepascal.org/~michael/articles/daemons/daemons.pdf>) | |
| 178 | + | * [Przydatna dyskusja z małą działającą aplikacją demona](<http://forum.lazarus.freepascal.org/index.php/topic,22983.msg152303.html#msg152303>) | |
| 179 | + | * [[Docker Containerization]] \- Konteneryzacja jako sposób na łatwe tworzenie demonów / usług | |
| 175 | 180 | ||
| 176 | 181 | --- | |
| 177 | - | ||
| 182 | + | *From the Free Pascal wiki, page "Daemons and Services/pl", as the Internet Archive kept it on 2022-10-07. 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).* |