image-layout: a MUST and some schema

Signed-off-by: Vincent Batts <[email protected]>

Author: vbatts

image-layout.md

@@ -15,7 +15,7 @@ The image layout has two top level directories:
 - "refs" contains [descriptors][descriptors]. Commonly pointing to an [image manifest](manifest.md#image-manifest) or an [image manifest list](manifest-list.md#oci-image-manifest-list-specification).
 
 
-It also contains a file that is used to identify the layout version:
+An image layout MUST contain a file that is used to identify the layout version:
 
 - "oci-layout" MUST contain a JSON object with a version field `{"imageLayoutVersion": "1.0.0"}` and MAY include additional fields.
 

schema/fs.go

@@ -205,7 +205,7 @@ var _escData = map[string]*_escFile{
 	"/config-schema.json": {
 		local:   "config-schema.json",
 		size:    774,
-		modtime: 1477035771,
+		modtime: 1478197703,
 		compressed: `
 H4sIAAAJbogA/5SRsW4DIQyG93sKRDL2QodOt+YBOnSsOlAwOUc6TI0zRFXevQJyTU6KquvCYP/f/2P7
 u1NKe8iOMQlS1IPSrwninqJYjMBqTzHgQb0lcBjQ2ap6Ktg2uxEmW5BRJA3GHDPFvlV3xAfj2Qbpn19M
@@ -219,7 +219,7 @@ YiIJ+f9eV27hNWIW4vOjMSyzPd/WjQLTfejq2Dniyl26+a1/0AxfJ+R68vcHl7htejl9p9RHd+l+AgAA
 	"/content-descriptor.json": {
 		local:   "content-descriptor.json",
 		size:    637,
-		modtime: 1476325139,
+		modtime: 1478197703,
 		compressed: `
 H4sIAAAJbogA/5SRP0/DMBDF93yKk9uR1gwVQ1bYGWBDDKn93F6l2sY+hoL63dHFLaQwAFt0er/3J37v
 iIxHdYWzcIqmJ3OfEW9TlIEjCukXotDdSZQKPWQ4DuyGkbhSi3l1W+wHxbciubd2V1NctOsylY31ZQiy
@@ -232,7 +232,7 @@ ZQnPG1SZ1vjLohPVnLqTmyl4eeUCfcWn7398uvkyuiN67o7dRwAAAP//zGqYSn0CAAA=
 	"/defs-config.json": {
 		local:   "defs-config.json",
 		size:    2270,
-		modtime: 1476325139,
+		modtime: 1478197703,
 		compressed: `
 H4sIAAAJbogA/+RVzY7TMBC+5ylGhmNhL4jDXrscUZEq4IBQ5SbjdpbYY8YTIEJ9d5Rs6eanDd1detpD
 VcX29zMznvHvDMAUmHKhqMTBXIO5QUeBmq8E0YpSXpVWQBkWEcOcg1oKKDDn4GgDy4g5Ocpti5/dER4Y
@@ -248,7 +248,7 @@ L+dZaPYex0P6HCj6qPWqreQp+Jq5RBtO9kPW/HbZnwAAAP//X8Yig94IAAA=
 	"/defs-image.json": {
 		local:   "defs-image.json",
 		size:    2550,
-		modtime: 1476325139,
+		modtime: 1478197703,
 		compressed: `
 H4sIAAAJbogA/7RWTW/bMAy951cQaoEeEsc9DAMaFAWG9bJTB3SnBdnAynSszpY0SimWFv7vgx3Hn3GL
 rNnNosin96hn2i8TABGRk6ysV0aLBYhbipVWxcqBRfZKblJk8AbuLOnPRntUmhi+ZLgmuLckVawkluWz
@@ -267,7 +267,7 @@ MRC9muxX+SSf/A0AAP//XF/NGfYJAAA=
 	"/defs.json": {
 		local:   "defs.json",
 		size:    3193,
-		modtime: 1476325139,
+		modtime: 1478197703,
 		compressed: `
 H4sIAAAJbogA/7SWQZPSMBTH73yKTPSIbpumLXBzRNc97MDMjifHQy0PiEIS09Rx3eG7OymlNG0oFPGw
 C03yfv/3/nmheRkghBeQpYpJzQTHE4SnsGScmacM5RkskF4rka/WItdIrwHNJPD3guuEcVDoSULKlixN
@@ -283,10 +283,23 @@ VfOwZWpT3H45DszfbvA3AAD//0JyEpx5DAAA
 `,
 	},
 
+	"/image-layout-schema.json": {
+		local:   "image-layout-schema.json",
+		size:    414,
+		modtime: 1478197703,
+		compressed: `
+H4sIAAAJbogA/2yPwUrEMBCG732KIXq0TQVPue5pQdiD4EU8xHa2zWKTOJkKi/TdJZlWD91TmD/z8c3/
+UwGoHlNHLrILXhlQp4j+EDxb55HgONkB4dlew8zw0o04WfWQqfskgwE1Mkej9SUFX0vaBBp0T/bMdfuk
+JbsTzvUbkozWIaLvNlkqmGxrl8X1ZxELydeImQ0fF+zWLFKISOwwKQO5TTZkUi5+RUpSS/72bb9lA8IZ
+eEQ4HY6wMxdusycm54f/HP08KQNv6wygHpu2adU6v5d3qQCWcjDh1+wI+z/k1rlV5pbqNwAA//8bwMuB
+ngEAAA==
+`,
+	},
+
 	"/image-manifest-schema.json": {
 		local:   "image-manifest-schema.json",
 		size:    1032,
-		modtime: 1476325139,
+		modtime: 1478197703,
 		compressed: `
 H4sIAAAJbogA/6RSvW7jMAze/RSEk/Ec3XCT15tuOHRo0KXooNqUzSCWVFItEAR590JSlNpIh7ZZKX6/
 4rECqHuUjskHcrZuob7zaP86GzRZZPg36QHhv7ZkUALce+zIUKfT9q8IX0s34qQjdAzBt0rtxNkmTzeO
@@ -301,7 +314,7 @@ X3p8DwgEAAA=
 	"/manifest-list-schema.json": {
 		local:   "manifest-list-schema.json",
 		size:    1010,
-		modtime: 1476325139,
+		modtime: 1478197703,
 		compressed: `
 H4sIAAAJbogA/6ySMU/7MBDF93yKU9rxn/o/MGWFBQnEQMWCGExybq5qbOM7kKqq3x3ZTkqiMoDoevF7
 93vvcigAyha5CeSFnC1rKB882mtnRZPFALe93iDca0sGWeCOWODRY0OGGp0k/6LHkpsOex31nYivldqy

schema/image-layout-schema.json

@@ -0,0 +1,18 @@
+{
+  "description": "OpenContainer Image Layout Schema",
+  "$schema": "http://json-schema.org/draft-04/schema#",
+  "id": "https://opencontainers.org/schema/image-layout",
+  "type": "object",
+  "properties": {
+    "imageLayoutVersion": {
+      "description": "version of the OCI image-layout",
+      "type": "string",
+      "enum": [
+        "1.0.0"
+      ]
+    }
+  },
+  "required": [
+    "imageLayoutVersion"
+  ]
+}