Skip to content

Commit 50e1281

Browse files
authored
Removing outdated VS references (Part 3) (#1811)
* Initial commit * Updates * Updates * Updates * Revert removal of last official release spec * Breaking changes work #1 * Fix merge conflict * Updates * React to feedback * React to feedback * Revert Docker for Windows removal * Add note to install .NET Core workload with VS
1 parent 45835eb commit 50e1281

File tree

15 files changed

+90
-82
lines changed

15 files changed

+90
-82
lines changed

.openpublishing.redirection.json

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -708,6 +708,10 @@
708708
{
709709
"source_path": "docs/visual-basic/developing-apps/using-ide/using-the-visual-basic-development-environment.md",
710710
"redirect_url": "/visualstudio/ide/visual-studio-ide"
711+
},
712+
{
713+
"source_path": "docs/visual-basic/getting-started/breaking-changes-in-visual-studio-2015.md",
714+
"redirect_url": "/dotnet/articles/visual-basic/getting-started/breaking-changes-in-visual-studio"
711715
}
712716
]
713717
}

docs/core/docker/visual-studio-tools-for-docker.md

Lines changed: 17 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,35 @@
11
---
22
title: Visual Studio Tools for Docker
33
description: Using Visual Studio Tools for Docker
4-
keywords: .NET, .NET Core, Docker, ASP.NET Core, Visual Studio 2015
4+
keywords: .NET, .NET Core, Docker, ASP.NET Core, Visual Studio
55
author: spboyer
66
ms.author: shboyer
7-
ms.date: 09/16/2016
7+
ms.date: 04/27/2017
88
ms.topic: article
99
ms.prod: .net-core
1010
ms.technology: dotnet-docker
1111
ms.devlang: dotnet
1212
ms.assetid: 1f3b9a68-4dea-4b60-8cb3-f46164eedbbf
1313
---
1414

15-
# Visual Studio Tools for Docker
16-
Developing and debugging your application in a Docker container can be a ceremony of tasks to get setup with various tools. [Visual Studio Tools for Docker](https://visualstudiogallery.msdn.microsoft.com/0f5b2caa-ea00-41c8-b8a2-058c7da0b3e4) helps you get past the hurdles and find the bugs using F5 to debug your application directly in a locally hosted Docker Container.
15+
# Visual Studio Tools for Docker
1716

18-
> [!NOTE]
19-
>The current version targets Linux Docker containers, with Windows Containers coming soon.
17+
[Microsoft Visual Studio 2017](https://www.visualstudio.com/) with [Docker for Windows](https://docs.docker.com/docker-for-windows/install/) supports building, debugging, and running .NET Framework and .NET Core web and console applications using Windows and Linux containers.
2018

2119
## Prerequisites
22-
- [Microsoft Visual Studio 2015 Update 3](https://www.visualstudio.com/downloads/download-visual-studio-vs)
23-
- [.NET Core 1.0.1 - VS 2015 Tooling Preview 2](https://go.microsoft.com/fwlink/?LinkID=827546)
24-
- [Docker For Windows](https://www.docker.com/products/docker#/windows) to run your Docker containers locally
20+
21+
- [Microsoft Visual Studio 2017](https://www.visualstudio.com/)
22+
- [Docker for Windows](https://docs.docker.com/docker-for-windows/install/)
2523

2624
## Installation and setup
27-
Download and install the [Visual Studio Tools for Docker](https://aka.ms/DockerToolsForVS) from the [Visual Studio Gallery](http://visualstudiogallery.msdn.microsoft.com/) or you can search for it in **Extensions and Updates** within Visual Studio.
2825

29-
A required configuration is to setup **[Shared Drives](https://docs.docker.com/docker-for-windows/#/shared-drives)** in Docker for Windows. The setting is required for the volume mapping and debugging support.
26+
Install [Microsoft Visual Studio 2017](https://www.visualstudio.com/) with the .NET Core workload. Review the information at [Docker for Windows: What to know before you install](https://docs.docker.com/docker-for-windows/install/#what-to-know-before-you-install) and install [Docker For Windows](https://docs.docker.com/docker-for-windows/install/).
27+
28+
A required configuration is to setup **[Shared Drives](https://docs.docker.com/docker-for-windows/#shared-drives)** in Docker for Windows. The setting is required for the volume mapping and debugging support.
3029

3130
Right click the Docker icon in the System Tray, click Settings and select Shared Drives.
3231

33-
![Shared Drives](./media/visual-studio-tools-for-docker/settings-shared-drives-win.png)
32+
![Shared Drives](./media/visual-studio-tools-for-docker/settings-shared-drives-win.png)
3433

3534
## Create an ASP.NET Web Application and add Docker Support
3635

@@ -46,8 +45,8 @@ Project Context Menu
4645

4746
The following files are added to the project.
4847

49-
- **Dockerfile**: the Docker file for ASP.NET Core applications is based on the [microsoft/aspnetcore](https://hub.docker.com/r/microsoft/aspnetcore) image. This image includes the ASP.NET Core NuGet packages, which have been pre-jitted improving startup performance. When building .NET Core Console Applications, the Dockerfile FROM will reference the most recent [microsoft/dotnet](https://hub.docker.com/r/microsoft/dotnet) image.
50-
- **docker-compose.yml**: base Docker Compose file used to define the collection of images to be built and run with docker-compose build/run.
48+
- **Dockerfile**: the Docker file for ASP.NET Core applications is based on the [microsoft/aspnetcore](https://hub.docker.com/r/microsoft/aspnetcore) image. This image includes the ASP.NET Core NuGet packages, which have been pre-jitted improving startup performance. When building .NET Core Console Applications, the Dockerfile FROM will reference the most recent [microsoft/dotnet](https://hub.docker.com/r/microsoft/dotnet) image.
49+
- **docker-compose.yml**: base Docker Compose file used to define the collection of images to be built and run with docker-compose build/run.
5150
- **docker-compose.dev.debug.yml**: additional docker-compose file with for iterative changes when your configuration is set to debug. Visual Studio will call -f docker-compose.yml -f docker-compose.dev.debug.yml to merge these together. This compose file is used by Visual Studio development tools.
5251
- **docker-compose.dev.release.yml**: additional Docker Compose file to debug your release definition. It will volume mount the debugger so it doesn't change the contents of the production image.
5352

@@ -72,6 +71,7 @@ In this example, `image: user/hellodockertools${TAG}` generates the image `user/
7271
You will want to change the `user` to your Docker Hub username if you plan to push the image to the registry. For example, `spboyer/hellodockertools`, or change to your private registry url `privateregistry.domain.com/` depending on your configuration.
7372

7473
### Debugging
74+
7575
Select **Docker** from the debug dropdown in the toolbar and use F5 to start debugging the application.
7676

7777
- The microsoft/aspnetcore image is acquired (if not already in your cache)
@@ -97,6 +97,7 @@ CONTAINER ID IMAGE COMMAND CREATED
9797
```
9898

9999
### Edit and Continue
100+
100101
Changes to static files and/or razor template files (.cshtml) are automatically updated without the need of a compilation step. Make the change, save and tap refresh in the browser to view the update.
101102

102103
Modifications to code files require compiling and a restart of Kestrel within the container. After making the change, use CTRL + F5 to perform the process and start the application within the container. The Docker container is not rebuilt or stopped; using `docker ps` in the command line you can see that the original container is still running as of 10 minutes ago.
@@ -106,7 +107,8 @@ CONTAINER ID IMAGE COMMAND CREATED
106107
3f240cf686c9 spboyer/hellodockertools:dev "tail -f /dev/null" 10 minutes ago Up 10 minutes 0.0.0.0:32769->80/tcp hellodockertools_hellodockertools_1
107108
```
108109

109-
### Publishing Docker images
110+
### Publishing Docker images
111+
110112
Once you have completed the develop and debug cycle of your application, the Visual Studio Tools for Docker will help you create the production image of your application. Change the debug dropdown to **Release** and build the application. The tooling will produce the image with the `:latest` tag which you can push to your private registry or Docker Hub.
111113

112114
Using the `docker images` you can see the list of images.

0 commit comments

Comments
 (0)