[nydus] Add annotation to indicate empty layer

Set the annotation`containerd.io/snapshot/nydus-empty-layer: "true"` on the empty layer that's added in the OCI image. Just to be able to find it easily.

Author: Fricounet

pkg/driver/nydus/nydus.go

@@ -57,6 +57,8 @@ const (
 	annotationSourceDigest = "containerd.io/snapshot/nydus-source-digest"
 	// annotationSourceReference indicates the source OCI image reference name.
 	annotationSourceReference = "containerd.io/snapshot/nydus-source-reference"
+	// annotationEmptyLayer indicates that the layer is an empty layer added by nydus that won't change the final image's content.
+	annotationEmptyLayer = "containerd.io/snapshot/nydus-empty-layer"
 	// annotationFsVersion indicates the fs version (rafs v5/v6) of nydus image.
 	annotationFsVersion = "containerd.io/snapshot/nydus-fs-version"
 	// annotationBuilderVersion indicates the nydus builder (nydus-image) version.
@@ -487,9 +489,10 @@ func PrependEmptyLayer(ctx context.Context, cs content.Store, manifestDesc ocisp
 	}
 	emptyDescriptorBytes := generateDockerEmptyLayer()
 	emptyDescriptor := ocispec.Descriptor{
-		MediaType: emptyLayerMediaType,
-		Digest:    digest.FromBytes(emptyDescriptorBytes),
-		Size:      int64(len(emptyDescriptorBytes)),
+		Annotations: map[string]string{annotationEmptyLayer: "true"},
+		MediaType:   emptyLayerMediaType,
+		Digest:      digest.FromBytes(emptyDescriptorBytes),
+		Size:        int64(len(emptyDescriptorBytes)),
 	}
 
 	manifest.Layers = append([]ocispec.Descriptor{emptyDescriptor}, manifest.Layers...)

pkg/driver/nydus/nydus_test.go

@@ -257,6 +257,7 @@ func verifyPrependResults(ctx context.Context, t *testing.T, cs content.Store, o
 	expectedEmptyDigest := "sha256:4f4fb700ef54461cfa02571ae0db9a0dc1e0cdb5577484a6d75e68dc38e8acc1"
 	assert.Equal(t, expectedEmptyDigest, emptyLayer.Digest.String(), "empty layer digest should match expected")
 	assert.Equal(t, int64(32), emptyLayer.Size, "empty layer size should be 32 bytes")
+	assert.Equal(t, "true", emptyLayer.Annotations[annotationEmptyLayer], "empty layer annotation should be set to true")
 
 	// Verify media types based on the original manifest type
 	var expectedEmptyLayerMediaType, expectedconfigDescriptorMediaType string