.nh
.TH "glab" "1" "Sep 2026" "Auto generated by spf13/cobra" ""

.SH "نام (NAME)"
glab-artifact-registry-login \- احراز هویت یک مدیر بسته در رجیستری آرتفکت گیت‌لب (آزمایشی)


.SH "خلاصه دستور (SYNOPSIS)"
\fBglab artifact-registry login [flags]\fP


.SH "توضیحات (DESCRIPTION)"
پیکربندی یک مدیر بسته برای احراز هویت در رجیستری آرتفکت گیت‌لب (GitLab Artifact Registry)، با استفاده از یک توکن دسترسی کوتاه‌مدت مبادله‌شده از نشست گیت‌لب شما.

.PP
گزینه متناسب با مدیر بسته خود را به کار ببرید:
.IP \(bu 2
\fB--docker\fR: ثبت \fBglab\fR به‌عنوان دستیار اطلاعات اعتباری (credential helper) داکر برای رجیستری.
.IP \(bu 2
\fB--maven\fR: نوشتن یک بلوک \fB<server>\fR در \fB~/.m2/settings.xml\fR، کلیدگذاری‌شده با \fB--registry-alias\fR\&. از یک \fB<repository>\fR حامل همان \fB<id>\fR به آن ارجاع دهید.
.IP \(bu 2
\fB--gradle\fR: نوشتن \fB{alias}Url\fR، \fB{alias}Username\fR و \fB{alias}Password\fR در \fB~/.gradle/gradle.properties\fR، که در آن \fB{alias}\fR همان \fB--registry-alias\fR است.
.IP \(bu 2
\fB--npm\fR: نوشتن یک ورودی \fB//{host}{path}/:_authToken\fR در \fB~/.npmrc\fR\&. شما همچنان باید با یک خط \fBregistry=\fR یا \fB@scope:registry=\fR مدیر بسته npm را به رجیستری هدایت کنید.
.IP \(bu 2
\fB--sbt\fR: نوشتن یک خط \fBcredentials +=\fR در \fB~/.sbt/1.0/credentials.sbt\fR، که فرض را بر یک sbt 1.x پیش‌فرض می‌گذارد. نسخه‌ای از sbt که دایرکتوری پایه سراسری آن با \fB-Dsbt.global.base\fR یا مقدار پیش‌فرض جدیدتر جابه‌جا شده باشد، آن فایل را نمی‌خواند.

.PP
طول عمر توکن:
.IP \(bu 2
گزینه \fB--docker\fR در هر pull یا push یک توکن جدید مبادله می‌کند، بنابراین \fB--duration\fR برای آن اعمال نمی‌شود.
.IP \(bu 2
سایر گزینه‌ها تنها یک توکن می‌نویسند و چیزی آن را تازه‌سازی نمی‌کند. پیش از منقضی شدن \fB--duration\fR دستور را دوباره اجرا کنید. مقدار پیش‌فرض ۱۵ دقیقه و حداکثر ۱۲ ساعت است.

.PP
تفکیک و حل اطلاعات اعتباری:
.IP \(bu 2
داکر دستیار اطلاعات اعتباری را به‌عنوان زیرپردازه خود اجرا می‌کند، که اطلاعات اعتباری شما را از فایل پیکربندی خوانده و \fBGITLAB_TOKEN\fR را نادیده می‌گیرد. این دستور نیز وضعیت ورود را به همین شیوه اعتبارسنجی می‌کند، بنابراین اگر توکنی برای میزبان ذخیره نشده باشد، ابتدا دستور \fBglab auth login\fR را اجرا کنید.
.IP \(bu 2
سایر گزینه‌ها متغیر محیطی \fBGITLAB_TOKEN\fR را می‌خوانند. \fBglab\fR توکن را خودش درون هر فایل می‌نویسد، بنابراین ابزار می‌تواند آن را بدون واکشی مجدد اطلاعات اعتباری بخواند.

.PP
انتخاب رجیستری و نام مستعار:
.IP \(bu 2
از \fB--registry\fR تنها برای رجیستری‌هایی استفاده کنید که رجیستری آرتفکت واقعاً از آنها پشتیبانی می‌کند. اگر نام یک رجیستری کانتینر را در اینجا مشخص کنید، توکن اشتباهی دریافت خواهد کرد و خطا تنها در pull بعدی بروز خواهد کرد.
.IP \(bu 2
گزینه \fB--registry-alias\fR تنها برای \fB--maven\fR و \fB--gradle\fR اعمال می‌شود، زیرا \fB--npm\fR و \fB--sbt\fR ورودی‌های خود را بر پایه خود \fB--registry\fR کلیدگذاری می‌کنند. برای \fB--gradle\fR، از نام مستعاری استفاده کنید که یک شناسه معتبر در اسکریپت بیلد شما باشد: مقدار پیش‌فرض از میزبان رجیستری مشتق شده و شامل خط تیره است، که Groovy نمی‌تواند آن را به‌صورت \fB${...}\fR درون‌یابی کند.

.PP
این قابلیت آزمایشی است و برای استفاده در محیط عملیاتی آماده نیست. ممکن است ناپایدار باشد یا در هر زمان حذف شود. برای اطلاعات بیشتر، پیوند زیر را ببینید:
https://docs.gitlab.com/policy/development_stages_support


.SH "گزینه‌ها (OPTIONS)"
\fB--docker\fP[=false]
	پیکربندی Docker برای احراز هویت در رجیستری. در $DOCKER_CONFIG، یا در صورت تنظیم نبودن در ~/.docker می‌نویسد.

.PP
\fB--duration\fP=15m0s
	مدت زمانی که توکن مبادله‌شده باید معتبر بماند. برای --docker نادیده گرفته می‌شود.

.PP
\fB--gradle\fP[=false]
	پیکربندی Gradle برای احراز هویت در رجیستری. در ~/.gradle/gradle.properties می‌نویسد.

.PP
\fB--hostname\fP=""
	نام میزبان GitLab برای درخواست توکن از آن. پیش‌فرض بر روی نمونه پیکربندی‌شده GitLab است.

.PP
\fB--maven\fP[=false]
	پیکربندی Maven برای احراز هویت در رجیستری. در ~/.m2/settings.xml می‌نویسد.

.PP
\fB--npm\fP[=false]
	پیکربندی npm برای احراز هویت در رجیستری. در ~/.npmrc می‌نویسد.

.PP
\fB--registry\fP=""
	رجیستری مورد نظر برای احراز هویت. برای --docker، یک نام میزبان ساده؛ برای سایرین، معمولاً یک نشانی وب (URL).

.PP
\fB--registry-alias\fP=""
	نام مستعار/شناسه (ID) برای ثبت رجیستری تحت آن (تنها برای Maven/Gradle). پیش‌فرض نامی است که از --registry مشتق شده است.

.PP
\fB--sbt\fP[=false]
	پیکربندی sbt برای احراز هویت در رجیستری. در ~/.sbt/1.0/credentials.sbt می‌نویسد.


.SH "گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)"
\fB-h\fP, \fB--help\fP[=false]
	نمایش راهنما برای این دستور.


.SH "مثال‌ها (EXAMPLES)"
.EX
# پیکربندی Docker برای احراز هویت در رجیستری
glab artifact-registry login --docker --registry registry.example.com

# پیکربندی Maven برای احراز هویت در رجیستری به مدت دو ساعت
glab artifact-registry login --maven --registry https://ar.example.com --duration 2h

# پیکربندی Gradle برای احراز هویت در رجیستری به مدت دو ساعت
glab artifact-registry login --gradle --registry https://ar.example.com --duration 2h

# پیکربندی npm برای احراز هویت در رجیستری به مدت دو ساعت
glab artifact-registry login --npm --registry https://ar.example.com --duration 2h

# پیکربندی sbt برای احراز هویت در رجیستری به مدت دو ساعت
glab artifact-registry login --sbt --registry https://ar.example.com --duration 2h

.EE


.SH "همچنین ببینید (SEE ALSO)"
\fBglab-artifact-registry(1)\fP