Creación, ejecución y prueba de .NET Core y ASP.NET Core 2.1 en Docker en una Raspberry Pi (ARM32)

Docker tiene una característica de múltiples arquitecturas que microsoft/dotnet-nightly comenzó a utilizar recientemente. El plan es portar esto al repositorio oficial de microsoft/dotnet en breve. La función de varias arquitecturas permite utilizar una sola etiqueta en varias configuraciones de máquinas. Sin esta característica, cada arquitectura/SO/plataforma requiere una etiqueta única. Por ejemplo, la etiqueta microsoft/dotnet:1.0-runtime se basa en Debian y microsoft/dotnet:1.0-runtime-nanoserver si se basa en Nano Server. Con varias arquitecturas, habrá una etiqueta común microsoft/dotnet:1.0-runtime. Si extrae esa etiqueta de un entorno de contenedor de Linux, obtendrá la imagen basada en Debian, mientras que si extrae esa etiqueta de un entorno de contenedor de Windows, obtendrá la imagen basada en Nano Server. Esto ayuda a proporcionar uniformidad de etiquetas en todos los entornos de Docker, eliminando así la confusión.

En estos ejemplos anteriores puedo:

• Ejecute una aplicación preconfigurada dentro de una imagen de Docker como:
  • ejecutar docker --rm microsoft/dotnet-samples:dotnetapp
• Ejecute comandos dotnet dentro de la imagen SDK como:
  • ejecutar docker --rm -it microsoft/dotnet:2.1-sdk dotnet --info
• Ejecute un terminal interactivo dentro de la imagen SDK como:
  • ejecutar docker --rm -it microsoft/dotnet:2.1-sdk

Como ejemplo rápido, aquí saltaré a un contenedor y crearé una nueva aplicación de consola rápida y la ejecutaré, solo para demostrar que puedo. Este trabajo se desechará cuando salga del contenedor.

pi@raspberrypi:~ $ docker run --rm -it microsoft/dotnet:2.1-sdk
root@063f3c50c88a:/# ls
bin  boot  dev  etc  home  lib  media  mnt  opt  proc  root  run  sbin  srv  sys  tmp  usr  var
root@063f3c50c88a:/# cd ~
root@063f3c50c88a:~# mkdir mytest
root@063f3c50c88a:~# cd mytest/
root@063f3c50c88a:~/mytest# dotnet new console 
The template "Console Application" was created successfully.

Processing post-creation actions...
Running 'dotnet restore' on /root/mytest/mytest.csproj...
  Restoring packages for /root/mytest/mytest.csproj...
  Installing Microsoft.NETCore.DotNetAppHost 2.1.0-rc1.
  Installing Microsoft.NETCore.DotNetHostResolver 2.1.0-rc1.
  Installing NETStandard.Library 2.0.3.
  Installing Microsoft.NETCore.DotNetHostPolicy 2.1.0-rc1.
  Installing Microsoft.NETCore.App 2.1.0-rc1.
  Installing Microsoft.NETCore.Platforms 2.1.0-rc1.
  Installing Microsoft.NETCore.Targets 2.1.0-rc1.
  Generating MSBuild file /root/mytest/obj/mytest.csproj.nuget.g.props.
  Generating MSBuild file /root/mytest/obj/mytest.csproj.nuget.g.targets.
  Restore completed in 15.8 sec for /root/mytest/mytest.csproj.

Restore succeeded.
root@063f3c50c88a:~/mytest# dotnet run
Hello World!
root@063f3c50c88a:~/mytest# dotnet exec bin/Debug/netcoreapp2.1/mytest.dll
Hello World!

Si lo prueba usted mismo, notará que "dotnet run" no es muy rápido. Eso es porque hace una restauración, compilación y ejecución. La compilación no es súper rápida en estos pequeños dispositivos. Querrás hacer el menor trabajo posible. En lugar de una "ejecución de dotnet" todo el tiempo, haré una "compilación de dotnet" y luego una "ejecución de dotnet", que es muy rápida.

Si está haciendo Docker y .NET Core, no puedo enfatizar lo suficiente lo útiles que son los recursos en https://github.com/dotnet/dotnet-docker .

Creación de aplicaciones .NET Core con Docker

• Ejemplo de Docker de .NET Core:este ejemplo compila, prueba y ejecuta el ejemplo. Incluye y construye múltiples proyectos.
• Ejemplo de ASP.NET Core Docker:este ejemplo demuestra el uso de Docker con una aplicación web ASP.NET Core.

Desarrolle aplicaciones .NET Core en un contenedor

• Desarrolle aplicaciones .NET Core:este ejemplo muestra cómo desarrollar, compilar y probar aplicaciones .NET Core con Docker sin necesidad de instalar el SDK de .NET Core.
• Desarrolle aplicaciones ASP.NET Core:este ejemplo muestra cómo desarrollar y probar aplicaciones ASP.NET Core con Docker sin necesidad de instalar el SDK de .NET Core.

Optimización del tamaño del contenedor

• Ejemplo de Alpine Docker de .NET Core:este ejemplo crea, prueba y ejecuta una aplicación mediante Alpine.
• Ejemplo autónomo de .NET Core:este ejemplo compila y ejecuta una aplicación como una aplicación autónoma.

ARM32 / Frambuesa Pi

• Ejemplo de .NET Core ARM32 Docker:este ejemplo compila y ejecuta una aplicación con Debian en ARM32 (funciona en Raspberry Pi).
• Ejemplo de ASP.NET Core ARM32 Docker:este ejemplo compila y ejecuta una aplicación ASP.NET Core con Debian en ARM32 (funciona en Raspberry Pi).

Encontré que las muestras son muy útiles... asegúrese de profundizar en los propios Dockerfiles, ya que le dará mucha información sobre cómo estructurar sus propios archivos. Ser capaz de hacer Dockerfiles multietapa es crucial cuando se construye en un dispositivo pequeño como un RPi. Desea hacer el menor trabajo posible y dejar que Docker almacene en caché tantas capas con su "inteligencia" interna. Si no piensa en esto, terminará desperdiciando 10 veces más tiempo creando capas de imágenes en cada compilación.

¡Dockerización de un sitio ASP.NET Core real con pruebas!

¿Puedo tomar mi sitio de podcasts, dockerizarlo y compilarlo/probarlo/ejecutarlo en una Raspberry Pi? SÍ.

FROM microsoft/dotnet:2.1-sdk AS build
WORKDIR /app

# copy csproj and restore as distinct layers
COPY *.sln .
COPY hanselminutes.core/*.csproj ./hanselminutes.core/
COPY hanselminutes.core.tests/*.csproj ./hanselminutes.core.tests/
RUN dotnet restore

# copy everything else and build app
COPY . .
WORKDIR /app/hanselminutes.core
RUN dotnet build


FROM build AS testrunner
WORKDIR /app/hanselminutes.core.tests
ENTRYPOINT ["dotnet", "test", "--logger:trx"]


FROM build AS test
WORKDIR /app/hanselminutes.core.tests
RUN dotnet test


FROM build AS publish
WORKDIR /app/hanselminutes.core
RUN dotnet publish -c Release -o out


FROM microsoft/dotnet:2.1-aspnetcore-runtime AS runtime
WORKDIR /app
COPY --from=publish /app/hanselminutes.core/out ./
ENTRYPOINT ["dotnet", "hanselminutes.core.dll"]

Me encanta. Ahora puedo "construir ventana acoplable". en mi Raspberry Pi. Restaurará, probará y construirá. Si las pruebas fallan, la compilación de Docker fallará.

Vea cómo hay una sección adicional llamada "testrunner" y luego "test?" Esa sección de testrunner no es operativa. Establece un PUNTO DE ENTRADA pero nunca se usa... todavía. El ENTRYPOINT es una ejecución implícita si es la última línea en el Dockerfile. Eso está ahí para que pueda "correr hasta él" si quiero.

Puedo construir y ejecutar así:

docker build -t podcast .
docker run --rm -it -p 8000:80 podcast

docker build --pull --target testrunner -t podcast:test .
docker run --rm -v D:\github\hanselminutes-core\TestResults:/app/hanselminutes.core.tests/TestResults podcast:test

$ sudo apt-get -y update
$ sudo apt-get -y install libunwind8 gettext
$ wget https://dotnetcli.blob.core.windows.net/dotnet/Sdk/2.1.300-rc1-008673/dotnet-sdk-2.1.300-rc1-008673-linux-arm.tar.gz
$ wget https://dotnetcli.blob.core.windows.net/dotnet/aspnetcore/Runtime/2.1.0-rc1-final/aspnetcore-runtime-2.1.0-rc1-final-linux-arm.tar.gz
$ sudo mkdir /opt/dotnet
$ sudo tar -xvf dotnet-sdk-2.1.300-rc1-008673-linux-arm.tar.gz -C /opt/dotnet/
$ sudo tar -xvf aspnetcore-runtime-2.1.0-rc1-final-linux-arm.tar.gz -C /opt/dotnet/
$ sudo ln -s /opt/dotnet/dotnet /usr/local/bin
$ dotnet --info