Docker API calls into Docker format NXRM repositories may returned errors. NXRM does not always include a useful human readable message or suitable error code.
Configure the new Docker group repository docker-group with two members
1. docker-hosted hosted repo with Deployment policy read only
2. docker-proxy repo pointing at the official registry
Make the Writable Repository of the group the docker-hosted repo.
Add Docker Bearer Token Realm to Active realms.
Using a docker client:
docker login to the group repository
docker login 192.168.2.73:9933
docker pull the latest hello-world image from the official docker registry and tag it for upload to group repo:
Try to push to the docker-group - this fails as expected, but with a very poor error message that will cause confusion to the end user.
The error message is displayed this way because of how NXRM responded to the manifest PUT request:
A slight tweak to the response payload to look like this instead:
Gives a much better user experience:
The code field will be a unique identifier, all caps with underscores by convention. The message field will be a human readable string. The optional detail field may contain arbitrary json data providing information the client can use to resolve the issue.
Supported error codes are documented here:
Respond to docker errors with a more useful message suitable for end user consumption. This will help avoid support tickets and create a better user experience.