From 301fccfaee8a99b8be22db4d043a89430fa8e5db Mon Sep 17 00:00:00 2001 From: Rocky Linux Automation <75949597+rockylinux-auto@users.noreply.github.com> Date: Wed, 28 Aug 2024 11:03:33 -0400 Subject: [PATCH 1/9] New translations x11vnc_plus_ssh_lan.md (Ukrainian) --- docs/desktop/gnome/x11vnc_plus_ssh_lan.uk.md | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/docs/desktop/gnome/x11vnc_plus_ssh_lan.uk.md b/docs/desktop/gnome/x11vnc_plus_ssh_lan.uk.md index e323dcadbc..a522629721 100644 --- a/docs/desktop/gnome/x11vnc_plus_ssh_lan.uk.md +++ b/docs/desktop/gnome/x11vnc_plus_ssh_lan.uk.md @@ -153,8 +153,17 @@ vncviewer Введіть пароль x11vnc, який ви створили раніше. -## Висновок - ![TigerVNC viewer connected to an X session](images/x11vnc_plus_ssh_lan_images/x11vnc_over_ssh_lan_conclusion.webp) +Вітаємо! Тепер ви можете віддалено керувати робочим столом! + +## Підключення до машини через Інтернет + +Поки що ця стаття показала вам, як налаштувати сервер x11vnc і підключитися до нього за допомогою VNC, що пересилається через тунель SSH. Здавалося б, очевидна, але все ж важлива деталь, про яку слід знати, полягає в тому, що цей метод працюватиме лише для комп’ютерів, підключених до мережі. Оскільки основним варіантом використання, представленим у цьому посібнику, є віддалена підтримка, розумно припустити, що ви хочете підключитися до комп’ютера, який знаходиться в іншій локальній мережі (LAN), ніж ваша власна. Спосіб досягти цього — налаштувати VPN. Обидва перелічені нижче посібники нададуть відповідний приватний тунель для підключення до вашого сервера x11vnc через Інтернет. + +-[OpenVPN](https://docs.rockylinux.org/guides/security/openvpn/) +-[Wireguard VPN](https://docs.rockylinux.org/guides/security/wireguard_vpn/) + +## Висновок + Ви успішно налаштували сервер x11vnc і підключилися до нього за допомогою клієнта TigerVNC. Це рішення ідеально підходить для віддаленої підтримки, оскільки воно використовує той самий сеанс X, що й користувач, що забезпечує безперебійну підтримку. From a334dcdfeb666bf493978e5e3ab1f95641a9e295 Mon Sep 17 00:00:00 2001 From: Rocky Linux Automation <75949597+rockylinux-auto@users.noreply.github.com> Date: Wed, 28 Aug 2024 11:03:58 -0400 Subject: [PATCH 2/9] New translations wireguard_vpn.md (Ukrainian) --- docs/guides/security/wireguard_vpn.uk.md | 21 +++++---------------- 1 file changed, 5 insertions(+), 16 deletions(-) diff --git a/docs/guides/security/wireguard_vpn.uk.md b/docs/guides/security/wireguard_vpn.uk.md index 9b23447080..2c96ae9de1 100644 --- a/docs/guides/security/wireguard_vpn.uk.md +++ b/docs/guides/security/wireguard_vpn.uk.md @@ -1,7 +1,7 @@ --- title: WireGuard VPN author: Joseph Brinkman -contributors: Steven Spencer +contributors: Steven Spencer, Ganna Zhyrnova tested_with: 9.4 tags: - безпека @@ -92,23 +92,12 @@ sudo cat /etc/wireguard/privatekey ## Увімкнути IP-переадресацію -IP-переадресація дозволяє маршрутизувати пакети між мережами. Щоб увімкнути IP-переадресацію на вашому сервері WireGuard, скористайтеся командою нижче, щоб відкрити файл конфігурації: +IP-переадресація дозволяє маршрутизувати пакети між мережами. Це дозволяє внутрішнім пристроям спілкуватися один з одним через тунель WireGuard: -```bash -sudo vim /etc/sysctl.d/99-sysctl.conf -``` - -Додайте правило для IP-переадресації. Увімкніть IP-переадресацію для IPv4 і IPv6. Це дозволяє внутрішнім пристроям спілкуватися один з одним через тунель WireGuard: - -```bash -net.ipv4.ip_forward = 1 -net.ipv6.conf.all.forwarding = 1 -``` - -Застосуйте ці зміни конфігурації за допомогою: +Увімкніть IP-переадресацію для IPv4: ```bash -sudo sysctl -p +sudo sysctl -w net.ipv4.ip_forward=1 && sudo sysctl -w net.ipv6.conf.all.forwarding=1 ``` ## Налаштуйте `firewalld` @@ -209,7 +198,7 @@ sudo cat /etc/wireguard/publickey ip a | grep inet ``` -Файл конфігурації вузла тепер містить правило `PersistentKeepalive = 25`. Це правило вказує одноранговому вузлу перевіряти сервер WireGuard кожні 25 секунд, щоб підтримувати з’єднання VPN-тунелю. Це правило передбачає однорангову перевірку сервера WireGuard кожні 25 секунд, щоб підтримувати з’єднання з VPN-тунелем. +Файл конфігурації вузла тепер містить правило `PersistentKeepalive = 25`. Це правило вказує одноранговому вузлу перевіряти сервер WireGuard кожні 25 секунд, щоб підтримувати з’єднання VPN-тунелю. Без цього параметра тунель VPN закінчуватиметься після бездіяльності. ## Додайте ключ клієнта до конфігурації сервера WireGuard From 0289c865b3bf3d75f7bbbff3a9257a2e5c065f98 Mon Sep 17 00:00:00 2001 From: Rocky Linux Automation <75949597+rockylinux-auto@users.noreply.github.com> Date: Wed, 28 Aug 2024 11:04:00 -0400 Subject: [PATCH 3/9] New translations install_software_with_appimage.md (Ukrainian) --- docs/desktop/appimage/install_software_with_appimage.uk.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/desktop/appimage/install_software_with_appimage.uk.md b/docs/desktop/appimage/install_software_with_appimage.uk.md index 8b99e23691..6508c3bd78 100644 --- a/docs/desktop/appimage/install_software_with_appimage.uk.md +++ b/docs/desktop/appimage/install_software_with_appimage.uk.md @@ -1,7 +1,7 @@ --- title: Встановлення програмного забезпечення за допомогою AppImage author: Joseph Brinkman -contributors: Steven Spencer +contributors: Steven Spencer, Ganna Zhyrnova --- ## Вступ @@ -39,7 +39,7 @@ AppImages — це зручний спосіб інсталювати прогр Після запуску панелі дій введіть 'files' в поле пошуку. Натисніть програму Files: -![Activites pane on a Rocky linux system. 'Files' is typed into the search field. The Files app is hovered over.](images/searchbar_files_appimage.webp) +![Activites pane on a Rocky Linux system. 'Files' is typed into the search field. The Files app is hovered over.](images/searchbar_files_appimage.webp) Файли будуть запущені в домашньому каталозі. Натисніть папку Downloads: From 25a9f909a84fde8fce25feac32a35a065eb07d1b Mon Sep 17 00:00:00 2001 From: Rocky Linux Automation <75949597+rockylinux-auto@users.noreply.github.com> Date: Wed, 28 Aug 2024 11:04:01 -0400 Subject: [PATCH 4/9] New translations installing_nvidia_gpu_drivers.md (Ukrainian) --- .../installing_nvidia_gpu_drivers.uk.md | 118 ++++++++++++++++++ 1 file changed, 118 insertions(+) create mode 100644 docs/desktop/display/installing_nvidia_gpu_drivers.uk.md diff --git a/docs/desktop/display/installing_nvidia_gpu_drivers.uk.md b/docs/desktop/display/installing_nvidia_gpu_drivers.uk.md new file mode 100644 index 0000000000..ed26a9dc5c --- /dev/null +++ b/docs/desktop/display/installing_nvidia_gpu_drivers.uk.md @@ -0,0 +1,118 @@ +--- +title: Встановлення драйверів NVIDIA GPU +author: Joseph Brinkman +contributors: Steven Spencer, Ganna Zhyrnova +--- + +## Вступ + +Nvidia є одним з найпопулярніших виробників GPU. Ви можете встановити драйвери Nvidia GPU кількома способами. Цей посібник використовує офіційне сховище Nvidia для встановлення їх драйверів. Тому [посібник із встановлення Nvidia](https://docs.nvidia.com/cuda/pdf/CUDA_Installation_Guide_Linux.pdf) тут багато посилається. + +!!! Note "Примітка" + +``` +Посилання на дії перед установкою в офіційному посібнику Nvidia не працює. Щоб установити драйвер Nvidia з офіційного репозиторію, вам потрібно буде встановити необхідні утиліти та залежності. +``` + +Деякі інші альтернативні способи встановлення драйверів Nvidia включають: + +- Nvidia's `.run` installer +- Сторонній репозиторій RPMFusion +- Сторонній драйвер ELRepo + +У більшості випадків найкраще встановити драйвери Nvidia з офіційного джерела. RPMFusion і ELRepo доступні для тих, хто віддає перевагу репозиторію на основі спільноти. Для старішого обладнання найкраще працює RPMFusion. Бажано уникати використання інсталятора `.run`. Хоча це зручно, використання інсталятора `.run` відоме тим, що він перезаписує системні файли та має проблеми з несумісністю. + +## Припущення + +Для цього посібника вам потрібно: + +- Робоча станція Rocky Linux +- привілеї `sudo` + +## Встановіть необхідні утиліти та залежності + +Увімкніть репозиторій Extra Packages for Enterprise Linux (EPEL): + +```bash +sudo dnf install epel-release -y +``` + +Встановлення засобів розробки забезпечує необхідні залежності збірки: + +```bash +sudo dnf groupinstall "Development Tools" -y +``` + +Пакет `kernel-devel` надає необхідні заголовки та інструменти для створення модулів ядра: + +```bash +sudo dnf install kernel-devel -y +``` + +Dynamic Kernel Module Support (DKMS) — це програма, яка використовується для автоматичного відновлення модулів ядра: + +```bash +sudo dnf install dkms -y +``` + +## Встановлення драйверів NVIDIA + +Після встановлення необхідних передумов настав час встановити драйвери Nvidia. + +Додайте офіційний репозиторій Nvidia за допомогою такої команди: + +!!! Note "Примітка" + +``` +Якщо ви використовуєте Rocky 8, замініть `rhel9` у шляху до файлу на `rhel8`. +``` + +```bash +sudo dnf config-manager --add-repo http://developer.download.nvidia/compute/cuda/repos/rhel9/$(uname -i)/cuda-rhel9.repo +``` + +Далі встановіть набір пакетів, необхідних для збирання та встановлення модулів ядра: + +```bash +sudo dnf install kernel-headers-$(uname -r) kernel-devel-$(uname -r) tar bzip2 make automake gcc gcc-c++ pciutils elfutils-libelf-devel libglvnd-opengl libglvnd-glx libglv-devel acpid pkgconfig dkms -y +``` + +Встановіть найновіший модуль драйвера NVIDIA для вашої системи: + +```bash +sudo dnf module install nvidia-driver:latest-dkms -y +``` + +## Вимкнення Nouveau + +Nouveau — це драйвер NVIDIA з відкритим вихідним кодом, який надає обмежену функціональність порівняно з пропрієтарними драйверами NVIDIA. Найкраще відключити його, щоб уникнути конфліктів драйверів: + +Відкрийте файл конфігурації grub за допомогою редактора на ваш вибір: + +```bash +sudo vim /etc/default/grub +``` + +Додайте `nouveau.modeset=0` і `rd.driver.blacklist=nouveau` в кінці `GRUB_CMDLINE_LINUX`. + +Значення `GRUB_CMDLINE_LINUX` має виглядати подібно до наведеного нижче тексту, хоча воно не буде і не повинно бути точним збігом: + +```bash +GRUB_CMDLINE_LINUX="resume=/dev/mapper/rl-swap rd.lvm.lv=rl/root rd.lvm.lv=rl/swap crashkernel=auto rhgb quiet nouveau.modeset=0 rd.driver.blacklist=nouveau" +``` + +Перезавантажте середовище grub: + +```bash +grub2-mkconfig -o /boot/grub2/grubenv +``` + +Перезавантаження: + +```bash +sudo reboot now +``` + +## Висновок + +Ви встановили драйвери NVIDIA GPU у своїй системі за допомогою офіційного репозиторію NVIDIA. Насолоджуйтесь розширеними можливостями графічного процесора NVIDIA, які не можуть надати стандартні драйвери Nouveau. From c6ea32d3f5b43f345443fa249682b713b1edc19e Mon Sep 17 00:00:00 2001 From: Rocky Linux Automation <75949597+rockylinux-auto@users.noreply.github.com> Date: Wed, 28 Aug 2024 11:04:03 -0400 Subject: [PATCH 5/9] New translations openvpn.md (Ukrainian) --- docs/guides/security/openvpn.uk.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/guides/security/openvpn.uk.md b/docs/guides/security/openvpn.uk.md index c7687748f7..a0f4ab8e46 100644 --- a/docs/guides/security/openvpn.uk.md +++ b/docs/guides/security/openvpn.uk.md @@ -1,7 +1,7 @@ --- title: OpenVPN author: Joseph Brinkman -contributors: Steven Spencer +contributors: Steven Spencer, Ganna Zhyrnova tested_with: 9.4 tags: - безпека @@ -207,7 +207,7 @@ sudo sysctl -w net.ipv4.ip_forward=1 sudo openvpn /etc/openvpn/server.conf ``` -Після запуску OpenVPN натисніть `Ctrl + Z` і відправте завдання у фоновий режим: +Після запуску OpenVPN натисніть `Ctrl + Z`, а потім відправте завдання у фоновий режим: ```bash bg @@ -281,7 +281,7 @@ bg jobs ``` -Надішліть тестовий пінг на сервер, за замовчуванням його приватна адреса `10.8.0.1`: +Надішліть тестовий пінг на сервер. За умовчанням його приватна адреса `10.8.0.1`: ```bash ping 10.8.0.1 From d89e09fe64ce86e3b289619e204301f7650e147e Mon Sep 17 00:00:00 2001 From: Rocky Linux Automation <75949597+rockylinux-auto@users.noreply.github.com> Date: Wed, 28 Aug 2024 11:04:05 -0400 Subject: [PATCH 6/9] New translations decibels.md (Ukrainian) --- docs/desktop/gnome/decibels.uk.md | 51 +++++++++++++++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 docs/desktop/gnome/decibels.uk.md diff --git a/docs/desktop/gnome/decibels.uk.md b/docs/desktop/gnome/decibels.uk.md new file mode 100644 index 0000000000..1a43f8fe1c --- /dev/null +++ b/docs/desktop/gnome/decibels.uk.md @@ -0,0 +1,51 @@ +--- +title: Decibels +author: Christine Belzie +contributors: Steven Spencer, Ganna Zhyrnova +--- + +## Вступ + +Decibels — програма, яка відтворює аудіофайли. Його зручний інтерфейс спрощує завантаження та відтворення ваших улюблених пісень, а також записів лекцій, проектних ідей та інших файлів. + +## Припущення + +У цьому посібнику передбачається, що ви маєте наступне: + +- Rocky Linux +- Flatpak +- FlatHub + +## Процес встановлення + +Перейдіть на [Flathub.org](https://flathub.org), введіть «Decibels» в рядку пошуку та натисніть **Install**. + +![Screenshot of the Decibels app page on FlatHub, showing the install button being highlighted by a red rectangle](images/01_decibels.png) + +Потім виконайте таку команду у вашому терміналі: + +`flatpak run.org.gnome.Decibels` + +## Як використовувати + +Щоб скористатися програмою, виконайте такі дії: + +1. Натисніть _Open_ + ![Screenshot of Decibels' landing page with a red rectangle surrounding the blue open button](images/02_decibels.png) +2. Виберіть потрібний файл і натисніть кнопку **Open**, яка з’явиться у верхньому правому куті екрана + ![Screenshot of Decibels file selection interface with numbered arrows indicating audio file and Open button](images/03_decibels.png) + +!!! note "Примітка" + +``` +Втомилися клацати мишею? Ось кілька способів використання клавіатури для відтворення аудіофайлів і взаємодії з ними + +- ++ctrl++ + ++shift++ + ++o++ = Відкрити файл +- ++space++ = Відтворити або призупинити +- ++left++ = Перемістити звук на 10 секунд назад +- ++right++ = Перемістити аудіо на 10 секунд вперед +``` + +## Висновок + +Ви прагнете дізнатися більше про цю програму чи маєте більше ідей для неї? [Надішліть ідею в репозиторій Decibel на GitLab](https://gitlab.gnome.org/GNOME/Incubator/decibels/-/issues). From 887f8bcc2746215a731ce1b4aaf9e7e3948159be Mon Sep 17 00:00:00 2001 From: Rocky Linux Automation <75949597+rockylinux-auto@users.noreply.github.com> Date: Wed, 28 Aug 2024 17:23:03 -0400 Subject: [PATCH 7/9] New translations x11vnc_plus_ssh_lan.md (French) --- docs/desktop/gnome/x11vnc_plus_ssh_lan.fr.md | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/docs/desktop/gnome/x11vnc_plus_ssh_lan.fr.md b/docs/desktop/gnome/x11vnc_plus_ssh_lan.fr.md index f8543726f1..a01c79aedd 100644 --- a/docs/desktop/gnome/x11vnc_plus_ssh_lan.fr.md +++ b/docs/desktop/gnome/x11vnc_plus_ssh_lan.fr.md @@ -1,5 +1,5 @@ --- -title: Partage du Desktop (via `x11vnc`) +title: Partage du Desktop via `x11vnc` et SSH author: Joseph Brinkman contributors: Steven Spencer, Ganna Zhyrnova --- @@ -153,8 +153,17 @@ Connectez-vous au serveur VNC en entrant 127.0.0.1 ou localhost dans TigerVNC et Saisissez le mot de passe x11vnc que vous avez créé précédemment. -## Conclusion - ![TigerVNC viewer connected to an X session](images/x11vnc_plus_ssh_lan_images/x11vnc_over_ssh_lan_conclusion.webp) +Félicitations ! Vous pouvez désormais contrôler votre ordinateur à distance ! + +## Connexion à la machine via Internet + +Jusqu'à présent, cet article vous a montré comment configurer un serveur x11vnc et vous y connecter à l'aide de VNC transféré via un tunnel SSH. Un détail apparemment évident mais important à prendre en compte est que cette méthode ne fonctionnera que pour les ordinateurs connectés à un réseau. Étant donné que le principal cas d'utilisation présenté dans ce guide est l'assistance à distance, il est raisonnable de supposer que vous souhaitez vous connecter à un ordinateur situé sur un réseau local (LAN) différent du vôtre. Le moyen d'y parvenir est de mettre en place un VPN. Les deux guides ci-dessous fourniront un tunnel privé approprié pour vous connecter à votre serveur x11vnc via Internet. + +-[OpenVPN](https://docs.rockylinux.org/guides/security/openvpn/) +-[Wireguard VPN](https://docs.rockylinux.org/guides/security/wireguard_vpn/) + +## Conclusion + Vous avez configuré avec succès un serveur x11vnc et vous y êtes connecté à l'aide d'un client TigerVNC. Cette solution est idéale pour la maintenance à distance, car elle partage la même session X que l’utilisateur, garantissant une expérience d’assistance transparente. From 0cf191a225741b33ee19d7e73b9b4841a72ee4d0 Mon Sep 17 00:00:00 2001 From: Rocky Linux Automation <75949597+rockylinux-auto@users.noreply.github.com> Date: Wed, 28 Aug 2024 22:06:50 -0400 Subject: [PATCH 8/9] New translations cronie.md (Chinese Simplified) --- docs/guides/automation/cronie.zh.md | 118 +++++++++++++++------------- 1 file changed, 63 insertions(+), 55 deletions(-) diff --git a/docs/guides/automation/cronie.zh.md b/docs/guides/automation/cronie.zh.md index 399bb81018..d3a957ca08 100644 --- a/docs/guides/automation/cronie.zh.md +++ b/docs/guides/automation/cronie.zh.md @@ -1,111 +1,119 @@ --- title: cronie - 定时任务 -author: 李天赐 -contributors: 史蒂文 斯本 +author: tianci li +contributors: Steven Spencer, Ganna Zhyrnova update: 2021-10-26 --- # 前提条件 -* 运行Rocky Linux的机器。 +* 一台运行Rocky Linux的计算机 * 知道如何使用您最喜欢的编辑器来修改命令行环境中的配置文件(这篇文章将使用 `vi`)。 * 您已经了解了bash、 python 或其他脚本/编程工具的基础知识，并且想要自动运行脚本。 -* 您已经通过 ssh 连接到您的机器(它可以是 root 用户或普通用户，UID 大于 1000) -* 我们认为你是一个很酷的人。 +* 您已经通过 ssh 连接到您的机器(它可以是 root 用户或 UID 大于 1000 的普通用户)。 -## cron 介绍 +## cron 简介 -GNU/Linux提供 *cron* 系统，这是一个基于时间的 `cron` 自动化流程的作业程序。 它是很简单，但却相当强大。 想要一个脚本或程序每天在 5 pm 运行？ `cron` 可以做到。 `cron`的不同分支(或变量)，具有相同的功能。 在这个文档中，使用 **cronie** ，版本为 1.5.2。 您可以点击 \[here\](https://github .com/cronie-cronie-cronie/cronie) 查找最新版本并更新日志。 +GNU/Linux提供 *cron* 系统，这是一个基于时间的 `cron` 自动化流程的作业程序。 它并不复杂，但却相当强大。 想要一个脚本或程序每天在 5 pm 运行？ `cron` 可以做到。 `cron`的不同分支(或变量)，具有相同的功能。 在这个文档中，使用 **cronie** ，版本为 1.5.2。 你可以单击[这里](https://github.com/cronie-crond/cronie)找到最后更新版本的日志。 ## cronie的描述 -* **cronie** -包名, Rocky Linux 默认包含cronie; -* **crontab** -命令为每个用户保留 `crontab` (任务计划)； -* **crond.service** -cronie 的守护程序，您可以通过 `systemctl 启动来管理守护进程 | 重启 | 停止 | 状态`; -* **/etc/crontab** -将cron 任务分配给不同的用户，通常我们更习惯于使用 `crontab-e`。 例如，如果您目前是以 root 用户身份登录， 输入 `crontab -e` 并在保存后您将在文件 /var/spool/cron/root 中看到特定的 cron 作业。 -* **/var/log/cron \* ** -Cronie 的日志，默认情况下是日志旋转并以日期后缀结尾。 \* 此表示通配符 -* **anacron** -cronie的一部分 关于 `anacron` 的更多信息，见 [anacron - 自动命令](anacron.md)。 关于 `anacron` 的更多信息，见 [anacron - 自动命令](anacron.md)。 +* **cronie** -包名, Rocky Linux 默认包含cronie; +* **crontab** -每个用户维护 `crontab` (任务计划) 的命令； +* **crond.service** -cronie 的守护进程，可以通过 `systemctl start | restart | stop | status` 来管理; +* **/etc/crontab** -将cron 任务分配给不同的用户，通常我们更习惯于使用 `crontab-e`。 例如，如果您目前是以 root 用户身份登录， 输入 `crontab -e` 并在保存后您将在文件 /var/spool/cron/root 中看到特定的 cron 作业。 +* **/var/log/cron*** - Cronie 的日志，默认情况下是日志会滚动更新，并以日期后缀结束。 末尾星号的意思是通配符, 指代的是不同的日期后缀。 +* **anacron** - 是 cronie 的一部分. 关于 `anacron` 的更多信息，见 [anacron - 自动命令](anacron.md)。 -## `ceontab` 命令 +## `crontab` 命令 -`crontab` 是安装cronie 软件包后获得的命令。 与 `anacron`, 它更适合于每天工作7*24小时的服务器。 `crontab` 的常见选项是： +`crontab` 是安装cronie 软件包后获得的命令。 相比于 `anacron`, 它更适合于每天工作7*24小时的服务器。 `crontab` 的常见选项是： ```bash -e # 编辑定时任务 -l # 查看定时任务 --r # 删除所有当前用户的 crontab任务 +-r # 删除当前用户所有 crontab 任务 ``` -## Cronie的使用 +## 使用 cronie 为了允许不同的用户在不同时间执行不同的命令(或脚本)，他们可以写入这个文件。 然而，我们通常更习惯使用 `crontab -e`。 ```bash shell > cat /etc/crontab SHELL=/bin/bash -PATH=/sbin:/usr/bin +PATH=/sbin:/bin:/usr/sbin:/usr/bin MAILTO=root -# 详细信息见man 4 crontab -# 作业定义示例： -# 。 ---------------- 分钟(0-59) -# | .------------ 小时 (0-23) -# | . ------------ 月份(1-31) -# | | .-------- 月 (1-12个月) 或 jan,feb,mar,apr ... -# | | | | . --- 每周一天(0-6) (unday=0 或 7) 或日,蒙,tue,wed,thu,fri,, 在 -# | | | | | | | -# * * * * * 需要执行的用户名称命令 +# 注意: 所有 # 开头的行都是注释说明, 可随意修改添加 +# 默认 * 代表所有, 比如每一分钟/每一小时/每一天均执行命令 +# 更多说明详见 man 4 crontabs +# 任务定义示例: +# .---------------- 指定分钟 (0-59) +# | .-------------- 指定小时 (0-23) +# | | .------------ 每月第几天 (1-31) +# | | | .---------- 指定月份 (1-12) 或月份前三个字母缩写 jan,feb,mar,apr ... +# | | | | . ------- 每周第几天(0-6) (周日=0 或 7) 或者 sun, mon, tue, wed, thu, fri, sat +# | | | | | +# * * * * * 要执行的用户名 要执行的命令 ``` -| 参数 | 含义 | 取值范围 | -| ----------- | -------- | ------------- | -| 1st\* | 一小时的第一分钟 | 0-59 | -| 2nd\* | 一天中的每小时 | 0-23 | -| 3rd\* | 月中的某一天 | 1-31 | -| The 4th\* | 年度月 | 1-12 | -| The 5th\* | 一周中的一天 | 0-7(0和7均表示周日) | +| 参数 | 含义 | 取值范围 | +| ---- | -------------- | ------------- | +| 第一个* | 指定每小时的第几分钟执行命令 | 0-59 | +| 第二个* | 指定每天中的第几小时执行命令 | 0-23 | +| 第三个* | 指定每月中的哪一天执行命令 | 1-31 | +| 第四个* | 指定每年中的哪个月执行命令 | 1-12 | +| 第五个* | 指定每周中的哪一天执行命令 | 0-7(0和7均表示周日) | -在这个示例中，假定您作为根用户执行此操作。 输入以下内容： `crontab -e`, 这将提升根用户的定时任务 如果您使用 `vi` 作为默认系统编辑器， 按 i 键进入插入模式， 输入以下内容，# 表示这是一条注释行。 按 Esc 退出插入模式，请输入：wq (显示在底部) 保存并退出 `vi`这意味着每晚22:00时运行脚本。 显然，这是一个非常简单的例子，当你需要详细阐述时，情况可能变得非常复杂。 +在下面的示例中，假定您作为 root 用户执行此操作，请输入以下内容： + +* `crontab -e` 将显示 root 用户的定时任务。 如果使用 `vi` 作为默认系统编辑器，按 ++i++ 键进入插入模式。 +* "#" 表示这是一行是备注, 任务执行时将跳过当前行。 ```bash -# 晚间10：00 备份系统 -00 * * /usr/local/sbin/备份 +# 晚上 10：00 进行系统备份 +00 22 * * * /usr/local/sbin/backup ``` -!!! !!! tip "注意" +* 一旦输入了上述内容(再次假定 `vi` 是系统编辑器)，按 ++escape++ 退出插入模式。 +* 按下组合键 Shift+:并输入wq!保存并退出您的文件(显示在编辑器底部)。 + +现在脚本将在每天 22:00 运行。 显然，这是一个非常简单的例子。 如果你需要更详细的内容，事情就会变得更加复杂。 + +!!! tip "注意" - 脚本需要先执行权限 (chmod +x`) 才能运行它。 + 对于要按时运行的脚本文件, 需要先执行 (`chmod +x`) 命令添加可执行权限, cronie 才能自动运行它。 -#### 复杂选项 +### 复杂选项 迄今为止，讨论的内容是非常简单的选择，但是如何完成更复杂的定时任务？ ```bash -# 假设你想要运行每10分钟备份脚本(可能不切实际，但它只是一个例子！ ) 整天都是如此。 为此目的， 以下将写入： +# 假设你想要运行每10分钟备份脚本(可能不切实际，但它只是一个例子！) 且执行一整天。 为此目的， 以下将写入： * /10 * * * * /usr/local/sbin/backup -#如果你只想在星期一每10分钟运行一个备份怎么办。 星期三和星期五？ : -* /10 * * 1,3,5 /usr/local/sbin/backup +# 如果你只想在星期一, 星期三和星期五每10分钟运行一个备份怎么办 ？ 为此, 要这么写: +* /10 * * * 1,3,5 /usr/local/sbin/backup # 除了星期六和星期天之外, 每天10分钟一次，如何备份？ * /10 * * * 1-5 /usr/local/sbin/backup ``` -| 特殊符号 | 含义 | -| ---- | ------------------------------------------------------- | -| * | 代表任何时间。 例如，第一个*是指任何分钟，第二个*是指任何一小时 | -| , | 代表连续时间，例如"08,12,16***", 这意味着命令将在每天8:00、12:00和16:00执行一次 | -| - | 代表一个连续的时间范围，例如“05* * 1-6”， 这意味着一个命令将在星期一至星期六每天早上5点被执行 | -| */n | 表示执行间隔的频率，例如"*/10 * * * * *" 表示每隔10分钟执行 | +| 特殊符号 | 含义 | +| ----- | ----------------------------------------------------------------- | +| `*` | 代表任何时间。 例如，第一个 `*` 指任意分钟，第二个 `*` 是指任意小时 | +| `,` | 代表非连续时间，例如 `0 8,12,16 * * *`, 这意味着命令将在每天 8:00、12:00 和 16:00 各执行一次 | +| `-` | 代表一个连续的时间范围，例如 `0 5 * * 1-6`, 这意味着一个命令将在星期一至星期六每天早上 5 点被执行 | +| `*/n` | 表示执行间隔的频率，例如 `*/10 * * * *` 表示每隔10分钟执行 | -!!! !!! tip "注意" +!!! tip "注意" - Cronie能够识别的最小时间单位为1分钟。 使用例如`30 4 1,15 * 5 command` 时， 它将使指挥部每个月第1和第15次运行，每星期五上午4时30分运行； 某些脚本或命令的输出信息将防止执行定时任务。 和输出重定向是必需的，例如`*/10 * * * /usr/local/sbin/backup &> /dev/null` + 当前 cronie 能识别的最小时间单位是1分钟；例如，当使用 `30 4 1,15 * 5 command` 时，它将导致该命令在每月1日和15日且必须是周五的上午4:30运行；某些脚本或命令的输出信息将阻止执行定时任务，并且需要输出重定向，例如`*/10 * * * * /usr/local/sbin/backup &> /dev/null` ## 常见问答 1. /etc/crontab 和 `crontab -e` , 两种方法之间是否有任何差异？ `crontab-e` 不需要指定用户 (默认情况下使用当前登录的用户)， /etc/crontab需要指定用户。 -2. 如果指定的命令或脚本没有正确执行，我应该怎么办？ 检查/var/log/cron* 文件，使用 `journalctl -u crond.service` 来检查有关守护进程的信息，脚本是否有 x 权限等用于排除故障。 -3. 除了croni，还有什么样的cron变体？ [ dcron ](http://www.jimpryor.net/linux/dcron.html), 最新版本是 4.5 (2011-50-01)。 [ fcron ](http://fcron.free.fr/), 最新版本是 3.3.0 (dev, 2016-08-14)。 [ bcron ](http://untroubled.org/bcron/), 最新版本是 0.11 (2015-08-12). [ bcron ](http://untroubled.org/bcron/), 最新版本是 0.11 (2015-08-12). [ cronsun ](https://github.com/shunfei/cronsun), 最新版本 0.3.5 (2018-11-20). +2. 如果指定的命令或脚本没有正确执行，我应该怎么办？ 检查/var/log/cron* 文件，或使用 `journalctl -u crond.service` 来检查有关守护进程的信息，查看脚本是否有 x 可执行权限等排除故障。 +3. 除了 cronie，还有什么样的 cron 变体？ [ fcron ](http://fcron.free.fr/), 最新版本是 3.3.0 (dev, 2016-08-14)。 [cronsun](https://github.com/shunfei/cronsun), 最新版本 0.3.5 (2018-11-20). ## 总结 -对Rocky Linux桌面用户或系统管理员来说，cronie 是一个非常强大的工具。 它可以允许您自动执行任务和脚本，这样您就不必记住手动运行它们了。 虽然基本知识很简单，但实际任务可能很复杂。 关于 `crontab` 的更多信息，直到 [crontab 手册页面](https://man7.org/linux/man-pages/man5/crontab.5.html)。 您也可以简单地在互联网上搜索"crontab"。 这将为您提供大量的搜索结果，并帮助您提高`crontab` 表达式。 +对Rocky Linux桌面用户或系统管理员来说，cronie 是一个非常强大的工具。 它可以允许您自动执行任务和脚本，这样您就不必记住手动运行它们了。 虽然基本知识很简单，但实际任务可能很复杂。 关于 `crontab` 的更多信息，查看 [crontab man 页面](https://man7.org/linux/man-pages/man5/crontab.5.html)。 您也可以简单地在互联网上搜索"crontab"。 这将为您提供大量的搜索结果，并帮助您提高`crontab` 表达式的优化能力。 From e80f38a102fefe3435c64e911aa226341711b73c Mon Sep 17 00:00:00 2001 From: Rocky Linux Automation <75949597+rockylinux-auto@users.noreply.github.com> Date: Wed, 28 Aug 2024 23:30:07 -0400 Subject: [PATCH 9/9] New translations olivetin.md (Chinese Simplified) --- docs/guides/automation/olivetin.zh.md | 150 ++++++++++++++++++++++++++ 1 file changed, 150 insertions(+) create mode 100644 docs/guides/automation/olivetin.zh.md diff --git a/docs/guides/automation/olivetin.zh.md b/docs/guides/automation/olivetin.zh.md new file mode 100644 index 0000000000..6e00fddbc7 --- /dev/null +++ b/docs/guides/automation/olivetin.zh.md @@ -0,0 +1,150 @@ +--- +title: OliveTin +author: Ezequiel Bruni +contributors: Steven Spencer, Ganna Zhyrnova +tested_with: 8.5, 8.6 +tags: + - 自动化 + - 网页 + - bash +--- + +# 如何在 Rocky Linux 上安装 & 使用 OliveTin + +## 介绍 + +您是否已经对在同一个CLI命令中连续和多次输入感到厌倦？ 您是否曾经希望家中的其他人能够在不受您干预的情况下重启Plex服务器？ 您想要在网页面板中输入一个名字，按下按钮，然后观看定制Docker/LXD容器的奇迹般出现吗？ + +如果是这样的话, 可以试试 OliveTin。 OliveTin实际上只是一个让你从配置文件生成网页的应用程序，而且网页有按钮。 点击按钮，OliveTin将运行你之前预设的基础命令。 + +当然, 你也可以手动创建类似的功能, 从头开始的那种, 需要大量编程经验... 但这种 *方式* 更简单罢了. 它在设置时看起来有点像这样( 开源仓库地址 [OliveTin 仓库](https://github.com/OliveTin/OliveTin)): + +![桌面上的 OliveTin 截图；它有一个网格中的几个正方形，每个命令都有可以运行的标签和动作。](olivetin/screenshotDesktop.png) + +!!! 警告“永远不要在公共服务器上运行此应用” + + 根据设计和创建者自己的承认，这款应用程序旨在用于本地网络，*也许* 用于开发设置。 然而，它目前没有用户认证系统，并且(直到开发者修正它) *默认运行为 root* 。 + + 所以，在安全和防火墙的网络上使用你想要的一切。 *不要*将其放在任何供公开使用的地方。 至少现在是这样的。 + +## 先决条件和假设 + +要遵循本指南，您将需要： + +* 一台运行Rocky Linux的计算机 +* 在最舒适的环境给命令行编写代码。 +* Root 访问权限或使用 `sudo` 的能力。 +* 学习YAML的基本知识。 这不是很难，你会在后续的介绍中学会它。 + +## 安装 OliveTin + +OliveTin 包括预构建的 RPM 包。 只需根据你电脑的架构下载最新版并安装即可。 如果您在一个带有图形桌面的工作站查看本指南， 只需下载文件并双击它即可进行安装。 + +如果你期望在服务器上安装此应用程序，那么可以在工作机器上下载并通过SSH/SCP/SFTP上传安装包。 或者根据需要找其他开发者的定制版安装包，然后用 `wget` 下载它。 + +例如: + +```bash +wget https://github.com/OliveTin/OliveTin/releases/download/2022-04-07/OliveTin_2022-04-07_linux_amd64.rpm +``` + +然后通过以下方式安装应用程序 (还是示例): + +```bash +sudo rpm -i OliveTin_2022-04-07_linux_amd64.rpm +``` + +现在，OliveTin 可以正常运行 `systemd` 服务了，但先不要着急启用它。 你需要先配置文件。 + +!!! Note "说明" + + 经过一些测试，我已经确定这些安装指令将在Rocky Linux LXD容器中正常工作。 任何喜欢Docker的人都可以使用预制的镜像。 + +## 配置 OliveTin 动作 + +OliveTin可以做任何 bash 脚本可以做到的事情，甚至更多。 您可以使用 CLI 选项执行应用，运行基本脚本，重启服务等。 若要启动，请使用 root 或 sudo 打开配置文件，并使用你喜欢的文本编辑器： + +```bash +sudo nano /etc/OliveTin/config.yaml +``` + +最基本的动作是一个简单的按钮，你点击它，对应命令就会在主机运行一次。 您可以在 YAML 文件中定义： + +```yaml +actions: + - title: Restart Nginx + shell: systemctl restart nginx +``` + +您也可以添加自定义图标到每个动作，如Unicode emoji： + +```yaml +actions: + - title: Restart Nginx + icon: "F504" + shell: systemctl restart nginx +``` + +这里不会详细介绍自定义选项，仅说一下基础的定义规则, 比如使用文本输入和下拉菜单向要运行的命令添加变量和选项。 这样配置后，OliveTin会在页面提示你输入相关参数, 之后才会执行命令。 + +为此，您可以运行任何程序，通过 SSH 控制远程机器，触发网络钩子等等。 查看 [官方文档](https://docs.olivetin.app/actions.html) 了解更多详情。 + +这里是我自己的例子：我有一个个人脚本，用来生成LXD容器, 容器里面预装了 web 服务。 通过OliveTin，我能够为像这样的脚本快速制作一个GUI： + +```yaml +actions: +- title: 构建容器 + shell: sh /home/ezequiel/server-scripts/rocky-host/buildcontainer -c {{ containerName }} -d {{ domainName }} {{ softwarePackage }} + timeout: 60 + arguments: + - name: containerName + title: 容器名称 + type: ascii_identifier + + - name: domainName + title: 域名 + type: ascii_identifier + + - name: softwarePackage + title: 默认软件 + choices: + - title: None + value: + + - title: Nginx + value: -s nginx + + - title: Nginx & PHP + value: -s nginx-php + + - title: mariadb + value: -s mariadb +``` + +在前端，看起来是这样的(OliveTin有一个黑暗模式，我 *真的* 需要更改那个图标)： + +![一个包含两个文本输入和一个下拉菜单的表单](olivetin/containeraction.png) + +## 启用 OliveTin + +一旦你拥有你想要的配置文件，只需开启并启动 OliveTin ： + +```bash +sudo systemctl enable --now OliveTin +``` + +每次您编辑配置文件时，您都需要以通常方式重新启动服务： + +```bash +sudo systemctl restart OliveTin +``` + +## 总结 + +从简单的基础命令到一些相当复杂的操作脚本, 使用 OliveTin 来运行他们是非常好的方法。 但牢记，默认一切都是 root 账号运行， 除非使用 su/sudo 在 shell 命令中更改该特定命令的用户。 + +因此，你应该谨慎地设置这件事， 特别是如果打算让家人访问(例如控制服务器和设备等)。 + +再说一遍，除非你准备好尝试并保护你自己的页面，否则不要把它放在公共服务器上。 + +通常情况下它很有趣, 这是一个简洁的小工具。