podman/podman-artifact-inspect.1.md at c11941eadbac1bf21ee4d9c61ea768a788b13aac

mirror of https://github.com/containers/podman.git synced 2025-10-13 01:06:10 +08:00

Files

Daniel J Walsh 4764b0e403 Add creation timestamp to podman artifacts

This commit implements automatic creation timestamp functionality for artifacts
as requested in GitHub issue #27081, allowing users to see when artifacts were created.

Changes made:
- Add org.opencontainers.image.created annotation with Unix nanoseconds timestamp during artifact creation
- Preserve original creation timestamp when using --append option
- Update artifact inspect and add man pages to document the new functionality
- Add comprehensive e2e and system BATS tests to verify creation timestamp behavior
- Store timestamp as integer (Unix nanoseconds) for programmatic access

The creation timestamp helps users understand artifact freshness, particularly
useful for AI models and other time-sensitive artifacts managed by tools like RamaLama.

Usage examples:
  podman artifact add myartifact:latest /path/to/file     # Creates with timestamp
  podman artifact inspect myartifact:latest              # Shows created annotation as integer
  podman artifact add --append myartifact:latest /file2  # Preserves original timestamp

Fixes: https://github.com/containers/podman/issues/27081
Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>

2025-09-25 08:39:28 -04:00

965 B

Raw Blame History

% podman-artifact-inspect 1

NAME

podman-artifact-inspect - Inspect an OCI artifact

SYNOPSIS

podman artifact inspect [name] ...

DESCRIPTION

Inspect an artifact in the local store and output the results in JSON format. The artifact can be referred to with either:

Fully qualified artifact name
Full or partial digest of the artifact's manifest

The inspect output includes the artifact manifest with annotations. All artifacts automatically include a creation timestamp in the org.opencontainers.image.created annotation using RFC3339Nano format, showing when the artifact was initially created.

OPTIONS

--help

Print usage statement.

EXAMPLES

Inspect an OCI image in the local store.

$ podman artifact inspect quay.io/myartifact/myml:latest

HISTORY

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

965 B Raw Blame History