spiegel_podman/docs/source
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
..
_static Show API doc for several versions 2022-02-09 18:17:52 +01:00
locale/ja/LC_MESSAGES Improve documentation wording 2025-08-20 17:23:40 +02:00
markdown Add creation timestamp to podman artifacts 2025-09-25 08:39:28 -04:00
Commands.rst Initial implementation of podman quadlet commands 2025-07-18 13:57:11 -07:00
conf.py docs: update read the docs changes 2024-08-30 11:57:58 +02:00
includes.rst [CI:DOCS] Fix GitHub URL to Podman logo 2021-07-21 11:22:01 -04:00
index.rst [CI:DOCS] Add link to podman py docs 2023-11-17 07:18:59 -05:00
Introduction.rst docs: delete the duplicated phrase in introduction page 2025-04-03 15:32:45 +05:30
Reference.rst docs: add v5.4 to API reference 2025-02-11 14:05:00 +01:00
Search.rst [CI:DOCS] Docs revamp. 2020-05-21 17:16:10 -04:00
Tutorials.rst fix typo in Tutorials.rst 2024-05-23 16:15:40 +01:00