Docs feedback: Show CI Variable Path for verification examples
Problem to solve
Here the path given for verifications are literal examples and do not equate to known GitLab CI Vars. The portion @refpath specifically.
Here is the path given:
cosign verify-blob artifact.txt --bundle cosign.bundle --certificate-identity "https://gitlab.com/my-group/my-project//path/to/.gitlab-ci.yml@refs/heads/main" --certificate-oidc-issuer "https://gitlab.com"
But changing it to this does not work:
cosign verify-blob artifact.txt --bundle cosign.bundl --certificate-identity "${CI_PROJECT_URL}/.gitlab-ci.yml@refs/heads/${CI_COMMIT_REF_NAME}" --certificate-oidc-issuer "${CI_SERVER_URL}"
Further details
Proposal
It would be helpful to either provide only the variablized version or both, like this:
cosign verify-blob artifact.txt --bundle cosign.bundl --certificate-identity "${CI_PROJECT_URL}/.gitlab-ci.yml@refs/heads/${CI_COMMIT_REF_NAME}" --certificate-oidc-issuer "${CI_SERVER_URL}"
#which will resolve to something like: cosign verify-blob artifact.txt --bundle cosign.bundle --certificate-identity "https://gitlab.com/my-group/my-project//path/to/.gitlab-ci.yml@refs/heads/main" --certificate-oidc-issuer "https://gitlab.com"
Who can address the issue
Other links/references
Link the doc and describe what is wrong with it.