mirror of
https://github.com/containers/podman.git
synced 2025-08-06 03:19:52 +08:00
d7553fabc7
the podman artifact verb is used to manage OCI artifacts. the following verbs were added to `podman artifact`: * add * inspect * ls * pull * push * rm Notable items with this PR: * all artifact commands and their output are subject to change. i.e. consider all of this tech preview * there is no way to add a file to an artifact that already exists in the store. you would need to delete and recreate the artifact. * all references to artifacts names should be fully qualified names in the form of repo/name:tag (i.e. quay.io/artifact/foobar:latest) * i understand that we will likely want to be able to attribute things like arch, etc to artifact files. this function is not available yet. Many thanks to Paul Holzinger for autocompletion PRs and review PRs that fixed issues early on. Also fix up some Args function to specify the correct number of args. Signed-off-by: Paul Holzinger <pholzing@redhat.com> Signed-off-by: Brent Baude <bbaude@redhat.com>
76 lines
1.6 KiB
Markdown
76 lines
1.6 KiB
Markdown
% podman-artifact-pull 1
|
|
|
|
|
|
## WARNING: Experimental command
|
|
*This command is considered experimental and still in development. Inputs, options, and outputs are all
|
|
subject to change.*
|
|
|
|
## NAME
|
|
podman\-artifact\-pull - Pulls an artifact from a registry and stores it locally
|
|
|
|
## SYNOPSIS
|
|
**podman artifact pull** [*options*] *source*
|
|
|
|
|
|
## DESCRIPTION
|
|
podman artifact pull copies an artifact from a registry onto the local machine.
|
|
|
|
|
|
## SOURCE
|
|
SOURCE is the location from which the artifact image is obtained.
|
|
|
|
```
|
|
# Pull from a registry
|
|
$ podman artifact pull quay.io/foobar/artifact:special
|
|
```
|
|
|
|
## OPTIONS
|
|
|
|
@@option authfile
|
|
|
|
@@option cert-dir
|
|
|
|
@@option creds
|
|
|
|
@@option decryption-key
|
|
|
|
|
|
#### **--help**, **-h**
|
|
|
|
Print the usage statement.
|
|
|
|
#### **--quiet**, **-q**
|
|
|
|
Suppress output information when pulling images
|
|
|
|
@@option retry
|
|
|
|
@@option retry-delay
|
|
|
|
@@option tls-verify
|
|
|
|
## FILES
|
|
|
|
## EXAMPLES
|
|
Pull an artifact from a registry
|
|
|
|
```
|
|
podman artifact pull quay.io/baude/artifact:josey
|
|
Getting image source signatures
|
|
Copying blob e741c35a27bb done |
|
|
Copying config 44136fa355 done |
|
|
Writing manifest to image destination
|
|
|
|
```
|
|
|
|
## SEE ALSO
|
|
**[podman(1)](podman.1.md)**, **[podman-artifact(1)](podman-artifact.1.md)**, **[podman-login(1)](podman-login.1.md)**, **[containers-certs.d(5)](https://github.com/containers/image/blob/main/docs/containers-certs.d.5.md)**
|
|
|
|
### Troubleshooting
|
|
|
|
See [podman-troubleshooting(7)](https://github.com/containers/podman/blob/main/troubleshooting.md)
|
|
for solutions to common issues.
|
|
|
|
## HISTORY
|
|
Jan 2025, Originally compiled by Brent Baude <bbaude@redhat.com>
|