.nh
.TH runc-spec "8"

.SH "نام (NAME)"
\fBrunc-spec\fP \- ایجاد یک فایل مشخصات جدید


.SH "خلاصه دستور (SYNOPSIS)"
\fBrunc spec\fP [\fIگزینه\fP ...]


.SH "توضیحات (DESCRIPTION)"
دستور \fBspec\fP یک فایل مشخصات جدید با نام \fIconfig.json\fP برای بسته (bundle) ایجاد می‌کند\&.

.PP
فایل مشخصات تولیدشده تنها یک فایل اولیه است. برای دستیابی به نتایج دلخواه، ویرایش این فایل مشخصات الزامی است. به عنوان مثال، فایل مشخصات تازه‌تولیدشده شامل پارامتر \fBargs\fP است که در ابتدا برای فراخوانی دستور \fBsh\fP هنگام راه‌اندازی کانتینر تنظیم شده است. فراخوانی \fBsh\fP ممکن است برای یک کانتینر ubuntu یا busybox کار کند، اما برای کانتینرهایی که فاقد باینری \fBsh\fP هستند کار نخواهد کرد\&.


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB--bundle\fP|\fB-b\fP \fIpath\fP
تنظیم \fIpath\fP به عنوان ریشه دایرکتوری بسته (bundle)\&.

.TP
\fB--rootless\fP
تولید پیکربندی برای یک کانتینر بدون ریشه (rootless). توجه داشته باشید که این گزینه کاملاً با گزینه سراسری \fB--rootless\fP متفاوت است\&.


.SH "مثال‌ها (EXAMPLES)"
برای اجرای یک کانتینر ساده "hello-world"، لازم است پارامتر \fBargs\fP در فایل مشخصات برای فراخوانی hello تنظیم شود. این کار را می‌توان با استفاده از \fBsed\fP(1)، \fBjq\fP(1) یا یک ویرایشگر متن انجام داد\&.

.PP
دستورات زیر اقدامات زیر را انجام می‌دهند:
 \- ایجاد یک بسته (bundle) برای hello-world؛
 \- تغییر دستور اجرایی درون کانتینر به \fB/hello\fP با استفاده از \fBjq\fP(1)؛
 \- اجرای دستور \fBhello\fP در یک کانتینر جدید hello-world با نام \fBcontainer1\fP\&.

.EX
mkdir hello
cd hello
docker pull hello-world
docker export $(docker create hello-world) > hello-world.tar
mkdir rootfs
tar -C rootfs -xf hello-world.tar
runc spec
jq '.process.args |= ["/hello"]' < config.json > new.json
mv -f new.json config.json
runc run container1
.EE

.PP
در دستور \fBrun\fP بالا، \fBcontainer1\fP نام نمونه کانتینری است که راه‌اندازی می‌کنید. نامی که برای نمونه کانتینر مشخص می‌کنید باید روی میزبان شما یکتا باشد\&.

.PP
یک راهکار جایگزین برای تولید پیکربندی مشخصات سفارشی، استفاده از \fBoci-runtime-tool\fP است؛ زیردستور \fBoci-runtime-tool generate\fP دارای گزینه‌های متعددی است که می‌توان از آن‌ها برای انجام هرگونه سفارشی‌سازی دلخواه استفاده کرد. برای کسب اطلاعات بیشتر،
runtime-tools
\[la]https://github.com/opencontainers/runtime\-tools\[ra]
را ببینید\&.

.PP
هنگام راه‌اندازی کانتینر از طریق \fBrunc\fP، معمولاً به مجوزهای کاربر ریشه (root) نیاز است. اگر از قبل به عنوان کاربر ریشه اجرا نمی‌کنید، می‌توانید از \fBsudo\fP(8) استفاده کنید، برای مثال:

.EX
sudo runc start container1
.EE

.PP
به عنوان روشی دیگر، می‌توانید یک کانتینر بدون ریشه (rootless) را راه‌اندازی کنید که توانایی اجرا بدون مجوزهای کاربر ریشه را دارد. برای اینکه این مورد کار کند، فایل مشخصات باید بر این اساس تنظیم شود. می‌توانید گزینه \fB--rootless\fP را به این دستور ارسال کنید تا یک فایل مشخصات بدون ریشه مناسب ایجاد گردد\&.


.SH "همچنین ببینید (SEE ALSO)"
\fBrunc-run\fP(8),
\fBrunc\fP(8).