schema: also keep the manifest list digest in meta.json

Add a new `manifest-list-digest` to the OCI image objects we publish
in `meta.json` for our pushed images containing a backreference to
the digest of the manifest list. Otherwise, that digest is not really
captured anywhere in our metadata.

This could be used down the line to also add the manifest list digest
to release metadata, which would be more appropriate as the aggregation
point of metadata across all the arches. But the more immediate want for
it is for use in `cosa sign`.

Author: jlebon

pkg/builds/cosa_v1.go

@@ -1,7 +1,7 @@
 package builds
 
 // generated by 'make schema'
-// source hash: 4289a52f5ee4665caa5432d9caa653b74605117632ac045955912e624d149524
+// source hash: 11704f512a9b6e0c5ac178a9917e03a05ea10a7878ef9b5c0a6695d52c9cd7f5
 
 type AdvisoryDiff []AdvisoryDiffItems
 
@@ -182,11 +182,12 @@ type PackageSetDifferences []PackageSetDifferencesItems
 type PackageSetDifferencesItems interface{}
 
 type PrimaryImage struct {
-	AdditionalImages []interface{}     `json:"additional-images,omitempty"`
-	Comment          string            `json:"comment,omitempty"`
-	Digest           string            `json:"digest,omitempty"`
-	Image            string            `json:"image"`
-	Tags             []PrimaryImageTag `json:"tags,omitempty"`
+	AdditionalImages   []interface{}     `json:"additional-images,omitempty"`
+	Comment            string            `json:"comment,omitempty"`
+	Digest             string            `json:"digest,omitempty"`
+	Image              string            `json:"image"`
+	ManifestListDigest string            `json:"manifest-list-digest,omitempty"`
+	Tags               []PrimaryImageTag `json:"tags,omitempty"`
 }
 
 type PrimaryImageTag string

pkg/builds/schema_doc.go

@@ -1,5 +1,5 @@
 // Generated by ./generate-schema.sh
-// Source hash: 4289a52f5ee4665caa5432d9caa653b74605117632ac045955912e624d149524
+// Source hash: 11704f512a9b6e0c5ac178a9917e03a05ea10a7878ef9b5c0a6695d52c9cd7f5
 // DO NOT EDIT
 
 package builds
@@ -98,6 +98,7 @@ var generatedSchemaJSON = `{
       ],
       "optional": [
         "digest",
+        "manifest-list-digest",
         "tags",
         "comment",
         "additional-images"
@@ -108,6 +109,11 @@ var generatedSchemaJSON = `{
           "type": "string",
           "title": "Digest"
         },
+        "manifest-list-digest": {
+          "$id": "#/image/manifest-list-digest",
+          "type": "string",
+          "title": "Manifest List Digest"
+        },
         "comment": {
           "$id": "#/image/comment",
           "type": "string",

src/cmd-coreos-prune

@@ -55,7 +55,7 @@ Build = collections.namedtuple("Build", ["id", "images", "arch", "meta_json"])
 # set metadata caching to 5m
 CACHE_MAX_AGE_METADATA = 60 * 5
 # These lists are up to date as of schema hash
-# 4289a52f5ee4665caa5432d9caa653b74605117632ac045955912e624d149524. If changing
+# 11704f512a9b6e0c5ac178a9917e03a05ea10a7878ef9b5c0a6695d52c9cd7f5. If changing
 # this hash, ensure that the list of SUPPORTED and UNSUPPORTED artifacts below
 # is up to date.
 SUPPORTED = ["amis", "aws-winli", "gcp"]

src/cmd-push-container-manifest

@@ -103,7 +103,7 @@ def main():
             return
 
         # Create/Upload the manifest list to the container registry
-        manifest_info = create_and_push_container_manifest(
+        manifest_digest, manifest_info = create_and_push_container_manifest(
             args.repo, args.tags, images, args.write_digest_to_file, args.v2s2)
         # if we pushed in v2s2 mode, we need to reload from the repo the actual
         # final digests: https://github.com/containers/podman/issues/16603
@@ -125,6 +125,7 @@ def main():
             image = {
                 'image': args.repo,
                 'digest': manifest['digest'],
+                'manifest-list-digest': manifest_digest,
                 'tags': args.tags
             }
             if buildmetas[arch].get(args.metajsonname):

src/cosalib/container_manifest.py

@@ -1,4 +1,5 @@
 import json
+import tempfile
 
 from cosalib.cmdlib import runcmd
 
@@ -53,7 +54,7 @@ def delete_local_container_imgref(repo, tag):
     runcmd(cmd)
 
 
-def push_container_manifest(repo, tags, write_digest_to_file, v2s2=False):
+def push_container_manifest(repo, tags, write_digest_to_file, v2s2=False) -> str:
     '''
     Push manifest to registry
     @param repo str registry repository
@@ -66,14 +67,21 @@ def push_container_manifest(repo, tags, write_digest_to_file, v2s2=False):
         # to create a manifest with 2 different mediaType. It seems to be
         # a Quay issue.
         base_cmd.extend(["--remove-signatures", "-f", "v2s2"])
-    if write_digest_to_file:
-        base_cmd.extend(["--digestfile", write_digest_to_file])
-    runcmd(base_cmd + [f"{repo}:{tags[0]}"])
+
+    with tempfile.NamedTemporaryFile(mode='r+', encoding='utf-8') as f:
+        runcmd(base_cmd + [f"{repo}:{tags[0]}", "--digestfile", f.name])
+        digest = f.read()
+        if write_digest_to_file:
+            with open(write_digest_to_file, mode='w', encoding='utf-8') as g:
+                g.write(digest)
+
     for tag in tags[1:]:
         runcmd(base_cmd + [f"{repo}:{tag}"])
 
+    return digest
+
 
-def create_and_push_container_manifest(repo, tags, images, write_digest_to_file, v2s2) -> dict:
+def create_and_push_container_manifest(repo, tags, images, write_digest_to_file, v2s2) -> tuple[str, dict]:
     '''
     Do it all! Create, push, cleanup, and return the final manifest JSON.
     @param repo str registry repository
@@ -85,6 +93,6 @@ def create_and_push_container_manifest(repo, tags, images, write_digest_to_file,
         # perhaps left over from a previous failed run -> delete
         delete_local_container_imgref(repo, tags[0])
     manifest_info = create_local_container_manifest(repo, tags[0], images)
-    push_container_manifest(repo, tags, write_digest_to_file, v2s2)
+    manifest_digest = push_container_manifest(repo, tags, write_digest_to_file, v2s2)
     delete_local_container_imgref(repo, tags[0])
-    return manifest_info
+    return (manifest_digest, manifest_info)

src/v1.json

@@ -92,6 +92,7 @@
       ],
       "optional": [
         "digest",
+        "manifest-list-digest",
         "tags",
         "comment",
         "additional-images"
@@ -102,6 +103,11 @@
           "type": "string",
           "title": "Digest"
         },
+        "manifest-list-digest": {
+          "$id": "#/image/manifest-list-digest",
+          "type": "string",
+          "title": "Manifest List Digest"
+        },
         "comment": {
           "$id": "#/image/comment",
           "type": "string",