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