.nh
.TH podman-image-sign 1
.SH "نام (NAME)"
podman-image-sign \- ایجاد امضا برای یک ایمیج

.SH "خلاصه دستور (SYNOPSIS)"
\fBpodman image sign\fP [\fIگزینه‌ها\fP] \fIایمیج\fP [\fIایمیج\fP ...]

.SH "توضیحات (DESCRIPTION)"
دستور \fBpodman image sign\fP یک امضای محلی برای یک یا چند ایمیج محلی که از یک رجیستری دریافت (pull) شده‌اند ایجاد می‌کند. این امضا در دایرکتوری مشتق‌شده از فایل‌های پیکربندی رجیستری در مسیر \fB$HOME/.config/containers/registries.d\fR (در صورت وجود) یا در غیر این صورت \fB/etc/containers/registries.d\fR نوشته می‌شود (مگر اینکه در زمان کامپایل بازتعریف شده باشد)، برای اطلاعات بیشتر به \fBcontainers-registries.d(5)\fP مراجعه کنید.
به‌طور پیش‌فرض، امضا برای کاربر ریشه (root) در \fB/var/lib/containers/sigstore\fR و برای کاربران غیرریشه در \fB$HOME/.local/share/containers/sigstore\fR نوشته می‌شود.

.SH "گزینه‌ها (OPTIONS)"
.SS \fB--all\fP, \fB-a\fP
امضای تمامی مانیفست‌های یک ایمیج چندمعماری (پیش‌فرض false).

.SS \fB--authfile\fP=\fIpath\fP
مسیر فایل احراز هویت. مقدار پیش‌فرض در لینوکس \fB${XDG_RUNTIME_DIR}/containers/auth.json\fR و در ویندوز/مک \fB$HOME/.config/containers/auth.json\fR است.
این فایل توسط \fBpodman login\fP ایجاد می‌شود. اگر وضعیت احراز هویت در آنجا یافت نشود، مسیر \fB$HOME/.docker/config.json\fR که با \fBdocker login\fP تنظیم می‌شود بررسی خواهد شد.

.PP
نکته: همچنین این امکان وجود دارد که با تنظیم متغیر محیطی \fBREGISTRY_AUTH_FILE\fR، مسیر پیش‌فرض فایل احراز هویت را بازتعریف کنید. این کار با دستور \fBexport REGISTRY_AUTH_FILE=\fIpath\fP\fP انجام‌پذیر است.

.SS \fB--cert-dir\fP=\fIpath\fP
استفاده از گواهی‌های موجود در \fIpath\fP (*\&.crt, *\&.cert, *\&.key) برای اتصال به رجیستری. (پیش‌فرض: /etc/containers/certs.d)
برای جزئیات بیشتر، به \fBcontainers-certs.d(5)\fP مراجعه کنید.
(این گزینه در کلاینت ریموت پادمن، از جمله سیستم‌های مک و ویندوز (به‌جز WSL2) در دسترس نیست).

.SS \fB--directory\fP, \fB-d\fP=\fIdir\fP
ذخیره امضاها در دایرکتوری مشخص‌شده. پیش‌فرض: /var/lib/containers/sigstore

.SS \fB--help\fP, \fB-h\fP
چاپ راهنمای نحوه استفاده.

.SS \fB--sign-by\fP=\fIidentity\fP
بازتعریف هویت پیش‌فرض امضا.

.SH "مثال‌ها (EXAMPLES)"
امضای ایمیج busybox با شناسه هویت foo@bar.com با استفاده از دسته‌کلید (keyring) کاربر و ذخیره امضا در /tmp/signatures/:

.EX
   $ sudo podman image sign --sign-by foo@bar.com --directory /tmp/signatures docker://privateregistry.example.com/foobar

   $ sudo podman image sign --authfile=/tmp/foobar.json --sign-by foo@bar.com --directory /tmp/signatures docker://privateregistry.example.com/foobar
.EE

.SH "پیکربندی مرتبط (RELATED CONFIGURATION)"
مکان نوشتن (و خواندن) امضاها در فایل‌های پیکربندی مبتنی بر YAML در مسیر /etc/containers/registries.d/ برای کاربر ریشه یا $HOME/.config/containers/registries.d برای کاربران غیرریشه تعریف می‌شود. هنگام امضای یک ایمیج، پادمن از این فایل‌های پیکربندی برای تعیین محل نوشتن امضا بر اساس نام رجیستری مبدا یا مقدار پیش‌فرض فضای ذخیره‌سازی استفاده می‌کند، مگر اینکه با گزینه --directory بازتعریف شده باشد. برای مثال، فایل پیکربندی زیر را در نظر بگیرید:

.EX
docker:
  privateregistry.example.com:
    sigstore: file:///var/lib/containers/sigstore
.EE

.PP
هنگام امضای یک ایمیج که نام رجیستری 'privateregistry.example.com' پیشوند آن است، امضا در زیردایرکتوری‌های /var/lib/containers/sigstore/privateregistry.example.com نوشته می‌شود. استفاده از 'sigstore' همچنین بدین معناست که در عملیات‌های مربوط به دریافت (pull)، امضا از همان مکان خوانده می‌شود.

.SH "همچنین ببینید (SEE ALSO)"
\fBcontainers-certs.d(5)\fP, \fBcontainers-registries.d(5)\fP

.SH "تاریخچه (HISTORY)"
نوامبر ۲۰۱۸، در ابتدا توسط Qi Wang تدوین شد (qiwan at redhat dot com)