mirror of
https://github.com/containers/podman.git
synced 2025-10-14 17:55:51 +08:00
4764b0e403
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>
39 lines
965 B
Markdown
39 lines
965 B
Markdown
% 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:
|
|
|
|
1. Fully qualified artifact name
|
|
2. 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
|
|
```
|
|
|
|
## SEE ALSO
|
|
**[podman(1)](podman.1.md)**, **[podman-artifact(1)](podman-artifact.1.md)**
|
|
|
|
## HISTORY
|
|
Sept 2024, Originally compiled by Brent Baude <bbaude@redhat.com>
|