podman/podman-artifact.1.md at 2455ac327d9ab42c8df890a99cc491549bd64ebd

mirror of https://github.com/containers/podman.git synced 2025-10-16 10:43:52 +08:00

Files

Daniel J Walsh b765c91580 Add --replace option to podman artifact add command

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>

2025-10-06 12:22:40 -04:00

1.7 KiB

Raw Blame History

% 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)	Add an OCI artifact to local artifact store
extract	podman-artifact-extract(1)	Extract an OCI artifact to a local path
inspect	podman-artifact-inspect(1)	Inspect an OCI artifact
ls	podman-artifact-ls(1)	List OCI artifacts in local store
pull	podman-artifact-pull(1)	Pulls an artifact from a registry and stores it locally
push	podman-artifact-push(1)	Push an OCI artifact from local storage to an image registry
rm	podman-artifact-rm(1)	Remove one or more OCI artifacts from local storage

HISTORY

Sept 2024, Originally compiled by Brent Baude bbaude@redhat.com

1.7 KiB Raw Blame History