search

MicrosoftDocs / azure-docs

Open source documentation of Microsoft Azure
https://docs.microsoft.com/azure
Creative Commons Attribution 4.0 International
10.25k stars 21.42k forks source link

Docker Desktop setup instructions incorrect for macOSX #121068

Closed lets-data closed 5 months ago

lets-data commented 6 months ago

The following instructions for setting up docker desktop on MacOSX were incorrect for me as I was attempting to install Azure Service Fabric dev env on my desktop. The issues were in the enabling docker desktop for ipv6 scenarios.

image

Here are the issues:

  1. I was trying to use the dockers settings UI - there is no Preferences node. I did find a Settings node, it does not have a Daemon node.
  2. There is a docker engine node that has the json docker daemon, however, trying to add the ipv6 config mentioned seems to give a validation error. image

I seem to have the latest docker desktop. Also, it would be beneficial to know why are we adding this to the configuration (why service fabric would need ipv6 or the specific cidr range)

Document Details

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

PesalaPavan commented 6 months ago

@lets-data , Thanks for your feedback! We will investigate and update as appropriate.

ManoharLakkoju-MSFT commented 6 months ago

@lets-data Thank you for bringing this to our attention. I've delegated this to content author @tomvcassidy, who will review it and offer their insightful opinions.

tomvcassidy commented 5 months ago

Hi @lets-data ! I checked with the product team, and they don't believe that enabling IPv6 is a requirement. Looking back through the commit history for the doc, it seems it was once a requirement and the instructions weren't removed when that changed.

If you wanted to use IPv6, I suspect there would need to be additional JSON parameters added like shown on the Docker documentation here: https://docs.docker.com/config/daemon/ipv6/#use-ipv6-for-the-default-bridge-network

However, even with all of this said, I regret to inform you that the dev team hasn't published an up-to-date Linux container image for a while (https://hub.docker.com/_/microsoft-service-fabric-onebox), and I've been told they don't plan to for the foreseeable future. In light of that, I've been advised to retire this article. I'll be doing that shortly.

Thanks for bringing this issue to our attention. If you find anything else, please let us know.

please-close