Kuidas luua .NET Web API Dockeri pilt

Dockeri üks peamisi eeliseid on see, et see võimaldab teil käivitada tarkvaraprojekte ilma keerukate arenduskeskkondade seadistamiseta.

See juhend näitab teile, kuidas luua .NET 5 Web API Dockeri pilt. Seejärel saate pildi abil käivitada taustaprogrammi koodi igast arvutist, kuhu Docker on installitud, ja suhelda API-ga teie esiotsa veebiprojektist või mobiilirakendusest.

.NET 5 veebi API loomine

Nii Docker kui ka .NET 5 on avatud lähtekoodiga ja platvormiülesed, seetõttu võite seda juhendit järgida, kas kasutate macOS-i, Windowsi või Linuxi.

ASP.NET Web API projekti loomiseks järgmise käsuga kasutage dotneti CLI-d:

 dotnet uus webapi -o aspdockerapi 

Ülaltoodud käsk loob projekti nimega aspdockerapi ja paigutab selle samanimelisse kausta. Lisaks tellib rakendus API-kontrolleri koos mõningate ilmaprognoosiandmetega.

Märge: Kui teie arvutisse pole installitud .NET 5, saate selle alla laadida allolevalt lingilt.

Lae alla: .NET 5 Windowsi, macOSi ja Linuxi jaoks

Kui projekt on loodud, saate järgmise käsu abil minna projekti juurkausta.

cd aspdockerapi

Veebirakenduse saate käivitada ja teenindada, kasutades allolevat käsku.

 dotneti käivitamine 

Vaikimisi serveeritakse rakendust porti 5001. Rakenduse näidisandmeid saate vaadata oma brauseris järgmisel URL-il: https://localhost: 5001 / ilmaennustus ja API-de andmed peaksid välja nägema nagu allpool.

Lisateave: Mis on API?

Dockeri pildijuhiste loomine

Dockeri pildi loomiseks peate andma Docker Engine'ile mõned juhised selle koostamiseks. Need juhised tuleks paigutada faili nimega Dockerfile. Pange tähele, et failil pole laiendit.

Rakenduse loomiseks kasutage järgmist käsku Dockerfile oma rakenduse projekti juurkaustas.

puudutage valikut Dockerfile

Pärast Dockerfile, peaks teie projektide kausta struktuur olema sarnane allolevaga:

Nüüd kopeerige ja kleepige allolev kood oma Dockerfile.

FROM mcr.microsoft.com/dotnet/aspnet: 5.0-fokaalne AS-i alus
WORKDIR / rakendus
KOKKUPUUDE 80
FROM mcr.microsoft.com/dotnet/sdk: 5.0-fokaalne AS-i järk
WORKDIR / src
KOOPIA ["aspdockerapi.csproj", "./"]
RUN dotneti taastamine "./aspdockerapi.csproj"
KOOPIA. .
WORKDIR "/ src /."
Käivitage dotnet-i ehitis "aspdockerapi.csproj" -c Release -o / app / build
FROM build AS avaldab
RUN dotneti avaldamine "aspdockerapi.csproj" -c Release -o / app / publish
Baasist AS finaal
WORKDIR / rakendus
KOOPIA - alates = avaldage / rakendus / avaldage.
ENTRYPOINT ["dotnet", "aspdockerapi.dll"]

Märge: Ülaltoodud Dockerfile'is on projekti ja dll-nimed aspdockerapi.csproj ja aspdockerapi.dll vastavalt, kui teie projektil on erinev nimi, värskendage oma Dockerfile'i õigete nimedega.

Dockerfile'i juhiste mõistmine

The Dockerfile koosneb peamiselt Dockerfile'i märksõnadest, mis kokkuleppeliselt on suurtähelised sõnad. Märksõnad määravad Dockeri pildi igas kihis täidetava juhise. Allpool on toodud peamised Dockeri märksõnad, mida ülaltoodud Dockerfile kasutab.

1. PÄRAST

The PÄRAST märksõna määrab baaspildi, millele soovime oma pildi ehitada. Ülaltoodud Dockerfile'is on esialgne põhipilt Microsofti .NET 5 pilt. .NET 5 baaskujutis sisaldab rakenduse käitamiseks vajalikke komponente.

2. TÖÖDIRI

TÖÖDIRI määrab pildi sisse töökataloogi või konteksti. Selles näites /app kataloog määratakse vaiketöö juurkataloogiks järgmise lause abil WORKDIR / rakendus.

3. KOOPIA

The KOOPIA märksõna lihtsalt kopeerib sisu ühest kaustast ja asetab selle teise. Selles näites kasutatakse seda algselt projekti peafaili kopeerimiseks, st aspdockerapi.csproj piltide töökataloogi.

4. JOOKS

The JOOKS märksõna kasutatakse konkreetse Linuxi käsu käivitamiseks Dockeri pildil. Aastal Dockerfile ülal, JOOKS käsku kasutatakse sõltuvuste taastamiseks, projekti ASP.NET loomiseks ja projekti avaldamiseks.

5. CMD

The CMD märksõna on natuke sarnane märksõnaga JOOKS eespool käsitletud märksõna. Seda kasutatakse ka Linuxi käsu käivitamisel, kuid erinevalt JOOKS märksõna, mis käivitab pildi loomise käsud, CMD märksõna kasutatakse Linuxi käskude käivitamiseks pildi käivitamisel konteinereksemplaris.

6. TEENUS

The KOKKUPUUDE Märksõna kasutatakse Dockeri pildil asuva pordi eksponeerimiseks välismaailmale. Sellisel juhul paljastatakse pildil port 80, mida kasutatakse Dockeri konteineri käitamisel API eksponeerimiseks.

Dockeri pildi ehitamine

Dockeri pildi ehitamiseks Dockerfile, lihtsalt käivitage järgmine käsk projekti juurkaustas, see tähendab, kus Dockerfile on paigutatud.

dockeri loomine -t dockerwebapi -f Dockerfile.

Ülaltoodud käsk sildistab Dockeri pildi nimega dockerwebapi ja täpsustab ka, et selle pildi koostamise juhised on Dockerfile.

Pärast pildi ehitamise lõpetamist saate järgmise käsu abil kontrollida, kas see on kohaliku Dockeri pildina loetletud:

doki pildid

Ülaltoodud käsu väljund peaks olema sarnane allolevaga ja pilt (dockerwebapi) on antud juhul esimesel real.

Kui teie arvutisse pole installitud Dockerit, Siit saate teada, kuidas installida dokkija Ubuntu Linuxi, muul juhul kasutage Dockeri allalaadimiseks ja installimiseks allolevat linki.

Lae alla: Dockeri allalaadimis- ja installijuhend

Dockeri pildi käitamine

Äsja loodud Dockeri pildi käivitamiseks kasutage järgmist käsku. The -ti suvand määrab pildi käitamise interaktiivses terminalirežiimis ja --rm täpsustab, et konteiner tuleks eemaldada kohe pärast selle väljumist.

docker run -ti --rm -p 8080: 80 dockerwebapi

Samuti täpsustab käsk, et Dockeri konteiner peaks töötama HTTP-pordil 8080, mis kaardistab contianeri sees oleva pordi 80.

Minge URL-ile: http://localhost: 8080 / Ilmateade oma brauseris ja leiate, et teie API andmeid serveeritakse teie käitatavast Dockeri eksemplarist.

Miks kasutada Dockerit?

See juhend näitas teile, kuidas luua .NET 5 veebirakenduse Dockeri pilt.

Dockeri abil saate oma rakenduste juurutamist automatiseerida, lihtsustada tarkvaraarenduskeskkondade seadistamist ja hõlbustada koostööd teiste tarkvarainseneridega.

Docker pakub ka mitmeid eeliseid teiste virtualiseerimistehnoloogiate ees, mistõttu peaksite tõenäoliselt kaaluma selle kasutamist oma tarkvaratehnika projektides.

6 põhjust Dockeri virtualiseerimise tarkvara kasutamiseks

Docker pakub virtuaalse masina ees palju eeliseid. Siit on põhjust seda täna kasutada.

Loe edasi

Autori kohta

Laiendage, et lugeda kogu lugu