mirror of
https://github.com/containers/podman.git
synced 2025-11-28 17:18:58 +08:00
b765c91580
This commit implements the --replace functionality for the artifact add command, allowing users to replace existing artifacts without having to manually remove them first. Changes made: - Add Replace field to ArtifactAddOptions entity types - Add --replace CLI flag with validation to prevent conflicts with --append - Implement replace logic in ABI backend to remove existing artifacts before adding - Update API handlers and tunnel implementation for podman-remote support - Add comprehensive documentation and examples to man page - Add e2e and system BATS tests for --replace functionality - Fix code formatting in pkg/bindings/artifacts/types_pull_options.go: * Reorder imports with proper spacing * Fix function declaration spacing * Convert spaces to proper tab indentation * Remove extraneous blank lines The --replace option follows the same pattern as other podman replace options like 'podman container create --replace' and 'podman pod create --replace'. It gracefully handles cases where no existing artifact exists (no error thrown). Usage examples: podman artifact add --replace quay.io/myimage/artifact:latest /path/to/file podman artifact add --replace localhost/test/artifact /tmp/newfile.txt Fixes: Implements requested --replace functionality for artifact add command Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
34 lines
1.7 KiB
Markdown
34 lines
1.7 KiB
Markdown
% podman-artifact 1
|
|
|
|
## NAME
|
|
podman\-artifact - Manage OCI artifacts
|
|
|
|
## SYNOPSIS
|
|
**podman artifact** *subcommand*
|
|
|
|
## DESCRIPTION
|
|
`podman artifact` is a set of subcommands that manage OCI artifacts.
|
|
|
|
OCI artifacts are a common way to distribute files that are associated with OCI images and
|
|
containers. Podman is capable of managing (pulling, inspecting, pushing) these artifacts
|
|
from its local "artifact store".
|
|
|
|
## SUBCOMMANDS
|
|
|
|
| Command | Man Page | Description |
|
|
|---------|------------------------------------------------------------|--------------------------------------------------------------|
|
|
| add | [podman-artifact-add(1)](podman-artifact-add.1.md) | Add an OCI artifact to local artifact store |
|
|
| extract | [podman-artifact-extract(1)](podman-artifact-extract.1.md) | Extract an OCI artifact to a local path |
|
|
| inspect | [podman-artifact-inspect(1)](podman-artifact-inspect.1.md) | Inspect an OCI artifact |
|
|
| ls | [podman-artifact-ls(1)](podman-artifact-ls.1.md) | List OCI artifacts in local store |
|
|
| pull | [podman-artifact-pull(1)](podman-artifact-pull.1.md) | Pulls an artifact from a registry and stores it locally |
|
|
| push | [podman-artifact-push(1)](podman-artifact-push.1.md) | Push an OCI artifact from local storage to an image registry |
|
|
| rm | [podman-artifact-rm(1)](podman-artifact-rm.1.md) | Remove one or more OCI artifacts from local storage |
|
|
|
|
|
|
## SEE ALSO
|
|
**[podman(1)](podman.1.md)**
|
|
|
|
## HISTORY
|
|
Sept 2024, Originally compiled by Brent Baude <bbaude@redhat.com>
|