31 lines
1.5 KiB
Markdown
31 lines
1.5 KiB
Markdown
# Image Inspect CLI Command
|
|
|
|
## Module
|
|
Cli
|
|
|
|
## Status
|
|
IMPLEMENTED
|
|
|
|
## Description
|
|
CLI command `stella image inspect` for querying OCI image metadata including manifest type, architecture platforms, layer digests, annotations, and SBOM/attestation referrers in table or JSON output.
|
|
|
|
## Implementation Details
|
|
- **Command Group**: `src/Cli/StellaOps.Cli/Commands/ImageCommandGroup.cs` -- `ImageCommandGroup` for `stella image` commands
|
|
- **Command Handlers**: `src/Cli/StellaOps.Cli/Commands/CommandHandlers.Image.cs` -- image command handlers
|
|
- **OCI Registry Client**: `src/Cli/StellaOps.Cli/Services/OciRegistryClient.cs` / `IOciRegistryClient.cs` -- OCI registry operations
|
|
- **OCI Reference Parser**: `src/Cli/StellaOps.Cli/Services/OciImageReferenceParser.cs` -- parses image references
|
|
- **Tests**: `src/Cli/__Tests/StellaOps.Cli.Tests/GoldenOutput/ImageInspectGoldenOutputTests.cs`
|
|
- **Commands**:
|
|
- `stella image inspect <image>` -- inspect OCI image metadata. Options: `--format table|json`, `--verbose`
|
|
- Shows: manifest type, architecture platforms, layer digests, annotations, referrers (SBOMs, attestations)
|
|
|
|
## E2E Test Plan
|
|
- [ ] Run `stella image inspect myregistry/app:v1.0` and verify metadata displayed
|
|
- [ ] Verify manifest type shown (OCI, Docker)
|
|
- [ ] Verify architecture platforms listed (linux/amd64, linux/arm64, etc.)
|
|
- [ ] Verify layer digests displayed with sizes
|
|
- [ ] Verify annotations shown
|
|
- [ ] Verify SBOM/attestation referrers listed
|
|
- [ ] Run with `--format json` and verify structured JSON output
|
|
- [ ] Verify golden output tests pass
|