نام (NAME)

gh-secret-set - ایجاد یا به‌روزرسانی رازها

خلاصه دستور (SYNOPSIS)

gh secret set <secret-name> [flags]

توضیحات (DESCRIPTION)

تنظیم یک مقدار برای یک راز در یکی از سطوح زیر: - repository (پیش‌فرض): در دسترس برای اجراهای GitHub Actions، نشست‌های Agents یا Dependabot در یک مخزن - environment: در دسترس برای اجراهای GitHub Actions برای یک محیط استقرار در یک مخزن - organization: در دسترس برای اجراهای GitHub Actions، نشست‌های Agents، Dependabot یا Codespaces در یک سازمان - user: در دسترس برای Codespaces برای کاربر شما

رازهای سازمان و کاربر را می‌توان به صورت اختیاری محدود کرد تا تنها برای مخازن خاصی در دسترس باشند.

مقادیر رازها پیش از ارسال به گیت‌هاب، به‌صورت محلی رمزگذاری می‌شوند.

گزینه‌ها (OPTIONS)

-a, --app <string>: تنظیم برنامه برای یک راز: {actions|agents|codespaces|dependabot}
-b, --body <string>: مقدار راز (در صورت عدم تعیین، از ورودی استاندارد خوانده می‌شود)
-e, --env <environment>: تنظیم راز محیط استقرار
-f, --env-file <file>: بارگذاری نام‌ها و مقادیر رازها از یک فایل با قالب dotenv
--no-repos-selected: هیچ مخزنی نتواند به این راز سازمانی دسترسی داشته باشد
--no-store: چاپ مقدار رمزگذاری‌شده و کدگذاری‌شده با base64 به‌جای ذخیره آن در گیت‌هاب
-o, --org <organization>: تنظیم راز سازمانی
-r, --repos <repositories>: فهرست مخازنی که می‌توانند به یک راز سازمانی یا کاربری دسترسی داشته باشند
-u, --user: تنظیم یک راز برای کاربر شما
-v, --visibility <string> (default "private"): تنظیم میزان رویت‌پذیری برای یک راز سازمانی: {all|private|selected}

گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)

-R, --repo <[HOST/]OWNER/REPO>: انتخاب یک مخزن دیگر با استفاده از قالب [HOST/]OWNER/REPO

کدهای خروج (EXIT CODES)

0: اجرای موفقیت‌آمیز

1: خطا

2: لغو دستور

4: نیاز به احراز هویت است

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

مثال‌ها (EXAMPLES)

# چسباندن مقدار راز برای مخزن فعلی در یک اعلان تعاملی
$ gh secret set MYSECRET
# خواندن مقدار راز از یک متغیر محیطی
$ gh secret set MYSECRET --body "$ENV_VALUE"
# تنظیم راز برای یک مخزن دوردست مشخص
$ gh secret set MYSECRET --repo origin/repo --body "$ENV_VALUE"
# خواندن مقدار راز از یک فایل
$ gh secret set MYSECRET < myfile.txt
# تنظیم راز برای یک محیط استقرار در مخزن فعلی
$ gh secret set MYSECRET --env myenvironment
# تنظیم راز در سطح سازمان به طوری که برای هر دو نوع مخازن عمومی و خصوصی قابل رویت باشد
$ gh secret set MYSECRET --org myOrg --visibility all
# تنظیم راز در سطح سازمان به طوری که برای مخازن مشخصی قابل رویت باشد
$ gh secret set MYSECRET --org myOrg --repos repo1,repo2,repo3
# تنظیم راز در سطح سازمان بدون دسترسی برای هیچ‌یک از مخازن
$ gh secret set MYSECRET --org myOrg --no-repos-selected
# تنظیم راز در سطح کاربر برای Codespaces
$ gh secret set MYSECRET --user
# تنظیم راز در سطح مخزن برای Dependabot
$ gh secret set MYSECRET --app dependabot
# تنظیم چندین راز واردشده از فایل ".env"
$ gh secret set -f .env
# تنظیم چندین راز از ورودی استاندارد (stdin)
$ gh secret set -f - < myfile.txt

همچنین ببینید (SEE ALSO)

gh-secret(1)