From 2cd00be183f833a8b826344fcfdcdae2133471a7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=CD=BFason=20=CE=92oxman?= <141646877+jason-seqera@users.noreply.github.com> Date: Mon, 29 Apr 2024 17:05:03 -0400 Subject: [PATCH] Describe use of sha256 hash with Wave (#448) Signed-off-by: Paolo Di Tommaso Co-authored-by: Phil Ewels Co-authored-by: Paolo Di Tommaso --- docs/guide.mdx | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docs/guide.mdx b/docs/guide.mdx index 1bc9d2e02..59fd11644 100644 --- a/docs/guide.mdx +++ b/docs/guide.mdx @@ -54,6 +54,25 @@ If an access token isn't provided, the following rate limits apply: - 25 container builds per day - 250 container pulls per hour +## Known limitation + +### Use of sha256 digest in the image name + +The Wave does not support the use of sha256 digest in the image name, e.g. `ubuntu@sha256:3235...ce8f`, when using +the augmentation process to extend container images. + +In order to reference a container via sha256 digest in the image name with Wave you will need to *freeze* image mode +that will force the creation of a new container image using the container you have specified as base image. + +In your pipeline configuration, ensure that you specify the following settings: + +```groovy +wave.enabled = true +wave.freeze = true +wave.strategy = ['dockerfile'] +wave.build.repository = 'docker.io//' +``` + ## Tutorials ### Authenticate private repositories