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

.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBbuildah copy\fP \fIcontainer\fP \fIsrc\fP [[\fIsrc\fP ...] \fIdest\fP]

.SH "توضیحات (DESCRIPTION)"
.PP
محتویات یک فایل، نشانی اینترنتی یا یک دایرکتوری را در دایرکتوری کاری کانتینر یا یک مکان مشخص در کانتینر کپی می‌کند. اگر یک دایرکتوری محلی به عنوان منبع مشخص شود،
\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،
از گواهی‌های موجود در
\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
مجوزهای دسترسی به محتوای مقصد را تعیین می‌کند. قالب عددی یا نمادین را می‌پذیرد. اگر از
\fB--from\fR
استفاده نشود، مقدار پیش‌فرض
\fB0755\fR\&
است.

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

.PP
مالکیت کاربری و گروهی محتوای مقصد را تعیین می‌کند. اگر از
\fB--from\fR
استفاده نشود، مقدار پیش‌فرض
\fB0:0\fR\&
است.

.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
هنگام ارزیابی مسیرهای مطلق منبع و مسیر دایرکتوری زمینه، از دایرکتوری ریشه کانتینر یا ایمیج کاری مشخص‌شده به عنوان دایرکتوری ریشه استفاده می‌کند. اگر نیاز به واکشی یک ایمیج باشد، می‌توان از گزینه‌های شناخته‌شده توسط
\fBbuildah pull\fR
استفاده کرد. در صورتی که از
\fB--chown\fR
یا
\fB--chmod\fR
استفاده نشود، مجوزها و مالکیت حفظ می‌شوند.

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

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

.PP
\fB--link\fP

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

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

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

.PP
\fB--parents\fP

.PP
دایرکتوری‌های والد را در مسیر آیتم‌های در حال کپی حفظ می‌کند؛ چه نسبت به بالای زمینه ساخت، چه نسبت به «نقطه محوری» (pivot point)، مکانی در مسیر منبع که با مؤلفه مسیری به نام "." مشخص شده است (یعنی جایی که "/./" در مسیر رخ می‌دهد).

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

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

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

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

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

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

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

.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
نیاز به بررسی گواهی‌ها هنگام واکشی ایمیج‌های ارجاع‌شده با فلگ
\fB--from\fP*
را الزامی می‌کند (پیش‌فرض true است). هنگام برقراری ارتباط با یک رجیستری ناامن نمی‌توان از اعتبارسنجی TLS استفاده کرد.

.SH "مثال‌ها (EXAMPLES)"
.PP
buildah copy containerID '/myapp/app.conf' '/myapp/app.conf'

.PP
buildah copy --exclude=*\fI/\fP\&.md docs containerID 'docs' '/docs'

.PP
buildah copy --parents containerID './x/a.txt' './y/a.txt' '/parents'

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

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

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

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

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

.PP
buildah copy containerID 'https://github.com/containers/buildah' '/tmp'

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

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

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

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

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

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

.PP
ابزار Buildah از یک نویسه جانشین ویژه
\fB**\fR
پشتیبانی می‌کند که با هر تعداد دایرکتوری (از جمله صفر) مطابقت دارد. برای مثال،
\fB**/*.go\fR
تمام فایل‌هایی را که به 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./.dockerignore. است که از این سازوکار استفاده می‌کند:

.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)