.\" generated with Ronn-NG/v0.10.1 .\" http://github.com/apjanke/ronn-ng/tree/0.10.1 .TH "BUNDLE\-CONFIG" "1" "September 2025" "" .SH "نام (NAME)" \fBbundle\-config\fR \- تنظیم گزینه‌های پیکربندی bundler .SH "خلاصه دستور (SYNOPSIS)" \fBbundle config\fR [list] .br \fBbundle config\fR [get [\-\-local|\-\-global]] NAME .br \fBbundle config\fR [set [\-\-local|\-\-global]] NAME VALUE .br \fBbundle config\fR unset [\-\-local|\-\-global] NAME .SH "توضیحات (DESCRIPTION)" این دستور به شما امکان تعامل با سامانه پیکربندی Bundler را می‌دهد\. .P برنامه Bundler تنظیمات پیکربندی را به این ترتیب بارگذاری می‌کند: .IP "1." 4 پیکربندی محلی (\fB/\.bundle/config\fR یا \fB$BUNDLE_APP_CONFIG/config\fR) .IP "2." 4 متغیرهای محیطی (\fBENV\fR) .IP "3." 4 پیکربندی سراسری (\fB~/\.bundle/config\fR) .IP "4." 4 پیکربندی پیش‌فرض Bundler .IP "" 0 .P اجرای \fBbundle\fR در حالتی که متغیر محیطی \fBBUNDLE_IGNORE_CONFIG\fR تنظیم شده باشد، باعث می‌شود تمام پیکربندی‌ها نادیده گرفته شوند\. .SH "زیردستورها (SUB\-COMMANDS)" .SS "list (دستور پیش‌فرض)" اجرای \fBbundle config list\fR فهرستی از تمام پیکربندی‌های bundler برای بسته فعلی و مکانی که این پیکربندی‌ها در آن تنظیم شده‌اند را چاپ می‌کند\. .SS "get" اجرای \fBbundle config get \fR مقدار آن تنظیم پیکربندی و تمام مکان‌هایی که در آن تنظیم شده است را چاپ می‌کند\. .P \fBگزینه‌ها (OPTIONS)\fR .TP \fB\-\-local\fR دریافت پیکربندی از فایل پیکربندی برای برنامه محلی، یعنی \fB/\.bundle/config\fR یا \fB$BUNDLE_APP_CONFIG/config\fR در صورتی که \fBBUNDLE_APP_CONFIG\fR تنظیم شده باشد\. .TP \fB\-\-global\fR دریافت پیکربندی از فایل پیکربندی سراسری برای تمام بسته‌های اجرا شده توسط کاربر فعلی، یعنی از \fB~/\.bundle/config\fR\. .SS "set" اجرای \fBbundle config set \fR در صورت اجرا از درون یک برنامه محلی، به‌طور پیش‌فرض پیکربندی \fBlocal\fR (محلی) را تنظیم می‌کند، در غیر این صورت پیکربندی \fBglobal\fR (سراسری) را تنظیم خواهد کرد\. .P \fBگزینه‌ها (OPTIONS)\fR .TP \fB\-\-local\fR اجرای \fBbundle config set \-\-local \fR آن پیکربندی را در دایرکتوری برنامه محلی تنظیم می‌کند\. پیکربندی در \fB/\.bundle/config\fR ذخیره خواهد شد\. اگر \fBBUNDLE_APP_CONFIG\fR تنظیم شده باشد، پیکربندی در \fB$BUNDLE_APP_CONFIG/config\fR ذخیره خواهد شد\. .TP \fB\-\-global\fR اجرای \fBbundle config set \-\-global \fR آن پیکربندی را روی مقدار مشخص‌شده برای تمام بسته‌های اجرا شده توسط کاربر فعلی تنظیم می‌کند\. پیکربندی در \fB~/\.bundle/config\fR ذخیره خواهد شد\. اگر \fIname\fR از قبل تنظیم شده باشد، \fIname\fR بازنویسی شده و به کاربر هشدار داده می‌شود\. .SS "unset" اجرای \fBbundle config unset \fR پیکربندی را هم از منابع محلی و هم سراسری حذف می‌کند\. .P \fBگزینه‌ها (OPTIONS)\fR .TP \fB\-\-local\fR اجرای \fBbundle config unset \-\-local \fR پیکربندی را فقط از برنامه محلی حذف خواهد کرد\. .TP \fB\-\-global\fR اجرای \fBbundle config unset \-\-global \fR پیکربندی را فقط از پیکربندی کاربر حذف خواهد کرد\. .SH "کلیدهای پیکربندی (CONFIGURATION KEYS)" کلیدهای پیکربندی در bundler دو شکل دارند: شکل متعارف (canonical) و شکل متغیر محیطی\. .P برای مثال، دادن پرچم \fB\-\-without\fR به bundle install(1) \fIbundle\-install\.1\.html\fR مانع از این می‌شود که Bundler گروه‌های خاص مشخص‌شده در Gemfile(5) را نصب کند\. برنامه Bundler این مقدار را در \fBapp/\.bundle/config\fR ذخیره می‌کند تا فراخوانی‌های \fBBundler\.setup\fR سعی در یافتن gemهایی از \fBGemfile\fR که نصب نکرده‌اید نکنند\. علاوه بر این، فراخوانی‌های بعدی bundle install(1) \fIbundle\-install\.1\.html\fR این تنظیم را به خاطر می‌سپارند و از آن گروه‌ها صرف‌نظر می‌کنند\. .P شکل متعارف این پیکربندی \fB"without"\fR است\. برای تبدیل شکل متعارف به شکل متغیر محیطی، حروف آن را بزرگ کرده و پیشوند \fBBUNDLE_\fR را به آن اضافه کنید\. شکل متغیر محیطیِ \fB"without"\fR برابر است با \fBBUNDLE_WITHOUT\fR\. .P هنگام تنظیم از طریق متغیرهای محیطی، هر نقطه‌ای در کلیدهای پیکربندی باید با دو زیرخط جایگزین شود\. کلید پیکربندی \fBlocal\.rack\fR به متغیر محیطی \fBBUNDLE_LOCAL__RACK\fR تبدیل می‌شود\. .SH "فهرست کلیدهای دردسترس (LIST OF AVAILABLE KEYS)" در ادامه فهرستی از تمام کلیدهای پیکربندی و کاربرد آن‌ها آورده شده است\. می‌توانید درباره عملکرد آن‌ها در bundle install(1) \fIbundle\-install\.1\.html\fR اطلاعات بیشتری کسب کنید\. .TP \fBauto_install\fR (\fBBUNDLE_AUTO_INSTALL\fR) اجرای خودکار \fBbundle install\fR هنگامی که gemها مفقود هستند\. .TP \fBbin\fR (\fBBUNDLE_BIN\fR) در صورت پیکربندی، \fBbundle binstubs\fR فایل‌های اجراییِ gemهای موجود در بسته را در دایرکتوری مشخص‌شده نصب می‌کند\. در غیر این صورت، آن‌ها را در یک دایرکتوری \fBbin\fR نسبت به دایرکتوری Gemfile ایجاد خواهد کرد\. این فایل‌های اجرایی در بستر Bundler اجرا می‌شوند\. در صورت استفاده، ممکن است بخواهید این دایرکتوری را به متغیر محیطی \fBPATH\fR خود اضافه کنید\. برای مثال، اگر gem مربوط به \fBrails\fR همراه با یک فایل اجرایی \fBrails\fR عرضه شود، دستور \fBbundle binstubs\fR یک فایل اجرایی \fBbin/rails\fR ایجاد می‌کند که اطمینان می‌دهد تمام وابستگی‌های ارجاع‌شده با استفاده از gemهای بسته‌بندی‌شده حل‌وفصل می‌شوند\. .TP \fBcache_all\fR (\fBBUNDLE_CACHE_ALL\fR) کش کردن تمام gemها، شامل gemهای مسیر (path) و git\. این مورد قبل از bundler 4 باید به صراحت مشخص می‌شد، اما در bundler 4 حالت پیش‌فرض خواهد بود\. .TP \fBcache_all_platforms\fR (\fBBUNDLE_CACHE_ALL_PLATFORMS\fR) کش کردن gemها برای تمامی پلتفرم‌ها\. .TP \fBcache_path\fR (\fBBUNDLE_CACHE_PATH\fR) دایرکتوری‌ای که bundler هنگام اجرای \fBbundle package\fR، gemهای کش‌شده را در آن قرار می‌دهد، و هنگام نصب gemها نیز آنجا را بررسی می‌کند\. پیش‌فرض \fBvendor/cache\fR است\. .TP \fBclean\fR (\fBBUNDLE_CLEAN\fR) اینکه آیا Bundler باید پس از \fBbundle install\fR به‌طور خودکار \fBbundle clean\fR را اجرا کند یا خیر\. در Bundler 4 تا زمانی که \fBpath\fR به صراحت پیکربندی نشده باشد، مقدار پیش‌فرض \fBtrue\fR است\. .TP \fBconsole\fR (\fBBUNDLE_CONSOLE\fR) کنسولی که \fBbundle console\fR راه‌اندازی می‌کند\. پیش‌فرض \fBirb\fR است\. .TP \fBdefault_cli_command\fR (\fBBUNDLE_DEFAULT_CLI_COMMAND\fR) دستوری که با اجرای \fBbundle\fR بدون هیچ آرگومانی باید اجرا شود\. از نسخه Bundler 4 پیش‌فرض روی \fBcli_help\fR است، اما می‌تواند \fBinstall\fR نیز باشد که پیش‌فرض قبلی بود\. .TP \fBdeployment\fR (\fBBUNDLE_DEPLOYMENT\fR) معادل با تنظیم \fBfrozen\fR روی \fBtrue\fR و \fBpath\fR روی \fBvendor/bundle\fR\. .TP \fBdisable_checksum_validation\fR (\fBBUNDLE_DISABLE_CHECKSUM_VALIDATION\fR) اجازه نصب gemها حتی در صورتی که با چک‌سام ارائه‌شده توسط RubyGems مطابقت نداشته باشند\. .TP \fBdisable_exec_load\fR (\fBBUNDLE_DISABLE_EXEC_LOAD\fR) جلوگیری از استفاده Bundler از \fBload\fR برای راه‌اندازی یک فایل اجرایی درون فرایند در \fBbundle exec\fR\. .TP \fBdisable_local_branch_check\fR (\fBBUNDLE_DISABLE_LOCAL_BRANCH_CHECK\fR) اجازه به Bundler برای استفاده از جایگزینی محلی git بدون تعیین شاخه در Gemfile\. .TP \fBdisable_local_revision_check\fR (\fBBUNDLE_DISABLE_LOCAL_REVISION_CHECK\fR) اجازه به Bundler برای استفاده از جایگزینی محلی git بدون بررسی اینکه آیا بازبینی (revision) موجود در lockfile درون مخزن وجود دارد یا خیر\. .TP \fBdisable_shared_gems\fR (\fBBUNDLE_DISABLE_SHARED_GEMS\fR) جلوگیری از دسترسی Bundler به gemهای نصب‌شده در مکان عادی RubyGems\. .TP \fBdisable_version_check\fR (\fBBUNDLE_DISABLE_VERSION_CHECK\fR) جلوگیری از بررسی Bundler برای وجود نسخه جدیدتر Bundler در rubygems\.org\. .TP \fBforce_ruby_platform\fR (\fBBUNDLE_FORCE_RUBY_PLATFORM\fR) نادیده گرفتن پلتفرم ماشین فعلی و نصب انحصاری gemهای مربوط به پلتفرم \fBruby\fR\. در نتیجه، gemهای دارای افزونه‌های محلی (native extensions) از روی سورس کامپایل خواهند شد\. .TP \fBfrozen\fR (\fBBUNDLE_FROZEN\fR) غیرمجاز دانستن هرگونه تغییر خودکار در \fBGemfile\.lock\fR\. دستورات Bundler مسدود خواهند شد مگر اینکه lockfile دقیقاً همان‌طور که نوشته شده قابل نصب باشد\. این وضعیت معمولاً هنگامی رخ می‌دهد که \fBGemfile\fR به‌صورت دستی تغییر داده شده و به‌روزرسانی lockfile از طریق \fBbundle lock\fR یا \fBbundle install\fR فراموش شده باشد\. .TP \fBgem\.github_username\fR (\fBBUNDLE_GEM__GITHUB_USERNAME\fR) یک نام کاربری یا سازمان در GitHub را تنظیم می‌کند تا هنگام ایجاد یک gem جدید با دستور \fBbundle gem\fR در فایل‌های \fBREADME\fR و \fB\.gemspec\fR استفاده شود\. این مقدار را می‌توان با دادن پرچم صریح \fB\-\-github\-username\fR به \fBbundle gem\fR بازنویسی کرد\. .TP \fBgem\.push_key\fR (\fBBUNDLE_GEM__PUSH_KEY\fR) پارامتر \fB\-\-key\fR را برای \fBgem push\fR هنگام استفاده از دستور \fBrake release\fR به همراه یک کارساز خصوصی gemstash تنظیم می‌کند\. .TP \fBgemfile\fR (\fBBUNDLE_GEMFILE\fR) نام فایلی که bundler باید به عنوان \fBGemfile\fR استفاده کند\. مکان این فایل همچنین ریشه پروژه را تعیین می‌کند که از جمله موارد دیگر، برای حل‌وفصل مسیرهای نسبی در \fBGemfile\fR استفاده می‌شود\. به‌طور پیش‌فرض، bundler از دایرکتوری کاری فعلی به سمت بالا جستجو می‌کند تا یک \fBGemfile\fR بیابد\. .TP \fBglobal_gem_cache\fR (\fBBUNDLE_GLOBAL_GEM_CACHE\fR) اینکه آیا Bundler باید تمام gemها و افزونه‌های کامپایل‌شده را به‌جای مسیر نصب پیکربندی‌شده محلی، به‌صورت سراسری کش کند یا خیر\. .TP \fBignore_funding_requests\fR (\fBBUNDLE_IGNORE_FUNDING_REQUESTS\fR) در صورت تنظیم، هیچ درخواست کمک مالی (funding requests) چاپ نخواهد شد\. .TP \fBignore_messages\fR (\fBBUNDLE_IGNORE_MESSAGES\fR) در صورت تنظیم، هیچ پیامی پس از نصب چاپ نخواهد شد\. برای بی‌صدا کردن یک gem خاص، از علامت نقطه‌گذاری مانند \fBignore_messages\.httparty true\fR استفاده کنید\. .TP \fBinit_gems_rb\fR (\fBBUNDLE_INIT_GEMS_RB\fR) تولید یک \fBgems\.rb\fR به جای \fBGemfile\fR هنگام اجرای \fBbundle init\fR\. .TP \fBjobs\fR (\fBBUNDLE_JOBS\fR) تعداد gemهایی که Bundler می‌تواند به صورت موازی نصب کند\. پیش‌فرض برابر با تعداد پردازنده‌های دردسترس است\. .TP \fBlockfile\fR (\fBBUNDLE_LOCKFILE\fR) مسیر lockfile که bundler باید استفاده کند\. به‌طور پیش‌فرض، Bundler مقدار \fB\.lock\fR را به انتهای مدخل \fBgemfile\fR اضافه می‌کند\. برای غیرفعال کردن کامل ساخت lockfile می‌تواند در Gemfile روی \fBfalse\fR تنظیم شود (gemfile(5) را ببینید)\. .TP \fBlockfile_checksums\fR (\fBBUNDLE_LOCKFILE_CHECKSUMS\fR) اینکه آیا Bundler باید بخشی برای چک‌سام‌ها در lockfileهای جدید بگنجاند تا در برابر منابع دستکاری‌شده gem محافظت شود یا خیر\. پیش‌فرض true است\. .TP \fBno_install\fR (\fBBUNDLE_NO_INSTALL\fR) اینکه آیا \fBbundle package\fR باید از نصب gemها صرف‌نظر کند یا خیر\. .TP \fBno_prune\fR (\fBBUNDLE_NO_PRUNE\fR) اینکه آیا Bundler باید gemهای قدیمی را هنگام کش کردن هرس‌نشده باقی بگذارد یا خیر\. .TP \fBonly\fR (\fBBUNDLE_ONLY\fR) فهرستی جداشده با فاصله از گروه‌ها برای نصب اختصاصیِ gemهای متعلق به گروه‌های مشخص‌شده\. لطفاً اگر می‌خواهید gemهای بدون گروه را نیز نصب کنید با دقت بررسی نمایید، زیرا آن‌ها درون گروه \fBdefault\fR قرار می‌گیرند\. به عنوان مثال \fBonly test:default\fR تمام gemهای مشخص‌شده در گروه test و بدون گروه را نصب خواهد کرد\. .TP \fBpath\fR (\fBBUNDLE_PATH\fR) مکان روی دیسک که تمام gemهای موجود در بسته شما بدون در نظر گرفتن مقادیر \fB$GEM_HOME\fR یا \fB$GEM_PATH\fR در آن قرار خواهند گرفت\. gemهای بسته‌ای که در این مکان یافت نشوند توسط \fBbundle install\fR نصب خواهند شد\. در صورت عدم تنظیم، در Bundler 4 به‌طور پیش‌فرض در یک دایرکتوری \fB\.bundle\fR نسبت به ریشه مخزن نصب می‌شود، و قبل از Bundler 4 در مسیر پیش‌فرض سیستم (\fBGem\.dir\fR) نصب می‌شد\. این بدان معناست که پیش از Bundler 4، برنامه Bundler این مکان را با Rubygems به اشتراک می‌گذاشت، و دستور \fBgem install \|\.\|\.\|\.\fR gemها را در همان مکان نصب می‌کرد و بنابراین gemهای نصب‌شده بدون تنظیم \fBpath\fR، با فراخوانی \fBgem list\fR نشان داده می‌شدند\. این مورد در Bundler 4 صدق نخواهد کرد\. .TP \fBpath\.system\fR (\fBBUNDLE_PATH__SYSTEM\fR) اینکه آیا Bundler باید gemها را در مسیر پیش‌فرض سیستم (\fBGem\.dir\fR) نصب کند یا خیر\. .TP \fBplugins\fR (\fBBUNDLE_PLUGINS\fR) فعال‌سازی سامانه آزمایشی افزایه‌های Bundler\. .TP \fBprefer_patch\fR (BUNDLE_PREFER_PATCH) ترجیح دادن به‌روزرسانی تنها به نسخه وصله (patch) بعدی هنگام به‌روزرسانی‌ها\. فراخوانی‌های \fBbundle update\fR را معادل \fBbundler update \-\-patch\fR می‌کند\. .TP \fBredirect\fR (\fBBUNDLE_REDIRECT\fR) تعداد تغییر مسیرهای مجاز برای درخواست‌های شبکه\. پیش‌فرض \fB5\fR است\. .TP \fBretry\fR (\fBBUNDLE_RETRY\fR) تعداد دفعات تلاش مجدد برای درخواست‌های ناموفق شبکه\. پیش‌فرض \fB3\fR است\. .TP \fBshebang\fR (\fBBUNDLE_SHEBANG\fR) نام برنامه‌ای که باید برای binstubهای تولیدشده فراخوانی شود\. مقدار پیش‌فرض نام برنامه نصب‌شده ruby است که برای تولید binstub استفاده شده است\..TP \fBsilence_deprecations\fR (\fBBUNDLE_SILENCE_DEPRECATIONS\fR) مشخص می‌کند که آیا Bundler باید هشدارهای منسوخ‌شدگی را برای رفتارهایی که در نسخهٔ اصلی (major) بعدی تغییر خواهند کرد، بی‌صدا کند یا خیر\. .TP \fBsilence_root_warning\fR (\fBBUNDLE_SILENCE_ROOT_WARNING\fR) بی‌صدا کردن هشداری که Bundler هنگام نصب gemها به عنوان کاربر ریشه (root) چاپ می‌کند\. .TP \fBsimulate_version\fR (\fBBUNDLE_SIMULATE_VERSION\fR) نسخهٔ مجازی‌ای که Bundler باید برای فعال‌سازی پرچم‌های ویژگی استفاده کند\. می‌تواند برای شبیه‌سازی تمام قابلیت‌های جدیدی که در یک نسخهٔ اصلی (major) آینده فعال خواهند شد استفاده شود\. .TP \fBssl_ca_cert\fR (\fBBUNDLE_SSL_CA_CERT\fR) مسیر به یک فایل گواهی CA مشخص یا پوشه‌ای حاوی چندین گواهی برای CAهای مورد اعتماد در قالب PEM\. .TP \fBssl_client_cert\fR (\fBBUNDLE_SSL_CLIENT_CERT\fR) مسیر به یک فایل مشخص حاوی گواهی کلاینت X\.509 و کلید در قالب PEM\. .TP \fBssl_verify_mode\fR (\fBBUNDLE_SSL_VERIFY_MODE\fR) حالت اعتبارسنجی SSL که Bundler هنگام برقراری درخواست‌های HTTPS استفاده می‌کند\. پیش‌فرض verify peer است\. .TP \fBsystem_bindir\fR (\fBBUNDLE_SYSTEM_BINDIR\fR) مسیری که RubyGems فایل‌های binstub را در آن نصب می‌کند\. پیش‌فرض \fBGem\.bindir\fR است\. .TP \fBtimeout\fR (\fBBUNDLE_TIMEOUT\fR) مدت‌زمان مجاز (به ثانیه) پیش از اتمام مهلت (timeout) درخواست‌های شبکه\. پیش‌فرض \fB10\fR است\. .TP \fBupdate_requires_all_flag\fR (\fBBUNDLE_UPDATE_REQUIRES_ALL_FLAG\fR) الزام ارسال \fB\-\-all\fR به \fBbundle update\fR هنگامی که قرار است همه‌چیز به‌روزرسانی شود، و ممنوع کردن اجرای \fBbundle update\fR بدون ارسال هیچ گزینه‌ای\. .TP \fBuser_agent\fR (\fBBUNDLE_USER_AGENT\fR) بخش سفارشی عامل کاربر (user agent) که Bundler در درخواست‌های API قرار می‌دهد\. .TP \fBverbose\fR (\fBBUNDLE_VERBOSE\fR) مشخص می‌کند که آیا Bundler باید خروجی پرجزئیات چاپ کند یا خیر\. پیش‌فرض \fBfalse\fR است، مگر اینکه پرچم خط فرمان \fB\-\-verbose\fR استفاده شود\. .TP \fBversion\fR (\fBBUNDLE_VERSION\fR) نسخه‌ای از Bundler که هنگام اجرا در محیط Bundler استفاده می‌شود\. پیش‌فرض \fBlockfile\fR است\. همچنین می‌توانید \fBsystem\fR یا \fBx\.y\.z\fR را مشخص کنید\. مقدار \fBlockfile\fR از نسخهٔ Bundler مشخص‌شده در \fBGemfile\.lock\fR استفاده خواهد کرد، \fBsystem\fR از نسخهٔ سیستمی Bundler استفاده می‌کند، و \fBx\.y\.z\fR از نسخهٔ مشخص‌شدهٔ Bundler استفاده خواهد کرد\. .TP \fBwith\fR (\fBBUNDLE_WITH\fR) فهرستی از گروه‌ها با جداکنندهٔ فاصله یا \fB:\fR که gemهای آن‌ها باید توسط bundler نصب شوند\. .TP \fBwithout\fR (\fBBUNDLE_WITHOUT\fR) فهرستی از گروه‌ها با جداکنندهٔ فاصله یا \fB:\fR که gemهای آن‌ها نباید توسط bundler نصب شوند\. .SH "گزینه‌های ساخت (BUILD OPTIONS)" می‌توانید از \fBbundle config\fR برای تعیین پرچم‌هایی استفاده کنید که Bundler هربار هنگام تلاش برای نصب یک gem خاص، آن‌ها را به نصاب gem منتقل می‌کند\. .P یک نمونه بسیار رایج، gem به نام \fBmysql\fR است که کاربران Snow Leopard را ملزم می‌کند پرچم‌های پیکربندی را به \fBgem install\fR ارسال کنند تا مشخص شود فایل اجرایی \fBmysql_config\fR در کجا قرار دارد\. .IP "" 4 .nf gem install mysql \-\- \-\-with\-mysql\-config=/usr/local/mysql/bin/mysql_config .fi .IP "" 0 .P از آن‌جا که مکان دقیق آن فایل اجرایی می‌تواند از سیستمی به سیستم دیگر متفاوت باشد، می‌توانید این پرچم‌ها را برای هر سیستم به طور مجزا مشخص کنید\. .IP "" 4 .nf bundle config set \-\-global build\.mysql \-\-with\-mysql\-config=/usr/local/mysql/bin/mysql_config .fi .IP "" 0 .P پس از اجرای این دستور، هربار که bundler نیاز به نصب gem به نام \fBmysql\fR داشته باشد، پرچم‌های مشخص‌شده را ارسال خواهد کرد\. .SH "مخازن محلی گیت (LOCAL GIT REPOS)" دستور Bundler همچنین به شما اجازه می‌دهد به‌جای استفاده از نسخهٔ دوردست (remote)، با یک مخزن git به صورت محلی کار کنید\. این کار با تنظیم یک بازنویسی محلی (local override) امکان‌پذیر است: .IP "" 4 .nf bundle config set \-\-local local\.GEM_NAME /path/to/local/git/repository .fi .IP "" 0 .P برای نمونه، جهت استفاده از یک مخزن محلی Rack، توسعه‌دهنده می‌تواند دستور زیر را اجرا کند: .IP "" 4 .nf bundle config set \-\-local local\.rack ~/Work/git/rack .fi .IP "" 0 .P اکنون به‌جای دریافت مخزن دوردست git، از بازنویسی محلی استفاده خواهد شد\. مشابه یک منبع مسیر (path source)، هر بار که مخزن محلی git تغییر کند، تغییرات به طور خودکار توسط Bundler دریافت و اعمال می‌شوند\. این بدان معناست که یک کامیت در مخزن محلی git، بازنگری (revision) موجود در \fBGemfile\.lock\fR را به بازنگری مخزن محلی git به‌روزرسانی می‌کند\. این فرایند نیازمند همان دقتی است که زیرماژول‌های git (git submodules) می‌طلبند\. پیش از push کردن به مخزن دوردست، باید اطمینان حاصل کنید که تغییرات بازنویسی محلی push شده است، در غیر این صورت ممکن است به کامیتی اشاره کنید که تنها در سیستم محلی شما وجود دارد\. همچنین لازم است نام‌های کاربری و گذرواژه‌های خود را نیز به شیوهٔ CGI کدگذاری (CGI escape) کنید\. .P برنامهٔ Bundler بررسی‌های متعددی انجام می‌دهد تا اطمینان یابد توسعه‌دهنده با ارجاعات نامعتبر کار نمی‌کند\. به‌ویژه، برای استفاده از این قابلیت، توسعه‌دهنده ملزم به مشخص کردن یک شاخه (branch) در \fBGemfile\fR است\. اگر شاخهٔ مشخص‌شده در \fBGemfile\fR با شاخهٔ جاری در مخزن محلی git مطابقت نداشته باشد، Bundler متوقف خواهد شد\. این امر تضمین می‌کند که توسعه‌دهنده همواره بر روی شاخه‌های صحیح کار می‌کند و از قفل شدن تصادفی بر روی یک شاخهٔ متفاوت جلوگیری می‌نماید\. .P در نهایت، Bundler همچنین بررسی می‌کند که بازنگری فعلی موجود در \fBGemfile\.lock\fR در مخزن محلی git وجود داشته باشد\. با این کار، Bundler شما را ملزم می‌کند تا آخرین تغییرات را از مخازن دوردست دریافت (fetch) کنید\..SH "آینه‌های منابع جم (MIRRORS OF GEM SOURCES)" ابزار Bundler از بازنویسی منابع gem با آینه‌ها (mirrors) پشتیبانی می‌کند\. این ویژگی به شما اجازه می‌دهد rubygems\.org را به عنوان منبع gem در Gemfile خود تنظیم کرده در حالی که همچنان از آینهٔ خود برای دریافت gemها استفاده می‌کنید\. .IP "" 4 .nf bundle config set \-\-global mirror\.SOURCE_URL MIRROR_URL .fi .IP "" 0 .P به عنوان مثال، برای استفاده از یک آینهٔ https://rubygems\.org که روی https://example\.org میزبانی می‌شود: .IP "" 4 .nf bundle config set \-\-global mirror\.https://rubygems\.org https://example\.org .fi .IP "" 0 .P هر آینه همچنین یک تنظیم مهلت بازگشت (fallback timeout) فراهم می‌کند\. اگر آینه در بازهٔ زمانی مهلت بازگشت پاسخ ندهد، Bundler تلاش خواهد کرد تا به جای آینه از سرور اصلی استفاده کند\. .IP "" 4 .nf bundle config set \-\-global mirror\.SOURCE_URL\.fallback_timeout TIMEOUT .fi .IP "" 0 .P به عنوان مثال، برای بازگشت به rubygems\.org پس از ۳ ثانیه: .IP "" 4 .nf bundle config set \-\-global mirror\.https://rubygems\.org\.fallback_timeout 3 .fi .IP "" 0 .P مهلت زمانی پیش‌فرض برای بازگشت 0\.1 ثانیه است، اما این تنظیم در حال حاضر فقط ثانیه‌های کامل (به عنوان مثال 1، 15، یا 30) را می‌پذیرد\. .SH "اطلاعات احراز هویت منابع جم (CREDENTIALS FOR GEM SOURCES)" ابزار Bundler به شما امکان می‌دهد اطلاعات احراز هویت (credentials) را برای هر منبع gem پیکربندی کنید، که این کار مانع از قرار دادن اطلاعات محرمانه در Gemfile شما می‌شود\. .IP "" 4 .nf bundle config set \-\-global SOURCE_HOSTNAME USERNAME:PASSWORD .fi .IP "" 0 .P به عنوان مثال، برای ذخیرهٔ اطلاعات احراز هویت کاربر \fBclaudette\fR برای منبع gem در \fBgems\.longerous\.com\fR، این دستور را اجرا می‌کنید: .IP "" 4 .nf bundle config set \-\-global gems\.longerous\.com claudette:s00pers3krit .fi .IP "" 0 .P یا می‌توانید اطلاعات احراز هویت را به عنوان یک متغیر محیطی به این صورت تنظیم کنید: .IP "" 4 .nf export BUNDLE_GEMS__LONGEROUS__COM="claudette:s00pers3krit" .fi .IP "" 0 .P برای gemهایی با یک منبع git همراه با نشانی HTTP(S)، می‌توانید اطلاعات احراز هویت را بدین صورت مشخص کنید: .IP "" 4 .nf bundle config set \-\-global https://github\.com/ruby/rubygems\.git username:password .fi .IP "" 0 .P یا می‌توانید اطلاعات احراز هویت را به صورت یک متغیر محیطی مانند زیر تنظیم کنید: .IP "" 4 .nf export BUNDLE_GITHUB__COM=username:password .fi .IP "" 0 .P این ویژگی به ویژه برای مخازن خصوصی روی میزبان‌هایی مانند GitHub کاربردی است، جایی که می‌توانید از توکن‌های شخصی OAuth استفاده کنید: .IP "" 4 .nf export BUNDLE_GITHUB__COM=abcd0123generatedtoken:x\-oauth\-basic .fi .IP "" 0 .P توجه داشته باشید که هرگونه اطلاعات احراز هویت پیکربندی‌شده توسط دستورهای اطلاع‌رسانی مانند \fBbundle config list\fR یا \fBbundle config get\fR سانسور (redact) خواهد شد، مگر اینکه از گزینهٔ \fB\-\-parseable\fR استفاده کنید\. این کار برای جلوگیری از افشای ناخواستهٔ اطلاعات احراز هویت هنگام کپی و جای‌گذاری خروجی bundler است\. .P همچنین توجه داشته باشید که برای تضمین یک نگاشت منطقی میان نام‌های معتبر متغیرهای محیطی و نام‌های معتبر میزبان، bundler دگرگونی‌های زیر را اعمال می‌کند: .IP "\(bu" 4 هر نویسهٔ \fB\-\fR در نام میزبان به سه خط زیرین متوالی (\fB___\fR) در متغیر محیطی متناظر نگاشت می‌شود\. .IP "\(bu" 4 هر نویسهٔ \fB\.\fR در نام میزبان به دو خط زیرین متوالی (\fB__\fR) در متغیر محیطی متناظر نگاشت می‌شود\. .IP "" 0 .P این بدان معناست که اگر یک سرور gem به نام \fBmy\.gem\-host\.com\fR دارید، باید از متغیر \fBBUNDLE_MY__GEM___HOST__COM\fR برای پیکربندی اطلاعات احراز هویت آن از طریق ENV استفاده کنید\..SH "پیکربندی دایرکتوری‌های BUNDLER (CONFIGURE BUNDLER DIRECTORIES)" دایرکتوری‌های خانه، کَش (cache) و پلاگین Bundler و فایل پیکربندی آن را می‌توان از طریق متغیرهای محیطی پیکربندی کرد\. مکان پیش‌فرض برای دایرکتوری خانهٔ Bundler مسیر \fB~/\.bundle\fR است که تمام دایرکتوری‌ها به‌طور پیش‌فرض از آن ارث‌بری می‌کنند\. موارد زیر متغیرهای محیطی موجود و مقادیر پیش‌فرض آن‌ها را نشان می‌دهد .IP "" 4 .nf 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 .fi .IP "" 0