msa

Containerize msa applications with/without Dockerfile

Find the repository root

# Bazh/Zsh
REPOSITORY_ROOT=$(git rev-parse --show-toplevel)

# PowerShell
$REPOSITORY_ROOT = git rev-parse --show-toplevel

eShopLite.ProductApi in .NET with Dockerfile

Unlike the other microservice apps in this repository, this eShopLite.ProductApi app has to use Dockerfile for containerization because it requires the RUN instruction to create an SQLite database file inside the container.

1. Make sure you have been running Docker Desktop. If not, start Docker Desktop.

2. Move to the msa directory.

   cd $REPOSITORY_ROOT/msa

3. Build the container image.

   # To follow the build platform
   docker build -f Dockerfile.product -t eshoplite-product:latest .
   
   # To specify the target platform
   docker build --platform=linux/amd64 --build-arg TARGETARCH=amd64 -f Dockerfile.product -t eshoplite-product:latest .

4. Run a container from the container image.

   docker run -d -p 5051:8080 --name product eshoplite-product:latest

5. Open the browser and navigate to http://localhost:5051/api/products to see the web app running.

6. Stop and remove the container.

   docker stop product
   docker rm product --force

7. Delete the container image.

   docker rmi eshoplite-product:latest --force

eShopLite.WeatherApi in Java without Dockerfile

Jib is a tool that builds a container image for your Java app without a Dockerfile. It's directly integrated into the Maven or Gradle build process. The downside of this approach is that you can't add the RUN instruction. If it's really necessary, use the Dockerfile or build a custom base image that has already applied the RUN instruction.

1. Make sure you have been running Docker Desktop. If not, start Docker Desktop.

2. Make sure you have logged in Docker daemon to your preferred container registry. If not, run the following command:

   docker login

3. Move to the msa directory.

   cd $REPOSITORY_ROOT/msa

4. Set the variables for building container image. Replace {{YOUR_CONTAINER_REGISTRY}} with your preferred container registry. For example, my_container_registry.azurecr.io. If you want to use Docker Hub, you can use your Docker Hub username.

   REGISTRY="{{YOUR_CONTAINER_REGISTRY}}"

   $REGISTRY = "{{YOUR_CONTAINER_REGISTRY}}"

5. Build the container image.

   ./src/eShopLite.WeatherApi/mvnw clean package \
       -f ./src/eShopLite.WeatherApi/pom.xml \
       -Dimage="$REGISTRY/eshoplite-weather:latest"

   ./src/eShopLite.WeatherApi/mvnw clean package `
       -f ./src/eShopLite.WeatherApi/pom.xml `
       -Dimage="$REGISTRY/eshoplite-weather:latest"

6. Pull the container image from the container registry.

   docker pull "$REGISTRY/eshoplite-weather:latest"
   docker tag "$REGISTRY/eshoplite-weather:latest" eshoplite-weather:latest

7. Run a container from the container image.

   docker run -d -p 5050:5050 --name weather "eshoplite-weather:latest"

8. Open the browser and navigate to http://localhost:5050/api/weatherforecast to see the app running.

9. Stop and remove the container.

   docker stop weather
   docker rm weather --force

10. Delete the container image.

    docker rmi eshoplite-weather:latest --force
    docker rmi "$REGISTRY/eshoplite-weather:latest" --force

eShopLite.WebApp in .NET without Dockerfile

MSBuild has a feature to build your .NET app containerized without a Dockerfile. The downside of this approach is that you can't add the RUN instruction. If it's really necessary, use the Dockerfile or build a custom base image that has already applied the RUN instruction.

1. Make sure you have been running Docker Desktop. If not, start Docker Desktop.

2. Move to the msa directory.

   cd $REPOSITORY_ROOT/msa

3. Run the following dotnet publish command to build the app.

   dotnet publish ./src/eShopLite.WebApp \
       -t:PublishContainer \
       --os linux --arch x64

   dotnet publish ./src/eShopLite.WebApp `
       -t:PublishContainer `
       --os linux --arch x64

4. If you want to change the base image to Ubuntu Chiseled image, use the following command.

   dotnet publish ./src/eShopLite.WebApp \
       -t:PublishContainer \
       --os linux --arch x64 \
       -p:ContainerBaseImage=mcr.microsoft.com/dotnet/aspnet:9.0-noble-chiseled \
       -p:ContainerRepository=eshoplite-webstore \
       -p:ContainerImageTag=latest

   dotnet publish ./src/eShopLite.WebApp `
       -t:PublishContainer `
       --os linux --arch x64 `
       -p:ContainerBaseImage=mcr.microsoft.com/dotnet/aspnet:9.0-noble-chiseled `
       -p:ContainerRepository=eshoplite-webstore `
       -p:ContainerImageTag=latest

5. Run a container from the container image.

   docker run -d -p 5000:8080 --name webstore eshoplite-webstore:latest

6. Open the browser and navigate to http://localhost:5000 to see the app running. Make sure that both /weather and /products pages are not properly working, which is expected.

7. Stop and remove the container.

   docker stop webstore
   docker rm webstore --force

8. Delete the container image.

   docker rmi eshoplite-webstore:latest --force

Container orchestration

Container orchestration with docker network

1. Create a new bridge network.

   docker network create eshoplite

2. Run containers from each container image with the network attached

   docker run -d -p 5000:8080 --network eshoplite --network-alias webstore --name webstore eshoplite-webstore:latest
   docker run -d -p 5050:5050 --network eshoplite --network-alias weather --name weather eshoplite-weather:latest
   docker run -d -p 5051:8080 --network eshoplite --network-alias product --name product eshoplite-product:latest

3. Open the browser and navigate to http://localhost:5000 to see the app running. Make sure this time both /weather and /products pages are properly showing contents.

4. Delete containers and network

   docker stop webstore
   docker rm webstore --force
   
   docker stop weather
   docker rm weather --force
   
   docker stop product
   docker rm product --force
   
   docker network rm eshoplite --force

Container orchestration with docker compose

1. Make sure you have been running Docker Desktop. If not, start Docker Desktop.

2. Move to the msa directory.

   cd $REPOSITORY_ROOT/msa

3. Run the following command to run all the containers.

   docker compose up

4. Open the browser and navigate to http://localhost:5000 to see the app running.

5. Stop and remove the containers.

   docker compose down