Skip to content

Commit

Permalink
Update install docs for .NET 8 (#38071)
Browse files Browse the repository at this point in the history
* Update install docs for .NET 8

* Add note to top of ubuntu articles
  • Loading branch information
adegeo authored Nov 15, 2023
1 parent 236074b commit 784159c
Show file tree
Hide file tree
Showing 36 changed files with 344 additions and 100 deletions.
2 changes: 1 addition & 1 deletion docs/core/install/includes/linux-install-60-apt.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ sudo apt-get update && \
### Install .NET 6 Runtime

Both .NET Runtime and the ASP.NET Core Runtime allow 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:
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 commands:

```bash
sudo apt-get update && \
Expand Down
2 changes: 1 addition & 1 deletion docs/core/install/includes/linux-install-60-dnf.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ sudo dnf install dotnet-sdk-6.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 install the ASP.NET Core Runtime, which is the most compatible runtime for .NET. In your terminal, run the following command:
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-6.0
Expand Down
28 changes: 28 additions & 0 deletions docs/core/install/includes/linux-install-80-apk.md
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
```
36 changes: 36 additions & 0 deletions docs/core/install/includes/linux-install-80-apt.md
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
```
28 changes: 28 additions & 0 deletions docs/core/install/includes/linux-install-80-dnf.md
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
```
28 changes: 28 additions & 0 deletions docs/core/install/includes/linux-install-80-yum.md
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
```
28 changes: 28 additions & 0 deletions docs/core/install/includes/linux-install-80-zyp.md
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
```
Original file line number Diff line number Diff line change
@@ -1,3 +1,9 @@
---
author: adegeo
ms.author: adegeo
ms.date: 11/14/2023
ms.topic: include
---

> [!IMPORTANT]
> Package manager installs are only supported on the **x64** architecture. Other architectures, such as **Arm**, must install .NET by some other means such as with Snap, an installer script, or through a manual binary installation.
Expand Down
6 changes: 6 additions & 0 deletions docs/core/install/includes/linux-intro-sdk-vs-runtime.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,9 @@
---
author: adegeo
ms.author: adegeo
ms.date: 11/14/2023
ms.topic: include
---

Install the SDK (which includes the runtime) if you want to develop .NET apps. Or, if you only need to run apps, install the Runtime. If you're installing the Runtime, we suggest you install the **ASP.NET Core Runtime** as it includes both .NET and ASP.NET Core runtimes.

Expand Down
6 changes: 6 additions & 0 deletions docs/core/install/includes/linux-prep-intro-apt.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,9 @@
---
author: adegeo
ms.author: adegeo
ms.date: 11/14/2023
ms.topic: include
---

Installing with APT can be done with a few commands. Before you install .NET, run the following commands to add the Microsoft package signing key to your list of trusted keys and add the package repository.

Expand Down
6 changes: 6 additions & 0 deletions docs/core/install/includes/linux-prep-intro-generic.md
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:
9 changes: 9 additions & 0 deletions docs/core/install/includes/linux-release-wait.md
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.
6 changes: 6 additions & 0 deletions docs/core/install/includes/linux-rpm-install-dependencies.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,9 @@
---
author: adegeo
ms.author: adegeo
ms.date: 11/14/2023
ms.topic: include
---

When you install with a package manager, these libraries are installed for you. But, if you manually install .NET or you publish a self-contained app, you'll need to make sure these libraries are installed:

Expand Down
6 changes: 6 additions & 0 deletions docs/core/install/includes/linux-uninstall-preview-info.md
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).
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>.
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>.
Original file line number Diff line number Diff line change
@@ -1,10 +1,16 @@
---
author: adegeo
ms.author: adegeo
ms.date: 11/14/2023
ms.topic: include
---

If you receive an error message similar to **Unable to locate package {dotnet-package}** or **Some packages could not be installed**, run the following commands.

There are two placeholders in the following set of commands.

- `{dotnet-package}`\
This represents the .NET package you're installing, such as `aspnetcore-runtime-7.0`. This is used in the following `sudo apt-get install` command.
This represents the .NET package you're installing, such as `aspnetcore-runtime-8.0`. This is used in the following `sudo apt-get install` command.

- `{os-version}`\
This represents the distribution version you're on. This is used in the `wget` command below. The distribution version is the numerical value, such as `20.04` on Ubuntu or `10` on Debian.
Expand Down
14 changes: 10 additions & 4 deletions docs/core/install/includes/package-manager-heading-hack-pkgname.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,9 @@
---
author: adegeo
ms.author: adegeo
ms.date: 11/14/2023
ms.topic: include
---

All versions of .NET are available for download at <https://dotnet.microsoft.com/download/dotnet>, but require [manual installation](../linux-scripted-manual.md). You can try and use the package manager to install a different version of .NET. However, the requested version may not be available.

Expand All @@ -18,20 +24,20 @@ Chooses the SDK or the runtime. Valid options are:
- **version**\
The version of the SDK or runtime to install. This article will always give the instructions for the latest supported version. Valid options are any released version, such as:

- 7.0
- 5.0
- 8.0
- 6.0
- 3.1
- 2.1

It's possible the SDK/runtime you're trying to download is not available for your Linux distribution. For a list of supported distributions, see [Install .NET on Linux](../linux.md).

### Examples

- Install the ASP.NET Core 7.0 runtime: `aspnetcore-runtime-7.0`
- Install the ASP.NET Core 8.0 runtime: `aspnetcore-runtime-8.0`
- Install the .NET Core 2.1 runtime: `dotnet-runtime-2.1`
- Install the .NET 5 SDK: `dotnet-sdk-5.0`
- Install the .NET Core 3.1 SDK: `dotnet-sdk-3.1`

### Package missing

If the package-version combination doesn't work, it's not available. For example, there isn't an ASP.NET Core SDK, the SDK components are included with the .NET SDK. The value `aspnetcore-sdk-7.0` is incorrect and should be `dotnet-sdk-7.0`. For a list of Linux distributions supported by .NET, see [.NET dependencies and requirements](../linux.md).
If the package-version combination doesn't work, it's not available. For example, there isn't an ASP.NET Core SDK, the SDK components are included with the .NET SDK. The value `aspnetcore-sdk-8.0` is incorrect and should be `dotnet-sdk-8.0`. For a list of Linux distributions supported by .NET, see [.NET dependencies and requirements](../linux.md).
24 changes: 12 additions & 12 deletions docs/core/install/includes/verify-download-macos-linux.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
---
author: adegeo
ms.author: adegeo
ms.date: 06/21/2023
ms.date: 11/14/2023
ms.topic: include
---

Use the `sha512sum` command to print the checksum of the file you've downloaded. For example, the following command reports the checksum of the _dotnet-sdk-7.0.304-linux-x64.tar.gz_ file:
Use the `sha512sum` command to print the checksum of the file you've downloaded. For example, the following command reports the checksum of the _dotnet-sdk-8.0.100-linux-x64.tar.gz_ file:

```bash
$ sha512sum dotnet-sdk-7.0.304-linux-x64.tar.gz
f4b7d0cde432bd37f445363b3937ad483e5006794886941e43124de051475925b3cd11313b73d2cae481ee9b8f131394df0873451f6088ffdbe73f150b1ed727 dotnet-sdk-7.0.304-linux-x64.tar.gz
$ sha512sum dotnet-sdk-8.0.100-linux-x64.tar.gz
13905ea20191e70baeba50b0e9bbe5f752a7c34587878ee104744f9fb453bfe439994d38969722bdae7f60ee047d75dda8636f3ab62659450e9cd4024f38b2a5 dotnet-sdk-8.0.100-linux-x64.tar.gz
```

Compare the checksum with the value provided by the download site.
Expand All @@ -21,11 +21,11 @@ Compare the checksum with the value provided by the download site.

The .NET release notes contain a link to a checksum file you can use to validate your downloaded file. The following steps describe how to download the checksum file and validate a .NET install binary:

01. The release notes page for .NET 7 on GitHub at <https://github.com/dotnet/core/tree/main/release-notes/7.0> contains a section named **Releases**. The table in that section links to the downloads and checksum files for each .NET 7 release:
01. The release notes page for .NET 8 on GitHub at <https://github.com/dotnet/core/tree/main/release-notes/8.0> contains a section named **Releases**. The table in that section links to the downloads and checksum files for each .NET 8 release:

:::image type="content" source="../media/install-sdk/release-notes-root.png" alt-text="The github release notes version table for .NET":::

01. Select the link for the version of .NET that you downloaded. The previous section used .NET SDK 7.0.304, which is in the .NET 7.0.7 release.
01. Select the link for the version of .NET that you downloaded. The previous section used .NET SDK 8.0.100, which is in the .NET 8.0.0 release.

01. In the release page, you can see the .NET Runtime and .NET SDK version, and a link to the checksum file:

Expand All @@ -36,23 +36,23 @@ The .NET release notes contain a link to a checksum file you can use to validate
01. Use the following script, but replace the link to download the appropriate checksum file:

```bash
curl -O https://dotnetcli.blob.core.windows.net/dotnet/checksums/7.0.7-sha.txt
curl -O https://dotnetcli.blob.core.windows.net/dotnet/checksums/8.0.0-sha.txt
```

01. With both the checksum file and the .NET release file downloaded to the same directory, use the `sha512sum -c {file} --ignore-missing` command to validate the downloaded file.

When validation passes, you see the file printed with the **OK** status:

```bash
$ sha512sum -c 7.0.7-sha.txt --ignore-missing
dotnet-sdk-7.0.304-linux-x64.tar.gz: OK
$ sha512sum -c 8.0.0-sha.txt --ignore-missing
dotnet-sdk-8.0.100-linux-x64.tar.gz: OK
```

If you see the file marked as **FAILED**, the file you downloaded isn't valid and shouldn't be used.

```bash
$ sha512sum -c 7.0.7-sha.txt --ignore-missing
dotnet-sdk-7.0.304-linux-x64.tar.gz: FAILED
$ sha512sum -c 8.0.0-sha.txt --ignore-missing
dotnet-sdk-8.0.100-linux-x64.tar.gz: FAILED
sha512sum: WARNING: 1 computed checksum did NOT match
sha512sum: 7.0.7-sha.txt: no file was verified
sha512sum: 8.0.0-sha.txt: no file was verified
```
Loading

0 comments on commit 784159c

Please sign in to comment.