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>
72 lines
1.9 KiB
Markdown
72 lines
1.9 KiB
Markdown
% podman-artifact-push 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\-push - Push an OCI artifact from local storage to an image registry
|
|
|
|
## SYNOPSIS
|
|
**podman artifact push** [*options*] *image*
|
|
|
|
## DESCRIPTION
|
|
Pushes an artifact from the local artifact store to an image registry.
|
|
|
|
```
|
|
# Push artifact to a container registry
|
|
$ podman artifact push quay.io/artifact/foobar1:latest
|
|
```
|
|
|
|
## OPTIONS
|
|
|
|
@@option authfile
|
|
|
|
@@option cert-dir
|
|
|
|
@@option creds
|
|
|
|
@@option digestfile
|
|
|
|
#### **--quiet**, **-q**
|
|
|
|
When writing the output image, suppress progress output
|
|
|
|
@@option retry
|
|
|
|
@@option retry-delay
|
|
|
|
#### **--sign-by**=*key*
|
|
|
|
Add a “simple signing” signature at the destination using the specified key. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)
|
|
|
|
@@option sign-by-sigstore
|
|
|
|
|
|
#### **--sign-by-sigstore-private-key**=*path*
|
|
|
|
Add a sigstore signature at the destination using a private key at the specified path. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)
|
|
|
|
@@option sign-passphrase-file
|
|
|
|
@@option tls-verify
|
|
|
|
## EXAMPLE
|
|
|
|
Push the specified iage to a container registry:
|
|
```
|
|
$ podman artifact push quay.io/baude/artifact:single
|
|
Getting image source signatures
|
|
Copying blob 3ddc0a3cdb61 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-pull(1)](podman-pull.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)**
|
|
|
|
|
|
## HISTORY
|
|
Jan 2025, Originally compiled by Brent Baude <bbaude@redhat.com>
|