Skip to content

Commit e60312e

Browse files
authored
Merge branch 'main' into patch-1
2 parents dfc3738 + b44f540 commit e60312e

File tree

453 files changed

+2591
-1542
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

453 files changed

+2591
-1542
lines changed

.github/workflows/stale-issues.yml

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ name: close-stale-issues
77
on:
88
schedule:
99
- cron: "0 0 * * 4"
10+
workflow_dispatch:
1011

1112
permissions:
1213
contents: read
@@ -18,7 +19,7 @@ jobs:
1819
pull-requests: write # for actions/stale to close stale PRs
1920
runs-on: ubuntu-latest
2021
steps:
21-
- uses: actions/stale@v4.0.0
22+
- uses: actions/stale@v6
2223
with:
2324
repo-token: ${{ secrets.GITHUB_TOKEN }}
2425
stale-issue-message: 'Thanks for sharing your feedback. We apologize for our delayed response. Due to the sheer volume of feedback in our repo, we have decided to prioritize the newest issues and are automatically closing our oldest issues with an Issues bot. If you believe your feedback is still actionable, then either respond directly in this issue or open a new documentation issue and we’ll review. If no activity occurs in the next 14 days, this issue will be closed.'

.github/workflows/stale.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ jobs:
1313
pull-requests: write
1414

1515
steps:
16-
- uses: actions/stale@v4.0.0
16+
- uses: actions/stale@v6
1717
with:
1818
repo-token: ${{ secrets.GITHUB_TOKEN }}
1919
days-before-pr-stale: 14

CONTRIBUTING.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# Contribute to Visual Studio documentation
22

3-
Thank you for taking the time to contribute to the Visual Studio docs.
3+
Thank you for taking the time to contribute to the Visual Studio documentation.
44

5-
This guide covers some general topics around contributing and refers out to the docs.microsoft.com [contributors guide](https://docs.microsoft.com/contribute) for more detailed explanations.
5+
This guide covers some general topics around contributing and refers to the [Microsoft Docs contributor guide](https://learn.microsoft.com/contribute) for more detailed explanations.
66

77
## Code of conduct
88

@@ -20,11 +20,11 @@ Please use the feedback tool at the bottom of any article to submit bugs and sug
2020

2121
### Quick edit in GitHub
2222

23-
Follow the guidance for [quick edits to existing documents](https://docs.microsoft.com/contribute/#quick-edits-to-existing-documents) in the contributors guide.
23+
Follow the guidance for [quick edits to existing documents](https://learn.microsoft.com/contribute/#quick-edits-to-existing-documents) in the contributors guide.
2424

2525
### Larger edits
2626

27-
Review the guidance for [pull requests](https://docs.microsoft.com/contribute/how-to-write-workflows-major#pull-request-processing) in the contributors guide.
27+
Review the guidance for [pull requests](https://learn.microsoft.com/contribute/how-to-write-workflows-major#pull-request-processing) in the contributors guide.
2828

2929
**NOTE**
3030

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Visual Studio documentation
22

3-
Welcome! This repo contains source files for the Visual Studio technical documentation. The topics are published on [docs.microsoft.com](https://docs.microsoft.com/visualstudio).
3+
Welcome! This repo contains source files for the Visual Studio technical documentation. The topics are published at [Visual Studio product family documentation](https://learn.microsoft.com/visualstudio).
44

55
This repo was moved on June 23, 2017 from https://github.com/Microsoft/vsdocs.
66

bridge/articles/bridge-to-kubernetes-sample.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ minikube start --vm-driver hyperv --hyperv-virtual-switch "Primary Virtual Switc
4444

4545
## Deploy the application
4646

47-
Clone the [mindaro repo](https://github.com/Microsoft/mindaro) and open a command window with the current working folder to *samples/todo-app*.
47+
Clone the [Bridge to Kubernetes repo](https://github.com/Azure/Bridge-To-Kubernetes) and open a command window with the current working folder to *samples/todo-app*.
4848

4949
Create a namespace for the sample.
5050

bridge/articles/bridge-to-kubernetes-vs.md

Lines changed: 14 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -30,9 +30,9 @@ In this tutorial, you learn how to:
3030

3131
- A Kubernetes cluster. You can create one in the [Azure portal](https://azure.microsoft.com/free/). If you don't have an Azure subscription, you can [create an account for free](https://azure.microsoft.com/free/).
3232
- The [kubectl](https://kubernetes.io/docs/reference/kubectl/kubectl/) executable installed on your system.
33-
- [Visual Studio 2019](https://www.visualstudio.com/vs/) version 16.7 or later running on Windows 10 or later.
34-
- The Bridge to Kubernetes extension for [Visual Studio 2019](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.mindaro) or [Visual Studio 2022](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.mindaro2022).
35-
- An application to troubleshoot, such as this [TODO App sample application](https://github.com/Microsoft/mindaro).
33+
- [Visual Studio 2019](https://www.visualstudio.com/vs/) version 16.7 or later running on Windows 10 or later or [Visual Studio 2022](https://www.visualstudio.com/vs/).
34+
- The [Bridge to Kubernetes extension for Visual Studio 2019](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.mindaro) or [Bridge to Kubernetes extension for Visual Studio 2022](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.mindaro2022).
35+
- An application to troubleshoot, such as this [TODO App sample application](https://github.com/Azure/Bridge-To-Kubernetes/tree/main/samples/todo-app).
3636

3737
## Set up a service
3838

@@ -51,7 +51,7 @@ The sample application has a frontend to interact and a backend that provides pe
5151
1. Clone the sample repo.
5252

5353
```bash
54-
git clone https://github.com/Microsoft/mindaro
54+
git clone https://github.com/Azure/Bridge-To-Kubernetes
5555
```
5656

5757
1. Change directory to *samples/todo-app* and then create a namespace for the sample.
@@ -163,6 +163,16 @@ In this section, you set a breakpoint in your service.
163163

164164
1. To remove the breakpoint, select that line and then select **Debug** > **Toggle Breakpoint** or select **F9**.
165165

166+
## Edit launch profile
167+
168+
If you need to change how Bridge to Kubernetes connects to your cluster, in this section, you'll edit the launch profile settings.
169+
170+
1. Click on the arrow next to the **Bridge to Kubernetes** button, then click on **databaseApi Debug Properties**.
171+
![Screenshot shows the Bridge to Kubernetes drop down menu.](media/bridge-to-kubernetes-vs/change-bridge-properties.png)
172+
173+
1. Click on the **Edit profile for Bridge to Kubernetes** link in the **Launch Profiles** dialog.
174+
![Screenshot shows Launch Profiles dialog with a link to edit the Bridge to Kubernetes profile](media/bridge-to-kubernetes-vs/bridge-launch-profiles.png)
175+
166176
## Clean up resources
167177

168178
If you used the sample todo app for this tutorial, you can remove it from your cluster by using the Azure portal.
Loading
Loading

docs/azure/azure-app-insights-add-connected-service.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,6 @@ ms.workload: azure-vs
88
ms.topic: conceptual
99
ms.date: 08/17/2020
1010
ms.author: angelpe
11-
monikerRange: ">= vs-2019"
1211
---
1312
# Add Azure Application Insights by using Visual Studio Connected Services
1413

docs/azure/azure-sql-database-add-connected-service.md

Lines changed: 46 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ manager: jmartens
66
ms.technology: vs-azure
77
ms.workload: azure-vs
88
ms.topic: conceptual
9-
ms.date: 08/17/2020
9+
ms.date: 09/16/2022
1010
ms.author: angelpe
1111
monikerRange: ">= vs-2019"
1212
---
@@ -83,6 +83,51 @@ The connected service functionality adds all the needed references and connectio
8383

8484
![Service dependencies](./media/azure-sql-database-add-connected-service/service-dependencies-after.png)
8585

86+
## Entity Framework migrations
87+
88+
It might be convenient to work with a local data store during early development, but with Entity Framework Core, when you're ready to move to the cloud, you can use Visual Studio's support for Entity Framework migration to move your database, or merge changes with a remote data store. See [Migrations overview](/ef/core/managing-schemas/migrations/?tabs=vs).
89+
90+
On the **Connected Services** tab, you can find the migration commands by clicking on the three dots, as shown in the screenshot:
91+
92+
![Screenshot showing migration commands.](./media/vs-2022/add-migration-light-theme.png)
93+
94+
Commands are available there to create new migrations, apply them directly, or generate SQL scripts that apply the migrations.
95+
96+
:::moniker range=">=vs-2022"
97+
98+
### Add migration
99+
100+
When a data model change is introduced, you can use Entity Framework Core tools to add a corresponding migration that describes in code the updates necessary to keep the database schema in sync. Entity Framework Core compares the current model against a snapshot of the old model to determine the differences, and generates migration source files. The files are added to your project, usually in a folder called *Migrations* and can be tracked in your project's source control like any other source file.
101+
102+
When you choose this option, you're asked to provide the context class name that represents the database schema you want to migrate.
103+
104+
![Screenshot showing adding an Entity Framework migration.](./media/vs-2022/entity-framework-migration-context.png)
105+
106+
### Update database
107+
108+
After a migration has been created, it can be applied to a database. Entity Framework updates your database and your schema with the changes specified in the migration code. When you choose this option, you're asked to provide the context class name that represents the database schema you want to migrate.
109+
110+
### Generate SQL script
111+
112+
The recommended way to deploy migrations to a production database is by generating SQL scripts. The advantages of this strategy include the following:
113+
114+
- SQL scripts can be reviewed for accuracy; this is important since applying schema changes to production databases is a potentially dangerous operation that could involve data loss.
115+
- In some cases, the scripts can be tuned to fit the specific needs of a production database.
116+
- SQL scripts can be used in conjunction with a deployment technology, and can even be generated as part of your CI process.
117+
- SQL scripts can be provided to a DBA, and can be managed and archived separately.
118+
119+
When you use this option, you're asked the database context class and the location for the script file.
120+
121+
![Screenshot showing the Generate SQL script option.](./media/vs-2022/entity-framework-generate-sql-script.png)
122+
123+
### Open in SQL Server Object Explorer
124+
125+
For convenience, this command lets you jump to the SQL Server Object Explorer, so you can view tables and other database entities, and work directly with your data. See [Object explorer](/sql/ssms/object/object-explorer).
126+
127+
![Screenshot showing SQL Server Object Explorer.](./media/vs-2022/sql-server-object-explorer-2.png)
128+
129+
:::moniker-end
130+
86131
## See also
87132

88133
- [Azure SQL Database product page](https://azure.microsoft.com/services/sql-database/)
Loading
41.5 KB
Loading
Loading
Loading
Loading
34 KB
Loading
Loading
Loading

docs/code-quality/index.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
### YamlMime:Landing
22

3-
title: Analyze code in Visual Studio
3+
title: Code analysis documentation - Visual Studio (Windows)
44
summary: Visual Studio provides several different tools to analyze and improve code quality.
55

66
metadata:
7-
title: Code analyzers
7+
title: Code analysis documentation - Visual Studio (Windows)
88
description: Learn how Visual Studio can help you analyze code quality.
99
ms.prod: visual-studio-windows
1010
ms.technology: vs-ide-code-analysis

docs/containers/includes/vs-2017/container-tools.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ With Visual Studio, you can easily build, debug, and run containerized ASP.NET C
1313
## Prerequisites
1414

1515
* [Docker Desktop](https://hub.docker.com/editions/community/docker-ce-desktop-windows)
16-
* [Visual Studio 2017](https://visualstudio.microsoft.com/vs/older-downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=vs+2017+download) with the **Web Development**, **Azure Tools** workload, and/or **.NET Core cross-platform development** workload installed
16+
* [Visual Studio 2017](https://visualstudio.microsoft.com/vs/older-downloads/?utm_medium=microsoft&utm_source=learn.microsoft.com&utm_campaign=vs+2017+download) with the **Web Development**, **Azure Tools** workload, and/or **.NET Core cross-platform development** workload installed
1717
* To publish to Azure Container Registry, an Azure subscription. [Sign up for a free trial](https://azure.microsoft.com/free/dotnet/).
1818

1919
## Installation and setup

docs/containers/overview.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Get to know the tools available in Visual Studio for working with D
44
author: ghogen
55
ms.author: ghogen
66
ms.topic: overview
7-
ms.date: 10/27/2021
7+
ms.date: 10/07/2022
88
ms.technology: vs-container-tools
99
---
1010
# Visual Studio Container Tools for Docker
@@ -31,7 +31,7 @@ The support for Docker in Visual Studio has changed over a number of releases in
3131
With Visual Studio 2019, you can use Docker Compose, Kubernetes, and Service Fabric as container orchestration services.
3232

3333
> [!NOTE]
34-
> When creating a .NET Framework or .NET Core console project, there is no option to **Add Docker support**. After a .NET Core console application project is created, the **Add Docker support** option is available. .Net Framework console application projects do not support the **Add Docker support** option after the project is created. After creation both .NET Framework or .NET Core console projects support the **Add Container Orchestrator Support** option using Service Fabric or Docker Compose.
34+
> When creating a .NET Framework or .NET Core console project, there is no option to **Add Docker support**. After a .NET Core console application project is created, the **Add Docker support** option is available. .NET Framework console application projects do not support the **Add Docker support** option after the project is created. After creation both .NET Framework or .NET Core console projects support the **Add Container Orchestrator Support** option using Service Fabric or Docker Compose.
3535
3636
In Visual Studio 2019 version 16.4 and later, the **Containers** window is available, which lets you view running containers, browse available images, view environment variables, logs, and port mappings, inspect the filesystem, attach a debugger, or open a terminal window inside the container environment. See [Use the Containers window](view-and-diagnose-containers.md).
3737

docs/containers/troubleshooting-docker-errors.md

Lines changed: 6 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.assetid: 346f70b9-7b52-4688-a8e8-8f53869618d3
99
ms.devlang: dotnet
1010
ms.topic: troubleshooting
1111
ms.workload: multiple
12-
ms.date: 11/12/2021
12+
ms.date: 10/12/2022
1313
ms.author: ghogen
1414
---
1515
# Troubleshoot Visual Studio development with Docker
@@ -28,7 +28,7 @@ File sharing only needs to be managed if you are using Hyper-V with Docker. If y
2828
![Shared drives](media/troubleshooting-docker-errors/docker-settings-image.png)
2929

3030
> [!TIP]
31-
> Visual Studio versions later than Visual Studio 2017 version 15.6 will prompt when **Shared Drives** aren't configured.
31+
> Visual Studio prompts you when **Shared Drives** aren't configured.
3232
3333
## Unable to start debugging
3434

@@ -89,18 +89,12 @@ Click **Apply & Restart**. These steps modify the configuration file at *%Progra
8989

9090
## Container type mismatch
9191

92-
When adding Docker support to a project, you choose either a Windows or a Linux container. If the Docker Server host is not configured to run the same container type as the project target, you will likely see an error similar to the one below:
92+
When adding Docker support to a project, you choose either a Windows or a Linux container. If the Docker Server host is not configured to run the same container type as the project target, you see an error similar to:
9393

9494
![Screenshot of Docker Host and Project Mismatch](media/troubleshooting-docker-errors/docker-host-config-change-linux-to-windows.png)
9595

96-
To resolve this issue:
96+
To resolve this issue, right-click the Docker for Windows icon in the System Tray and choose **Switch to Windows containers...** or **Switch to Linux containers...**.
9797

98-
- Right-click the Docker for Windows icon in the System Tray and choose **Switch to Windows containers...** or **Switch to Linux containers...**.
98+
## Other issues
9999

100-
## Microsoft/DockerTools GitHub repo
101-
102-
For any other issues you encounter, see [Microsoft/DockerTools](https://github.com/microsoft/dockertools/issues) issues.
103-
104-
## See also
105-
106-
- [Visual Studio troubleshooting](/troubleshoot/visualstudio/welcome-visual-studio/)
100+
For any other issues, see the [Microsoft/DockerTools](https://github.com/microsoft/dockertools/issues) repo.

0 commit comments

Comments
 (0)