Erstellen, Ausführen und Testen von .NET Core und ASP.NET Core 2.1 in Docker auf einem Raspberry Pi (ARM32)

Docker verfügt über eine Multi-Arch-Funktion, die Microsoft/dotnet-nightly seit kurzem verwendet. Es ist geplant, dies in Kürze auf das offizielle Microsoft/Dotnet-Repo zu portieren. Die Multi-Arch-Funktion ermöglicht die Verwendung eines einzelnen Tags über mehrere Maschinenkonfigurationen hinweg. Ohne diese Funktion benötigt jede Architektur/jedes Betriebssystem/jede Plattform ein eindeutiges Tag. Beispielsweise basiert das microsoft/dotnet:1.0-runtime-Tag auf Debian und microsoft/dotnet:1.0-runtime-nanoserver, wenn es auf Nano Server basiert. Bei Multi-Arch gibt es ein gemeinsames microsoft/dotnet:1.0-runtime-Tag. Wenn Sie dieses Tag aus einer Linux-Containerumgebung abrufen, erhalten Sie das Debian-basierte Image, während Sie das Nano Server-basierte Image erhalten, wenn Sie dieses Tag aus einer Windows-Containerumgebung abrufen. Dies trägt dazu bei, Tag-Einheitlichkeit in Docker-Umgebungen zu gewährleisten, wodurch Verwirrung vermieden wird.

In diesen Beispielen oben kann ich:

• Führen Sie eine vorkonfigurierte App in einem Docker-Image aus wie:
  • docker run --rm microsoft/dotnet-samples:dotnetapp
• Führen Sie dotnet-Befehle im SDK-Image aus wie:
  • docker run --rm -it microsoft/dotnet:2.1-sdk dotnet --info
• Führen Sie ein interaktives Terminal innerhalb des SDK-Images aus wie:
  • docker run --rm -it microsoft/dotnet:2.1-sdk

Als kurzes Beispiel springe ich hier in einen Container und erstelle eine schnelle Konsolen-App und führe sie aus, nur um zu beweisen, dass ich es kann. Diese Arbeit wird verworfen, wenn ich den Container verlasse.

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!

Wenn Sie es selbst versuchen, werden Sie feststellen, dass "dotnet run" nicht sehr schnell ist. Das liegt daran, dass es eine Wiederherstellung, Erstellung und Ausführung durchführt. Die Kompilierung ist auf diesen winzigen Geräten nicht besonders schnell. Sie wollen so wenig Arbeit wie möglich machen. Anstelle eines ständigen „dotnet run“ führe ich einen „dotnet build“ und dann einen „dotnet exec“ durch, was sehr schnell ist.

Wenn Sie Docker und .NET Core machen, kann ich nicht genug betonen, wie nützlich die Ressourcen drüben bei sind https://github.com/dotnet/dotnet-docker .

Erstellen von .NET Core-Apps mit Docker

• .NET Core Docker-Beispiel – Dieses Beispiel erstellt, testet und führt das Beispiel aus. Es enthält und erstellt mehrere Projekte.
• ASP.NET Core Docker-Beispiel – Dieses Beispiel veranschaulicht die Verwendung von Docker mit einer ASP.NET Core-Web-App.

Entwicklung von .NET Core-Apps in einem Container

• Entwicklung von .NET Core-Anwendungen – Dieses Beispiel zeigt, wie .NET Core-Anwendungen mit Docker entwickelt, erstellt und getestet werden, ohne dass das .NET Core SDK installiert werden muss.
• ASP.NET Core-Anwendungen entwickeln – Dieses Beispiel zeigt, wie ASP.NET Core-Anwendungen mit Docker entwickelt und getestet werden, ohne dass das .NET Core SDK installiert werden muss.

Optimierung der Containergröße

• .NET Core Alpine Docker-Beispiel – Dieses Beispiel erstellt, testet und führt eine Anwendung mit Alpine aus.
• Eigenständiges .NET Core-Beispiel – Dieses Beispiel erstellt und führt eine Anwendung als eigenständige Anwendung aus.

ARM32 / Raspberry Pi

• .NET Core ARM32 Docker-Beispiel – Dieses Beispiel erstellt und führt eine Anwendung mit Debian auf ARM32 aus (funktioniert auf Raspberry Pi).
• ASP.NET Core ARM32 Docker-Beispiel – Dieses Beispiel erstellt und führt eine ASP.NET Core-Anwendung mit Debian auf ARM32 aus (funktioniert auf Raspberry Pi).

Ich fand die Beispiele sehr nützlich ... graben Sie sich unbedingt in die Dockerfiles selbst ein, da Sie eine Menge Einblicke in die Strukturierung Ihrer eigenen Dateien erhalten. Die Fähigkeit, mehrstufige Dockerfiles zu erstellen, ist entscheidend, wenn Sie auf einem kleinen Gerät wie einem RPi bauen. Sie möchten so wenig Arbeit wie möglich erledigen und Docker so viele Ebenen mit seinen internen „Smarts“ zwischenspeichern lassen. Wenn Sie sich darüber keine Gedanken machen, verschwenden Sie bei jedem Build die zehnfache Zeit mit dem Erstellen von Bildebenen.

Dockern einer echten ASP.NET Core Site mit Tests!

Kann ich meine Podcast-Site nehmen und sie docken und auf einem Raspberry Pi erstellen/testen/ausführen? JA.

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"]

Liebe es. Jetzt kann ich "docker build" ausführen. auf meinem Raspberry Pi. Es wird wiederhergestellt, getestet und erstellt. Wenn die Tests fehlschlagen, schlägt der Docker-Build fehl.

Sehen Sie, wie dort oben ein zusätzlicher Abschnitt mit dem Namen "Testrunner" und danach "Test?" Dieser Testrunner-Abschnitt ist ein no-op. Es setzt einen EINTRITTSPUNKT, wird aber nie verwendet ... noch nicht. Der ENTRYPOINT ist ein impliziter Lauf wenn es die letzte Zeile im Dockerfile ist. Das ist da, damit ich "hinlaufen" kann, wenn ich will.

Ich kann einfach so bauen und ausführen:

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