Documentation contradictory about support for Linux containers on Windows host
Problem
According to the documentation, Linux containers are supported on the docker executor installed as a Windows runner.
Runner is installed on: | Executor is: | Container is running: |
---|---|---|
Windows | docker-windows | Windows |
Windows | docker | Linux |
However, in another part of the GitLab documentation, I see this:
Limitations of Docker executor on Windows The following are some limitations of using Windows containers with Docker executor:
Linux containers on Windows are not supported, since they are still experimental. Read the relevant issue for more details.
Currently, we have a portfolio of .NET Framework and .NET Core applications that we need to support a hybrid container model with some in Linux containers and others in Windows. Can a Windows runner support Linux containers or do I need to install a separate runner on Linux as a Docker executor in addition to a docker-windows executor on Windows?
NOTE: I don't seem to be able to pull and run Docker Linux images on this Docker host (Windows 2019 Server), so it would seem that the docker executor wouldn't work. But looking for confirmation.
Proposed solution
In the Docker executor page:
- Edit the intro paragraph for the Docker executor and add a more detailed explanation:
- If the Windows machine is able to run Linux Container, the executor when set to
docker
handles only Linux containers - If the executor is set to
docker-windows
, it handles only Windows Container on a Windows machine.
- If the Windows machine is able to run Linux Container, the executor when set to
- Revise the header labels for the table to reduce confusion.