glab(1) glab(1)

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

glab artifact-registry login [flags]

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

گزینه متناسب با مدیر بسته خود را به کار ببرید:

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

طول عمر توکن:

  • گزینه --docker در هر pull یا push یک توکن جدید مبادله می‌کند، بنابراین --duration برای آن اعمال نمی‌شود.
  • سایر گزینه‌ها تنها یک توکن می‌نویسند و چیزی آن را تازه‌سازی نمی‌کند. پیش از منقضی شدن --duration دستور را دوباره اجرا کنید. مقدار پیش‌فرض ۱۵ دقیقه و حداکثر ۱۲ ساعت است.

تفکیک و حل اطلاعات اعتباری:

  • داکر دستیار اطلاعات اعتباری را به‌عنوان زیرپردازه خود اجرا می‌کند، که اطلاعات اعتباری شما را از فایل پیکربندی خوانده و GITLAB_TOKEN را نادیده می‌گیرد. این دستور نیز وضعیت ورود را به همین شیوه اعتبارسنجی می‌کند، بنابراین اگر توکنی برای میزبان ذخیره نشده باشد، ابتدا دستور glab auth login را اجرا کنید.
  • سایر گزینه‌ها متغیر محیطی GITLAB_TOKEN را می‌خوانند. glab توکن را خودش درون هر فایل می‌نویسد، بنابراین ابزار می‌تواند آن را بدون واکشی مجدد اطلاعات اعتباری بخواند.

انتخاب رجیستری و نام مستعار:

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

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

--docker[=false] پیکربندی Docker برای احراز هویت در رجیستری. در $DOCKER_CONFIG، یا در صورت تنظیم نبودن در ~/.docker می‌نویسد.

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

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

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

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

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

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

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

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

-h, --help[=false] نمایش راهنما برای این دستور.

# پیکربندی 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

glab-artifact-registry(1)

Sep 2026 Auto generated by spf13/cobra