Docker machine link redirects to Docker Desktop documentation

[andrew-morris-rgs]

Related Issues

The webpage:
https://ranchermanager.docs.rancher.com/how-to-guides/new-user-guides/authentication-permissions-and-global-configuration/about-provisioning-drivers/manage-node-drivers

has a link to "docker-machines" but that link redirects to https://docs.docker.com/desktop/ which does not explain the topic at all. I also could not find any docker machine documentation on dockers home page.

[martyav]

I did a little research. The Docker Machine repo is now archived and the project is deprecated.

From docker/machine#4894 (comment):

We are not actively maintaining this project and see Docker Desktop as its successor for container development on macOS and Windows. I've added an item on our docker/roadmap#245 where you can leave us feedback.

From docker/roadmap#245:

The Docker Machine project started in 2014 to make it easier to setup and run Docker in a virtual machine. One of the major use cases for this was to make it easier to use Docker on macOS and Windows. Since its release in 2016, Docker Desktop has been seen as the replacement for Docker Machine to develop with containers on macOS and Windows. Not only does Docker Desktop provide a Docker API endpoint but it also provides transparent handling of file sharing and networking between the host and VM which make container development easier.

Rancher: Node Drivers contains a link to https://docs.docker.com/machine/ but that page has been removed and the Docker site redirects visitors to https://docs.docker.com/desktop/ instead.

Curiously enough, Rancher maintains its own fork of Docker Machine at https://github.com/rancher/machine. The README on that repo points to https://gcbw.github.io/docker.github.io/machine/, a mirror of the original Docker Machine docs.

The Rancher fork notes:

This project is intended to be embedded and executed by the full Rancher product and the stand alone cli functionality will remain but the human use of it will not be the primary focus as we will expect inputs provided by other things like Terraform or UIs.

@jiaqiluo do you know how/if this effects user-developed node drivers? The docs section that contains the dead Docker Machine link is specifically about users developing their own drivers.

[jiaqiluo]

hi @martyav, following the links in the README in rancher/machine, I found this website which seems to be the correct link to use in docs.