Skip to content

Commit

Permalink
Update install docs for NET6 (dotnet#26821)
Browse files Browse the repository at this point in the history
* Part 1

* fix lib ref for deb

* Updated infor for mac and uninstall

* Ubuntu

* CentOS

* Deb,OpenSuse,SLES

* Bookmark fixes

* alpine 3.12

* Minor fix

* Windows

* Dictionary update; linux main

* Minor

* Update fedora

* Update porting articles for .NET 6 (basics)

* Apply suggestions from code review

Co-authored-by: Tom Dykstra <[email protected]>

* Update linux-install-31-dnf.md

* Update linux-install-50-dnf.md

* Update linux-install-50-dnf.md

* Update linux-install-50-yum.md

* Update linux-install-50-zyp.md

Co-authored-by: Tom Dykstra <[email protected]>
  • Loading branch information
adegeo and tdykstra authored Nov 8, 2021
1 parent fcf68f4 commit e133beb
Show file tree
Hide file tree
Showing 33 changed files with 523 additions and 315 deletions.
3 changes: 2 additions & 1 deletion cSpell.json
Original file line number Diff line number Diff line change
Expand Up @@ -809,6 +809,7 @@
"singularizes",
"Sitecore",
"slas",
"SLES",
"smalldatetime",
"smallint",
"smallmoney",
Expand Down Expand Up @@ -1121,4 +1122,4 @@
"yaml",
"yml"
]
}
}
4 changes: 2 additions & 2 deletions docs/core/install/includes/linux-install-31-dnf.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@

### Install the SDK

The .NET Core SDK allows you to develop apps with .NET Core. If you install the .NET Core SDK, you don't need to install the corresponding runtime. To install the .NET Core SDK, run the following commands:
The .NET Core SDK allows you to develop apps with .NET Core. If you install the .NET Core SDK, you don't need to install the corresponding runtime. To install the .NET Core SDK, run the following command:

```bash
sudo dnf install dotnet-sdk-3.1
```

### Install the runtime

The .NET Core Runtime allows you to run apps that were made with .NET Core that didn't include the runtime. The following commands install the ASP.NET Core Runtime, which is the most compatible runtime for .NET Core. In your terminal, run the following commands.
The .NET Core Runtime allows you to run apps that were made with .NET Core that didn't include the runtime. The following command install the ASP.NET Core Runtime, which is the most compatible runtime for .NET Core. In your terminal, run the following command.

```bash
sudo dnf install aspnetcore-runtime-3.1
Expand Down
4 changes: 2 additions & 2 deletions docs/core/install/includes/linux-install-50-dnf.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@

### 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:
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-5.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 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 install 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-5.0
Expand Down
4 changes: 2 additions & 2 deletions docs/core/install/includes/linux-install-50-yum.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@

### 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:
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-5.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 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 install 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-5.0
Expand Down
4 changes: 2 additions & 2 deletions docs/core/install/includes/linux-install-50-zyp.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@

### 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:
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-5.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 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 install 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-5.0
Expand Down
40 changes: 40 additions & 0 deletions docs/core/install/includes/linux-install-60-apt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
---
author: adegeo
ms.author: adegeo
ms.date: 10/26/2021
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 apt-transport-https && \
sudo apt-get update && \
sudo apt-get install -y dotnet-sdk-6.0
```

> [!IMPORTANT]
> If you receive an error message similar to **Unable to locate package dotnet-sdk-6.0**, see the [APT troubleshooting](#apt-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 apt-transport-https && \
sudo apt-get update && \
sudo apt-get install -y aspnetcore-runtime-6.0
```

> [!IMPORTANT]
> If you receive an error message similar to **Unable to locate package aspnetcore-runtime-6.0**, see the [APT troubleshooting](#apt-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-6.0` in the previous command with `dotnet-runtime-6.0`:

```bash
sudo apt-get install -y dotnet-runtime-6.0
```
28 changes: 28 additions & 0 deletions docs/core/install/includes/linux-install-60-dnf.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
---
author: adegeo
ms.author: adegeo
ms.date: 10/26/2021
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-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 installs the ASP.NET Core Runtime, which is the most compatible runtime for .NET. In your terminal, run the following commands:

```bash
sudo dnf install aspnetcore-runtime-6.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-6.0` in the previous command with `dotnet-runtime-6.0`:

```bash
sudo dnf install dotnet-runtime-6.0
```
28 changes: 28 additions & 0 deletions docs/core/install/includes/linux-install-60-yum.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
---
author: adegeo
ms.author: adegeo
ms.date: 10/26/2021
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-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 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-6.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-6.0` in the previous command with `dotnet-runtime-6.0`:

```bash
sudo yum install dotnet-runtime-6.0
```
28 changes: 28 additions & 0 deletions docs/core/install/includes/linux-install-60-zyp.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
---
author: adegeo
ms.author: adegeo
ms.date: 10/26/2021
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-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 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-6.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-6.0` in the previous command with `dotnet-runtime-6.0`:

```bash
sudo zypper install dotnet-runtime-6.0
```
8 changes: 4 additions & 4 deletions docs/core/install/includes/versions-not-supported.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ ms.topic: include

The following versions of .NET are ❌ no longer supported. The downloads for these still remain published:

- 3.0
- 2.2
- 2.1
- 2.0
- .NET Core 3.0
- .NET Core 2.2
- .NET Core 2.1
- .NET Core 2.0
2 changes: 0 additions & 2 deletions docs/core/install/index.yml
Original file line number Diff line number Diff line change
Expand Up @@ -38,8 +38,6 @@ landingContent:
url: macos.md
- text: Supported macOS releases
url: macos.md#supported-releases
- text: Dependencies
url: macos.md#dependencies
- text: Install alongside Visual Studio Code
url: macos.md#install-alongside-visual-studio-code

Expand Down
20 changes: 10 additions & 10 deletions docs/core/install/linux-alpine.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Install .NET on Alpine - .NET
description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Alpine.
author: adegeo
ms.author: adegeo
ms.date: 01/06/2021
ms.date: 10/26/2021
---

# Install the .NET SDK or the .NET Runtime on Alpine
Expand All @@ -28,15 +28,15 @@ The following table is a list of currently supported .NET releases and the versi
- A ❌ indicates that the version of Alpine or .NET isn't supported on that Alpine release.
- When both a version of Alpine and a version of .NET have ✔️, that OS and .NET combination is supported.

| Alpine | .NET Core 2.1 | .NET Core 3.1 | .NET 5 |
|-------- |---------------|---------------|----------------|
| ✔️ 3.14 | ❌ 2.1 | ✔️ 3.1 | ✔️ 5.0 |
| ✔️ 3.13 | ❌ 2.1 | ✔️ 3.1 | ✔️ 5.0 |
| ✔️ 3.12 | ❌ 2.1 | ✔️ 3.1 | ✔️ 5.0 |
| ✔️ 3.11 | ❌ 2.1 | ✔️ 3.1 | ✔️ 5.0 |
| ❌ 3.10 | ❌ 2.1 | ✔️ 3.1 |5.0 |
| ❌ 3.9 | ❌ 2.1 | ✔️ 3.1 |5.0 |
| ❌ 3.8 | ❌ 2.1 | ✔️ 3.1 |5.0 |
| Alpine | .NET Core 3.1 | .NET 5 | .NET 6 |
|---------|---------------|-----------|-----------|
| ✔️ 3.14 | ✔️ 3.1 | ✔️ 5.0 | ✔️ 6.0 |
| ✔️ 3.13 | ✔️ 3.1 | ✔️ 5.0 | ✔️ 6.0 |
| ✔️ 3.12 | ✔️ 3.1 | ✔️ 5.0 | ✔️ 6.0 |
| 3.11 | ✔️ 3.1 | ✔️ 5.0 | ❌ 6.0 |
| ❌ 3.10 | ✔️ 3.1 | ❌ 5.0 |6.0 |
| ❌ 3.9 | ✔️ 3.1 | ❌ 5.0 |6.0 |
| ❌ 3.8 | ✔️ 3.1 | ❌ 5.0 |6.0 |

[!INCLUDE [versions-not-supported](includes/versions-not-supported.md)]

Expand Down
30 changes: 18 additions & 12 deletions docs/core/install/linux-centos.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Install .NET on CentOS - .NET
description: Demonstrates the various ways to install .NET SDK and .NET Runtime on CentOS.
author: adegeo
ms.author: adegeo
ms.date: 01/06/2021
ms.date: 11/04/2021
---

# Install the .NET SDK or the .NET Runtime on CentOS
Expand All @@ -22,10 +22,13 @@ The following table is a list of currently supported .NET releases on both CentO
- A ❌ indicates that the version of CentOS or .NET isn't supported on that CentOS release.
- When both a version of CentOS and a version of .NET have ✔️, that OS and .NET combination is supported.

| CentOS | .NET Core 2.1 | .NET Core 3.1 | .NET 5 |
|--------------------------|---------------|---------------|----------------|
| ✔️ [8](#centos-8-) | ❌ 2.1 | ✔️ 3.1 | ✔️ 5.0 |
| ✔️ [7](#centos-7-) | ❌ 2.1 | ✔️ 3.1 | ✔️ 5.0 |
| CentOS | .NET Core 3.1 | .NET 5 | .NET 6 |
|--------------------------|---------------|----------------|----------------|
| ✔️ [7](#centos-7-) | ✔️ 3.1 | ✔️ 5.0 | ✔️ 6.0 |
| ✔️ [8](#centos-8-)\* | ✔️ 3.1 | ✔️ 5.0 | ❌ 6.0 |

> [!WARNING]
> \*CentOS 8 will reach an early End Of Life (EOL) on December 31st, 2021. For more information, see the official [CentOS Linux EOL page](https://www.centos.org/centos-linux-eol/). Because of this, .NET 6 won't be supported on CentOS Linux 8.
[!INCLUDE [versions-not-supported](includes/versions-not-supported.md)]

Expand All @@ -39,12 +42,6 @@ The following table is a list of currently supported .NET releases on both CentO

[!INCLUDE [package-manager uninstall notice](./includes/linux-uninstall-preview-info.md)]

## CentOS 8 ✔️

.NET 5.0 is available in the default package repositories for CentOS 8.

[!INCLUDE [linux-dnf-install-50](includes/linux-install-50-dnf.md)]

## CentOS 7 ✔️

[!INCLUDE [linux-prep-intro-generic](includes/linux-prep-intro-generic.md)]
Expand All @@ -53,7 +50,16 @@ The following table is a list of currently supported .NET releases on both CentO
sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm
```

[!INCLUDE [linux-yum-install-50](includes/linux-install-50-yum.md)]
[!INCLUDE [linux-yum-install-60](includes/linux-install-60-yum.md)]

## CentOS 8 ✔️

> [!WARNING]
> \*CentOS 8 will reach an early End Of Life (EOL) on December 31st, 2021. For more information, see the official [CentOS Linux EOL page](https://www.centos.org/centos-linux-eol/). Because of this, .NET 6 won't be supported on CentOS Linux 8.
.NET 5 is available in the default package repositories for CentOS 8.

[!INCLUDE [linux-dnf-install-50](includes/linux-install-50-dnf.md)]

## How to install other versions

Expand Down
22 changes: 11 additions & 11 deletions docs/core/install/linux-debian.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Install .NET on Debian - .NET
description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Debian.
author: adegeo
ms.author: adegeo
ms.date: 09/14/2021
ms.date: 11/04/2021
---

# Install the .NET SDK or the .NET Runtime on Debian
Expand All @@ -22,12 +22,12 @@ The following table is a list of currently supported .NET releases and the versi
- A ❌ indicates that the version of Debian or .NET isn't supported on that Debian release.
- When both a version of Debian and a version of .NET have ✔️, that OS and .NET combination is supported.

| Debian | .NET Core 2.1 | .NET Core 3.1 | .NET 5 |
|--------------------------|---------------|---------------|----------------|
| ✔️ [11](#debian-11-) | ❌ 2.1 | ✔️ 3.1 | ✔️ 5.0 |
| ✔️ [10](#debian-10-) | ❌ 2.1 | ✔️ 3.1 | ✔️ 5.0 |
| ✔️ [9](#debian-9-) | ❌ 2.1 | ✔️ 3.1 | ✔️ 5.0 |
|[8](#debian-8-) |2.1 |3.1 |5.0 |
| Debian | .NET Core 3.1 | .NET 5 | .NET 6 |
|--------------------------|---------------|----------|----------|
| ✔️ [11](#debian-11-) | ✔️ 3.1 | ✔️ 5.0 | ✔️ 6.0 |
| ✔️ [10](#debian-10-) | ✔️ 3.1 | ✔️ 5.0 | ✔️ 6.0 |
| ✔️ [9](#debian-9-) | ✔️ 3.1 | ✔️ 5.0 | ✔️ 6.0 |
|[8](#debian-8-) |3.1 |5.0 |6.0 |

[!INCLUDE [versions-not-supported](includes/versions-not-supported.md)]

Expand All @@ -49,7 +49,7 @@ sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb
```

[!INCLUDE [linux-apt-install-50](includes/linux-install-50-apt.md)]
[!INCLUDE [linux-apt-install-60](includes/linux-install-60-apt.md)]

## Debian 10 ✔️

Expand All @@ -61,7 +61,7 @@ sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb
```

[!INCLUDE [linux-apt-install-50](includes/linux-install-50-apt.md)]
[!INCLUDE [linux-apt-install-60](includes/linux-install-60-apt.md)]

## Debian 9 ✔️

Expand All @@ -76,7 +76,7 @@ sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg
sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.list
```

[!INCLUDE [linux-apt-install-50](includes/linux-install-50-apt.md)]
[!INCLUDE [linux-apt-install-60](includes/linux-install-60-apt.md)]

## Debian 8 ❌

Expand Down Expand Up @@ -145,7 +145,7 @@ sudo apt-get update; \
When you install with a package manager, these libraries are installed for you. But, if you manually install .NET Core or you publish a self-contained app, you'll need to make sure these libraries are installed:

- libc6
- libgcc1
- libgcc_s1
- libgssapi-krb5-2
- libicu52 (for 8.x)
- libicu57 (for 9.x)
Expand Down
Loading

0 comments on commit e133beb

Please sign in to comment.