نام (NAME)

dnf5-automatic - دستور اجرای خودکار به‌روزرسانی‌ها در DNF5

خلاصه دستور (SYNOPSIS)

dnf5 automatic [options]

توضیحات (DESCRIPTION)

رابط خط فرمان جایگزین برای dnf upgrade همراه با امکانات ویژه جهت مناسب‌سازی آن برای اجرای خودکار و منظم از طریق تایمرهای systemd، جاب‌های cron و موارد مشابه.

نحوه عملکرد این ابزار توسط فایل‌های پیکربندی کنترل می‌شود. مقادیر پیش‌فرض از فایل پیکربندی /usr/share/dnf5/dnf5-plugins/automatic.conf تنظیم می‌گردند. سپس بازنویسی‌های مختص هر میزبان از فایل /etc/dnf/automatic.conf اعمال می‌شوند.

این ابزار متاداده بسته‌ها را در صورت نیاز همگام‌سازی کرده و سپس به‌روزرسانی‌های موجود برای سیستم مورد نظر را بررسی می‌کند؛ پس از آن یا خارج می‌شود، یا بسته‌ها را بارگیری می‌کند و یا به‌روزرسانی‌ها را بارگیری کرده و اعمال می‌نماید. در نهایت، نتیجه عملیات توسط سازوکار انتخاب‌شده گزارش داده می‌شود؛ به عنوان مثال از طریق خروجی استاندارد، رایانامه (ایمیل) یا پیام‌های MOTD.

واحد تایمر سیستم‌دی dnf5-automatic.timer مطابق با آنچه در فایل پیکربندی مشخص شده است (در ادامه ببینید)، در رابطه با بارگیری یا اعمال به‌روزرسانی‌ها رفتار خواهد کرد.

گزینه‌ها (OPTIONS)

--timer

اعمال تاخیر تصادفی پیش از اجرا.

گزینه‌های زیر می‌توانند برای بازنویسی مقادیر تعیین‌شده در فایل پیکربندی استفاده شوند.

--downloadupdates

بارگیری خودکار بسته‌های به‌روزرسانی‌شده.

--no-downloadupdates

بسته‌های به‌روزرسانی‌شده را به صورت خودکار بارگیری نکن.

--installupdates

نصب خودکار به‌روزرسانی‌های بارگیری‌شده (گزینه --downloadupdates را نیز در بر دارد).

--no-installupdates

به‌روزرسانی‌های بارگیری‌شده را به صورت خودکار نصب نکن.

اجرای سرویس خودکار DNF5 (RUN DNF5 AUTOMATIC SERVICE)

این سرویس معمولاً با استفاده از تایمر سیستم‌دی dnf5-automatic.timer اجرا می‌شود. برای پیکربندی سرویس، فایل /etc/dnf/automatic.conf را سفارشی‌سازی کنید. می‌توانید فایل پیکربندی توزیع را از /usr/share/dnf5/dnf5-plugins/automatic.conf کپی کرده و به عنوان مبنا استفاده نمایید، یا فایل پیکربندی اختصاصی خود را از ابتدا فقط با بازنویسی‌های لازم ایجاد کنید.

سپس واحد تایمر را فعال کنید:

systemctl enable --now dnf5-automatic.timer

قالب فایل پیکربندی (CONFIGURATION FILE FORMAT)

فایل پیکربندی به بخش‌های موضوعی مختلف تقسیم شده است.

بخش [commands] ([commands] section)

تنظیم حالت عملکرد برنامه.

apply_updates: بولی (boolean)، پیش‌فرض: False
مشخص می‌کند که آیا بسته‌های شامل به‌روزرسانی‌های موجود باید توسط dnf5-automatic.timer اعمال شوند (یعنی از طریق RPM نصب شوند) یا خیر. این گزینه مستلزم download_updates است. توجه داشته باشید که اگر این مقدار روی False تنظیم شود، بسته‌های بارگیری‌شده تا تراکنش موفق بعدی DNF در حافظه موقت (کَش) باقی می‌مانند.
download_updates: بولی (boolean)، پیش‌فرض: True
مشخص می‌کند که آیا بسته‌های شامل به‌روزرسانی‌های موجود باید توسط dnf5-automatic.timer بارگیری شوند یا خیر.
network_online_timeout: زمان به ثانیه، پیش‌فرض: 60
حداکثر زمانی (به ثانیه) که dnf5 automatic منتظر برخط (آنلاین) شدن سیستم می‌ماند. مقدار 0 به این معنی است که تشخیص در دسترس بودن شبکه نادیده گرفته می‌شود.
random_sleep: زمان به ثانیه، پیش‌فرض: 0
حداکثر تاخیر تصادفی پیش از بارگیری (تنها در صورتی اعمال می‌شود که از گزینه --timer استفاده شده باشد). توجه داشته باشید که به طور پیش‌فرض، تایمرهای systemd نیز یک تاخیر تصادفی تا سقف ۱ ساعت اعمال می‌کنند.

upgrade_type: یکی از مقادیر default، security، distro-sync، پیش‌فرض: default
نوع ارتقاهایی که باید بررسی شوند. مقدار default به معنای جستجو برای تمام به‌روزرسانی‌های موجود است، security فقط مواردی را که دارای هشدار امنیتی صادرشده هستند بررسی می‌کند، و distro-sync بسته‌ها را با آخرین نسخه‌های موجود در مخازن فعال همگام‌سازی می‌نماید (مشابه دستور dnf5 distro-sync).
reboot: یکی از مقادیر never، when-changed، when-needed، پیش‌فرض: never
زمان راه‌اندازی مجدد (ریبوت) سیستم پس از ارتقاها را تعیین می‌کند. مقدار never سیستم را ریبوت نمی‌کند. مقدار when-changed پس از هرگونه ارتقا راه‌اندازی مجدد را آغاز می‌کند. مقدار when-needed تنها در صورتی سیستم را ریبوت می‌کند که برای اعمال تغییرات ضروری باشد، مانند زمانی که systemd یا کرنل (هسته سیستم‌عامل) ارتقا یافته باشند.
reboot_command: رشته، پیش‌فرض: shutdown -r +5 'Rebooting after applying package updates'
دستوری را که باید برای راه‌اندازی مجدد سیستم اجرا شود مشخص می‌کند. برای مثال، برای نادیده گرفتن تاخیر ۵ دقیقه‌ای و پیام همگانی (wall)، از shutdown -r استفاده کنید.

بخش [emitters] ([emitters] section)

انتخاب نحوه گزارش نتایج.

emit_via: فهرست، پیش‌فرض: stdio
فهرست منتشرکننده‌ها (emitters) برای گزارش نتایج از طریق آن‌ها. منتشرکننده‌های موجود عبارتند از: stdio برای چاپ نتیجه در خروجی استاندارد، command برای ارسال نتیجه به یک دستور سفارشی، command_email برای ارسال ایمیل با استفاده از یک دستور، email برای ارسال گزارش از طریق ایمیل با استفاده از سرور SMTP (نیازمندی‌ها را در بخش [email] ببینید)، و motd که نتیجه را به فایل /etc/motd.d/dnf5-automatic ارسال می‌کند.
system_name: رشته، پیش‌فرض: نام میزبان (hostname) سیستم داده‌شده
نامی که سیستم در گزارش‌ها با آن خوانده می‌شود.
emit_no_updates: بولی (boolean)، پیش‌فرض: False
مشخص می‌کند که آیا در صورت عدم رخ دادن رویدادی خاص - یعنی عملیات موفق بوده و هیچ بسته‌ای برای نصب در دسترس نبوده یا نصب نشده است - پیامی ارسال شود یا خیر.

بخش [command] ([command] section)

پیکربندی منتشرکننده دستوری. متغیرهای قابل استفاده در آرگومان‌های رشته قالب‌بندی شامل body با بدنه پیام است.

command_format: رشته قالب‌بندی، پیش‌فرض: cat
دستور شل برای اجرا.
stdin_format: رشته قالب‌بندی، پیش‌فرض: {body}
داده‌هایی که باید از طریق ورودی استاندارد (stdin) به دستور ارسال شوند.

بخش [command_email] ([command_email] section)

پیکربندی منتشرکننده ایمیل دستوری. متغیرهای قابل استفاده در آرگومان‌های رشته قالب‌بندی عبارتند از: body با بدنه پیام، subject با موضوع ایمیل، email_from با نشانی "From:" و email_to با فهرستی از گیرندگان که با فاصله از هم جدا شده‌اند.

command_format: رشته قالب‌بندی، پیش‌فرض: mail -Ssendwait -s {subject} -r {email_from} {email_to}
دستور شل برای اجرا.
email_from: رشته، پیش‌فرض: root
نشانی فرستنده پیام ("From:").
email_to: فهرست، پیش‌فرض: root
فهرست گیرندگان پیام.
stdin_format: رشته قالب‌بندی، پیش‌فرض: {body}
داده‌هایی که باید از طریق ورودی استاندارد (stdin) به دستور ارسال شوند.

بخش [email] ([email] section)

پیکربندی منتشرکننده ایمیل. این منتشرکننده پیام‌ها را مستقیماً از طریق یک سرور SMTP با استفاده از libcurl ارسال می‌کند و به libcurl همراه با پشتیبانی از پروتکل SMTP نیاز دارد. برخی توزیع‌ها نسخه‌ای کمینه از libcurl را بدون پشتیبانی از SMTP ارائه می‌دهند. در فدورا، این مشکل با اجرای دستور dnf5 swap libcurl-minimal libcurl برطرف می‌شود. به عنوان راهکار جایگزین، می‌توانید از منتشرکننده command_email استفاده کنید که نیازی به پشتیبانی SMTP در libcurl ندارد. اطلاعات احراز هویت برای سرور SMTP از فایل ~/.netrc خوانده می‌شود.

email_from: رشته، پیش‌فرض: root
نشانی فرستنده پیام ("From:").
email_to: فهرست، پیش‌فرض: root
فهرست گیرندگان پیام.
email_host: رشته، پیش‌فرض: localhost
نام میزبان سرور SMTP که برای ارسال پیام استفاده می‌شود.
email_port: عدد صحیح، پیش‌فرض: 25
شماره درگاهی (پورت) که باید در سرور SMTP به آن متصل شد.
email_tls: یکی از مقادیر no، yes، starttls، پیش‌فرض: no
مشخص می‌کند که برای اتصال به سرور SMTP از TLS، STARTTLS یا بدون رمزنگاری استفاده شود.

بخش [base] ([base] section)

می‌تواند برای بازنویسی تنظیمات موجود در فایل پیکربندی اصلی DNF استفاده شود. dnf5.conf(5) را ببینید.

نویسندگان (AUTHORS)

فایل AUTHORS.md را در توزیع منبع dnf5 ببینید.

حق نشر (COPYRIGHT)

مشارکت‌کنندگان در پروژه dnf5.