-
Notifications
You must be signed in to change notification settings - Fork 5.9k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Update install docs for .NET 8 (#38071)
* Update install docs for .NET 8 * Add note to top of ubuntu articles
- Loading branch information
Showing
36 changed files
with
344 additions
and
100 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,28 @@ | ||
--- | ||
author: adegeo | ||
ms.author: adegeo | ||
ms.date: 11/14/2023 | ||
ms.topic: include | ||
--- | ||
|
||
### Install the SDK | ||
|
||
The .NET SDK allows you to develop apps with .NET. If you install the .NET SDK, you don't need to install the corresponding runtime. To install the .NET SDK, run the following command: | ||
|
||
```bash | ||
sudo apk add dotnet8-sdk | ||
``` | ||
|
||
### Install the runtime | ||
|
||
The ASP.NET Core Runtime allows you to run apps that were made with .NET that didn't provide the runtime. The following command installs the ASP.NET Core Runtime, which is the most compatible runtime for .NET. In your terminal, run the following command: | ||
|
||
```bash | ||
sudo apk add aspnetcore8-runtime | ||
``` | ||
|
||
As an alternative to the ASP.NET Core Runtime, you can install the .NET Runtime, which doesn't include ASP.NET Core support: replace `aspnetcore8-runtime` in the previous command with `dotnet8-runtime`: | ||
|
||
```bash | ||
sudo apk add dotnet8-runtime | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,36 @@ | ||
--- | ||
author: adegeo | ||
ms.author: adegeo | ||
ms.date: 11/14/2023 | ||
ms.topic: include | ||
--- | ||
|
||
### Install the SDK | ||
|
||
The .NET SDK allows you to develop apps with .NET. If you install the .NET SDK, you don't need to install the corresponding runtime. To install the .NET SDK, run the following commands: | ||
|
||
```bash | ||
sudo apt-get update && \ | ||
sudo apt-get install -y dotnet-sdk-8.0 | ||
``` | ||
|
||
> [!IMPORTANT] | ||
> If you receive an error message similar to **Unable to locate package dotnet-sdk-8.0**, see the [troubleshooting](#troubleshooting) section. | ||
### Install the runtime | ||
|
||
The ASP.NET Core Runtime allows you to run apps that were made with .NET that didn't provide the runtime. The following commands install the ASP.NET Core Runtime, which is the most compatible runtime for .NET. In your terminal, run the following commands: | ||
|
||
```bash | ||
sudo apt-get update && \ | ||
sudo apt-get install -y aspnetcore-runtime-8.0 | ||
``` | ||
|
||
> [!IMPORTANT] | ||
> If you receive an error message similar to **Unable to locate package aspnetcore-runtime-8.0**, see the [troubleshooting](#troubleshooting) section. | ||
As an alternative to the ASP.NET Core Runtime, you can install the .NET Runtime, which doesn't include ASP.NET Core support: replace `aspnetcore-runtime-8.0` in the previous command with `dotnet-runtime-8.0`: | ||
|
||
```bash | ||
sudo apt-get install -y dotnet-runtime-8.0 | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,28 @@ | ||
--- | ||
author: adegeo | ||
ms.author: adegeo | ||
ms.date: 11/14/2023 | ||
ms.topic: include | ||
--- | ||
|
||
### Install the SDK | ||
|
||
The .NET SDK allows you to develop apps with .NET. If you install the .NET SDK, you don't need to install the corresponding runtime. To install the .NET SDK, run the following command: | ||
|
||
```bash | ||
sudo dnf install dotnet-sdk-8.0 | ||
``` | ||
|
||
### Install the runtime | ||
|
||
The ASP.NET Core Runtime allows you to run apps that were made with .NET that didn't provide the runtime. The following command installs the ASP.NET Core Runtime, which is the most compatible runtime for .NET. In your terminal, run the following command: | ||
|
||
```bash | ||
sudo dnf install aspnetcore-runtime-8.0 | ||
``` | ||
|
||
As an alternative to the ASP.NET Core Runtime, you can install the .NET Runtime, which doesn't include ASP.NET Core support: replace `aspnetcore-runtime-8.0` in the previous command with `dotnet-runtime-8.0`: | ||
|
||
```bash | ||
sudo dnf install dotnet-runtime-8.0 | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,28 @@ | ||
--- | ||
author: adegeo | ||
ms.author: adegeo | ||
ms.date: 11/14/2023 | ||
ms.topic: include | ||
--- | ||
|
||
### Install the SDK | ||
|
||
The .NET SDK allows you to develop apps with .NET. If you install the .NET SDK, you don't need to install the corresponding runtime. To install the .NET SDK, run the following command: | ||
|
||
```bash | ||
sudo yum install dotnet-sdk-8.0 | ||
``` | ||
|
||
### Install the runtime | ||
|
||
The ASP.NET Core Runtime allows you to run apps that were made with .NET that didn't provide the runtime. The following command installs the ASP.NET Core Runtime, which is the most compatible runtime for .NET. In your terminal, run the following command: | ||
|
||
```bash | ||
sudo yum install aspnetcore-runtime-8.0 | ||
``` | ||
|
||
As an alternative to the ASP.NET Core Runtime, you can install the .NET Runtime, which doesn't include ASP.NET Core support: replace `aspnetcore-runtime-8.0` in the previous command with `dotnet-runtime-8.0`: | ||
|
||
```bash | ||
sudo yum install dotnet-runtime-8.0 | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,28 @@ | ||
--- | ||
author: adegeo | ||
ms.author: adegeo | ||
ms.date: 11/14/2023 | ||
ms.topic: include | ||
--- | ||
|
||
### Install the SDK | ||
|
||
The .NET SDK allows you to develop apps with .NET. If you install the .NET SDK, you don't need to install the corresponding runtime. To install the .NET SDK, run the following command: | ||
|
||
```bash | ||
sudo zypper install dotnet-sdk-8.0 | ||
``` | ||
|
||
### Install the runtime | ||
|
||
The ASP.NET Core Runtime allows you to run apps that were made with .NET that didn't provide the runtime. The following command installs the ASP.NET Core Runtime, which is the most compatible runtime for .NET. In your terminal, run the following command: | ||
|
||
```bash | ||
sudo zypper install aspnetcore-runtime-8.0 | ||
``` | ||
|
||
As an alternative to the ASP.NET Core Runtime, you can install the .NET Runtime, which doesn't include ASP.NET Core support: replace `aspnetcore-runtime-8.0` in the previous command with `dotnet-runtime-8.0`: | ||
|
||
```bash | ||
sudo zypper install dotnet-runtime-8.0 | ||
``` |
6 changes: 6 additions & 0 deletions
6
docs/core/install/includes/linux-install-package-manager-x64-vs-arm.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,8 @@ | ||
--- | ||
author: adegeo | ||
ms.author: adegeo | ||
ms.date: 11/14/2023 | ||
ms.topic: include | ||
--- | ||
|
||
Before you install .NET, run the following commands to add the Microsoft package signing key to your list of trusted keys and add the Microsoft package repository. Open a terminal and run the following commands: |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,9 @@ | ||
--- | ||
author: adegeo | ||
ms.author: adegeo | ||
ms.date: 11/14/2023 | ||
ms.topic: include | ||
--- | ||
|
||
> [!IMPORTANT] | ||
> .NET 8 was released on November 14, 2023. It may take time for the packages to appear in the package manager feeds. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,8 @@ | ||
--- | ||
author: adegeo | ||
ms.author: adegeo | ||
ms.date: 11/14/2023 | ||
ms.topic: include | ||
--- | ||
|
||
When using a package manager to manage your installation of .NET, you may run into a conflict if you've previously installed a preview release. The package manager may interpret the non-preview release as an earlier version of .NET. To install the non-preview release, first uninstall the preview versions. For more information about uninstalling .NET, see [How to remove the .NET Runtime and SDK](../remove-runtime-sdk-versions.md?pivots=os-linux#uninstall-net). |
6 changes: 6 additions & 0 deletions
6
docs/core/install/includes/package-manager-failed-to-fetch-deb.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,8 @@ | ||
--- | ||
author: adegeo | ||
ms.author: adegeo | ||
ms.date: 11/14/2023 | ||
ms.topic: include | ||
--- | ||
|
||
While installing the .NET package, you may see an error similar to `Failed to fetch ... File has unexpected size ... Mirror sync in progress?`. This error could mean that the package feed for .NET is being upgraded with newer package versions, and that you should try again later. During an upgrade, the package feed shouldn't be unavailable for more than 30 minutes. If you continually receive this error for more than 30 minutes, please file an issue at <https://github.com/dotnet/core/issues>. |
6 changes: 6 additions & 0 deletions
6
docs/core/install/includes/package-manager-failed-to-fetch-rpm.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,8 @@ | ||
--- | ||
author: adegeo | ||
ms.author: adegeo | ||
ms.date: 11/14/2023 | ||
ms.topic: include | ||
--- | ||
|
||
While installing the .NET package, you may see an error similar to `signature verification failed for file 'repomd.xml' from repository 'packages-microsoft-com-prod'`. Generally speaking, this error means that the package feed for .NET is being upgraded with newer package versions, and that you should try again later. During an upgrade, the package feed should not be unavailable for more than 2 hours. If you continually receive this error for more than 2 hours, please file an issue at <https://github.com/dotnet/core/issues>. |
8 changes: 7 additions & 1 deletion
8
docs/core/install/includes/package-manager-failed-to-find-deb.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.