| podman-save(1) | General Commands Manual | podman-save(1) |
نام (NAME)
podman-save - ذخیره یک یا چند ایمیج در یک فایل آرشیو یا دایرکتوری
خلاصه دستور (SYNOPSIS)
podman save [گزینهها] name[:tag]
podman image save [گزینهها] name[:tag]
توضیحات (DESCRIPTION)
دستور podman save یک ایمیج را در یک فایل محلی یا دایرکتوری ذخیره میکند. بهطور پیشفرض، podman save دادهها را در خروجی استاندارد (STDOUT) مینویسد و با استفاده از گزینه --output میتوان آن را به یک فایل هدایت کرد. با تنظیم گزینه --quiet، خروجی پیشرفت سرکوب میشود. دستور podman save لایههای والد ایمیج (ها) را ذخیره میکند و این ایمیجها میتوانند بعداً با استفاده از دستور podman load بارگذاری شوند. برای برونبری فایلسیستم کانتینرها، از دستور podman export استفاده کنید. توجه: نویسه : یک نویسه محدود شده است و نمیتواند بخشی از نام فایل خروجی باشد.
دستور podman save روی ایمیجها عمل میکند: آرشیو حاصل (از نوع OCI یا docker-archive) لایهها، تاریخچه و برچسبهای ایمیج را حفظ میکند و با دستور podman load دقیقاً به همان ایمیج بازیابی میشود. این عملکرد با podman export متفاوت است که سیستمفایل یک کانتینر را درون یک فایل فشرده tar تکلایهای بدون تاریخچه ایمیج یکپارچه (flatten) میکند. برای ذخیره سیستمفایل یک کانتینر، به podman-export(1) مراجعه کنید.
گزینهها (OPTIONS)
--compress
فشردهسازی لایههای آرشیو tar ایمیج هنگام ارسال به یک دایرکتوری با استفاده از ترنسپورت 'dir'. (پیشفرض همان نوع فشردهسازی مبدأ است؛ فشرده یا غیرفشرده).
توجه: این گزینه تنها همراه با --format=docker-dir قابل استفاده است.
--format=format
قالب ایمیج خروجی جهت تولید، که یکی از موارد زیر است:
| قالب | توضیحات |
| docker-archive | یک آرشیو tar سازگار با docker load(1) (پیشفرض) |
| oci-archive | یک آرشیو tar با استفاده از قالب ایمیج OCI |
| oci-dir | یک دایرکتوری با استفاده از قالب ایمیج OCI |
| docker-dir | ترنسپورت dir (نگاه کنید به containers-transports(5)) با مانیفست نسخه v2s2 |
توجه: قالبهای oci-dir و docker-dir در کلاینتهای راه دور پودمن (شامل macOS و Windows، به استثنای WSL2) با دستور podman load قابل بارگذاری نیستند.
--help, -h
نمایش راهنمای استفاده از دستور
--multi-image-archive, -m
امکان ایجاد آرشیوهای حاوی بیش از یک ایمیج. نامهای اضافی بهجای برچسب (tag) به عنوان ایمیج تفسیر میشوند. این گزینه فقط برای --format=docker-archive پشتیبانی میشود. مقدار پیشفرض این گزینه را میتوان از طریق فلگ multi_image_archive="true"|"false" در فایل containers.conf تغییر داد.
--output, -o=file
نوشتن خروجی در یک فایل، پیشفرض STDOUT است.
--quiet, -q
سرکوب خروجی و عدم نمایش روند پیشرفت
--uncompressed
پذیرش لایههای فشردهنشده هنگام استفاده از یکی از قالبهای OCI.
مثالها (EXAMPLES)
ذخیره ایمیج در یک فایل محلی بدون نمایش روند پیشرفت:
$ podman save --quiet -o alpine.tar alpine:2.6
ذخیره ایمیج در stdout و تغییر مسیر محتوا از طریق شل:
$ podman save alpine > alpine-all.tar
ذخیره ایمیج در قالب oci-archive در یک فایل محلی:
$ podman save -o oci-alpine.tar --format oci-archive alpine
ذخیره فشرده ایمیج در قالب docker-dir:
$ podman save --compress --format docker-dir -o alp-dir alpine Getting image source signatures Copying blob sha256:2fdfe1cd78c20d05774f0919be19bc1a3e4729bce219968e4188e7e0f1af679d 1.97 MB / 1.97 MB [========================================================] 0s Copying config sha256:501d1a8f0487e93128df34ea349795bc324d5e0c0d5112e08386a9dfaff620be 584 B / 584 B [============================================================] 0s Writing manifest to image destination Storing signatures
همچنین ببینید (SEE ALSO)
podman(1), podman-load(1), containers.conf(5), containers-transports(5)
تاریخچه (HISTORY)
ژوئیه ۲۰۱۷، در ابتدا توسط Urvashi Mohnani umohnani@redhat.com گردآوری شد ⟨mailto:umohnani@redhat.com⟩