Skip to content

Commit fca188e

Browse files
docs: clarify <tag> in attestation verify command
Explain that <tag> is the Docker image tag (no v prefix) and document where to find it. Also collapse the example command onto one line so it copy-pastes on Windows and macOS shells. UID2-6764 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 94216e2 commit fca188e

1 file changed

Lines changed: 9 additions & 4 deletions

File tree

README.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -74,12 +74,17 @@ Every non-snapshot image published by this repo's release workflow ships with a
7474
To verify an image, install [`gh`](https://cli.github.com/) (≥ 2.49) and run:
7575
7676
```bash
77-
gh attestation verify \
78-
oci://ghcr.io/iabtechlab/uid2-operator:<tag> \
79-
--owner IABTechLab \
80-
--signer-repo IABTechLab/uid2-shared-actions
77+
gh attestation verify oci://ghcr.io/iabtechlab/uid2-operator:<tag> --owner IABTechLab --signer-repo IABTechLab/uid2-shared-actions
8178
```
8279

80+
`<tag>` refers to the **Docker image tag** — bare semantic version, no `v` prefix (e.g. `5.70.84`). Note that the corresponding GitHub release and git tag for the same build are named with a `v` (e.g. `v5.70.84`); the registry tag drops it by OCI convention.
81+
82+
**Where to find a tag:**
83+
84+
- **GitHub Packages** for this repo — [`uid2-operator` package](https://github.com/IABTechLab/uid2-operator/pkgs/container/uid2-operator) lists every published image tag and its digest.
85+
- Or take a [release](https://github.com/IABTechLab/uid2-operator/releases) name (e.g. `v5.70.84`) and drop the leading `v`.
86+
- To pin to an exact manifest instead of a mutable tag, use the digest form: `oci://ghcr.io/iabtechlab/uid2-operator@sha256:<digest>` (visible on the Packages page, or via `gh api /orgs/IABTechLab/packages/container/uid2-operator/versions`).
87+
8388
A successful run prints `✓ Verification succeeded!` followed by the SLSA provenance fields — including `sourceRepositoryDigest` (the source commit), `workflow.path` (the signing workflow), and the runner identity.
8489

8590
Snapshot tags (`-SNAPSHOT` suffix) deliberately skip attestation. `gh attestation verify` returns `no attestations found` against a snapshot — that's expected.

0 commit comments

Comments
 (0)