Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
podman-artifact-add(1)	    General Commands Manual	podman-artifact-add(1)

NAME
       podman-artifact-add - Add an OCI	artifact to local artifact store

SYNOPSIS
       podman artifact add [options] artifact-name file	[file ...]

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.

       Artifacts  automatically	 include a creation timestamp in the org.open-
       containers.image.created	annotation using RFC3339Nano format. When  us-
       ing the --append	option,	the original creation timestamp	is preserved.

OPTIONS
   --annotation=annotation=value
       Set an annotation on the	entry for the specified	image or artifact.

       Note:  Set  annotations	for  each  file	 being	added.	The annotation
       "org.opencontainers.image.title"	is used	to name	the layer when mounted
       into a container, this title must be unigue for each artifact layer.

   --append, -a
       Append files to an existing artifact. This option cannot	be  used  with
       the --type option.

   --file-type
       Set  the	 media type of the artifact file instead of allowing detection
       to determine the	type

   --help
       Print usage statement.

   --replace
       If an artifact with the same name already exists,  replace  and	remove
       it. The default is false.  This option cannot be	used with the --append
       option.

   --type
       Set a type for the artifact being added.

EXAMPLES
       Add a single file to an artifact

       $ podman	artifact add quay.io/myartifact/myml:latest /tmp/foobar.ml
       0fe1488ecdef8cc4093e11a55bc048d9fc3e13a4ba846efd24b5a715006c95b3

       Add OCI artifact	to the store with type:

       $ podman	artifact add --artifact-type application/com.example.ai	--file-type application/vnd.gguf quay.io/myimage/myartifact:latest /home/user/model.gguf

       Replace an existing artifact with the same name

       $ podman	artifact add quay.io/myartifact/myml:latest /tmp/foobar.ml
       0fe1488ecdef8cc4093e11a55bc048d9fc3e13a4ba846efd24b5a715006c95b3

       Add multiple files to an	artifact

       $ podman	artifact add quay.io/myartifact/myml:latest /tmp/foobar1.ml /tmp/foobar2.ml
       1487acae11b5a30948c50762882036b41ac91a7b9514be8012d98015c95ddb78

       Add files to an existing	OCI artifact

       $ podman	artifact add --append quay.io/myimage/myartifact:latest	/home/user/config.yaml

       Create  artifact	 with  the  layer  title name being replaced, and then
       mount into a container.

       podman artifact add --annotation	org.opencontainers.image.title=smollm2 quay.io/myreg/smollm2:latest blobs/sha256-4d2396b16114669389d7555c15a1592aad584750310f648edad5ca8c4eccda17
       podman run --mount type=artifact,source=quay.io/myreg/smollm2:latest,destination=/mnt fedora ls -l /mnt
       smollm2

SEE ALSO
       podman(1), podman-artifact(1)

HISTORY
       Jan  2025,  Originally  compiled	 by  Brent   Baude   bbaude@redhat.com
       <mailto:bbaude@redhat.com>

							podman-artifact-add(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-artifact-add&sektion=1&manpath=FreeBSD+Ports+15.0.quarterly>

home | help