نام (NAME)

podman-artifact-extract - استخراج یک آرتیفکت OCI به یک مسیر محلی

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

podman artifact extract artifact target

توضیحات (DESCRIPTION)

استخراج بلاب‌های (blobs) یک آرتیفکت OCI به یک فایل یا دایرکتوری محلی.

اگر مسیر مقصد یک فایل باشد یا وجود نداشته باشد، آرتیفکت باید شامل تنها یک بلاب (لایه) باشد، یا اگر دارای چندین بلاب (لایه) است باید از گزینه --digest یا --title برای انتخاب تنها یک بلاب منفرد استفاده شود. اگر فایل از قبل وجود داشته باشد، بازنویسی خواهد شد.

اگر مقصد یک دایرکتوری باشد (باید از قبل وجود داشته باشد)، تمام بلاب‌ها به دایرکتوری مقصد کپی خواهند شد. مقدار حاشیه‌نویسی (annotation) org.opencontainers.image.title به عنوان نام فایل مقصد استفاده می‌شود. در صورتی که این حاشیه‌نویسی وجود نداشته باشد، نام فایل مقصد برابر با دایجست (digest) بلاب خواهد بود (که در نام آن : با - جایگزین می‌شود). اگر فایل مقصد از قبل در دایرکتوری وجود داشته باشد، بازنویسی خواهد شد.

گزینه‌ها (OPTIONS)

مثال‌ها (EXAMPLES)

استخراج یک آرتیفکت با یک بلاب منفرد

$ podman artifact extract quay.io/artifact/foobar1:test /tmp/myfile

استخراج یک آرتیفکت با چندین بلاب

$ podman artifact extract quay.io/artifact/foobar2:test /tmp/mydir
$ ls /tmp/mydir
CONTRIBUTING.md  README.md

استخراج تنها یک بلاب از یک آرتیفکت با چندین بلاب

$ podman artifact extract --title README.md quay.io/artifact/foobar2:test /tmp/mydir
$ ls /tmp/mydir
README.md

یا استفاده از دایجست به جای عنوان

$ podman artifact extract --digest sha256:c0594e012b17fd9e6548355ceb571a79613f7bb988d7d883f112513601ac6e9a quay.io/artifact/foobar2:test /tmp/mydir
$ ls /tmp/mydir
README.md

همچنین ببینید (SEE ALSO)

podman(1), podman-artifact(1)

تاریخچه (HISTORY)

فوریه ۲۰۲۵، در ابتدا توسط پائول هولتسینگر (Paul Holzinger pholzing@redhat.com) گردآوری شد ⟨mailto:pholzing@redhat.com⟩