diff --git a/web/site/content/docs/how-to-guides/verify-signed-container-images.md b/web/site/content/docs/how-to-guides/verify-signed-container-images.md new file mode 100644 index 00000000..cbf7e56a --- /dev/null +++ b/web/site/content/docs/how-to-guides/verify-signed-container-images.md @@ -0,0 +1,153 @@ +--- +title: "Verify signed container images" +type: docs +description: > + Verify that container image is signed when creating a container from it in Kanto Container Management. +weight: 5 +--- + +By following the steps below, you will sign a container image and push it to a local registry using a{{% refn "https://github.com/notaryproject/notation" %}}`notation`{{% /refn %}}. Then a notation trust policy and the Kanto Container Management service will be configured in a way that running containers from the signed image via kanto-cm CLI will be successful, while running containers from unsigned images will fail. + +### Before you begin + +To ensure that your edge device is capable to execute the steps in this guide, you need: + +* If you don't have an installed and running Eclipse Kanto, follow {{% relrefn "install" %}} Install Eclipse Kanto {{% /relrefn %}} +* Installed {{% refn "https://notaryproject.dev/docs/user-guides/installation/cli/" %}} Notation CLI {{% /refn %}} +* Installed and running {{% refn "https://www.docker.com/products/docker-desktop/" %}} Docker {{% /refn %}} + +### Create an image and push it to a local registry using docker and than sign it with notation + +Create and run a local container registry: +```shell +sudo kanto-cm create --ports 5000:5000 --e REGISTRY_STORAGE_DELETE_ENABLED=true --name registry docker.io/library/registry:latest +sudo kanto-cm start -n registry +``` + +Build a dummy hello world image and push it to the registry: +```shell +cat <