.nh
.TH buildah-add "1" "April 2021" "buildah"
.SH "نام (NAME)"
buildah-add \- افزودن محتوای فایل‌ها، دایرکتوری‌ها یا نشانی‌های وب به کانتینر

.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBbuildah add\fP [\fIگزینه‌ها\fP] \fIcontainer\fP \fIsrc\fP [[\fIsrc\fP ...] \fIdest\fP]

.SH "توضیحات (DESCRIPTION)"
.PP
محتوای یک فایل، نشانی اینترنتی (URL) یا یک دایرکتوری را به دایرکتوری کاری کانتینر یا یک مکان مشخص‌شده در کانتینر اضافه می‌کند. اگر یک فایل منبع محلی یک فایل آرشیو به نظر برسد، محتوای آن استخراج شده و به جای خود فایل آرشیو اضافه می‌شود. اگر یک دایرکتوری محلی به عنوان منبع مشخص شود،
\fIمحتوای\fP
آن به مقصد کپی می‌شود.

.SH "گزینه‌ها (OPTIONS)"
.PP
\fB--add-history\fP

.PP
یک ورودی به تاریخچه اضافه می‌کند که شناسه یکتای (digest) محتوای اضافه‌شده را ثبت می‌نماید. مقدار پیش‌فرض false است.

.PP
نکته: شما همچنین می‌توانید مقدار پیش‌فرض
\fB--add-history\fR
را با تنظیم متغیر محیطی BUILDAH_HISTORY بازنویسی کنید:
\fBexport BUILDAH_HISTORY=true\fR

.PP
\fB--allow-empty-wildcard\fP

.PP
در صورت تنظیم روی true، اگر تطبیق الگو (globbing) با چیزی مطابقت پیدا نکند، خطایی برگردانده نمی‌شود. فقط زمانی معنادار است که
\fB--allow-wildcard\fP
روی true باشد. مقدار پیش‌فرض false است.

.PP
\fB--allow-wildcard\fP

.PP
امکان استفاده از الگوهای عمومی (glob) را در مسیرهای منبع فراهم می‌کند. هنگام تنظیم روی false، مسیرهای منبع حاوی نویسه‌های جانشین (*، ?، [) با خطا رد می‌شوند. مقدار پیش‌فرض true است.

.PP
\fB--cert-dir\fP \fIمسیر\fP

.PP
هنگام اتصال به رجیستری‌ها برای دریافت ایمیج‌های مشخص‌شده با فلگ
\fB--from\fP،
و هنگام اتصال به سرورهای HTTPS برای واکشی منابع از مکان‌های مشخص‌شده با نشانی‌های اینترنتی HTTPS، از گواهی‌های موجود در
\fIمسیر\fP
(*\&.crt، *\&.cert، *\&.key)
استفاده می‌کند. دایرکتوری پیش‌فرض گواهی‌ها
\fI/etc/containers/certs.d\fP\&
است.

.PP
\fB--checksum\fP \fIچک‌سام\fP

.PP
چک‌سام محتوای منبع را بررسی می‌کند. مقدار
\fIچک‌سام\fP
باید یک رشته شناسه استاندارد کانتینر (digest) باشد. فقط برای منابع HTTP پشتیبانی می‌شود.

.PP
\fB--chmod\fP \fIمجوزها\fP

.PP
مجوزهای دسترسی به محتوای مقصد را تعیین می‌کند. قالب عددی یا نمادین را می‌پذیرد.

.PP
\fB--chown\fP \fIمالک\fP:\fIگروه\fP

.PP
مالکیت کاربری و گروهی محتوای مقصد را تعیین می‌کند.

.PP
\fB--contextdir\fP \fIدایرکتوری\fP

.PP
دایرکتوری زمینه ساخت (context). مشخص کردن یک دایرکتوری زمینه باعث می‌شود Buildah به دایرکتوری زمینه chroot کند. این بدان معناست که کپی فایل‌هایی که توسط پیوندهای نمادین به خارج از chroot اشاره می‌کنند با شکست مواجه خواهد شد.

.PP
\fB--exclude\fP \fIالگو\fP

.PP
از کپی کردن فایل‌های منطبق با الگوی مشخص‌شده خودداری می‌کند. این گزینه می‌تواند چندین بار مشخص شود. الگوها با مسیر هر فایل نسبت به دایرکتوری زمینه (یا در صورت استفاده از
\fB--from\fP،
نسبت به ریشه کانتینر یا ایمیج منبع) سنجیده می‌شوند. برای قالب‌های پشتیبانی‌شده به containerignore(5) مراجعه کنید.

.PP
\fB--from\fP \fIکانتینر_یا_ایمیج\fP

.PP
هنگام ارزیابی مسیرهای مطلق منبع و مسیر دایرکتوری زمینه، از دایرکتوری ریشه کانتینر یا ایمیج کاری مشخص‌شده به عنوان دایرکتوری ریشه استفاده می‌کند. اگر نیاز به دریافت (pull) یک ایمیج باشد، می‌توان از گزینه‌های شناخته‌شده توسط
\fBbuildah pull\fR
استفاده کرد.

.PP
\fB--ignorefile\fP \fIفایل\fP

.PP
مسیر یک فایل جایگزین containerignore. (یا dockerignore.). مستلزم این است که
\fB--contextdir\fR
مشخص شده باشد.

.PP
\fB--link\fP

.PP
به‌جای تغییر سیستم‌فایل کانتینر در حال کار، یک لایه ایمیج مستقل برای فایل‌های اضافه‌شده ایجاد می‌کند. اگر
\fBbuildah run\fR
فایلی ایجاد کند و
\fBbuildah add --link\fR
فایلی به همان مسیر اضافه کند، فایل حاصل از
\fBbuildah add --link\fR
در ایمیج نهایی تثبیت‌شده (committed) حضور خواهد داشت. لایه --link در زمان تثبیت و پس از اعمال تمام تغییرات سیستم‌فایل کانتینر اعمال می‌شود.

.PP
\fB--no-follow-symlinks\fP

.PP
هنگامی که یک منبع محلی یک پیوند نمادین است، پیوند را به عنوان یک پیوند نمادین کپی می‌کند، به جای اینکه پیوند را دنبال کرده (dereference) و محتوای هدف را کپی کند.

.PP
\fB--quiet\fP, \fB-q\fP

.PP
از چاپ شناسه (digest) محتوای اضافه‌شده خودداری می‌کند.

.PP
\fB--retry\fP \fIتعداد_تلاش\fP

.PP
تعداد دفعات تلاش مجدد در صورت بروز خطا هنگام واکشی ایمیج‌ها از رجیستری یا دریافت محتوا از نشانی‌های اینترنتی HTTPS.

.PP
پیش‌فرض
\fB3\fR\&
است.

.PP
\fB--retry-delay\fP \fIمدت_زمان\fP

.PP
مدت‌زمان تاخیر میان تلاش‌های مجدد در صورت بروز خطا هنگام واکشی ایمیج‌ها از رجیستری یا دریافت محتوا از نشانی‌های اینترنتی HTTPS.

.PP
پیش‌فرض
\fB2s\fR\&
است.

.PP
\fB--timestamp\fP \fIثانیه‌ها\fP

.PP
برچسب زمانی ("mtime") را برای محتوای اضافه‌شده دقیقاً روی این تعداد ثانیه از مبدأ زمان یونیکس (زمان یونیکس ۰، یعنی 00:00:00 UTC در ۱ ژانویه ۱۹۷۰) تنظیم می‌کند تا به ساخت‌های قطعی و تکرارپذیر (deterministic) کمک کند.

.PP
دایرکتوری مقصدی که محتوا در آن کپی می‌شود، به احتمال زیاد نشان‌دهنده زمانی خواهد بود که محتوا به آن اضافه شده است.

.PP
\fB--tls-verify\fP \fIمقدار_بولی\fP

.PP
نیاز به بررسی و تایید گواهی‌ها هنگام دریافت منابع از مکان‌های HTTPS یا هنگام واکشی ایمیج‌های ارجاع‌شده با فلگ
\fB--from\fP*
را الزامی می‌کند (پیش‌فرض true است). هنگام برقراری ارتباط با یک رجیستری ناامن نمی‌توان از اعتبارسنجی TLS استفاده کرد.

.SH "مثال (EXAMPLE)"
.PP
buildah add containerID '/myapp/app.conf' '/myapp/app.conf'

.PP
buildah add --chown myuser:mygroup containerID '/myapp/app.conf' '/myapp/app.conf'

.PP
buildah add --chmod 660 containerID '/myapp/app.conf' '/myapp/app.conf'

.PP
buildah add containerID '/home/myuser/myproject.go'

.PP
buildah add containerID '/home/myuser/myfiles.tar' '/tmp'

.PP
buildah add containerID '/tmp/workingdir' '/tmp/workingdir'

.PP
buildah add containerID 'https://github.com/containers/buildah/blob/main/README.md' '/tmp'

.PP
buildah add containerID 'passwd' 'certs.d' /etc

.PP
buildah add containerID '/tmp/myfiles-*' '/dest/'

.PP
buildah add --allow-empty-wildcard=true containerID '/tmp/logs-*' '/dest/'

.SH "فایل‌ها (FILES)"
.SS \&.containerignore یا .dockerignore
.PP
اگر فایل containerignore. یا dockerignore. در دایرکتوری زمینه وجود داشته باشد،
\fBbuildah add\fR
محتویات آن را می‌خواند. اگر هر دو وجود داشته باشند، از containerignore. استفاده می‌شود.

.PP
هنگامی که گزینه
\fB--ignorefile\fR
مشخص شده باشد، Buildah آن را خوانده و از آن برای تصمیم‌گیری در مورد اینکه کدام محتوا هنگام کپی در کانتینر کاری مستثنی شود، استفاده می‌کند.

.PP
کاربران می‌توانند مجموعه‌ای از الگوهای عمومی (glob) پوسته یونیکس را در یک فایل نادیده‌گیری مشخص کنند تا فایل‌ها/دایرکتوری‌های مورد نظر برای مستثنی شدن شناسایی شوند.

.PP
ابزار Buildah از یک نویسه جانشین ویژه
\fB**\fR
پشتیبانی می‌کند که با هر تعداد دایرکتوری (از جمله صفر) مطابقت دارد. برای مثال،
*\fI/\fP\&.go
تمام فایل‌هایی را که به go. ختم می‌شوند و در تمامی دایرکتوری‌ها یافت می‌شوند، مستثنی خواهد کرد.

.PP
نمونه فایل containerignore./.dockerignore.:

.EX
# here are files we want to exclude
*/*.c
**/output*
src
.EE

.PP
\fB*/*.c\fR
.PP
فایل‌ها و دایرکتوری‌هایی را که نام آن‌ها به c. ختم می‌شود در هر زیردایرکتوری سطح بالا مستثنی می‌کند؛ برای مثال، فایل منبع include/rootless.c.

.PP
\fB**/output*\fR
.PP
فایل‌ها و دایرکتوری‌هایی را که با
\fBoutput\fR
شروع می‌شوند از هر دایرکتوری مستثنی می‌کند.

.PP
\fBsrc\fR
.PP
فایل‌های با نام src و دایرکتوری src و همچنین هرگونه محتوای درون آن را مستثنی می‌کند.

.PP
خطوطی که با ! (علامت تعجب) شروع می‌شوند می‌توانند برای ایجاد استثنا در موارد مستثنی‌شده استفاده شوند. نمونه زیر یک فایل containerignore. است که از این سازوکار استفاده می‌کند:

.EX
*.doc
!Help.doc
.EE

.PP
هنگام کپی محتوا به درون کانتینر، همه فایل‌های doc. به جز Help.doc مستثنی می‌شوند.

.PP
این قابلیت با نحوه مدیریت فایل‌های containerignore. که در اینجا توضیح داده شده، سازگار است:

.PP
https://github.com/containers/common/blob/main/docs/containerignore.5.md

.SH "همچنین ببینید (SEE ALSO)"
.PP
buildah(1), containerignore(5)