| NETPLAN-GENERATE(8) | System Manager's Manual | NETPLAN-GENERATE(8) |
نام (NAME)
netplan-generate - تولید پیکربندی بک‌اند از فایل‌های YAML نت‌پلن
خلاصه دستور (SYNOPSIS)
netplan [--debug] generate -h|--help
netplan [--debug] generate [--root-dir ROOT_DIR] [--mapping MAPPING]
توضیحات (DESCRIPTION)
دستور netplan generate فایل‌های YAML نت‌پلن را به فایل‌های پیکربندی قابل فهم برای بک‌اندهای شبکه (systemd-networkd(8) یا NetworkManager(8)) تبدیل می‌کند. این دستور پیکربندی تولیدشده را اعمال نمی‌کند.
به طور معمول نیازی به اجرای مستقیم این دستور نخواهید داشت، زیرا توسط netplan apply، netplan try، یا هنگام راه‌اندازی سیستم (بوت) اجرا می‌شود.
تنها در صورتی که در طول فاز initializing سیستم‌دی اجرا شود (یعنی "اوایل بوت، پیش از رسیدن به basic.target")، تلاش خواهد کرد واحدهای سرویس تازه ایجادشده را شروع یا اعمال کند. **نیازمند ویژگی: generate-just-in-time**
هنگامی که به عنوان یک systemd.generator(7) فراخوانی می‌شود، تمام خطاهای تجزیه و اعتبارسنجی به طور پیش‌فرض نادیده گرفته می‌شوند. اگر تعاریف شبکه به دلیل خطاهای تجزیه نادیده گرفته شوند، ممکن است ناقص باشند. این بدان معناست که پیکربندی صادرشده برای بک‌اند ممکن است کاملاً معتبر نباشد.
برای مشاهده جزئیات قالب فایل پیکربندی، netplan(5) را ببینید.
گزینه‌ها (OPTIONS)
- -h, --help
- چاپ راهنمای اولیه.
- --debug
- چاپ خروجی اشکال‌زدایی در طول فرآیند.
- --root-dir ROOT_DIR
- به جای جستجو در /{lib,etc,run}/netplan، در /ROOT_DIR/{lib,etc,run}/netplan جستجو می‌کند.
- --mapping MAPPING
- به جای تولید فایل‌های خروجی، فایل‌های پیکربندی را تجزیه کرده و برخی اطلاعات داخلی درباره دستگاه مشخص‌شده در MAPPING را چاپ می‌کند.
مدیریت چندین فایل (HANDLING MULTIPLE FILES)
دستور netplan generate ۳ مسیر را بررسی می‌کند:
- •
- /lib/netplan/*.yaml
- •
- /etc/netplan/*.yaml
- •
- /run/netplan/*.yaml
اگر چندین فایل با نام دقیقاً یکسان وجود داشته باشند، تنها یک فایل خوانده خواهد شد. یک فایل در /run/netplan روی فایلی با همان نام در /etc/netplan سایه انداخته (کاملاً جایگزین آن می‌شود). یک فایل در /etc/netplan نیز به نوبه خود روی فایلی در /lib/netplan سایه می‌اندازد.
یا به عبارت دیگر، /run/netplan بالاترین اولویت را دارد، سپس /etc/netplan، و /lib/netplan کمترین اولویت را داراست.
اگر فایل‌هایی با نام‌های متفاوت وجود داشته باشند، بدون توجه به دایرکتوری مربوطه به ترتیب الفبایی در نظر گرفته می‌شوند. فایل‌های بعدی تنظیمات فایل‌های قبلی را تکمیل یا بازنویسی می‌کنند. به عنوان مثال، /run/netplan/10-xyz.yaml توسط /lib/netplan/20-abc.yaml به‌روزرسانی خواهد شد.
اگر دو فایل با کلید یا تنظیم یکسان داشته باشید، قوانین زیر اعمال می‌شوند:
- •
- اگر مقادیر بولی یا مقادیر اسکالر YAML (اعداد و رشته‌ها) باشند، مقدار قدیمی توسط مقدار جدید بازنویسی می‌شود.
- •
- اگر مقادیر توالی (آرایه) باشند، توالی‌ها به یکدیگر متصل می‌شوند - مقادیر جدید به انتهای فهرست قدیمی الحاق می‌شوند.
- •
- اگر مقادیر نگاشت (دیکشنری) باشند، Netplan عناصر نگاشت‌ها را با استفاده از این قوانین به نوبت بررسی خواهد کرد.
همچنین ببینید (SEE ALSO)
netplan(5), netplan-apply(8), netplan-try(8), systemd-networkd(8), NetworkManager(8)
نویسندگان (AUTHORS)
Daniel Axtens (daniel.axtens@canonical.com).