-
Notifications
You must be signed in to change notification settings - Fork 4.9k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #6160 from dotnet/apr
Release artifacts for April
- Loading branch information
Showing
13 changed files
with
1,936 additions
and
28 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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,96 @@ | ||
# .NET Core 2.1.27 | ||
|
||
.NET Core 2.1.27 comprises: | ||
|
||
* .NET Core Runtime 2.1.27 | ||
* ASP.NET Core 2.1.27 | ||
* .NET Core SDK 2.1.523 | ||
|
||
See the [Release Notes](https://github.com/dotnet/core/blob/main/release-notes/2.1/2.1.27/2.1.27.md) for details about what is included in this update. | ||
|
||
## Docker | ||
|
||
The [.NET Core Docker images](https://hub.docker.com/_/microsoft-dotnet) have been updated for this release. The [.NET Docker samples](https://github.com/dotnet/dotnet-docker/blob/master/samples/README.md) show various ways to use .NET and Docker together. | ||
|
||
## Installing .NET Core on Linux | ||
|
||
### Install using Snap | ||
|
||
Snap is a system which installs applications in an isolated environment and provides for automatic updates. Many distributions which are not directly supported by .NET Core can use Snaps to install. See the [list of distributions supported Snap](https://docs.snapcraft.io/installing-snapd/6735) for details. | ||
|
||
After configuring Snap on your system, run the following command to install the latest .NET Core SDK. | ||
|
||
`sudo snap install dotnet-sdk --channel 2.1/stable --classic` | ||
|
||
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 distros require an additional step to enable access to the SSL certificate. If you experience SSL errors when running `dotnet restore`, see [Linux Setup](https://github.com/dotnet/core/blob/main/Documentation/linux-setup.md) for a possible resolution. | ||
|
||
### Install using a Package Manager | ||
|
||
Before installing .NET, you will need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine. Refer to [Setting up Linux for .NET Core][linux-setup] for the requirements. | ||
|
||
The following commands don't specifically include package managers to help with readability. Here are the package managers typically used by the distros on which .NET Core is supported. | ||
|
||
| Distro | Package Manager | | ||
| --- | :----: | | ||
| CentOS, Oracle | yum | | ||
| Debian, Ubuntu | apt-get | | ||
| Fedora | dnf | | ||
| OpenSUSE, SLES | zypper | | ||
|
||
## Develop applications | ||
|
||
To develop applications using the .NET Core SDK, run the following command. The .NET Core and ASP.NET Core runtimes are included. | ||
|
||
```bash | ||
sudo [package manager] update or refresh | ||
sudo [package manager] install dotnet-sdk-2.1 | ||
``` | ||
|
||
## Run applications | ||
|
||
If you only need to run existing applications, run the following command. The .NET Core and ASP.NET Core runtimes are included. | ||
|
||
```bash | ||
sudo [package manager] update or refresh | ||
sudo [package manager] install aspnetcore-runtime-2.1 | ||
``` | ||
|
||
### 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/main/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-2.1` using your package manager. If you also need ASP.NET Core functionality, installing `aspnetcore-runtime-2.1` will install both the ASP.NET Core Runtime and .NET Core Runtime. | ||
|
||
## Windows Server Hosting | ||
|
||
If you're looking to host standalone 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-2.1.27-win.exe][dotnet-hosting-win.exe] | ||
|
||
This will install the ASP.NET Core Module for IIS. | ||
|
||
|
||
[release-notes]: https://github.com/dotnet/core/blob/main/release-notes/2.1/2.1.27/2.1.27.md | ||
|
||
|
||
[checksums-runtime]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/2.1.27-sha.txt | ||
[checksums-sdk]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/2.1.27-sha.txt | ||
|
||
[linux-setup]: https://docs.microsoft.com/dotnet/core/install/linux | ||
|
||
[dotnet-hosting-win.exe]: https://download.visualstudio.microsoft.com/download/pr/4155e077-4635-4a74-8c96-3feb3f341073/771eb3d31794d7fd6030d367e0236ec8/dotnet-hosting-2.1.27-win.exe |
Oops, something went wrong.