Skip to content

Commit 2d736c9

Browse files
bamurtaughchrmarti
authored andcommitted
Update README.md
1 parent 5438541 commit 2d736c9

File tree

1 file changed

+13
-13
lines changed

1 file changed

+13
-13
lines changed

README.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# Try Out Development Containers: .NET Core
22

3-
[![Open in Remote - Containers](https://img.shields.io/static/v1?label=Remote%20-%20Containers&message=Open&color=blue&logo=visualstudiocode)](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/microsoft/vscode-remote-try-dotnetcore)
3+
[![Open in Dev Containers](https://img.shields.io/static/v1?label=Dev%20Containers&message=Open&color=blue&logo=visualstudiocode)](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/microsoft/vscode-remote-try-dotnetcore)
44

5-
A **development container** is a running [Docker](https://www.docker.com) container with a well-defined tool/runtime stack and its prerequisites. You can try out development containers with **[GitHub Codespaces](https://github.com/features/codespaces)** or **[Visual Studio Code Remote - Containers](https://aka.ms/vscode-remote/containers)**.
5+
A **development container** is a running [Docker](https://www.docker.com) container with a well-defined tool/runtime stack and its prerequisites. You can try out development containers with **[GitHub Codespaces](https://github.com/features/codespaces)** or **[Visual Studio Code Dev Containers](https://aka.ms/vscode-remote/containers)**.
66

77
This is a sample project that lets you try out either option in a few easy steps. We have a variety of other [vscode-remote-try-*](https://github.com/search?q=org%3Amicrosoft+vscode-remote-try-&type=Repositories) sample projects, too.
88

@@ -17,24 +17,24 @@ Follow these steps to open this sample in a Codespace:
1717

1818
For more info, check out the [GitHub documentation](https://docs.github.com/en/free-pro-team@latest/github/developing-online-with-codespaces/creating-a-codespace#creating-a-codespace).
1919

20-
### VS Code Remote - Containers
20+
### VS Code Dev Containers
2121

22-
If you already have VS Code and Docker installed, you can click the badge above or [here](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/microsoft/vscode-remote-try-dotnetcore) to get started. Clicking these links will cause VS Code to automatically install the Remote - Containers extension if needed, clone the source code into a container volume, and spin up a dev container for use.
22+
If you already have VS Code and Docker installed, you can click the badge above or [here](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/microsoft/vscode-remote-try-dotnetcore) to get started. Clicking these links will cause VS Code to automatically install the Dev Containers extension if needed, clone the source code into a container volume, and spin up a dev container for use.
2323

24-
Follow these steps to open this sample in a container using the VS Code Remote - Containers extension:
24+
Follow these steps to open this sample in a container using the VS Code Dev Containers extension:
2525

2626
1. If this is your first time using a development container, please ensure your system meets the pre-reqs (i.e. have Docker installed) in the [getting started steps](https://aka.ms/vscode-remote/containers/getting-started).
2727

2828
2. To use this repository, you can either open the repository in an isolated Docker volume:
2929

30-
- Press <kbd>F1</kbd> and select the **Remote-Containers: Try a Sample...** command.
30+
- Press <kbd>F1</kbd> and select the **Dev Containers: Try a Sample...** command.
3131
- Choose the ".NET Core" sample, wait for the container to start, and try things out!
32-
> **Note:** Under the hood, this will use the **Remote-Containers: Clone Repository in Container Volume...** command to clone the source code in a Docker volume instead of the local filesystem. [Volumes](https://docs.docker.com/storage/volumes/) are the preferred mechanism for persisting container data.
32+
> **Note:** Under the hood, this will use the **Dev Containers: Clone Repository in Container Volume...** command to clone the source code in a Docker volume instead of the local filesystem. [Volumes](https://docs.docker.com/storage/volumes/) are the preferred mechanism for persisting container data.
3333
3434
Or open a locally cloned copy of the code:
3535

3636
- Clone this repository to your local filesystem.
37-
- Press <kbd>F1</kbd> and select the **Remote-Containers: Open Folder in Container...** command.
37+
- Press <kbd>F1</kbd> and select the **Dev Containers: Open Folder in Container...** command.
3838
- Select the cloned copy of this folder, wait for the container to start, and try things out!
3939

4040
3. If you want to enable **HTTPS**, see [enabling HTTPS](#enabling-https) to reuse your local development cert in the container.
@@ -65,7 +65,7 @@ Some things to try:
6565
- Clicking the globe icon in the 'Ports' view. The 'Ports' view gives you an organized table of your forwarded ports, and you can access it with the command **Ports: Focus on Ports View**.
6666
- Notice port 5000 in the 'Ports' view is labeled "Hello Remote World." In `devcontainer.json`, you can set `"portsAttributes"`, such as a label for your forwarded ports and the action to be taken when the port is autoforwarded.
6767

68-
> **Note:** In Remote - Containers, you can access your app at `http://localhost:5000` in a local browser. But in a browser-based Codespace, you must click the link from the notification or the `Ports` view so that the service handles port forwarding in the browser and generates the correct URL.
68+
> **Note:** In Dev Containers, you can access your app at `http://localhost:5000` in a local browser. But in a browser-based Codespace, you must click the link from the notification or the `Ports` view so that the service handles port forwarding in the browser and generates the correct URL.
6969
7070
5. **Rebuild or update your container**
7171

@@ -75,7 +75,7 @@ Some things to try:
7575

7676
- Open the `.devcontainer/devcontainer.json` file.
7777
- Modify the `"onAutoForward"` attribute in your `portsAttributes` from `"notify"` to `"openBrowser"`.
78-
- Press <kbd>F1</kbd> and select the **Remote-Containers: Rebuild Container** or **Codespaces: Rebuild Container** command so the modifications are picked up.
78+
- Press <kbd>F1</kbd> and select the **Dev Containers: Rebuild Container** or **Codespaces: Rebuild Container** command so the modifications are picked up.
7979

8080
### Enabling HTTPS
8181

@@ -114,7 +114,7 @@ To enable HTTPS for this sample, you can mount an exported copy of a locally gen
114114
115115
4. Finally, make the certificate available in the container as follows:
116116
117-
**If using GitHub Codespaces and/or Remote - Containers**
117+
**If using GitHub Codespaces and/or Dev Containers**
118118
119119
1. Start the container/codespace
120120
2. Drag `~/.aspnet/https/aspnetapp.pfx` from your local machine into the root of the File Explorer in VS Code.
@@ -123,15 +123,15 @@ To enable HTTPS for this sample, you can mount an exported copy of a locally gen
123123
mkdir -p /home/vscode/.aspnet/https && mv aspnetapp.pfx /home/vscode/.aspnet/https
124124
```
125125
126-
**If using only Remote - Containers with a local container**
126+
**If using only Dev Containers with a local container**
127127
128128
Add the following to `.devcontainer/devcontainer.json`:
129129
130130
```json
131131
"mounts": [ "source=${env:HOME}${env:USERPROFILE}/.aspnet/https,target=/home/vscode/.aspnet/https,type=bind" ]
132132
```
133133
134-
5. If you've already opened your folder in a container, rebuild the container using the **Remote-Containers: Rebuild Container** command from the Command Palette (<kbd>F1</kbd>) so the settings take effect.
134+
5. If you've already opened your folder in a container, rebuild the container using the **Dev Containers: Rebuild Container** command from the Command Palette (<kbd>F1</kbd>) so the settings take effect.
135135
136136
Next time you debug using VS Code (<kbd>F5</kbd>), you'll be able to use HTTPS! Note that you will need to specifically navigate to `https://localhost:5001` to get the certificate to work (**not** `https://127.0.0.1:5001`).
137137

0 commit comments

Comments
 (0)