Merge branch 'hotfix/better-container-registry-documentation' into 'master'

Add some docs for Docker Registry configuration - Relatively important for anyone installing from source

There have been a few issues created because of the lack of documentation for how to configure Docker Registry when installing from source, specifically what the `realm` needs to be and the `service`

These 2 bits of info will stop a lot of headaches 👍

Issues:
https://gitlab.com/gitlab-org/gitlab-ce/issues/17957
https://gitlab.com/gitlab-org/gitlab-ce/issues/17991

See merge request !4738
Signed-off-by: Rémy Coutable <remy@rymai.me>

CHANGELOG

@@ -5,6 +5,7 @@ v 8.9.1 (unreleased)
   - Fix some CI wording in documentation. !4660
   - Document `GIT_STRATEGY` and `GIT_DEPTH`. !4720
   - Add documentation for the export & import features. !4732
+  - Add some docs for Docker Registry configuration. !4738
   - Fix MR-auto-close text added to description. !4836
   - Fix typo in export failure email. !4847
 

doc/administration/container_registry.md

@@ -84,6 +84,17 @@ GitLab does not ship with a Registry init file. Hence, [restarting GitLab][resta
 will not restart the Registry should you modify its settings. Read the upstream
 documentation on how to achieve that.
 
+The Docker Registry configuration will need `container_registry` as the service and `https://gitlab.example.com/jwt/auth` as the realm:
+
+```
+auth:
+  token:
+    realm: https://gitlab.example.com/jwt/auth
+    service: container_registry
+    issuer: gitlab-issuer
+    rootcertbundle: /root/certs/certbundle
+```
+
 ## Container Registry domain configuration
 
 There are two ways you can configure the Registry's external domain.