Notation is a project to add signatures as standard items in the registry ecosystem, and to build a set of simple tooling for signing and verifying these signatures. This should be viewed as similar security to checking git commit signatures, although the signatures are generic and can be used for additional purposes. Notation is an implementation of the Notary V2 specifications.
- Notation Quick Start
- Contributing
- Core Documents
- Community
- Release Management
- Support
- Code of Conduct
- License
-
Install the Notation CLI from Notation Releases
curl -Lo notation.tar.gz https://github.com/notaryproject/notation/releases/download/v0.9.0-alpha.1/notation_0.9.0-alpha.1_linux_amd64.tar.gz tar xvzf notation.tar.gz -C ~/bin notation -
Run a local instance of the CNCF Distribution Registry, with ORAS Artifacts support.
docker run -d -p 5000:5000 ghcr.io/oras-project/registry:v1.0.0-rc
-
Build, Push, Sign, Verify the
net-monitorsoftwareexport IMAGE=localhost:5000/net-monitor:v1 docker build -t $IMAGE https://github.com/wabbit-networks/net-monitor.git#main docker push $IMAGE notation cert generate-test --default --trust "wabbit-networks-dev" notation sign --plain-http $IMAGE notation list --plain-http $IMAGE notation verify --plain-http $IMAGE
Signatures are persisted as ORAS Artifacts manifests.
For more detailed samples, see hello-signing
- Regular conversations for Notation occur on the Cloud Native Computing Slack notary-v2 channel.
- Please see the CNCF Calendar for community meeting details.
- Meeting notes are captured on hackmd.io.
The Notation release process is defined in RELEASE_MANAGEMENT.md.
Support for the Notation project is defined in supported releases.
This project has adopted the CNCF Code of Conduct. See CODE_OF_CONDUCT.md for further details.
This project is covered under the Apache 2.0 license. You can read the license here.