نام (NAME)

debootstrap - راه‌اندازی و برپایی یک سیستم پایه دبیان

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

debootstrap [OPTION...] SUITE TARGET [MIRROR [SCRIPT]]

debootstrap [OPTION...] --second-stage

توضیحات (DESCRIPTION)

دستور debootstrap یک سیستم پایه دبیان از SUITE (مجموعه انتشار) را از طریق مخزن آینه‌ای MIRROR و با اجرای SCRIPT، درون مقصد TARGET راه‌اندازی و برپا می‌کند. MIRROR می‌تواند یک نشانی اینترنتی http:// یا https://، یک نشانی file:/// یا یک نشانی ssh:/// باشد.

مقدار SUITE می‌تواند نام رمز انتشار (مانند sid، stretch، jessie) یا یک نام نمادین (مانند unstable، testing، stable، oldstable) باشد.

توجه داشته باشید که نشانی‌های file:/ به file:/// (طرح‌واره صحیح همان‌طور که در RFC1738 برای نام فایل‌های محلی شرح داده شده است) تبدیل می‌شوند و file:// کار نخواهد کرد. نشانی‌های ssh://USER@HOST/PATH با استفاده از scp دریافت می‌شوند؛ استفاده از ssh-agent یا ابزارهای مشابه اکیداً توصیه می‌شود.

از debootstrap می‌توان برای نصب دبیان روی یک سیستم بدون استفاده از دیسک نصب استفاده کرد، اما همچنین می‌توان از آن برای اجرای توزیع متفاوتی از دبیان در یک محیط chroot بهره برد. از این طریق می‌توانید یک نصب کامل (کمینه) از دبیان ایجاد کنید که برای اهداف آزمایشی قابل استفاده است (بخش مثال‌ها (EXAMPLES) را ببینید). اگر به دنبال یک سیستم chroot برای ساخت بسته‌ها هستید، لطفاً نگاهی به pbuilder بیندازید.

گزینه‌ها (OPTIONS)

--arch=ARCH: تنظیم معماری مقصد (در صورتی که dpkg نصب نیست استفاده می‌شود). همچنین گزینه --foreign را ببینید.
--include=alpha,beta: فهرستی از بسته‌ها که با کاما از هم جدا شده‌اند و به فهرست‌های بارگیری و استخراج اضافه خواهند شد.
--exclude=alpha,beta: فهرستی از بسته‌ها که با کاما از هم جدا شده‌اند و از فهرست‌های بارگیری و استخراج حذف خواهند شد. هشدار: شما می‌توانید و احتمالاً خواهید توانست بسته‌های ضروری را حذف کنید، هنگام استفاده از این گزینه محتاط باشید.
--extra-suites=alpha,beta: استفاده همزمان از بسته‌های موجود در مجموعه‌های ذکرشده از آرشیو.
--components=alpha,beta: استفاده از بسته‌های متعلق به بخش‌های (components) فهرست‌شده در آرشیو.
--no-resolve-deps: به‌طور پیش‌فرض، debootstrap تلاش می‌کند تا هرگونه وابستگی ناموجود را به‌طور خودکار برطرف کند و در صورت یافتن، هشدار دهد. توجه داشته باشید که این یک حل وابستگی کامل در مفهوم dpkg یا apt نیست و تعیین کل سیستم پایه بسیار بهتر از تکیه بر این گزینه است. با تنظیم این گزینه، این رفتار غیرفعال می‌شود.
--log-extra-deps: اگر می‌خواهید وابستگی‌های اضافه هنگام حل وابستگی‌های بسته ثبت شوند، این گزینه را برای ردیابی آن‌ها در debootstrap.log تنظیم کنید.
--variant=minbase|buildd|fakechroot: نام نگارش (variant) اسکریپت راه‌اندازی مورد استفاده. در حال حاضر نگارش‌های پشتیبانی‌شده عبارتند از: minbase که تنها شامل بسته‌های required و apt است؛ buildd که بسته‌های build-essential را نصب می‌کند؛ و fakechroot که بسته‌ها را بدون امتیازات ریشه نصب می‌نماید. حالت پیش‌فرض بدون آرگومان --variant=X، ایجاد یک نصب پایه دبیان با تمامی بسته‌های دارای اولویت required و important شامل apt است.
--merged-usr: ایجاد پیوندهای نمادین /{bin,sbin,lib}/ که به همتایان خود در /usr/ اشاره می‌کنند. (حالت پیش‌فرض برای بیشتر نگارش‌ها و مجموعه‌ها.)
--no-merged-usr: پیوندهای نمادین /{bin,sbin,lib}/ به همتایان خود در /usr/ ایجاد نشوند. (پیش‌فرض برای نگارش buildd در دبیان ۱۲ «bookworm» یا قدیمی‌تر، و تمام نگارش‌های دبیان ۹ «stretch» یا قدیمی‌تر.)
--keyring=KEYRING: نادیده گرفتن دسته‌کلید پیش‌فرض توزیعی که در حال راه‌اندازی است، و استفاده از KEYRING برای بررسی امضاهای فایل‌های Release دریافت‌شده.
--no-check-sig: بررسی امضاهای OpenPGP فایل‌های Release دریافت‌شده را غیرفعال می‌کند. از نسخه 1.0.139 پشتیبانی می‌شود.
--no-check-gpg: نام مستعار منسوخ‌شده برای «--no-check-sig».
--force-check-sig: بررسی امضای OpenPGP فایل‌های Release را اجباری می‌کند و بازگشت خودکار به HTTPS را در صورت نبود دسته‌کلید غیرفعال می‌سازد. با گزینه قبلی ناسازگار است. از نسخه 1.0.139 پشتیبانی می‌شود.
--force-check-gpg: نام مستعار منسوخ‌شده برای «--force-check-sig».
--verbose: ارائه اطلاعات بیشتر درباره فرآیند بارگیری.
--print-debs: چاپ بسته‌هایی که باید نصب شوند و خروج. توجه داشته باشید که باید یک دایرکتوری TARGET خالی یا ناموجود مشخص شود تا debootstrap بتواند فایل‌های Packages را برای تعیین بسته‌هایی که باید نصب شوند و حل وابستگی‌ها بارگیری کند. دایرکتوری TARGET حذف خواهد شد مگر اینکه گزینه --keep-debootstrap-dir مشخص شده باشد.
--download-only: بسته‌ها را بارگیری می‌کند اما عملیات نصب را انجام نمی‌دهد.
--foreign: فقط مرحله باز کردن اولیه (unpack) راه‌اندازی را انجام می‌دهد؛ برای مثال اگر معماری مقصد با معماری میزبان سازگار نباشد. نسخه‌ای از debootstrap که برای تکمیل فرآیند راه‌اندازی کافی باشد به عنوان /debootstrap/debootstrap در سیستم‌فایل مقصد نصب خواهد شد. می‌توانید آن را با گزینه --second-stage اجرا کنید تا فرآیند راه‌اندازی کامل شود.
--second-stage: تکمیل فرآیند راه‌اندازی. به‌طور کلی به سایر آرگومان‌ها نیازی نیست.
--second-stage-target=DIR: اجرای مرحله دوم در یک زیردایرکتوری به‌جای ریشه. (می‌توان از آن برای ایجاد یک chroot با معماری بیگانه استفاده کرد) (نیازمند --second-stage است)
--keep-debootstrap-dir: پس از پایان نصب، دایرکتوری /debootstrap را در مقصد پاک نکن.
--cache-dir=DIR: ذخیره موقت فایل‌های ‎.deb در دایرکتوری. این مسیر باید یک مسیر مطلق باشد.
--unpack-tarball=FILE: دریافت فایل‌های ‎.deb از تاربال فشرده شده با gzip به نام FILE (مشخص‌شده با مسیر مطلق) به‌جای بارگیری از طریق HTTP(S).
--make-tarball=FILE: به‌جای راه‌اندازی، یک تاربال فشرده با gzip (نوشته‌شده در FILE) از بسته‌های بارگیری‌شده می‌سازد. تاربال حاصل می‌تواند بعداً به گزینه --unpack-tarball داده شود. توجه داشته باشید که باید یک دایرکتوری TARGET خالی یا ناموجود مشخص شود تا debootstrap بتواند برای آماده‌سازی تاربال، بسته‌ها را بارگیری کند. دایرکتوری TARGET پاک خواهد شد مگر اینکه گزینه --keep-debootstrap-dir مشخص شده باشد.
--debian-installer: برای مقاصد داخلی توسط نصاب دبیان (debian-installer) استفاده می‌شود.
--extractor=TYPE: تغییر انتخاب خودکار استخراج‌کننده ‎.deb به TYPE. استخراج‌کننده‌های پشتیبانی‌شده عبارتند از: dpkg-deb و ar.
--no-check-certificate: عدم اعتبارسنجی گواهی در برابر مرجع‌های صدور گواهی
--ca-certificate: اعتبارسنجی سرور در برابر گواهی ذخیره‌شده در فایل (PEM)
--certificate=FILE: استفاده از گواهی کلاینت ذخیره‌شده در فایل (PEM)
--private-key=FILE: خواندن کلید خصوصی از فایل
--inrelease-path: تعیین مسیر فایل InRelease متعلق به مجموعه انتشار نسبت به مکان عادی یک فایل InRelease

مثال‌ها (EXAMPLES)

برای راه‌اندازی یک سیستم stretch:

debootstrap stretch ./stretch-chroot http://deb.debian.org/debian

debootstrap stretch ./stretch-chroot file:///LOCAL_MIRROR/debian

فرآیند کامل برای ایجاد یک نصب کامل دبیان از sid (توزیع unstable) در یک محیط chroot:

main # debootstrap sid sid-root http://deb.debian.org/debian
[ ... بارگیری کل سیستم را تماشا کنید ]
main # echo "proc sid-root/proc proc defaults 0 0" >> /etc/fstab
main # mount proc sid-root/proc -t proc
main # echo "sysfs sid-root/sys sysfs defaults 0 0" >> /etc/fstab
main # mount sysfs sid-root/sys -t sysfs
main # cp /etc/hosts sid-root/etc/hosts
main # chroot sid-root /bin/bash

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

دستور debootstrap توسط Anthony Towns <ajt@debian.org> نوشته شده است. این صفحه راهنما توسط Matt Kraai <kraai@debian.org> نوشته شده است.