You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Update docs for new Container Tools extension (#8289)
* Update docs outside of `docs\containers`
* Update docs with new Container Tools extension
* One more doc
* Finish the docs/containers files
* A few missed things
* Replace images/app-service images and cleanup
* Replace images/devenv images
* Replace images/compose images and clean up
* Replace (mostly) images/overview images
* Replace images/quickstarts
* Replace some external images
* Replace images/registries images
* Replace images in devcontainers\images\containers
* Replace images in api\working-witih-extensions\images\publishing-extension
* Replace images in images\overview (temporary)
Copy file name to clipboardExpand all lines: docs/azure/kubernetes.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,7 +29,7 @@ To install the Kubernetes extension, open the Extensions view (`kb(workbench.vie
29
29
30
30
## Containerize and publish the application
31
31
32
-
You can follow the [Working with Docker](/docs/azure/docker.md) tutorial to build your project, generate a Docker image, and push it to a public or private container registry through the Microsoft [Docker Extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-docker).
32
+
You can follow the [Working with Docker](/docs/azure/docker.md) tutorial to build your project, generate a Docker image, and push it to a public or private container registry through the Microsoft [Container Tools Extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-containers).
*[Docker](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-docker) - Create, manage, and debug containerized applications.
197
+
*[Container Tools](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-containers) - Create, manage, and debug containerized applications.
198
198
*[Even Better TOML](https://marketplace.visualstudio.com/items?itemName=tamasfe.even-better-toml) - Fully-featured TOML support for e.g. `pyproject.toml` files.
*[Python Environments](https://marketplace.visualstudio.com/items?itemName=ms-python.vscode-python-envs) - Manage Python environments and packages using your preferred environment manager.
@@ -285,11 +285,11 @@ This profile also sets the following settings:
285
285
286
286
The Node.js profile is a good starting point for all Node.js work. It comes with the following extensions:
287
287
288
-
*[ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) - Integrates ESLint JavaScript into VS Code.
288
+
*[Container Tools](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-containers) - Create, manage, and debug containerized applications.
289
289
*[Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) - Create custom development environments inside a Docker container.
290
-
*[Docker](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-docker) - Create, manage, and debug containerized applications.
291
290
*[DotENV](https://marketplace.visualstudio.com/items?itemName=mikestead.dotenv) - Support for dotenv file syntax.
292
291
*[EditorConfig for VS Code](https://marketplace.visualstudio.com/items?itemName=EditorConfig.EditorConfig) - EditorConfig Support for Visual Studio Code.
292
+
*[ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) - Integrates ESLint JavaScript into VS Code.
293
293
*[JavaScript (ES6) code snippets](https://marketplace.visualstudio.com/items?itemName=xabikos.JavaScriptSnippets) - Code snippets for JavaScript in ES6 syntax.
294
294
*[Jest](https://marketplace.visualstudio.com/items?itemName=Orta.vscode-jest) - Use Facebook's [jest](https://jestjs.io) testing framework.
295
295
*[Microsoft Edge Tools for VS Code](https://marketplace.visualstudio.com/items?itemName=ms-edgedevtools.vscode-edge-devtools) - Use the Microsoft Edge Tools from within VS Code.
Copy file name to clipboardExpand all lines: docs/containers/app-service.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,8 +18,8 @@ In this guide you will learn how to:
18
18
## Prerequisites
19
19
20
20
- An Azure subscription.
21
-
-[Docker](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-docker) and [Azure App Service](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azureappservice) extensions must be installed.
22
-
- A [**web** application](https://learn.microsoft.com/azure/app-service/tutorial-custom-container) that produces a docker image. You could also follow [Create a sample ASP .NET Core application](/docs/containers/quickstart-aspnet-core.md) to create such application.
21
+
-The [Container Tools](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-containers) and [Azure App Service](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azureappservice) extensions must be installed.
22
+
- A [**web** application](https://learn.microsoft.com/azure/app-service/tutorial-custom-container) that produces a container image. You could also follow [Create a sample ASP .NET Core application](/docs/containers/quickstart-aspnet-core.md) to create such application.
23
23
- You need a [Docker Hub](https://hub.docker.com/) account or an instance of [Azure Container Registry (ACR)](https://learn.microsoft.com/azure/container-registry/container-registry-get-started-portal).
24
24
25
25
## Create the application image
@@ -28,35 +28,35 @@ If you already have an image, skip this step and proceed to [Push the image to a
28
28
29
29
1. Open the application folder in VS Code.
30
30
31
-
2. Open Command Palette (`kb(workbench.action.showCommands)`) and use **Docker Images: Build Image...** command to build the image.
31
+
2. Open Command Palette (`kb(workbench.action.showCommands)`) and use **Container Images: Build Image...** command to build the image.
Before deploying the image to an App Service or a Container App, the image must be uploaded to a container registry. The image can be uploaded to either [Azure Container Registry (ACR)](https://learn.microsoft.com/azure/container-registry/container-registry-get-started-portal) or [Docker Hub](https://hub.docker.com/).
42
42
43
-
1. Open the Docker Explorer and select **Connect Registry...** icon under **Registries** group and follow the prompt. Choose the provider (Azure or Docker Hub) and provide the credential to connect to the registry.
43
+
1. Open the Container Explorer and select **Connect Registry...** icon under **Registries** group and follow the prompt. Choose the provider (Azure or Docker Hub) and provide the credential to connect to the registry.
44
44
45
45

46
46
47
47
2. Now the registry will be visible under Registries.
3. Optionally, tag the image. In order to upload an image to a registry, the image needs to be tagged with registry name so that the docker push will upload it to the right registry.
52
-
- To create a registry in Azure ACR, open the **Registries** section of the Docker view, sign in to Azure if not already signed in, and then right-click on the subscription you want to use, and choose **Create Registry**.
53
-
- The image built in previous section will appear in the Docker Explorer under Images section. Right-click and choose **Tag...**.
51
+
3. Optionally, tag the image. In order to upload an image to a registry, the image needs to be tagged with registry name so that the `docker push` command will upload it to the right registry.
52
+
- To create a registry in Azure ACR, open the **Registries** section of the Container Explorer, sign in to Azure if not already signed in, and then right-click on the subscription you want to use, and choose **Create Registry**.
53
+
- The image built in previous section will appear in the Container Explorer under Images section. Right-click and choose **Tag...**.
- Specify the new name `<your registry or username>/<image name>:<tag>` and complete the
57
57
tag action. For example, new image name for ACR named WebApp6 would be 'webapp6.azurecr.io/webapp6:latest' and for Docker Hub it would be 'myusername/webapp6:latest'.
58
58
59
-
4. The image will show up in the Docker Explorer under the registry that the image tag points to. Select this image and choose **Push**. If the image has not yet been tagged, you will be prompted to choose a registry to push to, and the image will be tagged based on the selection.
59
+
4. The image will show up in the Container Explorer under the registry that the image tag points to. Select this image and choose **Push**. If the image has not yet been tagged, you will be prompted to choose a registry to push to, and the image will be tagged based on the selection.
@@ -68,7 +68,7 @@ Before deploying the image to an App Service or a Container App, the image must
68
68
69
69
In the previous section, the image is pushed to a remote container registry. Now deploy this image to Azure App Service or Azure Container Apps.
70
70
71
-
1. In Docker Explorer, navigate to your image under Registries, right-click on the tag, and select **Deploy Image To Azure App Service...** or **Deploy Image to Azure Container Apps...**.
71
+
1. In Container Explorer, navigate to your image under Registries, right-click on the tag, and select **Deploy Image To Azure App Service...** or **Deploy Image to Azure Container Apps...**.
72
72
73
73

74
74
@@ -81,7 +81,7 @@ In the previous section, the image is pushed to a remote container registry. Now
Copy file name to clipboardExpand all lines: docs/containers/choosing-dev-environment.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -28,7 +28,7 @@ The second important choice is whether to debug your service running as an ordin
28
28
29
29
1. Debugging your service running in a container is possible, but brings additional complexity. Use normal debugging by default, and debugging in the container when you need it.
30
30
31
-
> The Docker extension natively supports container debugging for .NET-, Node.js-, and Python-based services.
31
+
> The Container Tools extension natively supports container debugging for .NET-, Node.js-, and Python-based services.
32
32
33
33
## Enabling Docker CLI inside a remote development environment
34
34
@@ -86,11 +86,11 @@ After Docker is installed and working on the remote machine, you can use VS Code
86
86
87
87
1. A new VS Code window opens, running in the context of the target machine. If you're using password authentication, the password will be prompted here. We strongly recommend that you set up [SSH key authentication](https://www.ssh.com/ssh/public-key-authentication), for ease of use.
88
88
89
-
1. In the Extensions view, install the Docker extension (on the remote host) (a reload may be required after this step):
89
+
1. In the Extensions view, install the Container Tools extension (on the remote host) (a reload may be required after this step):
90
90
91
-

91
+

92
92
93
-
>**Note**: If you are using the Docker extension to build Docker images and have source code, the approach above probably means you have your source enlistment on the remote host, rather than on your developer workstation. If you are just using the Docker extension for the Docker Explorer features, then you can disregard this.
93
+
>**Note**: If you are using the Container Tools extension to build container images and have source code, the approach above probably means you have your source enlistment on the remote host, rather than on your developer workstation. If you are just using the Container Tools extension for the Container Explorer features, then you can disregard this.
94
94
95
95
### Local Linux VM
96
96
@@ -100,7 +100,7 @@ Alternatively, you can install just the Docker CLI inside your development envir
100
100
101
101
## Debugging in a container
102
102
103
-
The Docker extension supports debugging .NET and Node.js-based services running inside a container. Other programming languages are not supported at this time.
103
+
The Container Tools extension supports debugging .NET and Node.js-based services running inside a container. Other programming languages are not supported at this time.
104
104
105
105
Debugging in a container may be harder to set up than regular debugging because a container is a stronger isolation mechanism than a process. In particular:
106
106
@@ -109,7 +109,7 @@ Debugging in a container may be harder to set up than regular debugging because
109
109
110
110
Because of the concerns above, it is generally recommended to use regular debugging, and employ debugging in a container when necessary.
111
111
112
-
For more information about how to set up debugging inside a container see [ASP.NET Core quickstart](/docs/containers/quickstart-aspnet-core.md), [Node.js quickstart](/docs/containers/quickstart-node.md), and [Docker extension task properties](/docs/containers/reference.md) (`docker-build` and `docker-run` tasks).
112
+
For more information about how to set up debugging inside a container see [ASP.NET Core quickstart](/docs/containers/quickstart-aspnet-core.md), [Node.js quickstart](/docs/containers/quickstart-node.md), and [Container Tools extension task properties](/docs/containers/reference.md) (`docker-build` and `docker-run` tasks).
0 commit comments