podman-build/docs/build/man/podman-artifact-add.1
2025-10-11 12:30:35 +09:00

76 lines
1.8 KiB
Groff

.nh
.TH podman-artifact-add 1
.SH NAME
podman-artifact-add \- Add an OCI artifact to the local store
.SH SYNOPSIS
\fBpodman artifact add\fP \fIname\fP \fIfile\fP [\fIfile\fP]...
.SH DESCRIPTION
Add an OCI artifact to the local store from the local filesystem. You must
provide at least one file to create the artifact, but several can also be
added.
.SH OPTIONS
.SS \fB--annotation\fP=\fIannotation=value\fP
Set an annotation on the entry for the specified image or artifact.
.PP
Note: Set annotations for each file being added.
.SS \fB--append\fP, \fB-a\fP
Append files to an existing artifact. This option cannot be used with the \fB--type\fP option.
.SS \fB--file-type\fP
Set the media type of the artifact file instead of allowing detection to determine the type
.SS \fB--help\fP
Print usage statement.
.SS \fB--type\fP
Set a type for the artifact being added.
.SH EXAMPLES
Add a single file to an artifact
.EX
$ podman artifact add quay.io/myartifact/myml:latest /tmp/foobar.ml
0fe1488ecdef8cc4093e11a55bc048d9fc3e13a4ba846efd24b5a715006c95b3
.EE
.PP
Add multiple files to an artifact
.EX
$ podman artifact add quay.io/myartifact/myml:latest /tmp/foobar1.ml /tmp/foobar2.ml
1487acae11b5a30948c50762882036b41ac91a7b9514be8012d98015c95ddb78
.EE
.PP
Set an annotation for an artifact
.EX
$ podman artifact add --annotation date=2025-01-30 quay.io/myartifact/myml:latest /tmp/foobar1.ml
.EE
.PP
Append a file to an existing artifact
.EX
$ podman artifact add --append quay.io/myartifact/tarballs:latest /tmp/foobar.tar.gz
.EE
.PP
Override the media type of the artifact being added
.EX
$ podman artifact add --file-type text/yaml quay.io/myartifact/descriptors:latest /tmp/info.yaml
.EE
.SH SEE ALSO
\fBpodman(1)\fP, \fBpodman-artifact(1)\fP
.SH HISTORY
Jan 2025, Originally compiled by Brent Baude bbaude@redhat.com
\[la]mailto:bbaude@redhat.com\[ra]