03b. Running Locally on a Linux Container from Visual Studio for Mac

To deploy the eShopOnWeb sample to a local Linux Docker container, from Visual Studio for Mac, follow these step-by-step instructions:

1. Clone or download the eShopOnWeb sample to a folder on your local machine.

2. Ensure that you have installed a recent version of Docker for Mac

3. Right click on the Web project in VS for Mac and select the Add menu then Docker Support. (this step has already been done for you, but this is how you would add Docker to your own project)

4. Select Linux and click on OK. This will create a new project in your solution called docker-compose. This project contains the settings for deploying to Docker.

5. Open the docker-compose.override.yml from the docker-compose project and change the line that reads 80 to read 5106. This is the port eShopOnWeb is configured to run on. (See the Program.cs file for details)

6. Press F5 to run the project or select Debug > Start Debugging from the menu.

7. Your default browser will start on a random port on localhost which is forwarded to the docker container.

Troubleshooting

The first time you run the application you may need to add a folder sharing path to Docker. Make sure you add the /usr/local/share/dotnet/sdk/NuGetFallbackFolder folder to Docker's file sharing options as detailed here.