.nh
.TH podman-secret-create 1
.SH "نام (NAME)"
podman-secret-create \- ایجاد یک سکرت جدید

.SH "خلاصه دستور (SYNOPSIS)"
\fBpodman secret create\fP [\fIگزینه‌ها\fP] \fIname\fP \fIfile|-\fP

.SH "توضیحات (DESCRIPTION)"
ایجاد یک سکرت (داده محرمانه) با استفاده از ورودی استاندارد یا از محتوای یک فایل.

.PP
دستور ایجاد، مسیر یک فایل یا نشانه \fB-\fR را می‌پذیرد که به پودمن اعلام می‌کند سکرت را از ورودی استاندارد (stdin) بخواند.

.PP
یک سکرت، قطعه‌ای از داده‌های حساس (blob) است که کانتینر در زمان اجرا به آن نیاز دارد اما در ایمیج یا سیستم کنترل نسخه ذخیره نمی‌شود؛ مانند نام‌های کاربری و گذرواژه‌ها، گواهی‌ها و کلیدهای TLS، کلیدهای SSH یا سایر رشته‌های مهم عمومی یا داده‌های دودویی (تا حجم حداکثر ۵۱۲ کیلوبایت).

.PP
سکرت‌ها با دستور \fBpodman commit\fR درون ایمیج ذخیره نمی‌شوند و در آرشیو ایجادشده توسط دستور \fBpodman export\fR نیز قرار نمی‌گیرند.

.PP
سکرت‌ها همچنین می‌توانند برای ذخیره‌سازی گذرواژه‌ها در \fBpodman login\fR جهت احراز هویت در رجیستری‌های کانتینر مورد استفاده قرار گیرند.

.SH "گزینه‌ها (OPTIONS)"
.SS \fB--driver\fP, \fB-d\fP=\fIdriver\fP
مشخص کردن درایور سکرت (پیش‌فرض \fBfile\fP است).

.SS \fB--driver-opts\fP=\fIkey1=val1,key2=val2\fP
مشخص کردن گزینه‌های اختصاصی درایور.

.SS \fB--env\fP=\fIfalse\fP
خواندن اطلاعات سکرت از متغیر محیطی.

.SS \fB--help\fP
نمایش راهنمای استفاده از دستور.

.SS \fB--ignore\fP=\fIfalse\fP
اگر سکرتی با همین نام از قبل وجود داشته باشد، خطایی بازگردانده نمی‌شود و شناسه سکرت موجود به جای ایجاد یک سکرت جدید بازگردانده می‌شود.
نمی‌توان همزمان با \fB--replace\fR استفاده کرد.
مقدار پیش‌فرض \fBfalse\fP است.

.SS \fB--label\fP, \fB-l\fP=\fIlabel\fP
تنظیم فراداده برای سکرت (مانند \fB--label mykey=value\fR). این گزینه می‌تواند چندین بار تکرار شود.
این برچسب‌ها در \fBpodman secret inspect\fR یا \fBpodman secret ls\fR قابل مشاهده هستند.

.SS \fB--replace\fP=\fIfalse\fP
اگر سکرتی با همین نام از قبل موجود باشد، آن را به‌روزرسانی می‌کند.
گزینه \fB--replace\fR سکرت‌های درون کانتینرهای موجود را تغییر نمی‌دهد و تنها بر کانتینرهای تازه‌تولیدشده اثر می‌گذارد.
نمی‌توان همزمان با \fB--ignore\fR استفاده کرد.
مقدار پیش‌فرض \fBfalse\fP است.

.SH "درایورهای سکرت (SECRET DRIVERS)"
.SS file
سکرت در یک فایل با دسترسی محافظت‌شده برای خواندن ذخیره می‌شود.

.SS pass
سکرت در یک فایل رمزنگاری‌شده توسط GPG ذخیره می‌شود.

.SS shell
سکرت توسط اسکریپت‌های سفارشی مدیریت می‌شود. یک متغیر محیطی به نام \fBSECRET_ID\fP به اسکریپت‌ها ارسال می‌شود (به جز برای \fBlist\fP)، و سکرت‌ها از طریق stdin/stdout (در صورت لزوم) تبادل می‌شوند. گزینه‌های درایور \fBlist\fP، \fBlookup\fP، \fBstore\fP و \fBdelete\fP برای معرفی اسکریپت‌ها به کار می‌روند:

.EX
[secrets]
driver = "shell"

[secrets.opts]
list =
lookup =
store =
delete =
.EE

.SH "مثال‌ها (EXAMPLES)"
ایجاد سکرت مشخص بر پایه یک فایل محلی:

.EX
echo -n mysecret > ./secret.txt
$ podman secret create my_secret ./secret.txt
.EE

.PP
ایجاد سکرت مشخص از طریق ورودی استاندارد (stdin):

.EX
$ printf <secret> | podman secret create my_secret -
.EE

.PP
ایجاد یا جایگزینی دوره‌ای یک سکرت تصادفی امن از نظر رمزنگاری، درست کمتر از حداکثر \fB512000\fR بایت از طریق stdin:

.EX
openssl rand -base64 378000 | podman secret create --replace my_secret -
.EE

.PP
اتصال (Mount) امن یک سکرت مبتنی بر فایل محلی در یک کانتینر:

.EX
podman run --rm --secret source=my_secret,type=mount,uid=1001,gid=1001,mode=440 docker.io/library/alpine ls -l /run/secrets/my_secret
.EE

.PP
ایجاد سکرت رمزنگاری‌شده با GPG بر پایه یک فایل محلی با استفاده از درایور pass:

.EX
$ podman secret create --driver=pass my_secret ./secret.txt.gpg
.EE

.PP
ایجاد سکرت از یک متغیر محیطی به نام 'MYSECRET':

.EX
$ podman secret create --env=true my_secret MYSECRET
.EE

.SH "همچنین ببینید (SEE ALSO)"
\fBpodman(1)\fP, \fBpodman-secret(1)\fP, \fBpodman-login(1)\fP, \fBpodman-run(1)\fP

.SH "تاریخچه (HISTORY)"
.IP \(bu 2
ژانویه ۲۰۲۱، در ابتدا توسط Ashley Cui acui@redhat.com گردآوری شد
\[la]mailto:acui@redhat.com\[ra]
.IP \(bu 2
فوریه ۲۰۲۴، افزودن مثال ایجاد سکرت از یک متغیر محیطی توسط Brett Calliss brett@obligatory.email
\[la]mailto:brett@obligatory.email\[ra]
.IP \(bu 2
مه ۲۰۲۵، افزودن مثال ایجاد، چرخش امن و اتصال سکرت توسط Stuart Cardall