نام (NAME)

bundle-config - تنظیم گزینه‌های پیکربندی bundler

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

bundle config [list]
bundle config [get [--local|--global]] NAME
bundle config [set [--local|--global]] NAME VALUE
bundle config unset [--local|--global] NAME

توضیحات (DESCRIPTION)

این دستور به شما امکان تعامل با سامانه پیکربندی Bundler را می‌دهد.

برنامه Bundler تنظیمات پیکربندی را به این ترتیب بارگذاری می‌کند:

1.: پیکربندی محلی (<project_root>/.bundle/config یا $BUNDLE_APP_CONFIG/config)
2.: متغیرهای محیطی (ENV)
3.: پیکربندی سراسری (~/.bundle/config)
4.: پیکربندی پیش‌فرض Bundler

اجرای bundle در حالتی که متغیر محیطی BUNDLE_IGNORE_CONFIG تنظیم شده باشد، باعث می‌شود تمام پیکربندی‌ها نادیده گرفته شوند.

زیردستورها (SUB-COMMANDS)

list (دستور پیش‌فرض)

اجرای bundle config list فهرستی از تمام پیکربندی‌های bundler برای بسته فعلی و مکانی که این پیکربندی‌ها در آن تنظیم شده‌اند را چاپ می‌کند.

get

اجرای bundle config get <name> مقدار آن تنظیم پیکربندی و تمام مکان‌هایی که در آن تنظیم شده است را چاپ می‌کند.

گزینه‌ها (OPTIONS)

--local: دریافت پیکربندی از فایل پیکربندی برای برنامه محلی، یعنی <project_root>/.bundle/config یا $BUNDLE_APP_CONFIG/config در صورتی که BUNDLE_APP_CONFIG تنظیم شده باشد.
--global: دریافت پیکربندی از فایل پیکربندی سراسری برای تمام بسته‌های اجرا شده توسط کاربر فعلی، یعنی از ~/.bundle/config.

اجرای bundle config set <name> <value> در صورت اجرا از درون یک برنامه محلی، به‌طور پیش‌فرض پیکربندی local (محلی) را تنظیم می‌کند، در غیر این صورت پیکربندی global (سراسری) را تنظیم خواهد کرد.

گزینه‌ها (OPTIONS)

--local: اجرای bundle config set --local <name> <value> آن پیکربندی را در دایرکتوری برنامه محلی تنظیم می‌کند. پیکربندی در <project_root>/.bundle/config ذخیره خواهد شد. اگر BUNDLE_APP_CONFIG تنظیم شده باشد، پیکربندی در $BUNDLE_APP_CONFIG/config ذخیره خواهد شد.
--global: اجرای bundle config set --global <name> <value> آن پیکربندی را روی مقدار مشخص‌شده برای تمام بسته‌های اجرا شده توسط کاربر فعلی تنظیم می‌کند. پیکربندی در ~/.bundle/config ذخیره خواهد شد. اگر name از قبل تنظیم شده باشد، name بازنویسی شده و به کاربر هشدار داده می‌شود.

unset

اجرای bundle config unset <name> پیکربندی را هم از منابع محلی و هم سراسری حذف می‌کند.

گزینه‌ها (OPTIONS)

--local: اجرای bundle config unset --local <name> پیکربندی را فقط از برنامه محلی حذف خواهد کرد.
--global: اجرای bundle config unset --global <name> پیکربندی را فقط از پیکربندی کاربر حذف خواهد کرد.

کلیدهای پیکربندی (CONFIGURATION KEYS)

کلیدهای پیکربندی در bundler دو شکل دارند: شکل متعارف (canonical) و شکل متغیر محیطی.

برای مثال، دادن پرچم --without به bundle install(1) bundle-install.1.html مانع از این می‌شود که Bundler گروه‌های خاص مشخص‌شده در Gemfile(5) را نصب کند. برنامه Bundler این مقدار را در app/.bundle/config ذخیره می‌کند تا فراخوانی‌های Bundler.setup سعی در یافتن gemهایی از Gemfile که نصب نکرده‌اید نکنند. علاوه بر این، فراخوانی‌های بعدی bundle install(1) bundle-install.1.html این تنظیم را به خاطر می‌سپارند و از آن گروه‌ها صرف‌نظر می‌کنند.

شکل متعارف این پیکربندی "without" است. برای تبدیل شکل متعارف به شکل متغیر محیطی، حروف آن را بزرگ کرده و پیشوند BUNDLE_ را به آن اضافه کنید. شکل متغیر محیطیِ "without" برابر است با BUNDLE_WITHOUT.

هنگام تنظیم از طریق متغیرهای محیطی، هر نقطه‌ای در کلیدهای پیکربندی باید با دو زیرخط جایگزین شود. کلید پیکربندی local.rack به متغیر محیطی BUNDLE_LOCAL__RACK تبدیل می‌شود.

فهرست کلیدهای دردسترس (LIST OF AVAILABLE KEYS)

در ادامه فهرستی از تمام کلیدهای پیکربندی و کاربرد آن‌ها آورده شده است. می‌توانید درباره عملکرد آن‌ها در bundle install(1) bundle-install.1.html اطلاعات بیشتری کسب کنید.

auto_install (BUNDLE_AUTO_INSTALL): اجرای خودکار bundle install هنگامی که gemها مفقود هستند.
bin (BUNDLE_BIN): در صورت پیکربندی، bundle binstubs فایل‌های اجراییِ gemهای موجود در بسته را در دایرکتوری مشخص‌شده نصب می‌کند. در غیر این صورت، آن‌ها را در یک دایرکتوری bin نسبت به دایرکتوری Gemfile ایجاد خواهد کرد. این فایل‌های اجرایی در بستر Bundler اجرا می‌شوند. در صورت استفاده، ممکن است بخواهید این دایرکتوری را به متغیر محیطی PATH خود اضافه کنید. برای مثال، اگر gem مربوط به rails همراه با یک فایل اجرایی rails عرضه شود، دستور bundle binstubs یک فایل اجرایی bin/rails ایجاد می‌کند که اطمینان می‌دهد تمام وابستگی‌های ارجاع‌شده با استفاده از gemهای بسته‌بندی‌شده حل‌وفصل می‌شوند.
cache_all (BUNDLE_CACHE_ALL): کش کردن تمام gemها، شامل gemهای مسیر (path) و git. این مورد قبل از bundler 4 باید به صراحت مشخص می‌شد، اما در bundler 4 حالت پیش‌فرض خواهد بود.
cache_all_platforms (BUNDLE_CACHE_ALL_PLATFORMS): کش کردن gemها برای تمامی پلتفرم‌ها.
cache_path (BUNDLE_CACHE_PATH): دایرکتوری‌ای که bundler هنگام اجرای bundle package، gemهای کش‌شده را در آن قرار می‌دهد، و هنگام نصب gemها نیز آنجا را بررسی می‌کند. پیش‌فرض vendor/cache است.
clean (BUNDLE_CLEAN): اینکه آیا Bundler باید پس از bundle install به‌طور خودکار bundle clean را اجرا کند یا خیر. در Bundler 4 تا زمانی که path به صراحت پیکربندی نشده باشد، مقدار پیش‌فرض true است.
console (BUNDLE_CONSOLE): کنسولی که bundle console راه‌اندازی می‌کند. پیش‌فرض irb است.
default_cli_command (BUNDLE_DEFAULT_CLI_COMMAND): دستوری که با اجرای bundle بدون هیچ آرگومانی باید اجرا شود. از نسخه Bundler 4 پیش‌فرض روی cli_help است، اما می‌تواند install نیز باشد که پیش‌فرض قبلی بود.
deployment (BUNDLE_DEPLOYMENT): معادل با تنظیم frozen روی true و path روی vendor/bundle.
disable_checksum_validation (BUNDLE_DISABLE_CHECKSUM_VALIDATION): اجازه نصب gemها حتی در صورتی که با چک‌سام ارائه‌شده توسط RubyGems مطابقت نداشته باشند.
disable_exec_load (BUNDLE_DISABLE_EXEC_LOAD): جلوگیری از استفاده Bundler از load برای راه‌اندازی یک فایل اجرایی درون فرایند در bundle exec.
disable_local_branch_check (BUNDLE_DISABLE_LOCAL_BRANCH_CHECK): اجازه به Bundler برای استفاده از جایگزینی محلی git بدون تعیین شاخه در Gemfile.
disable_local_revision_check (BUNDLE_DISABLE_LOCAL_REVISION_CHECK): اجازه به Bundler برای استفاده از جایگزینی محلی git بدون بررسی اینکه آیا بازبینی (revision) موجود در lockfile درون مخزن وجود دارد یا خیر.
disable_shared_gems (BUNDLE_DISABLE_SHARED_GEMS): جلوگیری از دسترسی Bundler به gemهای نصب‌شده در مکان عادی RubyGems.
disable_version_check (BUNDLE_DISABLE_VERSION_CHECK): جلوگیری از بررسی Bundler برای وجود نسخه جدیدتر Bundler در rubygems.org.
force_ruby_platform (BUNDLE_FORCE_RUBY_PLATFORM): نادیده گرفتن پلتفرم ماشین فعلی و نصب انحصاری gemهای مربوط به پلتفرم ruby. در نتیجه، gemهای دارای افزونه‌های محلی (native extensions) از روی سورس کامپایل خواهند شد.
frozen (BUNDLE_FROZEN): غیرمجاز دانستن هرگونه تغییر خودکار در Gemfile.lock. دستورات Bundler مسدود خواهند شد مگر اینکه lockfile دقیقاً همان‌طور که نوشته شده قابل نصب باشد. این وضعیت معمولاً هنگامی رخ می‌دهد که Gemfile به‌صورت دستی تغییر داده شده و به‌روزرسانی lockfile از طریق bundle lock یا bundle install فراموش شده باشد.
gem.github_username (BUNDLE_GEM__GITHUB_USERNAME): یک نام کاربری یا سازمان در GitHub را تنظیم می‌کند تا هنگام ایجاد یک gem جدید با دستور bundle gem در فایل‌های README و .gemspec استفاده شود. این مقدار را می‌توان با دادن پرچم صریح --github-username به bundle gem بازنویسی کرد.
gem.push_key (BUNDLE_GEM__PUSH_KEY): پارامتر --key را برای gem push هنگام استفاده از دستور rake release به همراه یک کارساز خصوصی gemstash تنظیم می‌کند.
gemfile (BUNDLE_GEMFILE): نام فایلی که bundler باید به عنوان Gemfile استفاده کند. مکان این فایل همچنین ریشه پروژه را تعیین می‌کند که از جمله موارد دیگر، برای حل‌وفصل مسیرهای نسبی در Gemfile استفاده می‌شود. به‌طور پیش‌فرض، bundler از دایرکتوری کاری فعلی به سمت بالا جستجو می‌کند تا یک Gemfile بیابد.
global_gem_cache (BUNDLE_GLOBAL_GEM_CACHE): اینکه آیا Bundler باید تمام gemها و افزونه‌های کامپایل‌شده را به‌جای مسیر نصب پیکربندی‌شده محلی، به‌صورت سراسری کش کند یا خیر.
ignore_funding_requests (BUNDLE_IGNORE_FUNDING_REQUESTS): در صورت تنظیم، هیچ درخواست کمک مالی (funding requests) چاپ نخواهد شد.
ignore_messages (BUNDLE_IGNORE_MESSAGES): در صورت تنظیم، هیچ پیامی پس از نصب چاپ نخواهد شد. برای بی‌صدا کردن یک gem خاص، از علامت نقطه‌گذاری مانند ignore_messages.httparty true استفاده کنید.
init_gems_rb (BUNDLE_INIT_GEMS_RB): تولید یک gems.rb به جای Gemfile هنگام اجرای bundle init.
jobs (BUNDLE_JOBS): تعداد gemهایی که Bundler می‌تواند به صورت موازی نصب کند. پیش‌فرض برابر با تعداد پردازنده‌های دردسترس است.
lockfile (BUNDLE_LOCKFILE): مسیر lockfile که bundler باید استفاده کند. به‌طور پیش‌فرض، Bundler مقدار .lock را به انتهای مدخل gemfile اضافه می‌کند. برای غیرفعال کردن کامل ساخت lockfile می‌تواند در Gemfile روی false تنظیم شود (gemfile(5) را ببینید).
lockfile_checksums (BUNDLE_LOCKFILE_CHECKSUMS): اینکه آیا Bundler باید بخشی برای چک‌سام‌ها در lockfileهای جدید بگنجاند تا در برابر منابع دستکاری‌شده gem محافظت شود یا خیر. پیش‌فرض true است.
no_install (BUNDLE_NO_INSTALL): اینکه آیا bundle package باید از نصب gemها صرف‌نظر کند یا خیر.
no_prune (BUNDLE_NO_PRUNE): اینکه آیا Bundler باید gemهای قدیمی را هنگام کش کردن هرس‌نشده باقی بگذارد یا خیر.
only (BUNDLE_ONLY): فهرستی جداشده با فاصله از گروه‌ها برای نصب اختصاصیِ gemهای متعلق به گروه‌های مشخص‌شده. لطفاً اگر می‌خواهید gemهای بدون گروه را نیز نصب کنید با دقت بررسی نمایید، زیرا آن‌ها درون گروه default قرار می‌گیرند. به عنوان مثال only test:default تمام gemهای مشخص‌شده در گروه test و بدون گروه را نصب خواهد کرد.
path (BUNDLE_PATH): مکان روی دیسک که تمام gemهای موجود در بسته شما بدون در نظر گرفتن مقادیر $GEM_HOME یا $GEM_PATH در آن قرار خواهند گرفت. gemهای بسته‌ای که در این مکان یافت نشوند توسط bundle install نصب خواهند شد. در صورت عدم تنظیم، در Bundler 4 به‌طور پیش‌فرض در یک دایرکتوری .bundle نسبت به ریشه مخزن نصب می‌شود، و قبل از Bundler 4 در مسیر پیش‌فرض سیستم (Gem.dir) نصب می‌شد. این بدان معناست که پیش از Bundler 4، برنامه Bundler این مکان را با Rubygems به اشتراک می‌گذاشت، و دستور gem install ... gemها را در همان مکان نصب می‌کرد و بنابراین gemهای نصب‌شده بدون تنظیم path، با فراخوانی gem list نشان داده می‌شدند. این مورد در Bundler 4 صدق نخواهد کرد.
path.system (BUNDLE_PATH__SYSTEM): اینکه آیا Bundler باید gemها را در مسیر پیش‌فرض سیستم (Gem.dir) نصب کند یا خیر.
plugins (BUNDLE_PLUGINS): فعال‌سازی سامانه آزمایشی افزایه‌های Bundler.
prefer_patch (BUNDLE_PREFER_PATCH): ترجیح دادن به‌روزرسانی تنها به نسخه وصله (patch) بعدی هنگام به‌روزرسانی‌ها. فراخوانی‌های bundle update را معادل bundler update --patch می‌کند.
redirect (BUNDLE_REDIRECT): تعداد تغییر مسیرهای مجاز برای درخواست‌های شبکه. پیش‌فرض 5 است.
retry (BUNDLE_RETRY): تعداد دفعات تلاش مجدد برای درخواست‌های ناموفق شبکه. پیش‌فرض 3 است.
shebang (BUNDLE_SHEBANG): نام برنامه‌ای که باید برای binstubهای تولیدشده فراخوانی شود. مقدار پیش‌فرض نام برنامه نصب‌شده ruby است که برای تولید binstub استفاده شده است..TP silence_deprecations (BUNDLE_SILENCE_DEPRECATIONS) مشخص می‌کند که آیا Bundler باید هشدارهای منسوخ‌شدگی را برای رفتارهایی که در نسخهٔ اصلی (major) بعدی تغییر خواهند کرد، بی‌صدا کند یا خیر.
silence_root_warning (BUNDLE_SILENCE_ROOT_WARNING): بی‌صدا کردن هشداری که Bundler هنگام نصب gemها به عنوان کاربر ریشه (root) چاپ می‌کند.
simulate_version (BUNDLE_SIMULATE_VERSION): نسخهٔ مجازی‌ای که Bundler باید برای فعال‌سازی پرچم‌های ویژگی استفاده کند. می‌تواند برای شبیه‌سازی تمام قابلیت‌های جدیدی که در یک نسخهٔ اصلی (major) آینده فعال خواهند شد استفاده شود.
ssl_ca_cert (BUNDLE_SSL_CA_CERT): مسیر به یک فایل گواهی CA مشخص یا پوشه‌ای حاوی چندین گواهی برای CAهای مورد اعتماد در قالب PEM.
ssl_client_cert (BUNDLE_SSL_CLIENT_CERT): مسیر به یک فایل مشخص حاوی گواهی کلاینت X.509 و کلید در قالب PEM.
ssl_verify_mode (BUNDLE_SSL_VERIFY_MODE): حالت اعتبارسنجی SSL که Bundler هنگام برقراری درخواست‌های HTTPS استفاده می‌کند. پیش‌فرض verify peer است.
system_bindir (BUNDLE_SYSTEM_BINDIR): مسیری که RubyGems فایل‌های binstub را در آن نصب می‌کند. پیش‌فرض Gem.bindir است.
timeout (BUNDLE_TIMEOUT): مدت‌زمان مجاز (به ثانیه) پیش از اتمام مهلت (timeout) درخواست‌های شبکه. پیش‌فرض 10 است.
update_requires_all_flag (BUNDLE_UPDATE_REQUIRES_ALL_FLAG): الزام ارسال --all به bundle update هنگامی که قرار است همه‌چیز به‌روزرسانی شود، و ممنوع کردن اجرای bundle update بدون ارسال هیچ گزینه‌ای.
user_agent (BUNDLE_USER_AGENT): بخش سفارشی عامل کاربر (user agent) که Bundler در درخواست‌های API قرار می‌دهد.
verbose (BUNDLE_VERBOSE): مشخص می‌کند که آیا Bundler باید خروجی پرجزئیات چاپ کند یا خیر. پیش‌فرض false است، مگر اینکه پرچم خط فرمان --verbose استفاده شود.
version (BUNDLE_VERSION): نسخه‌ای از Bundler که هنگام اجرا در محیط Bundler استفاده می‌شود. پیش‌فرض lockfile است. همچنین می‌توانید system یا x.y.z را مشخص کنید. مقدار lockfile از نسخهٔ Bundler مشخص‌شده در Gemfile.lock استفاده خواهد کرد، system از نسخهٔ سیستمی Bundler استفاده می‌کند، و x.y.z از نسخهٔ مشخص‌شدهٔ Bundler استفاده خواهد کرد.
with (BUNDLE_WITH): فهرستی از گروه‌ها با جداکنندهٔ فاصله یا : که gemهای آن‌ها باید توسط bundler نصب شوند.
without (BUNDLE_WITHOUT): فهرستی از گروه‌ها با جداکنندهٔ فاصله یا : که gemهای آن‌ها نباید توسط bundler نصب شوند.

گزینه‌های ساخت (BUILD OPTIONS)

می‌توانید از bundle config برای تعیین پرچم‌هایی استفاده کنید که Bundler هربار هنگام تلاش برای نصب یک gem خاص، آن‌ها را به نصاب gem منتقل می‌کند.

یک نمونه بسیار رایج، gem به نام mysql است که کاربران Snow Leopard را ملزم می‌کند پرچم‌های پیکربندی را به gem install ارسال کنند تا مشخص شود فایل اجرایی mysql_config در کجا قرار دارد.

gem install mysql -- --with-mysql-config=/usr/local/mysql/bin/mysql_config

از آن‌جا که مکان دقیق آن فایل اجرایی می‌تواند از سیستمی به سیستم دیگر متفاوت باشد، می‌توانید این پرچم‌ها را برای هر سیستم به طور مجزا مشخص کنید.

bundle config set --global build.mysql --with-mysql-config=/usr/local/mysql/bin/mysql_config

پس از اجرای این دستور، هربار که bundler نیاز به نصب gem به نام mysql داشته باشد، پرچم‌های مشخص‌شده را ارسال خواهد کرد.

مخازن محلی گیت (LOCAL GIT REPOS)

دستور Bundler همچنین به شما اجازه می‌دهد به‌جای استفاده از نسخهٔ دوردست (remote)، با یک مخزن git به صورت محلی کار کنید. این کار با تنظیم یک بازنویسی محلی (local override) امکان‌پذیر است:

bundle config set --local local.GEM_NAME /path/to/local/git/repository

برای نمونه، جهت استفاده از یک مخزن محلی Rack، توسعه‌دهنده می‌تواند دستور زیر را اجرا کند:

bundle config set --local local.rack ~/Work/git/rack

اکنون به‌جای دریافت مخزن دوردست git، از بازنویسی محلی استفاده خواهد شد. مشابه یک منبع مسیر (path source)، هر بار که مخزن محلی git تغییر کند، تغییرات به طور خودکار توسط Bundler دریافت و اعمال می‌شوند. این بدان معناست که یک کامیت در مخزن محلی git، بازنگری (revision) موجود در Gemfile.lock را به بازنگری مخزن محلی git به‌روزرسانی می‌کند. این فرایند نیازمند همان دقتی است که زیرماژول‌های git (git submodules) می‌طلبند. پیش از push کردن به مخزن دوردست، باید اطمینان حاصل کنید که تغییرات بازنویسی محلی push شده است، در غیر این صورت ممکن است به کامیتی اشاره کنید که تنها در سیستم محلی شما وجود دارد. همچنین لازم است نام‌های کاربری و گذرواژه‌های خود را نیز به شیوهٔ CGI کدگذاری (CGI escape) کنید.

برنامهٔ Bundler بررسی‌های متعددی انجام می‌دهد تا اطمینان یابد توسعه‌دهنده با ارجاعات نامعتبر کار نمی‌کند. به‌ویژه، برای استفاده از این قابلیت، توسعه‌دهنده ملزم به مشخص کردن یک شاخه (branch) در Gemfile است. اگر شاخهٔ مشخص‌شده در Gemfile با شاخهٔ جاری در مخزن محلی git مطابقت نداشته باشد، Bundler متوقف خواهد شد. این امر تضمین می‌کند که توسعه‌دهنده همواره بر روی شاخه‌های صحیح کار می‌کند و از قفل شدن تصادفی بر روی یک شاخهٔ متفاوت جلوگیری می‌نماید.

در نهایت، Bundler همچنین بررسی می‌کند که بازنگری فعلی موجود در Gemfile.lock در مخزن محلی git وجود داشته باشد. با این کار، Bundler شما را ملزم می‌کند تا آخرین تغییرات را از مخازن دوردست دریافت (fetch) کنید..SH "آینه‌های منابع جم (MIRRORS OF GEM SOURCES)" ابزار Bundler از بازنویسی منابع gem با آینه‌ها (mirrors) پشتیبانی می‌کند. این ویژگی به شما اجازه می‌دهد rubygems.org را به عنوان منبع gem در Gemfile خود تنظیم کرده در حالی که همچنان از آینهٔ خود برای دریافت gemها استفاده می‌کنید.

bundle config set --global mirror.SOURCE_URL MIRROR_URL

به عنوان مثال، برای استفاده از یک آینهٔ https://rubygems.org که روی https://example.org میزبانی می‌شود:

bundle config set --global mirror.https://rubygems.org https://example.org

هر آینه همچنین یک تنظیم مهلت بازگشت (fallback timeout) فراهم می‌کند. اگر آینه در بازهٔ زمانی مهلت بازگشت پاسخ ندهد، Bundler تلاش خواهد کرد تا به جای آینه از سرور اصلی استفاده کند.

bundle config set --global mirror.SOURCE_URL.fallback_timeout TIMEOUT

به عنوان مثال، برای بازگشت به rubygems.org پس از ۳ ثانیه:

bundle config set --global mirror.https://rubygems.org.fallback_timeout 3

مهلت زمانی پیش‌فرض برای بازگشت 0.1 ثانیه است، اما این تنظیم در حال حاضر فقط ثانیه‌های کامل (به عنوان مثال 1، 15، یا 30) را می‌پذیرد.

اطلاعات احراز هویت منابع جم (CREDENTIALS FOR GEM SOURCES)

ابزار Bundler به شما امکان می‌دهد اطلاعات احراز هویت (credentials) را برای هر منبع gem پیکربندی کنید، که این کار مانع از قرار دادن اطلاعات محرمانه در Gemfile شما می‌شود.

bundle config set --global SOURCE_HOSTNAME USERNAME:PASSWORD

به عنوان مثال، برای ذخیرهٔ اطلاعات احراز هویت کاربر claudette برای منبع gem در gems.longerous.com، این دستور را اجرا می‌کنید:

bundle config set --global gems.longerous.com claudette:s00pers3krit

یا می‌توانید اطلاعات احراز هویت را به عنوان یک متغیر محیطی به این صورت تنظیم کنید:

export BUNDLE_GEMS__LONGEROUS__COM="claudette:s00pers3krit"

برای gemهایی با یک منبع git همراه با نشانی HTTP(S)، می‌توانید اطلاعات احراز هویت را بدین صورت مشخص کنید:

bundle config set --global https://github.com/ruby/rubygems.git username:password

یا می‌توانید اطلاعات احراز هویت را به صورت یک متغیر محیطی مانند زیر تنظیم کنید:

export BUNDLE_GITHUB__COM=username:password

این ویژگی به ویژه برای مخازن خصوصی روی میزبان‌هایی مانند GitHub کاربردی است، جایی که می‌توانید از توکن‌های شخصی OAuth استفاده کنید:

export BUNDLE_GITHUB__COM=abcd0123generatedtoken:x-oauth-basic

توجه داشته باشید که هرگونه اطلاعات احراز هویت پیکربندی‌شده توسط دستورهای اطلاع‌رسانی مانند bundle config list یا bundle config get سانسور (redact) خواهد شد، مگر اینکه از گزینهٔ --parseable استفاده کنید. این کار برای جلوگیری از افشای ناخواستهٔ اطلاعات احراز هویت هنگام کپی و جای‌گذاری خروجی bundler است.

همچنین توجه داشته باشید که برای تضمین یک نگاشت منطقی میان نام‌های معتبر متغیرهای محیطی و نام‌های معتبر میزبان، bundler دگرگونی‌های زیر را اعمال می‌کند:

هر نویسهٔ - در نام میزبان به سه خط زیرین متوالی (___) در متغیر محیطی متناظر نگاشت می‌شود.
هر نویسهٔ . در نام میزبان به دو خط زیرین متوالی (__) در متغیر محیطی متناظر نگاشت می‌شود.

این بدان معناست که اگر یک سرور gem به نام my.gem-host.com دارید، باید از متغیر BUNDLE_MY__GEM___HOST__COM برای پیکربندی اطلاعات احراز هویت آن از طریق ENV استفاده کنید..SH "پیکربندی دایرکتوری‌های BUNDLER (CONFIGURE BUNDLER DIRECTORIES)" دایرکتوری‌های خانه، کَش (cache) و پلاگین Bundler و فایل پیکربندی آن را می‌توان از طریق متغیرهای محیطی پیکربندی کرد. مکان پیش‌فرض برای دایرکتوری خانهٔ Bundler مسیر ~/.bundle است که تمام دایرکتوری‌ها به‌طور پیش‌فرض از آن ارث‌بری می‌کنند. موارد زیر متغیرهای محیطی موجود و مقادیر پیش‌فرض آن‌ها را نشان می‌دهد

BUNDLE_USER_HOME : $HOME/.bundle
BUNDLE_USER_CACHE : $BUNDLE_USER_HOME/cache
BUNDLE_USER_CONFIG : $BUNDLE_USER_HOME/config
BUNDLE_USER_PLUGIN : $BUNDLE_USER_HOME/plugin