En este artículo te explico los pasos para crear una imagen de un contenedor Docker para una aplicación Hola Mundo de .NET Core. Intento explicar com más detalles las cosas relativas a las proceso de crear las imágenes de Docker que al proceso de desarrollar la aplicación con .NET Core considerando que una vez que tienes listo el archivo Dockerfile puedes reutilizarlo en otras aplicaciones.

TL:DR Si ya tienes Docker instalado puedes ver el no muy impresionante resultado ejecutando docker run jahbenjah/holamundodocker

Primero asegurate de tener instalado Docker, en mi caso uso Docker Desktop para Windows, el SDK de .NET Core 3.1, Visual Studio Code y la extensión para Docker.

Pantalla de Docker Desktop

Imágenes de Docker para .NET Core y ASP.NET Core

Para construir nuestras propias imágenes de Docker para nuestras aplicaciones de .NET Core necesitamos por lo menos 2 imágenes distintas una con el SDK y otra con el motor de tiempo de ejecución o con las dependencias del mismo si utilizamos un despliegue con autocontenido o de un solo archivo. Si quiere tener más detalles sobre como publicar una aplicación autocontenida te recomiendo el artículo Publicación self-contained y single-file en .NET Core o la documentación

Imagen del SDK mcr.microsoft.com/dotnet/core/sdk

Esta imagen contiene todo lo necesario para compilar y probar aplicaciones en .NET Core pero muchas de las cosas incluidas en esta imagen no son necesarias en producción como el compilador o Power Shell Core. Aunque hablamos de una imagen es importante decir que mas bien representan un conjunto de imágenes basadas en diferentes sistemas operativos identificadas por una etiqueta. La imágenes del SDK de .NET Core basadas en. Linux pesan entre los 400Mb y 600MB. Aunque el equipo de Microsoft ha logrado reducir el tamaño de las imágenes de Docker para Windows Server en un 40% para mi están descartadas completamente y solo haré referencia a las imágenes basadas en Linux.

Para descargar la imagen del .NET Core SDK puedes ejecutar el comando docker pull especificando el nombre de la imagen. Opcionalmente puedes especificar la etiqueta pero si no especificas la etiqueta por default se usa la etiqueta lastest.

docker pull mcr.microsoft.com/dotnet/core/sdk:3.1-alpine

De forma general podemos decir que el Microsoft proporciona tres imágenes para el SDK de .NET Core basadas en Debian,Ubuntu y Alpine respectivamente.Puedes ver la lista completa de etiquetas en el Docker Hub.

Buena prácticas para Docker: Se considera una buena practica especificar siempre la etiqueta de la imagen deseada por ejemplo mcr.microsoft.com/dotnet/core/sdk:3.1-alpine

Etiqueta Sistema operativo Tamaño
3.1-buster latest Debian 10 614MB
3.1-alpine Alpine 3.11 406MB
3.1-bionic Ubuntu 18.04 614MB

Como soy un poco codo, mi internet es lento, tengo poco espacio en disco y realizo unicamente DemoWare con Hola mundo siempre utilizare las imágenes más pequeñas, es decir, las basada en Linux Alpine.

Imagen del Runtime o imagen con las dependencias del RUNTIME

mcr.microsoft.com/dotnet/core/runtime-deps mcr.microsoft.com/dotnet/core/aspnet mcr.microsoft.com/dotnet/core/runtime

Buena práctica : En mi ruta de aprendizaje de los 50 días de Kubernetes he aprendido que que por razones de seguridad y rendimiento es una buena practica usar contenedores pequeños. Por lo que intentare usar Linux Alpine como base.

Peso de las imagenes de Docker para el motor de tiempo de ejecución de .NET Core

Construyendo nuestra propia imagen de Docker para .NET Core

Para que nuestra aplicación este disponible en un contenedor de Docker es necesario agregar por lo menos dos archivos adicionales a nuestro proyecto de .NET Core el .dockerignore y el Dockerfile el primero especifica carpetas y archivos que no deben ser incluidos en la imagen final y el segundo define los pasos necesario para construir la imagen.

En nuestro ejemplo la aplicación solo es un hola mundo y este lo conseguimos con el comando dotnet new console -o HolaMundoDocker. Posteriormente abre la carpeta HolaMundoDocker con cd HolaMundoDocker y edita el archivo Program.cs` para que el lugar de imprimir _Hello World! escriba ¡Hola Mundo! y tu aplicación esta lista para crear una imagen de Docker y poder crear contenedores.

Añade el archivo .dockerignore sin extension y con el siguiente contenido para evitar que se copien loas carpetas obj y bin

/bin
/obj

Añade otro archivo llamado Dockerfile con el siguiente contenido:

FROM mcr.microsoft.com/dotnet/core/sdk:3.1-alpine AS build
WORKDIR /source
COPY *.csproj .
RUN dotnet restore -r linux-musl-x64
COPY . .
RUN dotnet publish -c release -o /app -r linux-musl-x64 --self-contained true --no-restore /p:PublishTrimmed=true /p:PublishReadyToRun=true
FROM mcr.microsoft.com/dotnet/core/runtime-deps:3.1-alpine
WORKDIR /app
COPY --from=build /app .
ENTRYPOINT ["./HolaMundoDocker"]

>docker build -t jahbenjah/holamundodocker:latest .
Sending build context to Docker daemon   5.12kB
Step 1/10 : FROM mcr.microsoft.com/dotnet/core/sdk:3.1-alpine AS build
 ---> 3daf49f77d3c
Step 2/10 : WORKDIR /source
 ---> Running in d009b6c441be
Removing intermediate container d009b6c441be
 ---> a8d3b96a21ca
Step 3/10 : COPY *.csproj .
 ---> 4383dd51b18f
Step 4/10 : RUN dotnet restore -r linux-musl-x64
 ---> Running in b37002a8c68f
  Restore completed in 19.65 sec for /source/HolaMundoDocker.csproj.
Removing intermediate container b37002a8c68f
 ---> d12bddc58f16
Step 5/10 : COPY . .
 ---> 9e67aab2fd65
Step 6/10 : RUN dotnet publish -c release -o /app -r linux-musl-x64 --self-contained true --no-restore /p:PublishTrimmed=true /p:PublishReadyToRun=true
 ---> Running in b2247b2e4330
Microsoft (R) Build Engine version 16.4.0+e901037fe for .NET Core
Copyright (C) Microsoft Corporation. All rights reserved.

  HolaMundoDocker -> /source/bin/release/netcoreapp3.1/linux-musl-x64/HolaMundoDocker.dll
  Optimizing assemblies for size, which may change the behavior of the app. Be sure to test after publishing. See: https://aka.ms/dotnet-illink
  Some ReadyToRun compilations emitted warnings, indicating potential missing dependencies. Missing dependencies could potentially cause runtime failures. To show the warnings, set the PublishReadyToRunShowWarnings property to true.
  HolaMundoDocker -> /app/
Removing intermediate container b2247b2e4330
 ---> aba6f02af28b
Step 7/10 : FROM mcr.microsoft.com/dotnet/core/runtime-deps:3.1-alpine
3.1-alpine: Pulling from dotnet/core/runtime-deps
c9b1b535fdd9: Already exists
d314a858a3d7: Already exists
Digest: sha256:0895037a486aa130d737a64eb592056b8a42073118ca870d9554b90de9894acd
Status: Downloaded newer image for mcr.microsoft.com/dotnet/core/runtime-deps:3.1-alpine
 ---> 65324893f144
Step 8/10 : WORKDIR /app
 ---> Running in bcb0fa81b995
Removing intermediate container bcb0fa81b995
 ---> 3aad358320f7
Step 9/10 : COPY --from=build /app .
 ---> 727162a0b410
Step 10/10 : ENTRYPOINT ["./HolaMundoDocker"]
 ---> Running in e8ff085661ff
Removing intermediate container e8ff085661ff
 ---> 7593ec0e971c
Successfully built 7593ec0e971c
Successfully tagged jahbenjah/holamundodocker:latest
SECURITY WARNING: You are building a Docker image from Windows against a non-Windows Docker host. All files and directories added to build context will have '-rwxr-xr-x' permissions. It is recommended to double check and reset permissions for sensitive files and directories.

Docker y ASP.NET Core

Publicando la imagen en registro : Ducker Hub

Para publicar tu imagen un registro de contenedores puedes usar el comando docker push. La imagen debe contener una etiqueta y debes estar logeado en el registro

Conclusiones