OSTREE PULL(1) ostree pull OSTREE PULL(1)

ostree-pull - بارگیری داده‌ها از یک مخزن دوردست

ostree pull {REMOTE} [BRANCH]

--commit-metadata-only

تنها متاداده‌های کامیت را واکشی می‌کند.

--cache-dir=DIR

استفاده از یک پوشه کش جایگزین در DIR.

--disable-fsync

عدم فراخوانی fsync().

--localcache-repo

مانند clone --reference در git'. هنگام دریافت با HTTP، از مخزن OSTree داده‌شده به‌عنوان کش محلی شیء مجدداً استفاده می‌کند. می‌تواند چندین بار مشخص شود.

--untrusted

به منابع محلی اعتماد نمی‌کند، چکسام‌ها را بررسی کرده و به منبع پیوند سخت ایجاد نمی‌کند.

--disable-static-deltas

از دلتاهای ایستا (static deltas) استفاده نمی‌کند.

--mirror

ارجاع‌ها (refs) را مناسب برای یک نسخه آینه‌ای (mirror) می‌نویسد؛ یعنی ارجاع‌ها به‌جای پوشه remotes/ در پوشه heads/ ذخیره می‌شوند. این کار مخزن مقصد را برای ارائه به دیگر کلاینت‌ها جهت دریافت به‌عنوان یک ریموت ostree مناسب می‌سازد. اگر ارجاع خاصی مشخص نشود، تمام ارجاع‌ها واکشی خواهند شد (ریموت باید دارای یک فایل summary باشد).

--subpath=SUBPATH

تنها زیرمسیر ارائه‌شده را دریافت می‌کند.

--depth=DEPTH

پیمایش DEPTH والد (-1=بی‌نهایت) (پیش‌فرض: 0).

--network-retries=N

تعداد دفعاتی که دریافت هر بار پس از بروز خطا باید مجدداً تلاش شود را تعیین می‌کند (پیش‌فرض: 5).

--disable-retry-on-network-errors

در زمان بروز خطاهای شبکه مجدداً تلاش نمی‌کند، بلکه بلافاصله ناموفق می‌شود. (در حال حاضر تنها بر libcurl اثر می‌گذارد)

--low-speed-limit-bytes=N

میانگین سرعت انتقال بر حسب بایت در ثانیه در طول زمان تعیین‌شده با 'low-speed-time-seconds' تا libcurl عملیات را لغو کند (پیش‌فرض: 1000).

--low-speed-time-seconds=N

مدت‌زمان بر حسب ثانیه که سرعت انتقال باید پایین‌تر از تنظیم 'low-speed-limit-bytes' بماند تا libcurl عملیات را متوقف کند (پیش‌فرض: 30).

--max-outstanding-fetcher-requests=N

حداکثر تعداد مجاز اتصالات همزمان. (پیش‌فرض: 8)

--disable-verify-bindings

غیرفعال‌سازی بررسی پیوندهای متاداده کامیت.

بدون گزینه --mirror ، این دستور مراجع جدیدی در پوشه remotes/REMOTE/ برای هر شاخه دریافت شده ایجاد خواهد کرد مگر آنکه از قبل ایجاد شده باشند. چنین ارجاع‌هایی سپس می‌توانند با REMOTE:BRANCH در زیردستورهای ostree مورد استفاده قرار گیرند (برای نمونه ostree log origin:exampleos/x86_64/standard).

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

یک ساختار نحوی ویژه با نویسه @ امکان مشخص‌کردن یک کامیت خاص برای دریافت از یک شاخه را فراهم می‌کند. موارد کاربرد این قابلیت تا حدی شبیه به دریافت یک تگ خاص در git است؛ به‌عنوان مثال می‌توان اسکریپتی برای ارتقای سیستم به یک نسخه مطمئن مشخص نوشت، به‌جای دریافت آخرین نسخه از سوی ارائه‌دهنده محتوا.

$ ostree --repo=repo pull --depth=-1 --mirror remote_name

انجام یک آینه‌سازی کامل از مخزن دوردست. (این حالت بیشتر زمانی سودمند است که مخزن شما نیز در حالت archive باشد)

$ ostree --repo=repo pull remote_name exampleos/x86_64/standard

واکشی جدیدترین کامیت در exampleos/x86_64/standard.

$ ostree --repo=repo pull remote_name exampleos/x86_64/standard@98ea6e4f216f2fb4b69fff9b3a44842c38686ca685f3f55dc48c5d3fb1107be4

بارگیری کامیت خاصی که با 98ea6e آغاز می‌شود، درست مانند اینکه آخرین کامیت برای exampleos/x86_64/standard بوده است.

OSTree