This site uses cookies for analytics, personalized content and ads. By continuing to browse this site, you agree to this use. Learn more
Become familiar with the building blocks for creating microservices with .NET.
None.
15 minutes
Create a simple service that returns a list of values, then run the service in a Docker container.
To start building .NET apps you just need to download and install the .NET SDK (Software Development Kit).
Not running x64? You'll need to download the .NET Core binaries instead.
In order to install .NET Core from Red Hat on RHEL, you first need to register using the Red Hat Subscription Manager. If this has not been done on your system, or if you are unsure, see the Red Hat Product Documentation for .NET Core.
After registering with the Subscription Manager, you are ready to install and enable the .NET SDK.
In your terminal, run the following commands:
yum install rh-dotnet30 -y
scl enable rh-dotnet30 bashIn order to install .NET Core from Red Hat on RHEL, you first need to register using the Red Hat Subscription Manager. If this has not been done on your system, or if you are unsure, see the Red Hat Product Documentation for .NET Core.
After registering with the Subscription Manager, you are ready to install and enable the .NET SDK.
In your terminal, run the following commands:
sudo dnf install dotnet-sdk-3.0Before installing .NET, you'll need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine.
Open a terminal and run the following commands:
wget -q https://packages.microsoft.com/config/ubuntu/16.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.debUpdate the products available for installation, then install the .NET SDK.
In your terminal, run the following commands:
sudo apt-get update
sudo apt-get install apt-transport-https
sudo apt-get update
sudo apt-get install dotnet-sdk-3.0If you receive an error message similar to Unable to locate package dotnet-sdk-3.0, run the following commands.
sudo dpkg --purge packages-microsoft-prod && sudo dpkg -i packages-microsoft-prod.deb
sudo apt-get update
sudo apt-get install dotnet-sdk-3.0If that doesn't work, you can run a manual install with the following commands.
sudo apt-get install -y gpg
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.asc.gpg
sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/
wget -q https://packages.microsoft.com/config/ubuntu/16.04/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list
sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg
sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.list
sudo apt-get install -y apt-transport-https
sudo apt-get update
sudo apt-get install dotnet-sdk-3.0Before installing .NET, you'll need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine.
Open a terminal and run the following commands:
wget -q https://packages.microsoft.com/config/ubuntu/18.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.debUpdate the products available for installation, then install the .NET SDK.
In your terminal, run the following commands:
sudo add-apt-repository universe
sudo apt-get update
sudo apt-get install apt-transport-https
sudo apt-get update
sudo apt-get install dotnet-sdk-3.0If you receive an error message similar to Unable to locate package dotnet-sdk-3.0, run the following commands.
sudo dpkg --purge packages-microsoft-prod && sudo dpkg -i packages-microsoft-prod.deb
sudo apt-get update
sudo apt-get install dotnet-sdk-3.0If that doesn't work, you can run a manual install with the following commands.
sudo apt-get install -y gpg
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.asc.gpg
sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/
wget -q https://packages.microsoft.com/config/ubuntu/18.04/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list
sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg
sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.list
sudo apt-get install -y apt-transport-https
sudo apt-get update
sudo apt-get install dotnet-sdk-3.0Before installing .NET, you'll need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine.
Open a terminal and run the following commands:
wget -q https://packages.microsoft.com/config/ubuntu/19.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.debUpdate the products available for installation, then install the .NET SDK.
In your terminal, run the following commands:
sudo apt-get update
sudo apt-get install apt-transport-https
sudo apt-get update
sudo apt-get install dotnet-sdk-3.0If you receive an error message similar to Unable to locate package dotnet-sdk-3.0, run the following commands.
sudo dpkg --purge packages-microsoft-prod && sudo dpkg -i packages-microsoft-prod.deb
sudo apt-get update
sudo apt-get install dotnet-sdk-3.0If that doesn't work, you can run a manual install with the following commands.
sudo apt-get install -y gpg
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.asc.gpg
sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/
wget -q https://packages.microsoft.com/config/ubuntu/19.04/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list
sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg
sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.list
sudo apt-get install -y apt-transport-https
sudo apt-get update
sudo apt-get install dotnet-sdk-3.0Before installing .NET, you'll need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine.
Open a terminal and run the following commands:
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.asc.gpg
sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/
wget -q https://packages.microsoft.com/config/debian/9/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list
sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg
sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.listUpdate the products available for installation, then install the .NET SDK.
In your terminal, run the following commands:
sudo apt-get update
sudo apt-get install apt-transport-https
sudo apt-get update
sudo apt-get install dotnet-sdk-3.0Before installing .NET, you'll need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine.
Open a terminal and run the following commands:
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.asc.gpg
sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/
wget -q https://packages.microsoft.com/config/debian/10/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list
sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg
sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.listUpdate the products available for installation, then install the .NET SDK.
In your terminal, run the following commands:
sudo apt-get update
sudo apt-get install apt-transport-https
sudo apt-get update
sudo apt-get install dotnet-sdk-3.0Before installing .NET, you'll need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine.
Open a terminal and run the following commands:
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
sudo wget -q -O /etc/yum.repos.d/microsoft-prod.repo https://packages.microsoft.com/config/fedora/29/prod.repoUpdate the products available for installation, then install the .NET SDK.
In your terminal, run the following commands:
sudo dnf install dotnet-sdk-3.0Before installing .NET, you'll need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine.
Open a terminal and run the following commands:
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
sudo wget -q -O /etc/yum.repos.d/microsoft-prod.repo https://packages.microsoft.com/config/fedora/30/prod.repoUpdate the products available for installation, then install the .NET SDK.
In your terminal, run the following commands:
sudo dnf install dotnet-sdk-3.0Before installing .NET, you'll need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine.
Open a terminal and run the following commands:
sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpmUpdate the products available for installation, then install the .NET SDK.
In your terminal, run the following commands:
sudo yum install dotnet-sdk-3.0Before installing .NET, you'll need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine.
Open a terminal and run the following commands:
sudo zypper install libicu
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
wget -q https://packages.microsoft.com/config/opensuse/42.3/prod.repo
sudo mv prod.repo /etc/zypp/repos.d/microsoft-prod.repo
sudo chown root:root /etc/zypp/repos.d/microsoft-prod.repoUpdate the products available for installation, then install the .NET SDK.
In your terminal, run the following commands:
sudo zypper install dotnet-sdk-3.0Before installing .NET, you'll need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine.
Open a terminal and run the following commands:
sudo zypper install libicu
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
wget -q https://packages.microsoft.com/config/opensuse/15/prod.repo
sudo mv prod.repo /etc/zypp/repos.d/microsoft-prod.repo
sudo chown root:root /etc/zypp/repos.d/microsoft-prod.repoUpdate the products available for installation, then install the .NET SDK.
In your terminal, run the following commands:
sudo zypper install dotnet-sdk-3.0Before installing .NET, you'll need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine.
Open a terminal and run the following commands:
sudo rpm -Uvh https://packages.microsoft.com/config/sles/12/packages-microsoft-prod.rpmUpdate the products available for installation, then install the .NET SDK.
In your terminal, run the following commands:
sudo zypper install dotnet-sdk-3.0Before installing .NET, you'll need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine.
Open a terminal and run the following commands:
sudo rpm -Uvh https://packages.microsoft.com/config/sles/15/packages-microsoft-prod.rpmUpdate the products available for installation, then install the .NET SDK.
In your terminal, run the following commands:
sudo zypper install dotnet-sdk-3.0Once you've installed, open a new command prompt and run the following command:
Once you've installed, open a new terminal and run the following command:
dotnetIf the command runs, printing out information about how to use dotnet, you're good to go.
If you receive a 'dotnet' is not recognized as an internal or external command error, make sure you opened a new command prompt. If you can't resolve the issue, use the I ran into an issue button to get help fixing the problem.
In your command prompt, run the following commands:
In your terminal, run the following commands:
dotnet new webapi -o myMicroservice --no-https
cd myMicroserviceThe dotnet command creates a new application of type webapi (that's a REST API endpoint).
-o parameter creates a directory named myMicroservice where your app is stored.--no-https flag creates an app that will run without an HTTPS certificate, to keep things simple for deployment.The cd myMicroService command puts you into the newly created app directory.
Several files were created in the myNewMicroService directory, to give you a simple service that is ready to run.
myMicroservice.csproj defines what libraries the project references etc.Startup.cs contains all the settings and configuration that are loaded when the app starts.Controllers/WeatherForecastController.cs has code for a simple API that returns the weather forecast for the next five days.[ApiController]
[Route("[controller]")]
public class WeatherForecastController : ControllerBase
{
private static readonly string[] Summaries = new[]
{
"Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
};
private readonly ILogger<WeatherForecastController> _logger;
public WeatherForecastController(ILogger<WeatherForecastController> logger)
{
_logger = logger;
}
[HttpGet]
public IEnumerable<WeatherForecast> Get()
{
var rng = new Random();
return Enumerable.Range(1, 5).Select(index => new WeatherForecast
{
Date = DateTime.Now.AddDays(index),
TemperatureC = rng.Next(-20, 55),
Summary = Summaries[rng.Next(Summaries.Length)]
})
.ToArray();
}
}In your command prompt, run the following command:
In your terminal, run the following command:
dotnet runOnce the command completes, browse to http://localhost:5000/WeatherForecast
Congratulations, you've got a simple service running.
Docker is a platform that enables you to combine an app plus its configuration and dependencies into a single, independently deployable unit called a container.
If you already have Docker installed, make sure it's version 18.09 or higher.
You'll be asked to register for Docker Store before you can download the installer.
By default, Docker will use Linux Containers on Windows. Leave this configuration settings as-is when prompted in the installer.
Once you've installed, open a new command prompt and run the following command:
Once you've installed, open a new terminal and run the following command:
docker --versionIf the command runs, displaying some version information, then Docker is successfully installed.
To run with Docker Image you need a Dockerfile — a text file that contains instructions for how to build your app as a Docker image. A docker image contains everything needed to run your app as a Docker container.
Since you opened a new command prompt in the previous step, you'll need to return to the directory you created your service in.
Since you opened a new terminal in the previous step, you'll need to return to the directory you created your service in.
cd myMicroserviceCreate a file called Dockerfile with the following content in a text editor:
FROM mcr.microsoft.com/dotnet/core/sdk:2.2 AS build
WORKDIR /src
COPY myMicroservice.csproj .
RUN dotnet restore
COPY . .
RUN dotnet publish -c release -o /app
FROM mcr.microsoft.com/dotnet/core/aspnet:2.2
WORKDIR /app
COPY --from=build /app .
ENTRYPOINT ["dotnet", "myMicroservice.dll"]Note: Make sure to name the file as Dockerfile and not Dockerfile.txt or some other name.
A .dockerignore file reduces the set of files that are used as part of `docker build`. Fewer files will result in faster builds.
Create a file called .dockerignore file (this is similar to a .gitignore file if you are familiar with those) with the following content in a text editor:
Dockerfile
[b|B]in
[O|o]bjRun the following command:
docker build -t mymicroservice .The docker build command uses the Dockerfile to build a Docker image.
-t mymicroservice parameter tells it to tag (or name) the image as mymicroservice.Dockerfile (. specifies the current directory).You can run the following command to see a list of all images available on your machine, including the one you just created.
docker imagesYou can run your app in a container using the following command :
docker run -it --rm -p 3000:80 --name mymicroservicecontainer mymicroserviceOptionally, you can view your container running in a separate command promptterminal window using the following command:
docker psYou can browse to the following URL to access your application running in a container: http://localhost:3000/WeatherForecast.
Congratulations! You've successfully created a small, independent service that can be deployed and scaled using Docker containers.
These are the fundamental building blocks of microservices.
Next, deploy your microservice to the cloud.
Tutorial: Deploy microservice to Azure
You might also be interested in...
