Step by step: Scale ASP.NET Core with Docker Swarm
A few weeks ago I posted Step by step: ASP.NET Core on Docker were I showed how to build and run a Docker image with an ASP.NET Core application.
Today I bring you: Step by step: Scale ASP.NET Core with Docker Swarm so you can scale out or in the same application.
Assuming you have Docker 1.12 or later installed and running, follow this steps:
1. Create a dockerfile
On your Docker box create a dockerfile with the following contents
# We use the microsoft/dotnet image as a starting point. FROM microsoft/dotnet # Install git RUN apt-get install git -y # Create a folder to clone our source code RUN mkdir repositories # Set our working folder WORKDIR repositories # Clone the source code RUN git clone https://github.com/cmendible/aspnet-core-helloworld.git # Set our working folder WORKDIR aspnet-core-helloworld/src/dotnetstarter # Expose port 5000 for the application. EXPOSE 5000 # Restore nuget packages RUN dotnet restore # Start the application using dotnet!!! ENTRYPOINT dotnet run
2. Create a Docker image
With the dockerfile in place run the following command
sudo docker build -t hello_world .
Now you have an image named hello_world with all the dependencies and code needed to run the sample.
3. Initialize a Swarm
Initialize Docker Swarm.
docker swarm init
4. Create a Docker Service
Now that you have setup everything use the following command to create a service named hello_service based on the hello_world image and start it
docker service create --name hello_service --publish 5000:5000 hello_world
Wait a few seconds and navigate to http://localhost:5000 and you should be able to reach the web application.
If you want to learn more about Docker services, start here: Service Create/
5. Scale up your application
Let’s scale your service up to 3 instances with the following command
docker service scale hello_service=3
If you want to see how many replicas your service is running issue the following command:
docker service ls
Note that it takes some seconds before all new replicas start.
6. Scale down your application
Let’s scale your service down to 1 instance with the following command
docker service scale hello_service=1
7. Optional: Remove the service
If you are don’t want the service anymore, remove it from the Swarm with the following command
docker service rm hello_service
You can get a copy of the docker file here: https://github.com/cmendible/dotnetcore.samples/tree/main/docker.helloworld
Hope it helps!