Docker Community Forums

Share and learn in the Docker community.

Best practices for tag and image names for dockerhub and official images

Hi there,

I’ve created some docker images for the XWiki project and now that I wish to push them as official images on https://github.com/docker-library/official-images/ I have some questions.

Right now at https://github.com/xwiki-contrib/docker-xwiki I have one directory per image type (e.g. XWiki on mysql+tomcat. There’s only one right now but the plan is to have more: xwiki on postgres+jetty, etc). And right now the tags I have correspond to the XWiki version, e.g. 8.4.4, 8.x, latest.

However on the official-images github repo there seems to be only one metadata for single image names.

So I’m wondering what’s the best practice:

  • several differently named images with tags matching the xwiki versions (as I have now)
  • or a single image name with tags describing all the variations (such as “8.4.4-mysql-tomcat” or even “8.4.4-mysql5-tomcat8”)

The second option means having branches in git to represent the variations rather than directory names. It also means I wouldn’t be able to tag all the images together with a single git tag or git branch for all images.

So I’m wondering what’s the best practice.

Thanks a lot
-Vincent
XWiki committer