Skip to content

Commit

Permalink
Release Artifacts for .NET 5 Preview 6
Browse files Browse the repository at this point in the history
  • Loading branch information
rbhanda committed Jun 25, 2020
1 parent 9689e07 commit 65f68a6
Show file tree
Hide file tree
Showing 7 changed files with 591 additions and 11 deletions.
6 changes: 5 additions & 1 deletion release-notes/5.0/5.0-known-issues.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,10 @@ This document lists known issues for **.NET 5 Preview 1 and beyond releases** wh

1. The Microsoft.Windows.Compatibility package references dependencies that are not available at the targeted versions. To workaround, individually reference the packages your project needs. It is tracked by [dotnet/runtime/issues #34351](https://github.com/dotnet/runtime/issues/34351)

### Preview 6

1. With the work to provide sustainable and long-term support for WinRT consumption in .NET, the built-in support has been removed. This is a high impact change to all existing libraries and application that rely on the built-in WinRT support. The replacement for built-in WinRT support is the C#/WinRT tool chain. For complete details, see the official doc issue at dotnet/docs#18875.

## ASP.NET Core Runtime

### Preview 4
Expand All @@ -41,4 +45,4 @@ This will be fixed in the Preview 5 release. It is tracked by [dotnet/aspnetcore

### Preview 5

1. For self-contained single-file apps, hostfxr and hostpolicy are not bundled into the application bundle, but are published alongside it. Framework-dependent single-file apps are not affected (since hostfxr and hostpolicy reside within the framework). This issue will be resolved in Preview 6, tracked by [dotnet/runtime #32823](https://github.com/dotnet/runtime/issues/32823).
1. For self-contained single-file apps, hostfxr and hostpolicy are not bundled into the application bundle, but are published alongside it. Framework-dependent single-file apps are not affected (since hostfxr and hostpolicy reside within the framework). This issue should be resolved in Preview 6, tracked by [dotnet/runtime #32823](https://github.com/dotnet/runtime/issues/32823).
1 change: 1 addition & 0 deletions release-notes/5.0/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ The following .NET 5 releases have been shipped. You must be on the latest patch

| Release Date | Description | Download |
| :-- | :-- | :--: |
| 2020/06/25 | [5.0.0 Preview 6](https://github.com/dotnet/core/blob/master/release-notes/5.0/preview/5.0.0-preview.6.md) | [download](https://dotnet.microsoft.com/download/dotnet/5.0) |
| 2020/06/10 | [5.0.0 Preview 5](https://github.com/dotnet/core/blob/master/release-notes/5.0/preview/5.0.0-preview.5.md) | [download](https://dotnet.microsoft.com/download/dotnet/5.0) |
| 2020/05/19 | [5.0.0 Preview 4](https://github.com/dotnet/core/blob/master/release-notes/5.0/preview/5.0.0-preview.4.md) | [download](https://dotnet.microsoft.com/download/dotnet/5.0) |
| 2020/04/23 | [5.0.0 Preview 3](https://github.com/dotnet/core/blob/master/release-notes/5.0/preview/5.0.0-preview.3.md) | [download](https://dotnet.microsoft.com/download/dotnet/5.0) |
Expand Down
82 changes: 82 additions & 0 deletions release-notes/5.0/preview/5.0.0-preview.6-install-instructions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,82 @@
# .NET 5.0.0 Preview 6

.NET 5.0.0 Preview 6 comprises:

* .NET Runtime 5.0.0-preview.6.20305.6
* ASP.NET Core 5.0.0-preview.6.20312.15
* .NET SDK 5.0.100-preview.6.20318.15

See the [Release Notes][release-notes] for details about what is included in this update.

## Docker

The [.NET Docker images](https://hub.docker.com/r/microsoft/dotnet/) have been updated for this release. Details on our Docker versioning and how to work with the images can be seen in ["Staying up-to-date with .NET Container Images"](https://devblogs.microsoft.com/dotnet/staying-up-to-date-with-net-container-images/).

## Install .NET on Linux

### Install using Snap

Because of the isolated environment, using Snap is the preferred way to install and try .NET Previews on [Linux distributions that support Snap](https://docs.snapcraft.io/installing-snapd/6735).

After configuring Snap on your system, run the following command to install the latest .NET Core SDK.

`sudo snap install dotnet-sdk --channel=5.0/beta --classic`

Some systems require that you restart the terminal session so the Snap install location can be added to the path. If this is the case, you will see a warning once the dotnet-sdk Snap installation is complete.

When .NET Core in installed using the Snap package, the default .NET Core command is `dotnet-sdk.dotnet`, as opposed to just `dotnet`. The benefit of the namespaced command is that it will not conflict with a globally installed .NET Core version you may have. This command can be aliased to `dotnet` with:

`sudo snap alias dotnet-sdk.dotnet dotnet`

**Note:** Some distributions require an additional step to enable access to the SSL certificate. If you experience SSL errors when running `dotnet restore`, see [Linux Setup](https://docs.microsoft.com/dotnet/core/install/) for a possible resolution.

### Install using deb/rpm packages

Preview release installers are not available from the Microsoft package repositories. The steps below provide an easy way to install .NET 5 Preview 6 using your Distro package manager.

**Note:** `curl` must be available on the system before running the following steps. Once you have confirmed that `curl` is available, complete the steps to download and install the .NET 5 Preview 6 SDK and Runtime.

1. Create a directory to use for the download location and change into that directory. For example, `mkdir $HOME/dotnet_install && cd $HOME/dotnet_install`.
2. Run `curl -H 'Cache-Control: no-cache' -L https://aka.ms/install-dotnet-preview -o install-dotnet-preview.sh`
3. Run the script with `sudo bash install-dotnet-preview.sh`

Here's what the script does.

* Detects the distribution and version. If it's in the [5.0 Supported OS](https://github.com/dotnet/core/blob/master/release-notes/5.0/5.0-supported-os.md) list, the script continues.
* Determines if additional system dependencies or utilities are needed to successfully complete and install them. For example, `tar` is used to unpack that installer packages.
* Downloads the tar.gz containing the .NET preview installer packages for the detected distribution.
* Downloads the system dependency installer, if needed.
* Expands the tar.gz into ./dotnet_packages
* Attempts to install the contents of ./dotnet_packages using `rpm` or `dpkg`, as appropriate, for the detected distribution.

### Installation from a binary archive

Installing from the packages detailed above is recommended or you can install from binary archive, if that better suits your needs. When using binary archives to install, the contents must be extracted to a user location such as `$HOME/dotnet`, a symbolic link created for `dotnet` and a few dependencies installed. Dependency requirements can be seen in the [Linux System Prerequisites](https://github.com/dotnet/core/blob/master/Documentation/linux-prereqs.md) document.

```bash
mkdir -p $HOME/dotnet && tar zxf dotnet.tar.gz -C $HOME/dotnet
export PATH=$PATH:$HOME/dotnet
```

## .NET Core Runtime-only installation

If only the .NET Core Runtime is needed, install `dotnet-runtime-5.0` using your package manager. If you also need ASP.NET Core functionality, installing `aspnetcore-runtime-5.0` will install both the ASP.NET Core Runtime and .NET Core Runtime.

## Windows Server Hosting

If you are looking to host stand-alone apps on Servers, the following installer can be used on Windows systems.

### Windows

You can download the Windows Server Hosting installer and run the following command from an Administrator command prompt:

* [dotnet-hosting-5.0.0-preview.6.exe][dotnet-hosting-win.exe]

This will install the ASP.NET Core Module for IIS.

[blob-runtime]: https://dotnetcli.blob.core.windows.net/dotnet/Runtime/
[blob-sdk]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/
[release-notes]: https://github.com/dotnet/core/blob/master/release-notes/5.0/preview/5.0.0-preview.6.md


[dotnet-hosting-win.exe]: https://download.visualstudio.microsoft.com/download/pr/2563f05b-8dd1-4d66-92e0-2766ac653df9/cd36906fb799128ee9107e55194cf505/dotnet-hosting-5.0.0-preview.6.20312.15-win.exe
Loading

0 comments on commit 65f68a6

Please sign in to comment.