Running an ASP.NET Core Web Application on ECS
In this post, we go over how to set up a cloud instance, and get an ASP.NET Core-based web application up and running on it using Nginx.
Join the DZone community and get the full member experience.Join For Free
ASP.NET Core is a Microsoft web framework for developing web applications that can run in any environment, including Windows and Linux servers. According to the Microsoft Docs:
"ASP.NET Core is a cross-platform, high-performance, open-source framework for building modern, cloud-based, Internet-connected applications."
This tutorial provides detailed, step-by-step instructions for a first-time Alibaba Cloud user to create a Linux Elastic Compute Service (ECS) instance and host an ASP.NET Core Application on it.
Why Alibaba Cloud ECS?
Alibaba Cloud Elastic Compute Service (ECS) provides fast memory and the latest Intel CPUs to help you to power your cloud applications and achieve faster results with low latency. All ECS instances come with Anti-DDoS protection to safeguard your data and applications from DDoS and Trojan attacks.
For this tutorial, our setup uses the Nginx Web Server to forward requests to a running ASP.NET core application. We will follow the under-listed steps to successfully create and deploy an ASP.NET Core Web Application to Alibaba Cloud ECS.
- Create new Alibaba Cloud ECS Instance.
- Create a new .NET Core web application using Microsoft Visual Studio.
- Log into ECS Instance.
- Install .NET Core Runtime on ECS.
- Deploy your source code to ECS Instance.
- Configure Nginx.
- Run the application.
You should have a valid Alibaba Cloud account. If you don't have one already, sign up for the free trial. To create a new Alibaba Cloud ECS instance, you can follow the steps in this tutorial. You can also refer to this tutorial to set up your first Ubuntu server on Alibaba Cloud.
Create a New .NET Core Web Application Using Microsoft Visual Studio
We assume that you already have Visual Studio installed on your local machine. If you want to skip this step you can use a repo I already created at https://github.com/vnwonah/AlibabaCloudECSDeploy
- Open Visual Studio. Go to File > New Project. Under the C# node, select Web, then select ASP.NET Core Web Application. Give your application any name (do not include spaces in the name).
- Click Ok, then select Web Application (Model – View – Controller). set Authentication to No Authentication. Click Okay.
- Run the Application and confirm that it runs on localhost in your browser.
- Commit your code and push it to GitHub (or any repository service).
Log Into ECS Instance
I will be using Ubuntu on Windows to SSH into the instance. To learn how to install any Linux distro on Windows, see this article in the Microsoft docs.
- Go to the console, click on your ECS Instance.
- Under Configuration Information, copy the Internet IP Address. It should look like this: 188.8.131.52
- Open your terminal and type
ssh root@YOUR_IP_ADDRESS(replace YOUR_IP_ADDRESS with the Instance Internet IP Address).
- You will see a warning, answer yes. Enter your set password. You should now see your ECS welcome message.
Install .NET Core Runtime on ECS
To run our .NET web application on Alibaba Cloud, we need to install the .NET Core Runtime. Use the following commands:
wget -q https://packages.microsoft.com/config/ubuntu/16.04/packages-microsoft-prod.deb sudo dpkg -i packages-microsoft-prod.deb sudo apt-get install apt-transport-https sudo apt-get update sudo apt-get install dotnet-sdk-2.1
dotnet –version to confirm that the .NET Core runtime is installed.
Deploy Source Code to ECS Instance
Now we will pull our source code into the ECS Instance. For this tutorial, we will simply pull into our user folder.
Install git on the ECS instance. First run
apt-get update, then run the command
apt install git. Confirm that git installed successfully by typing
git –version and see the output.
Install libunwind08 with the command:
sudo apt-get install libunwind8
Clone your repository using:
git clone https://github.com/vnwonah/AlibabaCloudECSDeploy
CD into the directory containing the .csproj file. In our case we use the command:
Then type the command:
dotnet publish -c Release -o ./published -r linux-x64
This restores all dependencies for our project and builds a .dll file. At this point, we are ready to configure Nginx and use it to forward requests to our application.
In this section, we will install and configure Nginx to proxy requests to our .NET Core web application.
Install Nginx with the command
sudo apt-get install nginx. This command installs the Nginx web server. At this point, if you open your ECS Public IP Address in a browser, you should see the Nginx welcome page.
We need to configure Nginx to forward requests to the .NET Core application. To do this, run the command:
sudo pico /etc/nginx/sites-enabled/default. Clear everything in the file and type in:
[Unit] Description=Alibaba Cloud Net Core App [Service] WorkingDirectory=/root/netcoreapp ExecStart=/usr/bin/dotnet /root/AlibabaCloudECSDeploy/ALibabaCloudECSDeploy/AppName.dll Restart=always RestartSec=10 # Restart service after 10 seconds if dotnet service crashes SyslogIdentifier=dotnet-core-app User=root Environment=ASPNETCORE_ENVIRONMENT=Production [Install] WantedBy=multi-user.target
Now enable the service using the command
sudo systemctl enable dotnet-core-app.service and start it using
sudo systemctl start dotnet-core-app.service.
At this point, you should open the browser and navigate to your ECS public IP address and you will see your ASP.NET Core application now running.
In this article, we went from creating a new Alibaba Cloud Elastic Compute Service (ECS) instance to hosting a .NET Core web application using Nginx as a server on it.
Published at DZone with permission of Leona Zhang. See the original article here.
Opinions expressed by DZone contributors are their own.