mirror of
https://github.com/containers/podman.git
synced 2025-11-29 01:28:22 +08:00
95 lines
2.7 KiB
Markdown
95 lines
2.7 KiB
Markdown
% 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.opencontainers.image.created` annotation using RFC3339Nano format. When using
|
|
the `--append` option, the original creation timestamp is preserved.
|
|
|
|
|
|
## OPTIONS
|
|
|
|
@@option annotation.manifest
|
|
|
|
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.1.md)**, **[podman-artifact(1)](podman-artifact.1.md)**
|
|
|
|
## HISTORY
|
|
Jan 2025, Originally compiled by Brent Baude <bbaude@redhat.com>
|