.Net Core

.NET Core Application Server

The .NET Core application server provides a cross-platform environment for hosting websites, services, console applications, and cloud-native workloads. It can be deployed as an isolated container and used with the platform Deployment Manager to publish projects directly from Git repositories.

In this article

Overview

.NET Core is an open-source and cross-platform implementation of .NET. It is commonly used for websites, APIs, background services, console applications, cloud workloads, and microservice-based architectures.

!

Provider-dependent availability

The availability and supported versions of the .NET Core stack depend on the hosting provider. The template uses the modern systemd initialization system.

.NET Core Components

.NET Core Runtime Provides the type system, assembly loading, garbage collection, and other services required to execute .NET applications.
Framework Libraries Provide primitive data types, application-composition types, and common utilities used by .NET projects.
ASP.NET Core Runtime Provides the framework for modern web applications, internet-connected services, IoT applications, and mobile backends.
.NET Core SDK Includes the development tools and compilers required to build .NET projects.
Language Compilers Includes supported compilers such as Roslyn and F# tooling.
dotnet Command Runs applications and CLI commands, selects the required runtime, loads assemblies, and launches applications and tools.

Create a .NET Core Server

1

Sign in to the platform dashboard and click New Environment in the upper-left corner.

2

In the topology wizard, open the .NET tab and select the .NET Core application server.

Configure the required environment parameters, including reserved cloudlets, scaling limit, disk capacity, public IP addresses, environment name, and region.

.NET Core topology wizard
Select the .NET Core application server and configure the environment resources.
3

Click Create. The platform provisions the .NET Core environment within a few minutes.

.NET Core application server created
The .NET Core application server appears in the environment topology after provisioning.

The application server runs in a separate container. This isolated node has its own private IP address and unique DNS record.

Deploy an Application

The platform supports multiple application-deployment methods. The following workflow deploys a .NET project stored in a Git repository.

1

Open the Deployment Manager, switch to the Git / SVN tab, and click Add Repo.

Add repository in Deployment Manager
Open Git / SVN and click Add Repo.
2

Provide the repository details:

  • Name — a descriptive name for the project.
  • URL — the Git repository address.
  • Branch — the branch that should be deployed.
  • Use Authentication — enable this option when accessing a private repository.
Add .NET Core Git repository
Enter the repository URL and deployment branch.

Click Add to save the repository in Deployment Manager, or click Deploy to save and immediately begin deployment.

Application Variables

The .NET Core application server supports variables that help identify the target project and control its execution.

APP_NAME Points to a specific application folder when the repository contains multiple projects, or identifies the particular .dll file that should be launched.
ASPNETCORE_URLS Defines the URL or listening endpoints used by the ASP.NET Core application.
RUN_OPTION Provides additional options for the dotnet run command.

To configure a variable, open the node settings, select Variables, add or edit the required entry, and save the changes.

APP_NAME variable for .NET Core
Use APP_NAME to select a project folder or a specific application assembly.
!

Single application context

The .NET Core stack uses a single deployment context, similar to Python, Node.js, and Go stacks. Only one application can be deployed and active on the node at a time.

Run and Verify the Application

1

Open the deployment dialog by clicking the deployment icon beside the saved repository or the Deploy from Git / SVN icon beside the application server.

Deploy from Git
Use either deployment button to open the deployment dialog.
2

Select the required:

  • Repository
  • Branch
  • Environment

Configure optional deployment hooks, auto-deploy checks, and conflict-resolution settings as required.

Deploy .NET Core application
Select the repository, branch, and target .NET Core environment.
3

Click Deploy. The platform retrieves the repository, builds or prepares the application, and publishes it to the target node.

4

After deployment is completed, click Open in Browser beside the .NET Core application server.

Open .NET Core application in browser
Click Open in Browser after the application has been deployed.
.NET Core web application
The deployed .NET Core web application opens in a new browser tab.
✓

Expected result

The .NET Core environment is running, the selected Git project is deployed to the application server, and the application is accessible through the environment URL.

Related Documentation