Image metadata requirements

This table specifies the mandatory metadata labels, naming rules, and unique tagging requirements essential for certifying container images on Red Hat OpenShift.

Requirement Justification

Container images must include the following labels:

  • name: Image name
  • maintainer: Maintainer name
  • vendor: Company name
  • version: Version of the image
  • release: A number used to identify the specific build for this image
  • summary: A short overview of the application or component in this image
  • description: A long description of the application or component in this image

Test name: HasRequiredLabel

 Ensures that customers can obtain information about the image provider and the content of the images in a consistent way.

Container image label content must not begin with any Red Hat Marks:

  • name: Image Name
  • maintainer: Maintainer name
  • vendor: Company name

Test name: HasNoProhibitedLabels

 The image name must follow the Red Hat trademark guidelines.

Container images must include a unique tag that is descriptive of the certified image.

Red Hat recommends appending the image version and its build date or released date to the unique tag.

Floating tags, such as latest, although not adequate for certification, can be added to the image in addition to the descriptive tag.

Test name: HasUniqueTag

 Ensures that images can be uniquely identified.