Kā izveidot .NET Web API Docker attēlu

Viena no galvenajām Docker priekšrocībām ir tā, ka tā ļauj vadīt programmatūras projektus, neizveidojot sarežģītas izstrādes vides.

Šī rokasgrāmata parādīs, kā izveidot .NET 5 Web API Docker attēlu. Pēc tam jūs varat izmantot attēlu, lai palaistu aizmugures kodu no jebkura datora, kurā ir instalēts Docker, un mijiedarbotos ar API no jūsu priekšējā tīmekļa projekta vai mobilās lietotnes.

.NET 5 Web API izveide

Gan Docker, gan .NET 5 ir atvērtā koda un starpplatformu platformas, tāpēc jūs varat sekot šai rokasgrāmatai neatkarīgi no tā, vai izmantojat MacOS, Windows vai Linux.

Izmantojiet dotnet CLI, lai izveidotu ASP.NET Web API projektu ar šādu komandu:

 dotnet jauns webapi -o aspdockerapi 

Iepriekš minētā komanda izveido projektu ar nosaukumu aspdockerapi un ievieto to mapē ar tādu pašu nosaukumu. Turklāt lietojumprogramma sastatnes API kontrolieris ar dažiem laika apstākļu prognozes datu paraugiem.

Piezīme: Ja datorā nav instalēts .NET 5, varat to lejupielādēt no tālāk esošās saites.

Lejupielādēt: .NET 5 Windows, macOS un Linux

Kad projekts ir izveidots, varat doties uz projekta saknes mapi, izmantojot šādu komandu.

cd aspdockerapi

Izmantojot API, varat palaist un apkalpot tīmekļa API.

 dotnet palaist 

Pēc noklusējuma lietojumprogramma tiks pasniegta 5001. portā. Lietojumprogrammas datu paraugus varat pārlūkprogrammā skatīt šajā URL: https://localhost: 5001 / laika prognoze un API datiem jāizskatās šādi.

Uzzināt vairāk: Kas ir API?

Docker Image instrukciju izveide

Lai izveidotu Docker attēlu, jums jāsniedz Docker Engine dažas instrukcijas, kā to veidot. Šīs instrukcijas jāievieto failā ar nosaukumu Dockerfile. Ņemiet vērā, ka failam nav paplašinājuma.

Izmantojiet šo komandu, lai izveidotu Dockerfile lietojumprogrammas saknes mapē.

pieskarieties Dockerfile

Pēc Dockerfile, jūsu projektu mapes struktūrai jābūt līdzīgai zemāk redzamajai:

Tagad nokopējiet un ielīmējiet zemāk esošo kodu savā Dockerfile.

NO mcr.microsoft.com/dotnet/aspnet: 5.0 fokusa AS bāze
WORKDIR / lietotne
80. IEDARBĪBA
NO mcr.microsoft.com/dotnet/sdk: 5.0 fokusa AS būvējums
WORKDIR / src
KOPIJA ["aspdockerapi.csproj", "./"]
RUN dotnet atjaunot "./aspdockerapi.csproj"
KOPIJA. .
WORKDIR "/ src /."
Palaidiet dotnet būvējumu "aspdockerapi.csproj" -c Release -o / app / build
NO build AS publicēt
Palaidiet dotnet publicēt "aspdockerapi.csproj" -c Release -o / app / publish
NO bāzes AS galīgā
WORKDIR / lietotne
KOPIJA - no = publicēt / lietotne / publicēt.
ENTRYPOINT ["dotnet", "aspdockerapi.dll"]

Piezīme: Dockerfile augšpusē projekta un dll nosaukumi ir aspdockerapi.csproj un aspdockerapi.dll attiecīgi, ja jūsu projektam ir cits nosaukums, noteikti atjauniniet savu Dockerfile ar pareizajiem nosaukumiem.

Izpratne par Dockerfile instrukcijām

The Dockerfile galvenokārt sastāv no Dockerfile atslēgvārdiem, kas pēc vienošanās ir lielie burti. Atslēgvārdi norāda instrukciju, kas jāizpilda katrā Docker attēla slānī. Zemāk ir galvenie Docker atslēgvārdi, kurus Dockerfile izmanto iepriekš.

1. NO

The NO atslēgvārds norāda bāzes attēlu, uz kura mēs vēlamies, lai mūsu attēls tiktu veidots. Iepriekš Dockerfile sākotnējais bāzes attēls ir Microsoft .NET 5 attēls. .NET 5 bāzes attēlā ir nepieciešamie komponenti programmas darbināšanai.

2. DARBA DIR

DARBA DIR attēla iekšpusē iestata darba direktoriju vai kontekstu. Šajā piemērā /app direktorijs tiek piešķirts kā noklusējuma saknes darba direktorijs, izmantojot šo paziņojumu WORKDIR / lietotne.

3. KOPIJA

The KOPIJA atslēgvārds vienkārši kopē saturu no vienas mapes un ievieto to citā. Šajā piemērā tas sākotnēji tiek izmantots galvenā projekta faila kopēšanai, tas ir, aspdockerapi.csproj attēlu direktorijā.

4. RUN

The RUN atslēgvārds tiek izmantots, lai palaistu noteiktu Linux komandu Docker attēlā. Iekš Dockerfile iepriekš, RUN komandu izmanto atkarību atjaunošanai, ASP.NET projekta izveidošanai un projekta publicēšanai.

5. CMD

The CMD atslēgvārds ir nedaudz līdzīgs RUN atslēgvārds, kas tika apspriests iepriekš. To lieto arī, palaižot Linux komandu, bet atšķirībā no RUN atslēgvārds, kas izpilda komandas attēla veidošanai, CMD atslēgvārds tiek izmantots, lai palaistu Linux komandas, kad attēls tiek palaists, konteinera instancē.

6. PIEDĀVĀJUMS

The IEDARBĪBA atslēgvārds tiek izmantots, lai ārpasaulei atklātu portu Docker attēla iekšpusē. Šajā gadījumā attēls pakļauj 80. portu, kas tiek izmantots API eksponēšanai, palaižot Docker konteineru.

Docker attēla veidošana

Lai izveidotu Docker attēlu, pamatojoties uz Dockerfile, vienkārši izpildiet šo komandu projekta saknes mapē, tas ir, kur Dockerfile tiek ievietots.

docker build -t dockerwebapi -f Dockerfile.

Iepriekš minētā komanda atzīmē Docker attēlu ar nosaukumu dockerwebapi un arī norāda, ka šī attēla veidošanas instrukcijas ir Dockerfile.

Kad attēls ir pabeigts, varat pārbaudīt, vai tas ir norādīts kā vietējais Docker attēls, izmantojot šādu komandu:

dokeru attēli

Iepriekš minētās komandas izvadam jābūt līdzīgam zemāk redzamajam, un attēlam (dockerwebapi) šajā gadījumā parādās pirmajā rindā.

Ja datorā nav instalēts Docker, Lūk, kā instalēt dokeri Ubuntu Linux, citādi izmantojiet zemāk esošo saiti, lai lejupielādētu un instalētu Docker.

Lejupielādēt: Docker lejupielādes un instalēšanas rokasgrāmata

Docker Image palaišana

Lai palaistu jaunizveidoto Docker attēlu, izmantojiet šo komandu. The -ti opcija norāda, ka attēls jādarbina interaktīvā termināļa režīmā un --rm norāda, ka konteiners ir jāizņem tūlīt pēc tā iziešanas.

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

Komanda arī norāda, ka Docker konteineram jādarbojas HTTP portā 8080, kas tiek pieskaņots 80. portam contianer iekšpusē.

Pārejiet uz vietrādi URL: http://localhost: 8080 / WeatherForecast pārlūkprogrammā, un jūs atradīsit, ka jūsu API dati tiek piegādāti no jūsu palaistās Docker instances.

Kāpēc izmantot Docker?

Šī rokasgrāmata parādīja, kā izveidot .NET 5 tīmekļa API Docker attēlu.

Izmantojot Docker, jūs varat automatizēt lietojumprogrammu izvietošanu, vienkāršot programmatūras izstrādes vides iestatīšanu un atvieglot sadarbību ar citiem programmatūras inženieriem.

Docker piedāvā arī vairākas priekšrocības salīdzinājumā ar citām virtualizācijas tehnoloģijām, tāpēc, iespējams, jums vajadzētu apsvērt iespēju to izmantot programmatūras inženierijas projektos.

6 iemesli, kāpēc izmantot Docker virtualizācijas programmatūru

Docker nodrošina daudzas priekšrocības salīdzinājumā ar virtuālo mašīnu, ir iemesli, kāpēc to sākt lietot jau šodien.

Lasiet Tālāk

Par autoru

Izvērsiet, lai lasītu visu stāstu