Skip to content

Add specification for RHSCL and several labels that we already use in RHSCL #60

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
rhatdan merged 1 commit into from
Oct 9, 2015
Merged

Add specification for RHSCL and several labels that we already use in RHSCL #60

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 30 additions & 3 deletions vendor/redhat/labels.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ The Fields are:
* Note: there is an upstream Architecture field, but it uses a different terminology. We should work upstream to sync. For now we have to keep the two fields in sync.
* Right now the value is `"x86_64"`
* `"name"`
* The primary name of the image (relative path without TAG): `PRODUCT[$PRODUCTGEN][--$PLATFORMDIFFERENTIATOR]/ REPO[$CONTENTGENERATION][--$PLATFORMDIFFERENTIATOR]`
* The primary name of the image (relative path without TAG): `PRODUCT[$PRODUCTGEN][--$PLATFORMDIFFERENTIATOR]/ REPO[--$CONTENTGENERATION][--$PLATFORMDIFFERENTIATOR]`
* `"authoritative-source"`
* The authoritative registry in which the image is published. For Red Hat this is `"registry.access.redhat.com"`. This allows e.g. to verify if a newer version is available independent of local tagging.
* For ISVs this is optional.
Expand All @@ -33,7 +33,7 @@ $authoritative-source/$name:$version-$release
Aka:

```
$authoritative-source[:PORT]/PRODUCT[$PRODUCTGEN][--$PLATFORMDIFFERENTIATOR]/REPO[$CONTENTGENERATION][--$PLATFORMDIFFERENTIATOR]:$COMPVER-$IMGBUILD
$authoritative-source[:PORT]/PRODUCT[$PRODUCTGEN][--$PLATFORMDIFFERENTIATOR]/REPO[--$CONTENTGENERATION][--$PLATFORMDIFFERENTIATOR]:$COMPVER-$IMGBUILD
```

## Other labels
Expand Down Expand Up @@ -62,6 +62,14 @@ $authoritative-source[:PORT]/PRODUCT[$PRODUCTGEN][--$PLATFORMDIFFERENTIATOR]/REP
* URL of the version control repository
* `"vcs-ref"` (Optional)
* A 'reference' within the version control repository; e.g. a git commit, or a subversion branch
* `"io.k8s.description"` (Optional)
* Description of the container displayed in Kubernetes
* `"io.k8s.display-name"` (Optional)
* Name of the container displayed in Kubernetes
* `"io.openshift.expose-services"` (Optional)
* port:service pairs separated with comma, e.g. `"8080:http,8443:https"`
* `"io.openshift.tags"` (Optional)
* tags used by searching engine, e.g. `"builder,php,php56,rh-php56"`

### Examples

Expand Down Expand Up @@ -106,9 +114,28 @@ $authoritative-source[:PORT]/PRODUCT[$PRODUCTGEN][--$PLATFORMDIFFERENTIATOR]/REP
"release": "3",
"vendor": "Red Hat, Inc.",
"version": "5.4.16",
"summary": "Multiple",
"summary":"RHEL 7 based PHP platform image",
"distribution-scope":"authoritative-source-only"
},

1. `registry.access.redhat.com/rhscl/php-56-rhel7:5.6-3` has the following metadata:

"Labels": {
"architecture": "x86_64",
"authoritative-source": "registry.access.redhat.com"
"com.redhat.build-host": "rcm-img04.build.eng.bos.redhat.com",
"com.redhat.component": "rh-php56-docker",
"name": "rhscl/php-56-rhel7",
"release": "3",
"vendor": "Red Hat, Inc.",
"version": "5.6",
"summary": "PHP 5.6 platform for building and running applications",
"distribution-scope": "authoritative-source-only",
"url": "http://github.com/sclorg/rhscl-dockerfiles",
"io.k8s.description="Platform for building and running PHP 5.6 applications",
"io.k8s.display-name="Apache 2.4 with PHP 5.6",
"io.openshift.expose-services="8080:http",
"io.openshift.tags="builder,php,php56,rh-php56"
},


59 changes: 52 additions & 7 deletions vendor/redhat/names.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,7 @@ The spaces (" "s) after the are just for formating and not part of the actual sc
* $CONTENTGENERATION
* Optional number differentiating major generational changes withing the primary content that are significant for the use (ie the developer of a layered image). Example: python vs python-33, ruby-193 vs ruby-200.
* $PLATFORMDIFFERENTIATOR
* Optional field to differentiate builds of higher-level images based on the underlying platform generation. Example: SCL ruby200 built on RHEL 6 base vs RHEL 7 - the issue here is, that behavior of the whole stack is sufficiently different, so that as a developer I want to explicitly track (code may break in the move). We can't just track this in the TAG because the FROM line sets the base implicitly in the static linking model.
* Optional field to differentiate builds of higher-level images based on the underlying platform generation. Example: SCL ruby-200 built on RHEL 6 base vs RHEL 7 - the issue here is, that behavior of the whole stack is sufficiently different, so that as a developer I want to explicitly track (code may break in the move). We can't just track this in the TAG because the FROM line sets the base implicitly in the static linking model.
* $COMPVER
* Version string of the primary component without the build part of the rpm. For core RHEL platform images this is the release version string, for e.g. php it would be right now be '5.4.16' based on 'php-5.4.16-23.rhel7_0.3'.x86_64.rpm. For different frames of reference (aka non-RHEL), this would follow a different model depending what makes sense for the repsective product..
* $IMGBUILD
Expand Down Expand Up @@ -192,7 +192,7 @@ rhel8-beta/php...
```
REGISTRY/
PRODUCT$PRODUCTGEN[--$PLATFORMDIFFERENTIATOR]/
REPO[$CONTENTGENERATION][--$PLATFORMDIFFERENTIATOR]
REPO[--$CONTENTGENERATION][--$PLATFORMDIFFERENTIATOR]
:$COMPVER-$IMGBUILD
```

Expand All @@ -201,8 +201,8 @@ The mapping to Bugzilla (or Jira) components will follow REPO-docker within the

* `REGISTRY` Ignored in Bugzilla
* `PRODUCT[$PRODUCTGEN]` Maps to the product/version in Bugzilla, other metadata such as
* `REPO[$CONTENTGENERATION][--$PLATFORMDIFFERENTIATOR]`
* `REPO[$CONTENTGENERATION]` maps to the component with -docker appended
* `REPO[--$CONTENTGENERATION][--$PLATFORMDIFFERENTIATOR]`
* `REPO[--$CONTENTGENERATION]` maps to the component with -docker appended
* `PLATFORMDIFFERNTIATOR` is not part of the formal mapping
* `:$COMPVER` Maps to the version of the component
* `-$IMGBUILD` is not part of the formal mapping
Expand All @@ -215,7 +215,7 @@ registry.access.redhat.com/rhel7/php:5.4.16-3

maps to

* Product: RHEL
* Product: Red Hat Enterprise Linux 7
* Version: 7.0
* Component: php-docker

Expand Down Expand Up @@ -271,7 +271,7 @@ Please note, that at this point Red Hat has *no* plans to actually offer any ima
Red Hat uses the LABEL metadata field to provide additional information for images. All LABELs that are not actively used by the ISV must be overwritten with "". The following labels must be set appropriately to pass certification:

* `"name"`
* The primary name of the image (relative path w/o TAG): `PRODUCT[$PRODUCTGEN][--$PLATFORMDIFFERENTIATOR] /REPO[$CONTENTGENERATION][--$PLATFORMDIFFERENTIATOR]`
* The primary name of the image (relative path w/o TAG): `PRODUCT[$PRODUCTGEN][--$PLATFORMDIFFERENTIATOR] /REPO[--$CONTENTGENERATION][--$PLATFORMDIFFERENTIATOR]`
* `"release"`
* The build of the image, `$IMGBUILD`
* `"vendor"`
Expand Down Expand Up @@ -306,7 +306,52 @@ The work on defining the V2 protocol and repository/image format is ongoing. The

## Red Hat Software Collections Containers and Labels

TBA
Red Hat Software Collections containers use the following values:

* $PRODUCT: rhscl
* $PRODUCTGEN: not specified, since RHSCL 1.x and RHSCL 2.x content space is shared
* $REPO: name of the Software Collection without vendor prefix (`rh` is already used in the PRODUCT part, so no need to duplicate)
* $CONTENTGENERATION: part of the main component version, that is related to API stability
* for example `rh-php56` collection will use 56 as $CONTENTGENERATION
* $PLATFORMDIFFERENTIATOR: RHEL version that the collection is based on; e.g. rhel6, rhel7, ...
* $COMPVER: part of the main component version, that is related to API stability
* for example `rh-php56` collection will use 56 as $COMPVER
* $IMGBUILD: build of the image, usually increasing integer

### Beta Releases

Beta releases will be treated as separate 'generations' at the first level. Example:

```
rhscl_beta/php-56-rhel7:5.6-3
rhscl_beta/postgresql-94-rhel7:9.4-1
...
```


### Bugzilla Mapping

The following rules are used for Bugzilla mapping in Red Hat Software Collections:

* `REGISTRY` Ignored in Bugzilla
* `PRODUCT[$PRODUCTGEN]` is not part of the formal mapping
* `REPO[--$CONTENTGENERATION][--$PLATFORMDIFFERENTIATOR]`
* `REPO[--$CONTENTGENERATION]` maps to the Software Collection name with -docker appended
* `PLATFORMDIFFERNTIATOR` is not part of the formal mapping
* `:$COMPVER` Maps to the Software Collection name and is used in version field in Bugzilla
* `-$IMGBUILD` is not part of the formal mapping

Examples:
```
registry.access.redhat.com/rhscl/php-56-rhel7:5.6-3
```

maps to

* Product: Red Hat Software Collections
* Component: rh-php56-docker
* Version: rh-php56


## Red Hat Middleware Image Naming

Expand Down