Azure-docs: origin of field --docker-email <email-address> is unclear

[erosinger]

Hi everyone,
many thanks for this great guide. It worked out for me and my team in the most cases and I have just one question left.
Where do I get the email adress for "--docker-email <email-address>" from?

We have chosen various emails from time to time and it always worked out.
Is that intended? In the docs I can not see an explanation for this, yet.

Looking forward to your response.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: ed59d472-ac33-5c03-dbb7-0e86e88c7dd8
• Version Independent ID: 69e1ad8c-2dd3-cc1b-2b31-996a5d866cc0
• Content: Authenticate with Azure Container Registry from Azure Kubernetes Service
• Content Source: articles/container-registry/container-registry-auth-aks.md
• Service: container-service
• GitHub Login: @mmacy
• Microsoft Alias: marsma

[Karishma-Tiwari-MSFT]

Thanks for the feedback! We are currently investigating and will update you shortly.

[Karishma-Tiwari-MSFT]

@erosinger When using the Docker command line to push images, you can authenticate to a given registry by running 'docker login DOCKER_REGISTRY_SERVER --username=DOCKER_USER --password=DOCKER_PASSWORD --email=DOCKER_EMAIL'. That produces a ~/.dockercfg file that is used by subsequent 'docker push' and 'docker pull' commands to authenticate to the registry.

When creating applications, you may have a Docker registry that requires authentication. In order for the nodes to pull images on your behalf, they have to have the credentials. You can provide this information by creating a dockercfg secret and attaching it to your service account.

--docker-email="": Email for Docker registry

@mmacy Can you please share your insights if this document needs further explanation about the email part?

[erosinger]

@Karishma-Tiwari-MSFT thanks for the fast response and explanation. I now understand the purpose of the field.

Sadly I am not sure where to get the correct email from? Is it my personal one? Or the one of the Azure Subscription assigned to the ACR? Or any email Adresse which was configured to have access to the ACR?

I would be grateful if you can help me out on this one. And this could be an information we might want to include on the page for next readers.

Looking forward to your response. Best enosinger

[mmacy]

@erosinger You can use any well-formed email address for that value. In the future, this argument may no longer be required. In fact, the --docker-email argument is no longer required for docker login, and there is an issue in the Kubernetes repo regarding its removal.

For now, however, you can use any properly formatted email address.

[mmacy]

@Karishma-Tiwari-MSFT You can assign this one to me, I've added a work item to the backlog to update the article with a call-out for the email address argument.

in-progress

[Karishma-Tiwari-MSFT]

@mmacy Thank you for sharing the information. :)
@erosinger I have assigned the issue to the content author to evaluate and update as appropriate.

[erosinger]

@mmacy @Karishma-Tiwari-MSFT Thank you very much for the explanation. Then everything is fine and I do not need to worry about this any more :) Thanks for the help.