diff --git a/docs/books/nvchad/nerd_fonts.uk.md b/docs/books/nvchad/nerd_fonts.uk.md index 989c7e8172..1572e10628 100644 --- a/docs/books/nvchad/nerd_fonts.uk.md +++ b/docs/books/nvchad/nerd_fonts.uk.md @@ -1,7 +1,7 @@ --- title: Встановлення Nerd Fonts author: Franco Colussi -contributors: Steven Spencer, Ganna Zhyrnova +contributors: Steven Spencer, Ganna Zhyrnova, Christine Belzie tested: 8.6, 9.0 tags: - nvchad @@ -11,11 +11,11 @@ tags: # :material-format-font: Nerd Fonts - Шрифти для розробників -Встановлення Nerd Fonts не змінює функції Neovim або NvChad, а просто додає шрифти, які приємніші для очей, ніж будь-який стандартний термінальний шрифт, який зараз є. +## :material-format-font: Що таке Nerd Fonts? -![Nerd Fonts](images/nerd_fonts_site_small.png){ align=right } Nerd Fonts — це колекція модифікованих шрифтів, призначених для розробників. Зокрема, «знакові шрифти», такі як Font Awesome, Devicons, Octicons тощо, використовуються для додавання додаткових гліфів. +![Nerd Fonts](images/nerd_fonts_site_small.png){ align=right } Nerd Fonts — це колекція модифікованих шрифтів, призначених для розробників. Зокрема, для додавання додаткових гліфів використовуються «знакові шрифти», такі як [Font Awesome](https://fontawesome.com/), [Devicons](https://devicon.dev/) і [Octicons](https://primer.style/foundations/icons). -Nerd Fonts використовує найпопулярніші програмні шрифти та змінює їх, додаючи групу гліфів (піктограм). Також доступний засіб виправлення шрифтів, якщо шрифт, який ви хочете використати, ще не було відредаговано. На сайті доступний зручний попередній перегляд, який дозволяє побачити, як має виглядати шрифт у редакторі. Для отримання додаткової інформації відвідайте головний [сайт](https://www.nerdfonts.com/) проекту. +Nerd Fonts також використовує найпопулярніші програмні шрифти, такі як MonoLisa або SourceCode Pro, і змінює їх, додаючи групу гліфів (піктограм). Патчер шрифтів доступний, якщо шрифт, який ви бажаєте використовувати, ще не було відредаговано. Існує також функція попереднього перегляду, щоб побачити, як шрифт має виглядати в редакторі. Для отримання додаткової інформації відвідайте головний [сайт](https://www.nerdfonts.com/) проекту. ## :material-monitor-arrow-down-variant: Завантаження @@ -27,9 +27,9 @@ https://www.nerdfonts.com/font-downloads ### :material-monitor-arrow-down-variant: Процедура інсталяції -Встановлення Nerd Fonts у Rocky Linux виконується повністю з командного рядка завдяки реалізації процедури, наданої репозиторієм проекту [ryanoasis/nerd-fonts](https://github.com/ryanoasis/nerd-fonts), процедура використовує *git для отримання необхідних шрифтів і *fc-cache* для їх конфігурації.

+Встановлення Nerd Fonts у Rocky Linux виконується повністю з командного рядка завдяки реалізації процедури, наданої репозиторієм проекту [ryanoasis/nerd-fonts](https://github.com/ryanoasis/nerd-fonts). Процедура використовує *git* для отримання необхідних шрифтів і *fc-cache* для їх налаштування. -!!! note "Примітка" +!!! Note "Примітка" Цей метод можна використовувати в усіх дистрибутивах *linux*, які використовують [fontconfig](https://www.freedesktop.org/wiki/Software/fontconfig/) для керування системними шрифтами. @@ -40,8 +40,8 @@ git clone --filter=blob:none --sparse git@github.com:ryanoasis/nerd-fonts ``` Ця команда завантажує лише необхідні файли, пропускаючи шрифти, які містяться в *patched-fonts*, щоб не перевантажувати локальне сховище шрифтами, які пізніше не використовуватимуться, таким чином дозволяючи вибіркове встановлення. -У цьому посібнику використовуватиметься шрифт [IBM Plex Mono](https://github.com/ryanoasis/nerd-fonts/tree/master/patched-fonts/IBMPlexMono), який пропонує чітке та трохи типографське відображення, функції, які роблять його особливо придатним для написання документації Markdown. -Щоб отримати огляд, ви можете відвідати [спеціальний сайт](https://www.programmingfonts.org/#plex-mono) із попереднім переглядом доступних шрифтів. +У цьому посібнику використовуватиметься шрифт [IBM Plex Mono](https://github.com/ryanoasis/nerd-fonts/tree/master/patched-fonts/IBMPlexMono), який пропонує чисте та трохи типографське відображення, функції, які роблять його особливо придатним для написання документації Markdown. +Для огляду з попереднім переглядом доступних шрифтів ви можете відвідати [спеціальний сайт](https://www.programmingfonts.org/#plex-mono). Перейдіть до новоствореної папки та завантажте набір шрифтів за допомогою команд: @@ -60,7 +60,7 @@ git sparse-checkout add patched-fonts/IBMPlexMono Під час інсталяції шрифт перейменовується на BlexMono відповідно до ліцензії SIL Open Font License (OFL) і, зокрема, [механізму зарезервованих імен](http://scripts.sil.org/cms/scripts/page.php? item_id=OFL_web_fonts_and_RFNs#14cbfd4a). -Сценарій *install.sh* копіює шрифти до папки користувача `~/.local/share/fonts/` і викликає програму *fc-cache* для зареєструвати їх у системі. Після завершення шрифти будуть доступні для емулятора терміналу, зокрема ми знайдемо такі встановлені шрифти: +Сценарій *install.sh* копіює шрифти до папки користувача `~/.local/share/fonts/` і викликає програму *fc-cache* для зареєструвати їх у системі. Після завершення шрифти будуть доступні для емулятора терміналу; зокрема, ми знайдемо такі встановлені шрифти: ```text title="~/.local/share/fonts/" NerdFonts/ @@ -84,8 +84,8 @@ NerdFonts/ ## :material-file-cog-outline: Конфігурація -На цьому етапі шрифт Nerd за вашим вибором має бути доступним для вибору. Щоб фактично вибрати його, ви повинні звернутися до робочого столу, який ви використовуєте. +На цьому етапі вибраний вами шрифт Nerd має бути доступним для вибору. Щоб вибрати його, ви повинні звернутися до робочого столу, який ви використовуєте. -![Менеджер шрифтів](images/font_nerd_view.png) +![Font Manager](images/font_nerd_view.png) -Якщо ви використовуєте робочий стіл Rocky Linux за замовчуванням (Gnome), щоб змінити шрифт в емуляторі терміналу, вам потрібно просто відкрити `gnome-terminal`, перейти до «Параметрів» і встановити Nerd Font для свого профілю. +Якщо ви використовуєте робочий стіл Rocky Linux за замовчуванням (Gnome), щоб змінити шрифт в емуляторі терміналу, вам потрібно буде відкрити `gnome-terminal`, перейти до «Параметрів» і встановити Nerd Font для ваш профіль. diff --git a/docs/books/web_services/052-load-balancer-proxies-varnish.uk.md b/docs/books/web_services/052-load-balancer-proxies-varnish.uk.md new file mode 100644 index 0000000000..a609076f03 --- /dev/null +++ b/docs/books/web_services/052-load-balancer-proxies-varnish.uk.md @@ -0,0 +1,703 @@ +--- +author: Antoine Le Morvan +contributors: Ganna Zhyrnova +title: Частина 5.2 Varnish +--- + +## Varnish + +У цьому розділі ви дізнаєтесь про кеш-проксі веб-прискорювача: Varnish. + +**** + +**Цілі**: Ви дізнаєтеся, як: + +:heavy_check_mark: Встановити та налаштувати Varnish;\ +:heavy_check_mark: Кешувати вміст веб-сайту. + +:checkered_flag: **зворотний проксі**, **кеш** + +**Знання**: :star: :star:\ +**Складність**: :star: :star: :star: + +**Час читання**: 30 хвилин + +**** + +### Загальні положення + +Varnish — це служба зворотного проксі-кешу HTTP або прискорювач веб-сайтів. + +Varnish отримує HTTP-запити від відвідувачів: + +- Якщо відповідь на кешований запит доступна, вона повертає відповідь безпосередньо клієнту з пам’яті сервера, +- Якщо він не має відповіді, Varnish звертається до веб-сервера. Потім Varnish надсилає запит на веб-сервер, отримує відповідь, зберігає її у своєму кеші та відповідає клієнту. + +Відповідь із кешу в пам’яті покращує час відповіді для клієнтів. У цьому випадку немає доступу до фізичних дисків. + +За замовчуванням Varnish прослуховує порт **6081** і використовує **VCL** (**V**arnish **C**onfiguration **L**language) для своєї конфігурації. Завдяки VCL можна: + +- Визначити вміст, який клієнт отримує шляхом передачі +- Визначити кешований вміст +- З якого сайту і як відбуваються зміни відповіді. + +Varnish розширюється за допомогою модулів VMOD (Varnish Modules). + +#### Забезпечення високої доступності + +Використання кількох механізмів забезпечує високу доступність у всьому веб-ланцюжку: + +- Якщо varnish знаходиться за балансувальниками навантаження (LB), вони вже перебувають у режимі HA, оскільки LB зазвичай перебувають у режимі кластера. Перевірка від LBs підтверджує наявність Varnish. Якщо сервер varnish більше не відповідає, він автоматично видаляється з пулу доступних серверів. В цьому випадку varnish знаходиться в режимі ACTIVE/ACTIVE. +- якщо varnish не знаходиться за кластером LB, клієнти звертаються до VIP (див. розділ Heartbeat), спільного між двома varnish. У цьому випадку varnish знаходиться в режимі ACTIVE/PASSIVE. VIP перемикається на другий вузол varnish, якщо активний сервер недоступний. +- Якщо серверна частина більше не доступна, ви можете видалити її з пулу серверної версії varnish або автоматично (за допомогою перевірки працездатності), або вручну в режимі CLI (корисно для полегшення оновлень). + +#### Забезпечення масштабованості + +Якщо серверних модулів вже недостатньо для підтримки робочого навантаження: + +- або додати більше ресурсів до серверних модулів і переналаштувати проміжне програмне забезпечення +- або додайте іншу серверну частину до пулу серверної обробки varnish + +#### Полегшення масштабованості + +Під час створення веб-сторінка часто складається з HTML (часто динамічно створеного PHP) і більш статичних ресурсів (JPG, gif, CSS, js тощо). Швидко стає цікаво кешувати кешовані ресурси (статичні), що розвантажує багато запитів із серверних програм. + +!!! NOTE "Примітка" + +``` +Кешування веб-сторінок (HTML, PHP, ASP, JSP тощо) можливо, але це складніше. Вам потрібно знати додаток і чи кешуються сторінки, що має бути у випадку з REST API. +``` + +Коли клієнт безпосередньо звертається до веб-сервера, сервер повинен повертати те саме зображення так часто, як запитує клієнт. Коли клієнт отримав зображення вперше, воно кешується на стороні браузера, залежно від конфігурації сайту та веб-програми. + +Під час доступу до сервера за належним чином налаштованим сервером кешу перший клієнт, який запитує зображення, ініціює початковий запит серверної частини. Однак кешування зображення відбуватиметься протягом певного періоду, а подальша доставка буде спрямована іншим клієнтам, які запитують той самий ресурс. + +Хоча добре налаштований кеш на стороні браузера зменшує кількість запитів до серверної частини, він доповнює використання кеш-проксі-сервера. + +#### Керування сертифікатами TLS + +Varnish не може спілкуватися через HTTPS (і це не його роль). + +Отже, сертифікат: + +- передається LB, коли потік проходить через нього (рекомендованим рішенням є централізація сертифіката тощо). Потім потік проходить незашифрованим через центр обробки даних. +- передається службою Apache, Nginx або HAProxy на самому сервері varnish, який діє лише як проксі для varnish (від порту 443 до порту 80). Це рішення корисно при безпосередньому доступі до varnish. +- Подібним чином Varnish не може зв’язуватися з серверними частинами через порт 443. Якщо необхідно, вам потрібно використовувати зворотний проксі-сервер Nginx або Apache, щоб розшифрувати запит на varnish. + +#### Як це працює + +У базовій веб-службі клієнт зв’язується безпосередньо зі службою через TCP на порту 80. + +![How a standard website works](img/varnish_website.png) + +Щоб використовувати кеш, клієнт повинен зв’язатися з веб-службою через стандартний порт Varnish 6081. + +![How Varnish works by default](img/varnish_website_with_varnish.png) + +Щоб зробити службу прозорою для клієнта, вам потрібно буде змінити порт прослуховування за замовчуванням для Varnish і vhosts веб-служби. + +![Transparent implementation for the customer](img/varnish_website_with_varnish_port_80.png) + +Щоб надати службу HTTPS, вам потрібно буде додати або балансувальник навантаження перед службою варіювання, або проксі-сервер на сервері версії, наприклад Apache, Nginx або HAProxy. + +### Конфігурація + +Установка проста: + +```bash +dnf install -y varnish +systemctl enable varnish +systemctl start varnish +``` + +#### Налаштування демона varnish + +Починаючи з `systemctl`, параметри varnish налаштовуються завдяки службовому файлу `/usr/lib/systemd/system/varnish.service`: + +```bash +[Unit] +Description=Varnish Cache, a high-performance HTTP accelerator +After=network-online.target + +[Service] +Type=forking +KillMode=process + +# Maximum number of open files (for ulimit -n) +LimitNOFILE=131072 + +# Locked shared memory - should suffice to lock the shared memory log +# (varnishd -l argument) +# Default log size is 80MB vsl + 1M vsm + header -> 82MB +# unit is bytes +LimitMEMLOCK=85983232 + +# Enable this to avoid "fork failed" on reload. +TasksMax=infinity + +# Maximum size of the corefile. +LimitCORE=infinity + +ExecStart=/usr/sbin/varnishd -a :6081 -f /etc/varnish/default.vcl -s malloc,256m +ExecReload=/usr/sbin/varnishreload + +[Install] +WantedBy=multi-user.target +``` + +Змініть значення за замовчуванням завдяки `systemctl edit varnish.service`: це створить файл `/etc/systemd/system/varnish.service.d/override.conf`: + +```bash +$ sudo systemctl edit varnish.service +[Service] +ExecStart=/usr/sbin/varnishd -a :6081 -f /etc/varnish/default.vcl -s malloc,512m +``` + +Ви можете вибрати опцію кілька разів, щоб указати серверну частину кешу. Можливі типи зберігання: `malloc` (кешувати в пам’яті, потім замінити, якщо потрібно) або `file` (створити файл на диску, а потім відобразити в пам’яті). Розміри виражаються в K/M/G/T (кілобайтах, мегабайтах, гігабайтах або терабайтах). + +#### Налаштування бекендів + +Для конфігурації Varnish використовується спеціальна мова під назвою VCL. + +Це передбачає компіляцію файлу конфігурації VCL на C. Якщо компіляція пройшла успішно без сигналів тривоги, службу можна перезапустити. + +Ви можете перевірити конфігурацію лаку за допомогою такої команди: + +```bash +varnishd -C -f /etc/varnish/default.vcl +``` + +!!! NOTE "Примітка" + +``` +Бажано перевірити синтаксис VCL перед перезапуском демона varnishd. +``` + +Перезавантажте конфігурацію командою: + +```bash +systemctl reload varnishd +``` + +!!! warning "Важливо" + +`systemctl restart varnishd` очищає кеш-пам’ять varnish і спричиняє пікове навантаження на сервери. Тому вам слід уникати перезавантаження varnishd. + +!!! NOTE "Примітка" + +``` +Щоб налаштувати Varnish, дотримуйтесь рекомендацій на цій сторінці: . +``` + +### Мова VCL + +#### Підпрограми + +Varnish використовує файли VCL, сегментовані на підпрограми, що містять дії для виконання. Ці підпрограми виконуються лише в конкретних випадках, які вони визначають. Типовий файл `/etc/varnish/default.vcl` містить підпрограми `vcl_recv`, `vcl_backend_response` і `vcl_deliver`: + +```bash +# +# This is an example VCL file for Varnish. +# +# It does not do anything by default, delegating control to the +# builtin VCL. The builtin VCL is called when there is no explicit +# return statement. +# +# See the VCL chapters in the Users Guide at https://www.varnish-cache.org/docs/ +# and http://varnish-cache.org/trac/wiki/VCLExamples for more examples. + +# Marker to tell the VCL compiler that this VCL has been adapted to the +# new 4.0 format. +vcl 4.0; + +# Default backend definition. Set this to point to your content server. +backend default { + .host = "127.0.0.1"; + .port = "8080"; +} + +sub vcl_recv { + +} + +sub vcl_backend_response { + +} + +sub vcl_deliver { + +} +``` + +- **vcl_recv**: підпрограма, що викликається перед надсиланням запиту до серверної частини. У цій процедурі ви можете змінювати заголовки HTTP та файли cookie, вибирати серверну частину тощо. Перегляньте дії `set req`. +- **vcl_backend_response**: процедура викликається після отримання відповіді серверної частини (`beresp` означає BackEnd RESPonse). Перегляньте дії `set bereq.` і `set beresp.`. +- **vcl_deliver**: Ця процедура підходить для модифікації виводу Varnish. Якщо вам потрібно змінити кінцевий об’єкт (наприклад, додати або видалити заголовок), ви можете зробити це у `vcl_deliver`. + +#### Оператори VCL + +- `=`: призначення +- `==`: порівняння +- `~`: порівняння в поєднанні з регулярним виразом і ACL +- `!`: заперечення +- `&&`: і логіка +- `||`: або логіка + +#### Varnish об'єкти + +- **req**: об'єкт запиту. Створює `req`, коли Varnish отримує запит. Більшість роботи в підпрограмі `vcl_recv` стосується цього об'єкта. +- **bereq**: Об’єкт запиту призначено для веб-сервера. Varnish створює цей об’єкт із `req`. +- **beresp**: об'єкт відповіді веб-сервера. Він містить заголовки об’єктів із програми. Ви можете змінити відповідь сервера в підпрограмі `vcl_backend_response`. +- **resp**: відповідь HTTP, надіслана клієнту. Змініть цей об’єкт за допомогою підпрограми `vcl_deliver`. +- **obj**: кешований об’єкт. Тільки для читання. + +#### Varnish дії + +Найчастіші дії: + +- **pass**: Запит і подальша відповідь надійдуть із сервера додатків після повернення. Застосування кешу не відбувається. `pass` повертає з підпрограми `vcl_recv`. +- **hash**: Після повернення з `vcl_recv` Varnish обслуговуватиме вміст із кешу, навіть якщо конфігурація запиту вказує передачу без кешу. +- **pipe**: Використовується для керування потоками. У цьому випадку Varnish більше не перевірятиме кожен запит, але пропускатиме всі байти на сервер. Веб-сокети або керування відеопотоком, наприклад, використовують `pipe`. +- **deliver**: Доставляє об'єкт клієнту. Зазвичай із підпрограми `vcl_backend_response`. +- **restart**: Перезапускає процес обробки запиту. Зберігає зміни в об’єкті `req`. +- **retry**: Передає запит назад на сервер додатків. Використовується з `vcl_backend_response` або `vcl_backend_error`, якщо відповідь програми є незадовільною. + +У підсумку, на діаграмі нижче показано можливі взаємодії між підпрограмами та діями: + +![Transparent implementation for the customer](img/varnish_interactions.png) + +### Перевірка/тестування/усунення несправностей + +Перевірити, що сторінка походить із кешу varnish, можна за допомогою заголовків відповіді HTTP: + +![Simplified varnish operation](img/varnish_troobleshooting.png) + +### Бекенди + +Varnish використовує термін «backend» для віртуальних хостів, які йому потрібні для проксі. + +Ви можете визначити кілька серверних модулів на одному сервері Varnish. + +Налаштування серверних модулів здійснюється через `/etc/varnish/default.vcl`. + +#### Керування ACL + +```bash +# Deny ACL +acl deny { +"10.10.0.10"/32; +"192.168.1.0"/24; +} +``` + +Застосувати ACL: + +```bash +# Block ACL deny IPs +if (client.ip ~ forbidden) { + error 403 "Access forbidden"; +} +``` + +Не кешувати певні сторінки: + +```bash +# Do not cache login and admin pages +if (req.url ~ "/(login|admin)") { + return (pass); +} +``` + +#### Налаштування POST і файлів cookie + +Varnish ніколи не кешує запити HTTP POST або запити, що містять файли cookie (від клієнта чи серверної частини). + +Якщо серверна частина використовує файли cookie, кешування вмісту не відбуватиметься. + +Щоб виправити цю поведінку, ви можете скасувати файли cookie у своїх запитах: + +```bash +sub vcl_recv { + unset req.http.cookie; +} + +sub vcl_backend_response { + unset beresp.http.set-cookie; +} +``` + +#### Розповсюдження запитів на різні бекенди + +Якщо розміщено кілька сайтів, наприклад сервер документів (\) і вікі (\), можна розподіляти запити на правильну серверну частину. + +Оголошення бекендів: + +```bash +backend docs { + .host = "127.0.0.1"; + .port = "8080"; +} + +backend blog { + .host = "127.0.0.1"; + .port = "8081"; +} +``` + +Модифікація об’єкта `req.backend` відбувається відповідно до хоста, викликаного в HTTP-запиті в підпрограмі `vcl_recv`: + +```bash +sub vcl_recv { + if (req.http.host ~ "^doc.rockylinux.org$") { + set req.backend = docs; + } + + if (req.http.host ~ "^wiki.rockylinux.org$") { + set req.backend = wiki; + } +} +``` + +#### Розподіл навантаження + +Varnish може обробляти балансування навантаження за допомогою певних серверних модулів, які називаються directors. + +Director циклічного керування розповсюджує запити до систем циклічного керування (по черзі). Ви можете призначити вагу кожному серверу. + +Director клієнта розподіляє запити відповідно до липкої спорідненості сеансу на будь-якому елементі заголовка (тобто за допомогою файлу cookie сеансу). У цьому випадку клієнт завжди повертається до того самого сервера. + +Оголошення бекендів + +```bash +backend docs1 { + .host = "192.168.1.10"; + .port = "8080"; +} + +backend docs2 { + .host = "192.168.1.11"; + .port = "8080"; +} +``` + +`director` дозволяє пов’язати 2 визначені серверні модулі. + +Director - оголошення: + +```bash +director docs_director round-robin { + { .backend = docs1; } + { .backend = docs2; } +} +``` + +Все, що залишилося, це визначити director як бекенд для запитів: + +```bash +sub vcl_recv { + set req.backend = docs_director; +} +``` + +#### Керування бекендами за допомогою CLI + +Позначення серверів як **хворих** або **справних** можна з метою адміністрування чи обслуговування. Ця дія дозволяє видалити вузол із пулу, не змінюючи конфігурацію сервера Varnish (без його перезапуску) або зупиняючи серверну службу. + +Переглянути статус бекенда: команда `backend.list` відображає всі бекенди, навіть ті без перевірки працездатності (зонду). + +```bash +$ varnishadm backend.list +Backend name Admin Probe +site.default probe Healthy (no probe) +site.front01 probe Healthy 5/5 +site.front02 probe Healthy 5/5 +``` + +Щоб перейти з одного стану в інший: + +```bash +varnishadm backend.set_health site.front01 sick + +varnishadm backend.list +Backend name Admin Probe +site.default probe Healthy (no probe) +site.front01 sick Sick 0/5 +site.front02 probe Healthy 5/5 + +varnishadm backend.set_health site.front01 healthy + +varnishadm backend.list +Backend name Admin Probe +site.default probe Healthy (no probe) +site.front01 probe Healthy 5/5 +site.front02 probe Healthy 5/5 +``` + +Щоб дозволити Varnish вирішувати стан своїх серверних модулів, необхідно вручну перемкнути серверні модулі на хворі чи працездатні та повернутися до автоматичного режиму. + +```bash +varnishadm backend.set_health site.front01 auto +``` + +Оголошення серверних модулів виконується наступним чином: https://github.com/mattiasgeniar/varnish-6.0-configuration-templates. + +### Журнали Apache + +Оскільки HTTP-служба має зворотний проксі-сервер, веб-сервер більше не матиме доступу до IP-адреси клієнта, а лише до служби Varnish. + +Щоб врахувати зворотний проксі в журналах Apache, змініть формат журналу подій у файлі конфігурації сервера: + +```bash +LogFormat "%{X-Forwarded-For}i %l %u %t "%r" %>s %b "%{Referer}i" "%{User-Agent}i"" varnishcombined +``` + +і врахуйте цей новий формат у веб-сайті vhost: + +```bash +CustomLog /var/log/httpd/www-access.log.formatux.fr varnishcombined +``` + +і зробити його сумісним з Varnish: + +```bash +if (req.restarts == 0) { + if (req.http.x-forwarded-for) { + set req.http.X-Forwarded-For = req.http.X-Forwarded-For + ", " + client.ip; + } else { + set req.http.X-Forwarded-For = client.ip; + } +} +``` + +### Очищення кешу + +Кілька запитів на очищення кешу: + +в командному рядку: + +```bash +varnishadm 'ban req.url ~ .' +``` + +використовуючи секрет і порт, відмінний від типового: + +```bash +varnishadm -S /etc/varnish/secret -T 127.0.0.1:6082 'ban req.url ~ .' +``` + +на CLI: + +```bash +varnishadm + +varnish> ban req.url ~ ".css$" +200 + +varnish> ban req.http.host == www.example.com +200 + +varnish> ban req.http.host ~ . +200 +``` + +через запит HTTP PURGE: + +```bash +curl -X PURGE http://www.example.org/foo.txt +``` + +Налаштування Varnish для прийняття цього запиту виконується за допомогою: + +```bash +acl local { + "localhost"; + "10.10.1.50"; +} + +sub vcl_recv { + # directive to be placed first, + # otherwise another directive may match first + # and the purge will never be performed + if (req.method == "PURGE") { + if (client.ip ~ local) { + return(purge); + } + } +} +``` + +### Керування журналами + +Varnish записує свої журнали в пам’ять і двійковий файл, щоб не погіршувати продуктивність. Коли пам’ять закінчується, він переписує нові записи поверх старих, починаючи з початку пам’яті. + +Можна переглянути журнали за допомогою інструментів `varnishstat` (статистика), `varnishtop` (зверху для Varnish), `varnishlog` (докладне ведення журналів) або `varnishnsca` (журнали у форматі NCSA, наприклад Apache): + +```bash +varnishstat +varnishtop -i ReqURL +varnishlog +varnishnsca +``` + +Використання параметра `-q` для застосування фільтрів до журналів здійснюється за допомогою: + +```bash +varnishlog -q 'TxHeader eq MISS' -q "ReqHeader ~ '^Host: rockylinux\.org$'" +varnishncsa -q "ReqHeader eq 'X-Cache: MISS'" +``` + +Демони `varnishlog` і `varnishnsca` записують журнали на диск незалежно від демона `varnishd`. Демон `varnishd` продовжує заповнювати свої журнали в пам'яті, не погіршуючи продуктивність клієнтів; потім інші демони копіюють журнали на диск. + +### Практичне завдання + +Для цього практичного завдання вам знадобиться один сервер із встановленими, налаштованими та захищеними службами Apache, як описано в попередніх розділах. + +Ви налаштуєте зворотний кеш-проксі перед ним. + +Ваш сервер має такі IP-адреси: + +- server1: 192.168.1.10 + +Якщо у вас немає служби для визначення імен, заповніть файл `/etc/hosts` таким вмістом: + +```bash +$ cat /etc/hosts +127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4 +::1 localhost localhost.localdomain localhost6 localhost6.localdomain6 + +192.168.1.10 server1 server1.rockylinux.lan +``` + +#### Завдання 1: встановлення та налаштування Apache + +```bash +sudo dnf install -y httpd mod_ssl +sudo systemctl enable httpd --now +sudo firewall-cmd --permanent --add-service=http +sudo firewall-cmd --permanent --add-service=https +sudo firewall-cmd --reload +echo "Node $(hostname -f)" | sudo tee "/var/www/html/index.html" +``` + +Підтвердити: + +```bash +$ curl http://server1.rockylinux.lan +Node server1.rockylinux.lan + +$ curl -I http://server1.rockylinux.lan +HTTP/1.1 200 OK +Date: Mon, 12 Aug 2024 13:16:18 GMT +Server: Apache/2.4.57 (Rocky Linux) OpenSSL/3.0.7 +Last-Modified: Mon, 12 Aug 2024 13:11:54 GMT +ETag: "36-61f7c3ca9f29c" +Accept-Ranges: bytes +Content-Length: 54 +Content-Type: text/html; charset=UTF-8 +``` + +#### Завдання 2: Встановлення varnish + +```bash +sudo dnf install -y varnish +sudo systemctl enable varnishd --now +sudo firewall-cmd --permanent --add-port=6081/tcp --permanent +sudo firewall-cmd --reload +``` + +#### Завдання 3: Налаштувати Apache як серверну частину + +Змініть `/etc/varnish/default.vcl`, щоб використовувати apache (порт 80) як серверну частину: + +```bash +# Default backend definition. Set this to point to your content server. +backend default { + .host = "127.0.0.1"; + .port = "80"; +} +``` + +Перезавантажте Varnish + +```bash +sudo systemctl reload varnish +``` + +Перевірте, чи працює varnish: + +```bash +$ curl -I http://server1.rockylinux.lan:6081 +HTTP/1.1 200 OK +Server: Apache/2.4.57 (Rocky Linux) OpenSSL/3.0.7 +X-Varnish: 32770 6 +Age: 8 +Via: 1.1 varnish (Varnish/6.6) + +$ curl http://server1.rockylinux.lan:6081 +Node server1.rockylinux.lan +``` + +Як бачите, Apache обслуговує сторінку індексу. + +Було додано деякі заголовки, які дають нам інформацію про те, що наш запит було оброблено varnish (заголовок `Via`) і кешований час сторінки (заголовок `Age`), який говорить нам, що наша сторінка була надана безпосередньо з пам'яті varnish з диска з Apache. + +#### Завдання 4: Видаліть деякі заголовки + +Ми видалимо деякі заголовки, які можуть надати хакерам непотрібну інформацію. + +У підрозділі `vcl_deliver` додайте наступне: + +```bash +sub vcl_deliver { + unset resp.http.Server; + unset resp.http.X-Varnish; + unset resp.http.Via; + set resp.http.node = "F01"; + set resp.http.X-Cache-Hits = obj.hits; + if (obj.hits > 0) { # Add debug header to see if it is a HIT/MISS and the number of hits, disable when not needed + set resp.http.X-Cache = "HIT"; + } else { + set resp.http.X-Cache = "MISS"; + } +} +``` + +Перевірте свою конфігурацію та перезавантажте varnish: + +```bash +$ sudo varnishd -C -f /etc/varnish/default.vcl +... +$ sudo systemctl reload varnish +``` + +Перевірте відмінності: + +```bash +$ curl -I http://server1.rockylinux.lan:6081 +HTTP/1.1 200 OK +Age: 4 +node: F01 +X-Cache-Hits: 1 +X-Cache: HIT +Accept-Ranges: bytes +Connection: keep-alive +``` + +Як бачимо, видалення непотрібних заголовків відбувається при додаванні необхідних (для усунення неполадок). + +### Висновок + +Тепер у вас є всі знання, необхідні для налаштування основного сервера кешу та додавання функцій. + +Наявність сервера varnish у вашій інфраструктурі може бути дуже корисним для багатьох речей, окрім кешування: для безпеки серверного сервера, для обробки заголовків, для полегшення оновлень (наприклад, синій/зелений режим або режим жовтий) тощо. + +### Перевірте свої знання + +:heavy_check_mark: Чи може Varnish розміщувати статичні файли? + +- [ ] Так +- [ ] Ні + +:heavy_check_mark: Чи потрібно зберігати кеш-пам’ять varnish у пам’яті? + +- [ ] Так +- [ ] Ні diff --git a/docs/books/web_services/053-load-balancer-proxies-haproxy-squid.uk.md b/docs/books/web_services/053-load-balancer-proxies-haproxy-squid.uk.md new file mode 100644 index 0000000000..747ac3e041 --- /dev/null +++ b/docs/books/web_services/053-load-balancer-proxies-haproxy-squid.uk.md @@ -0,0 +1,62 @@ +--- +author: Antoine Le Morvan +contributors: null +title: Частина 5.3 Squid +--- + +!!! info + +``` +Цей вміст ще не написано. +``` + + diff --git a/docs/books/web_services/07-high-availability.uk.md b/docs/books/web_services/07-high-availability.uk.md index f527356cf6..28fc17e247 100644 --- a/docs/books/web_services/07-high-availability.uk.md +++ b/docs/books/web_services/07-high-availability.uk.md @@ -1,6 +1,6 @@ --- author: Antoine Le Morvan -contributors: Steven Spencer +contributors: Steven Spencer, Ganna Zhyrnova title: Частина 7 Висока доступність tags: - кластеризація @@ -26,7 +26,7 @@ tags: | 99,999% | 5 хвилин 15 секунд | | 99,9999% | 31,68 секунди | -«Висока доступність» (**HA**) стосується всіх заходів, вжитих для гарантування максимально можливої ​​доступності послуги. Іншими словами, це правильна робота 24 години на добу. +«Висока доступність» (**HA**) стосується всіх заходів, вжитих для гарантування максимально можливої ​​доступності послуги — правильної роботи 24 години на добу. ### Огляд @@ -57,7 +57,7 @@ tags: #### VIP -VIP — це віртуальна IP-адреса. Це адреса, призначена активному/пасивному кластеру. Призначте VIP активному вузлу кластера. У разі збою в службі VIP дезактивується на невдалому вузлі, тоді як активація відбувається на вузлі, який приймає. Це відомо як відновлення після відмови. +VIP — це віртуальна IP-адреса, призначена активному/пасивному кластеру. Призначте VIP активному вузлу кластера. У разі збою в службі VIP дезактивується на невдалому вузлі, тоді як активація відбувається на вузлі, який приймає. Це відомо як відновлення після відмови. Клієнти завжди звертаються до кластера за допомогою VIP, що робить активне відновлення сервера прозорим. @@ -513,6 +513,7 @@ VIP переміщено на server2. Перевірте за допомого sudo pcs node unstandby server1 ``` +!!! Важливо Після того, як сервер1 перейшов у режим очікування, кластер повертається до нормального стану, але ресурс не передається назад на сервер1: він залишається на сервері2. ##### Конфігурація служби @@ -753,7 +754,7 @@ $ cat /etc/hosts #### Завдання 1: Встановлення та налаштування -Для встановлення Pacemaker. Увімкніть репозиторій `highavailability`. +Щоб інсталювати Pacemaker, спочатку ввімкніть репозиторій `highavailability`: На обох вузлах: @@ -806,7 +807,7 @@ Full List of Resources: * myclusterVIP (ocf:heartbeat:IPaddr2): Started server2 ``` -#### Завдання 3: встановлення сервера Apache +#### Завдання 3: Встановлення сервера Apache Виконайте цю установку на обох вузлах: diff --git a/docs/desktop/gnome/dconf.fr.md b/docs/desktop/gnome/dconf.fr.md new file mode 100644 index 0000000000..ecaa0ff501 --- /dev/null +++ b/docs/desktop/gnome/dconf.fr.md @@ -0,0 +1,96 @@ +--- +title: Éditeur de Configuration – dconf +author: Ezequiel Bruni +contributors: Steven Spencer +--- + +## Introduction + +GNOME adopte une approche très rationalisée de son interface utilisateur et de ses fonctionnalités. Ce n'est pas une mauvaise chose, car cela facilite l'apprentissage et l'installation GNOME par défaut vous permet de vous mettre directement au travail. + +Cependant, cette approche signifie également que la configuration n'est pas aussi simple que certains le souhaiteraient. Bien sûr, si vous ne trouvez pas ce dont vous avez besoin dans le panneau `Settings`, vous pouvez installer `GNOME Tweaks` pour étendre vos possibilités. Vous pouvez même installer des extensions GNOME pour bénéficier de nouvelles fonctionnalités et options. + +Mais que faire si vous souhaitez voir en détail tous les paramètres, fonctionnalités et configurations que les développeurs de GNOME vous ont dissimulés ? Bien sûr, vous pouvez rechercher votre problème actuel en ligne et saisir une commande pour modifier une variable mystérieuse, ou bien vous installez `dconf Editor`. + +`dconf Editor` est essentiellement une application de paramètres GNOME qui contient _tout_ et sait tout faire. En fait, cela pourrait vous rappeler un peu le registre Windows, et la fonction _est_ similaire. Cependant, il est plus lisible mais il ne couvre que les fonctionnalités de GNOME et certains des logiciels créés pour GNOME. + +Et vous pouvez également modifier les paramètres des extensions GNOME, ce qui est donc très cool. + +!!! warning "Avertissement" + +``` +La comparaison avec le registre Windows était tout à fait intentionnelle. Tout comme les clés de registre erronées, *certains* paramètres de GNOME Shell peuvent en fait endommager votre installation GNOME, ou au moins causer des problèmes. Vous devrez peut-être restaurer les anciens paramètres via la ligne de commande. + +Si vous n'êtes pas sûr de la fonction d'un paramètre particulier, faites d'abord des recherches à ce sujet. La modification des paramètres d'application est toutefois acceptable et beaucoup plus facile à annuler. +``` + +## Prérequis + +Pour ce guide, vous aurez besoin des conditions suivantes : + +- Installation de Rocky Linux, GNOME inclus. +- Les droits nécessaires pour l'installation de logiciels sur votre système (privilèges `sudo`). + +Voilà, c’est tout. + +## `dconf Editor` — Installation + +Accédez à l'application `Software`, recherchez `Dconf Editor` et appuyez sur le bouton d'installation. Il est disponible dans le référentiel Rocky Linux par défaut. + +![the GNOME software center, featuring dconf Editor](images/dconf-01.png) + +Pour ceux d'entre vous qui préfèrent la ligne de commande, c'est : + +```bash +sudo dnf install dconf-editor +``` + +## `dconf Editor` — Utilisation + +Une fois que vous aurez ouvert l’application, vous verrez trois éléments importants de l’interface utilisateur. Tout en haut se trouve le chemin. Oui, vos paramètres GNOME sont tous organisés selon une arborescence de dossiers. + +En haut à droite vous verrez un bouton avec une petite étoile. C'est le bouton Favoris, vous pouvez ainsi enregistrer votre état dans l'application et y revenir plus tard rapidement et facilement. En dessous se trouve le panneau principal dans lequel vous sélectionnez vos sous-dossiers de paramètres et modifiez les paramètres comme bon vous semble. + +![a screenshot of the dconf Editor window with arrows pointing at the aforementioned elements](images/dconf-02.png) + +À gauche du bouton `Favorites`, vous verrez le bouton `Search`, qui fait exactement ce que vous attendez. + +Et maintenant, que faire si vous souhaitez modifier certains paramètres dans le gestionnaire de fichiers ? Par exemple, l'auteur adore la barre latérale. L'auteur trouve ça bien pratique. Mais peut-être que vous ressentez différemment et que vous souhaitez effectuer des modifications. Donc, pour les besoins de ce guide, il faut continuer. + +![a screenshot of the Nautilus file manager, with a threatening red X over the doomed sidebar](images/dconf-03.png) + +_Good night, sweet prince._ + +Allez dans `/org/gnome/nautilus/window-state` et vous verrez une option appelée `start-with-sidebar`. Appuyez sur le bouton bascule et cliquez sur `Reload` lorsque cela apparaît comme ceci : + +![a screenshot of dconf Editor, showing the toggle and reload button in question](images/dconf-04.png) + +Si tout s'est bien passé, la prochaine fenêtre du navigateur de fichiers que vous ouvrirez devrait ressembler à ceci : + +![a screenshot of the file manager, bereft of its sidebar](images/dconf-05.png) + +Si cela vous semble incorrect — et l'auteur convient que cela devrait l'être –, rétablissez-le simplement, appuyez à nouveau sur `Reload` et ouvrez une nouvelle fenêtre du navigateur de fichiers. + +Enfin, vous pouvez également cliquer directement sur n'importe quel paramètre dans la fenêtre « dconf Editor » pour voir plus d'informations (et parfois plus d'options). Par exemple, voici à quoi ressemble l'écran des paramètres `initial-size` du gestionnaire de fichiers GNOME. + +![a screenshot of dconf Editor showing the initial-size settings for the file manager](images/dconf-06.png) + +## Maintenance + +Si vous modifiez vos paramètres dans `dconf Editor` et que vous ne voyez aucun changement, essayez alors l’une des solutions suivantes : + +1. Redémarrez l'application sur laquelle vous effectuez les modifications. +2. Déconnectez-vous et reconnectez-vous, ou redémarrez pour apporter des modifications à GNOME Shell. +3. Abandonnez car cette option n’est tout simplement plus fonctionnelle. + +Sur ce dernier point : oui, les développeurs GNOME vous suppriment parfois simplement la possibilité de modifier réellement un paramètre, même avec `dconf Editor`. + +Par exemple, l'auteur a essayé d'apporter des modifications aux paramètres du sélecteur de fenêtres (la liste des fenêtres ouvertes qui s'affiche lorsque vous appuyez sur ++alt+tab++), et n'a obtenu aucun résultat. Peu importe ce que l'auteur a essayé, `dconf Editor` semble n'avoir aucun effet sur certaines de ses fonctions. + +Cela pourrait être un bug, mais ce ne serait pas la première fois qu'un paramètre affiché dans `dconf Editor` était essentiellement désactivé de manière furtive. Si vous rencontrez ce problème, recherchez sur le site des extensions GNOME pour voir s'il existe une extension qui ajoute l'option que vous souhaitez dans GNOME. + +## Conclusion + +C'est tout ce que vous devez savoir pour commencer. N'oubliez pas de garder une trace de toutes vos modifications, de ne pas modifier les paramètres sans savoir exactement ce qu'ils font, et amusez-vous à explorer les options qui s'offrent (pour la plupart) à votre disposition. + +Bonne chance ! diff --git a/docs/desktop/gnome/dconf.uk.md b/docs/desktop/gnome/dconf.uk.md new file mode 100644 index 0000000000..1575333434 --- /dev/null +++ b/docs/desktop/gnome/dconf.uk.md @@ -0,0 +1,96 @@ +--- +title: Редактор конфігурації dconf +author: Ezequiel Bruni +contributors: Steven Spencer +--- + +## Вступ + +GNOME використовує дуже спрощений підхід до свого інтерфейсу користувача та його функцій. Це непогано, оскільки його легко освоїти, а типовий досвід роботи з GNOME дає змогу приступати до роботи. + +Однак цей підхід також означає, що його не так швидко налаштувати. Якщо ви не можете знайти те, що вам потрібно на панелі налаштувань, ви можете встановити GNOME Tweaks, щоб розширити свої можливості. Ви навіть можете встановити розширення GNOME, щоб отримати нові функції та параметри. + +Але що, якщо ви хочете побачити всі маленькі параметри, функції та конфігурації, які приховали розробники GNOME? Ви можете знайти свою поточну проблему в Інтернеті та ввести команду, щоб змінити незрозумілу змінну, або ви можете встановити `dconf Editor`. + +`dconf Editor` — це програма налаштувань GNOME з _усім_. Це може трохи нагадувати вам реєстр Windows, і це _схоже_. Однак він більш читабельний; він охоплює лише функції GNOME, і деяке програмне забезпечення створено для GNOME. + +Ви також можете редагувати налаштування розширень GNOME. + +!!! Warning "Важливо" + +``` +Порівняння з реєстром Windows було цілком навмисним. Як і погані ключі реєстру, *деякі* налаштування оболонки GNOME можуть порушити інсталяцію GNOME або принаймні спричинити проблеми. Можливо, знадобиться відновити старі налаштування за допомогою командного рядка. + +Якщо ви не впевнені, що робить певний параметр, спочатку дослідіть його. Зміна налаштувань додатка — це добре, але їх набагато легше скасувати. +``` + +## Припущення + +Для цього посібника вам потрібно: + +- Rocky Linux із встановленим GNOME. +- Повноваження на встановлення програмного забезпечення у вашій системі (права sudo). + +І це все. + +## Встановлення `dconf Editor` + +Перейдіть до програми «Програмне забезпечення», знайдіть «Dconf Editor» і натисніть на кнопку встановлення. Це доступне у стандартному сховищі Rocky Linux. + +![the GNOME software center, featuring dconf Editor](images/dconf-01.png) + +Щоб інсталювати редактор dconf за допомогою командного рядка, виконайте такі дії: + +```bash +sudo dnf install dconf-editor +``` + +## Використання редактора dconf + +Відкривши програму, ви побачите три важливі частини інтерфейсу користувача. Вгорі – відображається шлях (хлібні крихти). Усі параметри GNOME містять шлях/структуру папок. + +У верхньому правому куті ви побачите кнопку з маленькою зірочкою. Це кнопка вибраного, яка дозволяє зберегти своє місце в додатку та повернутися до нього пізніше швидко та легко. Нижче розташована центральна панель, де ви вибираєте вкладені папки налаштувань і змінюєте налаштування на свій розсуд. + +![a screenshot of the dconf Editor window with arrows pointing at the aforementioned elements](images/dconf-02.png) + +Ліворуч від кнопки вибраного знаходиться кнопка пошуку, яка виконує саме те, що ви очікуєте. + +Що робити, якщо ви хочете змінити деякі налаштування у файловому менеджері? Наприклад, мені подобається бокова панель. Я вважаю її дуже зручним інструментом. Але, можливо, ви відчуваєте інакше і хочете щось змінити. Отже, для цього посібника це має піти. + +![a screenshot of the Nautilus file manager, with a threatening red X over the doomed sidebar](images/dconf-03.png) + +_Good night, sweet prince._ + +Перейдіть до `/org/gnome/nautilus/window-state`, і ви побачите опцію під назвою `start-with-sidebar`. Натисніть перемикач і натисніть кнопку «Перезавантажити», коли вона з’явиться, як показано на знімку екрана нижче: + +![a screenshot of dconf Editor, showing the toggle and reload button in question](images/dconf-04.png) + +Якщо все пройшло правильно, наступне вікно браузера файлів, яке ви відкриваєте, має виглядати так: + +![a screenshot of the file manager, bereft of its sidebar](images/dconf-05.png) + +Якщо це не так, перемкніть його назад, натисніть «Перезавантажити» ще раз і відкрийте нове вікно браузера файлів. + +Нарешті, ви можете клацнути безпосередньо на будь-якому параметрі у вікні `dconf Editor`, щоб побачити більше інформації (і іноді більше параметрів). Наприклад, ось екран налаштувань `початкового розміру` для файлового менеджера GNOME. + +![a screenshot of dconf Editor showing the initial-size settings for the file manager](images/dconf-06.png) + +## Вирішення проблем + +Якщо ви вносите зміни до своїх налаштувань у `dconf Editor` і нічого не змінюєте, спробуйте одне з наступних виправлень: + +1. Перезапустіть програму, до якої ви вносите зміни. +2. Вийдіть, увійдіть знову або перезавантажтеся, щоб змінити оболонку GNOME. +3. Відмовтеся, тому що ця опція просто не працює. + +Щодо останнього: так, розробники GNOME іноді вимикають вашу можливість змінювати налаштування, навіть за допомогою `dconf Editor`. + +Наприклад, я спробував змінити налаштування перемикача вікон (список відкритих вікон, який з’являється, коли ви натискаєте ++alt+tab++), і нічого не дійшло. Що б я не пробував, `dconf Editor` не впливає на деякі його функції. + +Тепер це може бути помилкою, але це буде не перший раз, коли параметр, показаний у `dconf Editor`, по суті, було вимкнено приховано. Це може бути помилкою, але це буде не перший випадок, коли параметр, показаний у `dconf Editor`, по суті, було вимкнено приховано. + +## Висновок + +Це все, що вам потрібно знати, щоб почати. Просто пам’ятайте про те, щоб відстежувати всі ваші зміни, не змінюйте налаштування, не знаючи, що саме вони роблять, і отримуйте задоволення, досліджуючи параметри, які (здебільшого) доступні для вас. + +Розважайтесь! diff --git a/docs/desktop/gnome/onlineaccounts.uk.md b/docs/desktop/gnome/onlineaccounts.uk.md new file mode 100644 index 0000000000..283a158978 --- /dev/null +++ b/docs/desktop/gnome/onlineaccounts.uk.md @@ -0,0 +1,70 @@ +--- +title: Онлайн-облікові записи GNOME +author: Ezequiel Bruni +contributors: Steven Spencer +--- + +## Вступ + +На перший погляд функція онлайн-облікових записів GNOME здається скромною, але вона досить потужна. Функція онлайн-облікових записів дає вам доступ до своєї електронної пошти, завдань, файлів у хмарному сховищі, онлайн-календарів тощо з настільних програм за лічені хвилини. + +У цьому короткому посібнику ви побачите, як почати. + +## Припущення + +У цьому посібнику передбачається, що ви маєте наступне: + +- Rocky Linux із встановленим робочим середовищем GNOME. + +Це все, що вам потрібно. + +## Як додати облікові записи онлайн + +Відкрийте огляд дій GNOME у верхньому лівому куті (або за допомогою клавіші ++meta++ чи ++win++) і знайдіть Облікові записи в мережі. Крім того, ви можете відкрити панель налаштувань і знайти онлайн-облікові записи зліва. + +У будь-якому випадку ви опинитеся тут: + +![a screenshot of the GNOME Online Accounts settings panel](images/onlineaccounts-01.png) + +!!! Note "Примітка" + +``` +Можливо, вам доведеться натиснути піктограму з трьома вертикальними крапками, щоб отримати доступ до всіх наведених тут параметрів: + +![a screenthot of the Online Accounts panel featuring the three-vertical-dots icon at the bottom](images/onlineaccounts-02.png) +``` + +Щоб додати обліковий запис, натисніть один із варіантів. Для вашого облікового запису Google ви отримаєте підказку ввійти в Google за допомогою свого браузера та дозволити GNOME доступ до всіх ваших даних. Для таких служб, як Nextcloud, ви побачите форму входу, подібну до наведеної нижче: + +![a screenshot showing the login form for Nextcloud](images/onlineaccounts-03.png) + +Заповніть відповідну інформацію, а GNOME подбає про решту. + +## Типи облікових записів, які підтримуються GNOME + +Як ви можете бачити на знімках екрана, Google, Nextcloud, Microsoft, Microsoft Exchange, Fedora, IMAP/SMTP і Kerberos певною мірою підтримуються. Однак ці інтеграції не є рівноправними. + +Облікові записи Google отримують найбільшу функціональність, хоча Microsoft Exchange і Nextcloud не надто відстають. + +Щоб було легше точно знати, що підтримується, а що ні, ось таблиця, яку автор безсоромно вкрав з офіційної документації GNOME: + +| **Постачальник** | **Пошта** | **Календар** | **Контакти** | **Карти** | **Фотографії** | **Файли** | **Квитки** | +| ------------------ | --------- | ------------ | ------------ | --------- | -------------- | --------- | ---------- | +| Google | √ | √ | √ | | √ | √ | | +| Microsoft | √ | | | | | | | +| Microsoft Exchange | √ | √ | √ | | | | | +| Nextcloud | | √ | √ | | | √ | | +| IMAP та SMTP | √ | | | | | | | +| Kerberos | | | | | | | √ | + +!!! Note "Примітка" + +``` +Хоча «завдання» не перераховані в таблиці вище, вони *здається* підтримуються, принаймні для Google. Тестування цього посібника показало, що якщо ви інсталюєте менеджер справ Endeavour (доступний через Flathub) на Rocky Linux і вже маєте обліковий запис Google, підключений до GNOME, ваші завдання буде імпортовано автоматично. +``` + +## Висновок + +Хоча ви, звичайно, можете використовувати версії веб-додатків деяких із цих служб або використовувати сторонні клієнти в деяких випадках, GNOME дозволяє легко просто інтегрувати багато найважливіших функцій прямо на робочий стіл. Просто зареєструйтесь і йдіть. + +Якщо якась служба відсутня, перегляньте [форуми спільноти GNOME](https://discourse.gnome.org) і повідомте їм. diff --git a/docs/desktop/printing/brother-all-in-one.uk.md b/docs/desktop/printing/brother-all-in-one.uk.md index 44c393dbf6..b758da4c58 100644 --- a/docs/desktop/printing/brother-all-in-one.uk.md +++ b/docs/desktop/printing/brother-all-in-one.uk.md @@ -45,23 +45,24 @@ tags: 1. [Завантажте сценарій bash для драйвера принтера Brother MFC-J480DW](https://support.brother.com/g/b/downloadtop.aspx?c=us\&lang=en\&prod=mfcj480dw_us_eu_as){target="_blank"} 2. Відкрийте вікно терміналу. - 3. Перейдіть до каталогу, куди ви завантажили файл на останньому кроці. наприклад, `cd Downloads` -3. Введіть цю команду, щоб розпакувати завантажений файл: +3. Перейдіть до каталогу, куди ви завантажили файл на останньому кроці. наприклад, `cd Downloads` + +4. Введіть цю команду, щоб розпакувати завантажений файл: ```bash gunzip linux-brprinter-installer-*.*.*-*.gz ``` -4. Отримайте авторизацію суперкористувача за допомогою команди `su` або `sudo su`. +5. Отримайте авторизацію суперкористувача за допомогою команди `su` або `sudo su`. -5. Запустіть інструмент: +6. Запустіть інструмент: ```bash bash linux-brprinter-installer-*.*.*-* Brother machine name ``` -6. Розпочнеться установка драйвера. Дотримуйтеся вказівок на екрані встановлення. +7. Розпочнеться установка драйвера. Дотримуйтеся вказівок на екрані встановлення. Процес встановлення може зайняти деякий час. Зачекайте, доки він завершиться. Після завершення ви можете надіслати тестовий друк. diff --git a/docs/desktop/tools/businessapps.uk.md b/docs/desktop/tools/businessapps.uk.md new file mode 100644 index 0000000000..bf0907a2ec --- /dev/null +++ b/docs/desktop/tools/businessapps.uk.md @@ -0,0 +1,203 @@ +--- +title: Бізнес та офісні програми +author: Ezequiel Bruni +contributors: Steven Spencer +--- + +## Вступ + +Незалежно від того, чи є у вас новий блискучий робочий ноутбук на базі Linux, чи ви намагаєтесь налаштувати домашнє офісне середовище, ви можете бути задані питанням, де знаходяться всі ваші звичайні офісні та бізнес-додатки. + +Багато з них є на Flathub. Цей посібник навчить вас, як установити найпоширеніші з цих програм, і надасть список можливих альтернатив. Читайте далі, якщо ви хочете знати, як інсталювати Office, Zoom тощо. + +## Припущення + +Цей посібник передбачає наступне: + +- Rocky Linux із графічним середовищем робочого столу +- Повноваження на встановлення програмного забезпечення у вашій системі +- Flatpak і Flathub встановлені та працюють + +## Як інсталювати звичайне бізнес-програмне забезпечення на Rocky Linux + +Це досить легко. Для більшості з них ви встановлюєте Flatpak і Flathub, заходите в Центр програмного забезпечення, шукаєте те, що вам потрібно, і встановлюєте це. Це дозволить розглянути кілька найпоширеніших варіантів. Для інших вам потрібно буде використовувати версії додатків у браузері. + +![A screenshot of Zoom in the software center](images/businessapps-01.png) + +Щоб розпочати роботу, ось список найпоширеніших бізнес-програм, які мають настільні клієнти, і найкращі способи їх отримати. + +!!! Note "Примітка" + +``` +Якщо ви хочете дізнатися про стан Microsoft Office у Linux, прокрутіть униз і перейдіть до наступного розділу. + +Крім того, цей список не включатиме такі програми, як Jira, які не мають офіційних настільних програм. +``` + +### Asana Desktop + +Програма для комп’ютера: недоступна в Linux + +Рекомендовано: Використовуйте веб-версію. + +### Discord + +Програма для настільного комп’ютера: офіційні програми та програми сторонніх розробників, доступні у Flathub у Центрі програмного забезпечення + +Рекомендовано: скористайтеся офіційним клієнтом, якщо вам потрібна функція «Натисни і говори». Використовуйте версію браузера або будь-які сторонні клієнти в Центрі програмного забезпечення. + +### Dropbox + +Додаток для комп’ютера: офіційний додаток доступний у Flathub у центрі програмного забезпечення. + +Рекомендовано: використовуйте офіційну програму в GNOME та більшості інших робочих середовищ. Якщо ви використовуєте KDE, використовуйте вбудовану інтеграцію Dropbox. + +### Evernote + +Програма для комп’ютера: більше не доступна для Linux. + +Рекомендовано: Використовуйте веб-версію. + +### Freshbooks + +Програма для комп’ютера: недоступна в Linux. + +Рекомендовано: Використовуйте веб-версію. + +### Google Drive + +Додаток для настільних ПК: сторонні клієнти. + +Рекомендовано: увійдіть у свій обліковий запис Google безпосередньо за допомогою функції онлайн-облікових записів у GNOME Shell або KDE. Це дасть вам інтегрований доступ до ваших файлів, електронної пошти, календаря, списків справ тощо в GNOME. + +У KDE ви можете переглядати файли на Диску та керувати ними за допомогою файлового менеджера. Він не настільки повністю інтегрований, як GNOME, але все одно корисний. + +### Hubspot + +Програма для комп’ютера: недоступна в Linux. + +Рекомендовано: Використовуйте веб-версію. + +### Microsoft Exchange + +Додаток для комп’ютера: лише сторонні клієнти. + +Рекомендовано: у GNOME ви можете використовувати функцію онлайн-облікових записів, щоб інтегрувати свої програми з Exchange, подібно до облікового запису Google. + +У будь-якому іншому робочому середовищі використовуйте Thunderbird з одним із _декількох_ доповнень для Exchange. Thunderbird доступний у стандартному сховищі Rocky Linux, але ви можете отримати новішу версію з Flathub. + +### Notion + +Програма для комп’ютера: недоступна в Linux. + +Рекомендовано: Використовуйте веб-версію. + +### Outlook + +Додаток для комп’ютера: лише програми сторонніх розробників. + +Рекомендовано: використовуйте поштовий клієнт за вашим вибором. Evolution і Thunderbird є хорошими варіантами. Або скористайтеся веб-версією. + +### Quickbooks + +Програма для комп’ютера: недоступна в Linux. + +Рекомендовано: Використовуйте веб-версію. + +### Slack + +Програма для комп’ютера: ця програма доступна з Flathub у центрі програмного забезпечення. + +Рекомендовано: використовуйте додаток або веб-версію на свій смак. + +### Teams + +Програма для комп’ютера: ця програма доступна з Flathub у центрі програмного забезпечення. + +Рекомендовано: використовуйте його на робочому столі або в браузері, як вважаєте за потрібне. Якщо вам потрібно ввімкнути спільний доступ до екрана, увійдіть у сеанс X11 під час завантаження ПК. Спільний доступ до екрана ще не підтримується на Wayland. + +### Zoom + +Програма для комп’ютера: ця програма доступна з Flathub у центрі програмного забезпечення. + +Рекомендовано: якщо ви використовуєте настільну програму на Rocky Linux, увійдіть у свій ПК за допомогою сеансу X11, а не Wayland, якщо вам потрібно надати спільний доступ до екрана. Спільний доступ до екрана зараз працює в Wayland, але лише в новіших версіях програмного забезпечення. + +Будучи стабільною корпоративною операційною системою, Rocky Linux знадобиться деякий час, щоб наздогнати її. + +Однак, залежно від вашого браузера, вам може пощастити більше поділитися екраном на Wayland, якщо взагалі пропустити настільну програму та використовувати лише веб-версію. + +## Альтернативи звичайних бізнес-програм з відкритим кодом + +Якщо ви можете вибрати програмне забезпечення для роботи та продуктивності, ви можете змінити свій розпорядок дня та спробувати альтернативу з відкритим кодом. Більшість програм, перелічених вище, можна замінити екземпляром [Nextcloud](https://nextcloud.com), розміщеним на власному чи хмарному сервері, а деякі програми сторонніх розробників можна встановити на цій платформі. + +Він може обслуговувати синхронізацію файлів, керування проектами, CRM, календар, керування нотатками, базову бухгалтерію, електронну пошту та, з певною роботою та налаштуванням, текстовий та відеочат. Це так багатогранно. + +[Wikisuite](https://wikisuite.org/Software) може зробити все, що перераховано вище, і допомогти вам створити веб-сайт вашої компанії. Це дуже схоже на Odoo. + +Однак зауважте, що ці платформи переважно орієнтовані на Інтернет. Клієнт Nextcloud Desktop призначений лише для синхронізації файлів, а у Wikisuite його немає. + +Ви можете легко замінити Slack на [Mattermost](https://mattermost.com), платформу для чату та керування командою з відкритим кодом. Якщо вам потрібні відео- та аудіофункції Discord, Teams або Zoom, ви можете додати [Jitsi Meet](https://meet.jit.si) до суміші. Це трохи схоже на самостійний Google Meet. + +І Mattermost, і Jitsi також мають настільні клієнти Linux на Flathub. + +Те саме стосується [Joplin](https://joplinapp.org) і [QOwnNotes](https://www.qownnotes.org/) і [Notesnook](https://notesnook.com), які є фантастичними альтернативи Evernote. + +Шукаєте альтернативу Notion у програмному центрі? Можливо, вам знадобиться [AppFlowy](https://appflowy.io) або [SiYuan](https://b3log.org/siyuan/en/). + +!!! Note "Примітка" + +``` +Хоча всі перелічені вище альтернативні програми є відкритими, не всі є «безкоштовними та відкритими програмами (FLOSS)». Це означає, що деякі стягують гроші за додаткові функції або преміум-версії своїх послуг. +``` + +## Microsoft Office на Rocky Linux + +Офіс Microsoft. Новачки у світі Linux можуть запитати, що такого складного в тому, щоб це працювало. Це не складно, якщо ви добре використовуєте веб-версію Office365. Це чудово працює. + +Однак це буде складніше, якщо вам потрібен повний робочий стіл з усіма наворотами, які надають програми Windows. Хоча час від часу хтось пише підручник про те, як змусити останню версію програм Office працювати на Linux з WINE, ці рішення часто виходять з ладу раніше, ніж пізніше. Немає стабільного способу запустити настільні програми в Linux. + +Існують дружні до Linux офісні пакети, сумісні з Microsoft Office, але справжньою проблемою є Excel. + +До цього моменту настільна версія Excel практично не мала собі рівних щодо функцій, способів маніпулювання даними тощо. За загальним визнанням, це чудова програма, яку іншим важко відтворити. + +Робочий процес відрізняється, навіть якщо альтернативи мають усі функції, які можуть знадобитися конкретному користувачеві. Ви не можете кинути свої найскладніші формули та електронні таблиці в одну з альтернатив, навіть у веб-версію Excel, і очікувати, що вона працюватиме. + +Але якщо Excel не є великою частиною вашого робочого процесу, неодмінно перегляньте альтернативи. _Всі_ вони доступні в програмному центрі з Flathub. + +### Альтернативи Microsoft Office для Rocky Linux + +#### LibreOffice + +[LibreOffice](https://www.libreoffice.org) — це фактичний стандарт офісного та продуктивного програмного забезпечення FLOSS. Він покриває більшість ваших офісних потреб: документи, електронні таблиці, презентації, програмне забезпечення для векторного малювання (створене з урахуванням друку) і бази даних. + +Загалом він має пристойну, але не ідеальну сумісність із Microsoft Office, але він _дуже_ добре працює з відкритими форматами. Якщо ви хочете повністю відірватися від екосистеми Microsoft, LibreOffice, мабуть, найкращий варіант. + +Існує також веб-версія під назвою Collabora Office, яка має обмеження, якщо ви не платите за преміум-версії. + +#### OnlyOffice + +[OnlyOffice](https://www.onlyoffice.com) — це дещо менш повний, але все ще фантастичний набір програм для створення документів, презентацій, електронних таблиць і PDF-форм. Примітно, що також є редактор PDF. + +Якщо вам потрібна сумісність з Microsoft Office, особливо для документів і презентацій, тоді OnlyOffice, мабуть, найкращий вибір. OnlyOffice краще обробляє документи Word, ніж онлайн-версія Office365. + +#### WPS Office + +[WPS Office](https://www.wps.com), раніше Kingsoft Office, існує в екосистемі Linux вже досить довго. Він також підтримує документи, електронні таблиці, презентації та редактор PDF. + +WPS Office має трохи кращу сумісність з Microsoft Office, ніж LibreOffice, але він не такий сумісний, як OnlyOffice. Він також має менше функцій і менш настроюваний. Автор це не говорить, це вони. Це уривок з їх блогу: + +![WPS Office має сучасніший і зручніший інтерфейс, ніж Onlyoffice. Його також легше освоїти та використовувати, особливо для новачків. WPS Office також має ширший діапазон шаблонів і тем, що полегшує створення документів професійного вигляду. Onlyoffice є більш потужним і настроюваним, ніж WPS Office. Він має ширший набір функцій, включаючи інструменти управління документами та проектами. Onlyoffice також більш сумісний із форматами Microsoft Office, ніж WPS Office.](images/businessapps-02.png) + +Їхня головна мета — створити більш простий і доступний досвід користувача. Це може бути саме те, що ви хочете. + +#### Calligra + +Офісний пакет [Calligra](https://calligra.org) — це проект FLOSS розробників KDE для створення зручного набору базових офісних програм, які охоплюють створення документів, електронних таблиць, презентацій, баз даних, блок-схем, векторні малюнки, електронні книги тощо. + +Однак програми Calligra непросто встановити на Rocky Linux. Якщо у вас є інша машина з Fedora, автор заохочує вас спробувати її. + +## Висновок + +За деякими помітними винятками, використання всього вашого офісного програмного забезпечення на Rocky Linux означає пошук програм на Flathub або просто використання веб-версії. У будь-якому випадку Rocky Linux, швидше за все, буде стабільною та зручною платформою для більшості типових офісних завдань. + +Якщо відсутність підтримки Excel для робочого столу є перешкодою, автор рекомендує використовувати повноцінний сервер бази даних. З серверами баз даних можна робити дивовижні речі. diff --git a/docs/desktop/tools/firewallgui.uk.md b/docs/desktop/tools/firewallgui.uk.md new file mode 100644 index 0000000000..1a8ecd0a1f --- /dev/null +++ b/docs/desktop/tools/firewallgui.uk.md @@ -0,0 +1,113 @@ +--- +title: Графічний інтерфейс брандмауера +author: Ezequiel Bruni +contributors: Steven Spencer +--- + +## Вступ + +Хочете керувати брандмауером без усього цього командного рядка? Ви можете! Існує чудова програма, спеціально створена для `firewalld`, брандмауера, який використовується в Rocky Linux, і вона доступна на Flathub. У цьому посібнику ви дізнаєтеся, як його швидко налаштувати та запустити, а також ознайомтеся з основами інтерфейсу. + +Ми не будемо охоплювати все, що може виконати `firewalld` або графічний інтерфейс користувача, але цього має бути достатньо, щоб почати. + +## Припущення + +Для цього посібника ми припускаємо, що у вас є: + +- Інсталяція Rocky Linux з будь-яким графічним середовищем робочого столу +- `sudo` або доступ адміністратора +- Фундаментальне розуміння того, як працює `firewalld` + +!!! note "Примітка" + +``` +Пам’ятайте, що хоча ця програма полегшує ваше життя, якщо ви віддаєте перевагу використанню графічного інтерфейсу користувача, вам все одно потрібно буде зрозуміти основні поняття, що стоять за `firewalld`. Ви повинні знати про порти, зони, служби, джерела тощо. + +Якщо вам щось із цього не зрозуміло, перегляньте [посібник для початківців із `firewalld`](../../guides/security/firewalld-beginners.md) і прочитайте, зокрема, про зони, щоб зрозуміти за те, що вони роблять. +``` + +## Встановлення програми + +Зайдіть у програму Software Center і знайдіть «Firewall». Це рідний пакет у сховищі Rocky Linux, і він називатиметься «Брандмауер», тому його має бути легко знайти. + +![Firewall in the Software Center](images/firewallgui-01.png) + +Це `firewall-config` у репозиторії, і його можна встановити за допомогою звичайної команди: + +```bash +sudo dnf install firewall-config +``` + +Коли ви відкриєте програму, вона запитає ваш пароль. Він також запитає ще раз перед виконанням конфіденційних операцій. + +## Режими конфігурації + +Перше, про що слід знати, це режим конфігурації, у якому ви перебуваєте, який можна вибрати у спадному меню у верхній частині вікна. Ваш вибір: Runtime та Permanent. + +![the configuration mode dropdown menu is near the top of the window](images/firewallgui-02.png) + +Відкриття портів, додавання дозволених служб і будь-які інші зміни, зроблені в режимі Runtime, є _тимчасовими_ і не дають вам доступу до всіх функцій. Після перезавантаження або перезавантаження брандмауера вручну ці зміни зникнуть. Це чудово, коли вам потрібно лише швидко внести зміни, щоб виконати одне завдання, або якщо ви хочете перевірити свої зміни, перш ніж зробити їх постійними. + +Наприклад, коли ви відкрили порт у публічній зоні, ви можете перейти до `Параметри > Час виконання до постійного`, щоб зберегти зміни. + +Постійний режим більш ризикований, але він відкриває всі функції. Це дозволяє створювати нові зони, індивідуальну конфігурацію служб, керувати мережевими інтерфейсами та додавати набори IPS (іншими словами, набори IP-адрес, яким дозволено або заборонено зв’язуватися з вашим комп’ютером або сервером). + +Після внесення постійних змін перейдіть до `Параметри > Перезавантажити Firewalld`, щоб увімкнути їх належним чином. + +## Керування інтерфейсами/підключеннями + +На крайній лівій панелі з написом «Активні прив’язки» можна знайти свої мережеві підключення та вручну додати мережевий інтерфейс. Якщо ви прокрутите вгору, ви побачите моє Ethernet-підключення (eno1). За замовчуванням «публічна» зона добре захищена та включає ваше мережеве підключення. + +У нижній частині панелі ви знайдете кнопку «Змінити зону», яка дозволяє призначити ваше підключення до іншої зони. У постійному режимі ви також можете створювати власні зони. + +![a screenshot featuring the Active Bindings panel on the left of the window](images/firewallgui-03.png) + +## Управління зонами + +У першій вкладці правої панелі ви знайдете меню «Зона». Тут ви можете відкривати та закривати порти, вмикати та вимикати служби, додавати надійні IP-адреси для вхідного трафіку (наприклад, локальні мережі), увімкнути переадресацію портів, додавати розширені правила тощо. + +Для більшості звичайних користувачів настільного комп’ютера саме тут ви проводите більшу частину свого часу, а найціннішими підвкладками на цій панелі будуть вкладки для налаштування служб і портів. + +!!! Note "Примітка" + +``` +Встановіть програми та служби зі сховища. Деякі з них (зазвичай призначені для використання на робочому столі) автоматично вмикають відповідні служби або відкривають відповідні порти. Однак якщо цього не сталося, ви можете виконати наведені нижче дії, щоб зробити все вручну. +``` + +### Додавання послуги в зону + +Служби – це популярні програми та фонові служби, які `firewalld` підтримує за замовчуванням. Ви можете швидко та легко ввімкнути їх, прокрутивши список і натиснувши відповідний прапорець. + +Тепер, якщо ви встановили KDE Connect\* для синхронізації робочого столу з іншими пристроями, і ви хочете дозволити його через брандмауер, щоб він справді працював, ви: + +1. Спочатку виберіть зону, яку потрібно редагувати. Для цього прикладу просто виберіть загальнодоступну зону за замовчуванням. +2. Прокрутіть список вниз і виберіть «kdeconnect». +3. Якщо ви перебуваєте в режимі налаштування Runtime, не забудьте натиснути «Runtime To Permanent» і «Reload Firewalld» у меню параметрів. + +\* Доступно в репозиторії EPEL. + +![a screenshot featuring the Zones tab in the right panel, and the Services sub-panel](images/firewallgui-04.png) + +Інші популярні служби в списку включають HTTP і HTTPS для розміщення веб-сайтів, SSH для надання доступу через термінал з інших пристроїв, samba для розміщення сумісних з Windows спільних файлів і багато інших. + +Однак не кожна програма є в списку, і вам може знадобитися відкрити порт вручну. + +### Відкриття портів у зоні + +Відкрити порти для певних програм досить просто. Просто прочитайте документацію, щоб дізнатися, які порти вам потрібні. + +1. Знову виберіть зону, яку потрібно редагувати. +2. Перейдіть на вкладку «Порти» на панелі праворуч. +3. Натисніть кнопку Додати. +4. Заповніть текстове поле портами, які потрібно відкрити. Перевірте, який протокол потрібен програмі та мережевий протокол, який вона використовує (іншими словами, TCP/UDP тощо). +5. Натисніть OK і скористайтеся параметрами «Runtime To Permanent» і «Reload Firewalld». + +![a screenshot featuring the Ports subpanel, and the popup window where you can enter the port number as needed](images/firewallgui-05.png) + +## Висновок + +Що ж, я сказав, що цей посібник буде простим. Якщо ви хочете потренувати свій розум, вам варто прочитати більше про основи `firewalld`. Ви також можете скористатися вкладкою «Служби» у верхній частині правої панелі (поруч із «Зонами»), щоб точно налаштувати роботу ваших служб або контролювати доступ інших комп’ютерів, яким дозволено спілкуватися з вашим за допомогою наборів IPS і джерел. + +Або ви можете відкрити порт для свого сервера Jellyfin і продовжувати свій день. Це залежить від вас. `firewalld` — це неймовірно потужний інструмент, і додаток Firewall може допомогти вам відкрити його можливості у зручний для початківців спосіб. + +Отримуйте задоволення та будьте в безпеці! diff --git a/docs/gemstones/index.de.md b/docs/gemstones/index.de.md index 40658f77b0..ed828e24bd 100644 --- a/docs/gemstones/index.de.md +++ b/docs/gemstones/index.de.md @@ -15,6 +15,6 @@ Der Code, das Skript oder das Beispiel für den Befehl sollte kurz sein. Wenn es * Ihre Motivation * Eine kurze Zusammenfassung -## Beitrag +## Mitwirkung Sie können zu Ihrem **Gemstone** auf die gleiche Weise beitragen, wie Sie zu anderen Dokumentationen beitragen (siehe: [Contribution Guide](../guides/contribute/README.md)). Wenn Sie ein Pull-Request auf GitHub senden, fügen Sie „gemstone“ in die Commit-Nachricht ein. Wenn Sie kein GitHub-Konto haben oder möchten, können Sie es einfach an den Kanal [Mattermost Documentation](https://chat.rockylinux.org/rocky-linux/channels/documentation) senden und wir bearbeiten und bauen Ihren **Gemstone** für Sie ein. Einfacher geht das nicht!