From b1e542401a79bcbf4e691f265b5d8508faf7be48 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lu=C3=ADs=20Pedro=20Algarvio?= Date: Sun, 5 Mar 2017 18:29:18 +0000 Subject: [PATCH 1/3] Added authors proposal to the specification 4 new additions: - org.label-schema.authors..name = "John Doe" - org.label-schema.authors..email = "john@example.com" - org.label-schema.authors..homepage = "http://john.example.com" - org.label-schema.authors..role = "DevOps" --- rc1.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/rc1.md b/rc1.md index 37cb99a..00a7b7a 100644 --- a/rc1.md +++ b/rc1.md @@ -72,6 +72,10 @@ All labels are OPTIONAL, however if present MUST be prefixed with the namespace | `url` | `org.label-schema.url="http://postgresql.org"` | URL of website with more information about the product or service provided by the container. | | `vcs-url` | `org.label-schema.vcs-url = "https://github.com/nginx/nginx"` | URL for the source code under version control from which this container image was built. | | `vcs-ref` | `org.label-schema.vcs-ref = "279FA63"` | Identifier for the version of the source code from which this image was built. For example if the version control system is git this is the SHA. | +| `authors..name` | `org.label-schema.authors..name = "John Doe"` | The name of `` that authored this image. Multiple usernames keys can exist. | +| `authors..email` | `org.label-schema.authors..email = "john@example.com"` | The email address of `` that authored this image. Multiple usernames keys can exist. | +| `authors..homepage` | `org.label-schema.authors..homepage = "http://john.example.com"` | The homepage url of `` that authored this image. Multiple usernames keys can exist. | +| `authors..role` | `org.label-schema.authors..role = "DevOps"` | The role of `` that authored this image. Multiple usernames keys can exist. | | `vendor` | `org.label-schema.vendor = "Stark Industries"` | The organization that produces this image. | | `version` | `org.label-schema.version = "1.2.3"` `org.label-schema.version = "Beta4.2"` `org.label-schema.version = "1.2.2-dirty"` `org.label-schema.version = "my-test"` | Release identifier for the contents of the image. This is entirely up to the user and could be a numeric version number like 1.2.3, or a text label.
The version MAY match a label or tag in the source code repository.
You should make sure that only images that exactly reflect a version of code should have that version label. If Julia finds a version 0.7.1 in a repository she SHOULD be able to infer this matches version 0.7.1 of the associated code (and in particular, not 0.7.1 plus some later commits).
You SHOULD omit the version label, or use a marker like "dirty" or "test" to indicate when a container image does not match a labelled / tagged version of the code. | | `schema-version` | `org.label-schema.schema-version = "1.0"` | This label SHOULD be present to indicate the version of Label Schema in use. | From 7d2110370909f8ef472c44a6ec74fa54b887bc67 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lu=C3=ADs=20Pedro=20Algarvio?= Date: Sun, 5 Mar 2017 19:12:10 +0000 Subject: [PATCH 2/3] Fixed minor typo --- rc1.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/rc1.md b/rc1.md index 00a7b7a..c31aa64 100644 --- a/rc1.md +++ b/rc1.md @@ -72,10 +72,10 @@ All labels are OPTIONAL, however if present MUST be prefixed with the namespace | `url` | `org.label-schema.url="http://postgresql.org"` | URL of website with more information about the product or service provided by the container. | | `vcs-url` | `org.label-schema.vcs-url = "https://github.com/nginx/nginx"` | URL for the source code under version control from which this container image was built. | | `vcs-ref` | `org.label-schema.vcs-ref = "279FA63"` | Identifier for the version of the source code from which this image was built. For example if the version control system is git this is the SHA. | -| `authors..name` | `org.label-schema.authors..name = "John Doe"` | The name of `` that authored this image. Multiple usernames keys can exist. | -| `authors..email` | `org.label-schema.authors..email = "john@example.com"` | The email address of `` that authored this image. Multiple usernames keys can exist. | -| `authors..homepage` | `org.label-schema.authors..homepage = "http://john.example.com"` | The homepage url of `` that authored this image. Multiple usernames keys can exist. | -| `authors..role` | `org.label-schema.authors..role = "DevOps"` | The role of `` that authored this image. Multiple usernames keys can exist. | +| `authors..name` | `org.label-schema.authors..name = "John Doe"` | The name of `` that authored this image. Multiple username keys can exist. | +| `authors..email` | `org.label-schema.authors..email = "john@example.com"` | The email address of `` that authored this image. Multiple username keys can exist. | +| `authors..homepage` | `org.label-schema.authors..homepage = "http://john.example.com"` | The homepage url of `` that authored this image. Multiple username keys can exist. | +| `authors..role` | `org.label-schema.authors..role = "DevOps"` | The role of `` that authored this image. Multiple username keys can exist. | | `vendor` | `org.label-schema.vendor = "Stark Industries"` | The organization that produces this image. | | `version` | `org.label-schema.version = "1.2.3"` `org.label-schema.version = "Beta4.2"` `org.label-schema.version = "1.2.2-dirty"` `org.label-schema.version = "my-test"` | Release identifier for the contents of the image. This is entirely up to the user and could be a numeric version number like 1.2.3, or a text label.
The version MAY match a label or tag in the source code repository.
You should make sure that only images that exactly reflect a version of code should have that version label. If Julia finds a version 0.7.1 in a repository she SHOULD be able to infer this matches version 0.7.1 of the associated code (and in particular, not 0.7.1 plus some later commits).
You SHOULD omit the version label, or use a marker like "dirty" or "test" to indicate when a container image does not match a labelled / tagged version of the code. | | `schema-version` | `org.label-schema.schema-version = "1.0"` | This label SHOULD be present to indicate the version of Label Schema in use. | From db1812fb744422f5b38e31c6856ae07d2a4bb3d2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lu=C3=ADs=20Pedro=20Algarvio?= Date: Wed, 15 Nov 2017 13:11:27 +0000 Subject: [PATCH 3/3] Update rc1.md --- rc1.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/rc1.md b/rc1.md index c31aa64..6469df1 100644 --- a/rc1.md +++ b/rc1.md @@ -75,7 +75,7 @@ All labels are OPTIONAL, however if present MUST be prefixed with the namespace | `authors..name` | `org.label-schema.authors..name = "John Doe"` | The name of `` that authored this image. Multiple username keys can exist. | | `authors..email` | `org.label-schema.authors..email = "john@example.com"` | The email address of `` that authored this image. Multiple username keys can exist. | | `authors..homepage` | `org.label-schema.authors..homepage = "http://john.example.com"` | The homepage url of `` that authored this image. Multiple username keys can exist. | -| `authors..role` | `org.label-schema.authors..role = "DevOps"` | The role of `` that authored this image. Multiple username keys can exist. | +| `authors..role` | `org.label-schema.authors..role = "Developer"` | The role of `` that authored this image. Multiple username keys can exist. | | `vendor` | `org.label-schema.vendor = "Stark Industries"` | The organization that produces this image. | | `version` | `org.label-schema.version = "1.2.3"` `org.label-schema.version = "Beta4.2"` `org.label-schema.version = "1.2.2-dirty"` `org.label-schema.version = "my-test"` | Release identifier for the contents of the image. This is entirely up to the user and could be a numeric version number like 1.2.3, or a text label.
The version MAY match a label or tag in the source code repository.
You should make sure that only images that exactly reflect a version of code should have that version label. If Julia finds a version 0.7.1 in a repository she SHOULD be able to infer this matches version 0.7.1 of the associated code (and in particular, not 0.7.1 plus some later commits).
You SHOULD omit the version label, or use a marker like "dirty" or "test" to indicate when a container image does not match a labelled / tagged version of the code. | | `schema-version` | `org.label-schema.schema-version = "1.0"` | This label SHOULD be present to indicate the version of Label Schema in use. |