Kako ustvariti sliko Dockerja spletnega API-ja .NET

Ena glavnih prednosti Dockerja je ta, da vam omogoča zagon projektov programske opreme, ne da bi morali postavljati zapletena razvojna okolja.

Ta priročnik vam bo pokazal, kako ustvarite Dockerjevo sliko spletnega API-ja .NET 5. Nato lahko sliko uporabite za zagon zaledne kode iz katerega koli osebnega računalnika, na katerem je nameščen Docker, in za interakcijo z API-jem iz vašega spletnega projekta ali mobilne aplikacije.

Ustvarjanje spletnega API-ja .NET 5

Tako Docker kot .NET 5 sta odprtokodna in večplastna, zato lahko sledite tem navodilom, ne glede na to, ali uporabljate macOS, Windows ali Linux.

Z dotnet CLI ustvarite projekt spletnega API-ja ASP.NET z naslednjim ukazom:

 dotnet new webapi -o aspdockerapi 

Zgornji ukaz ustvari projekt z imenom aspdockerapi in ga postavi v istoimensko mapo. Poleg tega aplikacija postavi krmilnik API z nekaj vzorčnimi podatki o vremenski napovedi.

Opomba: Če v računalniku niste namestili .NET 5, ga lahko prenesete s spodnje povezave.

Prenesi: .NET 5 za Windows, macOS in Linux

Ko je projekt ustvarjen, lahko z naslednjim ukazom odprete korensko mapo projekta.

cd aspdockerapi

Spletni API lahko zaženete in strežete z uporabo spodnjega ukaza.

 dotnet run 

Aplikacija bo privzeto na voljo na vratih 5001. Vzorčne podatke aplikacije si lahko v brskalniku ogledate na naslednjem URL-ju: https://localhost: 5001 / vremenska napoved in podatki API-jev naj bodo videti spodaj.

Nauči se več: Kaj je API?

Ustvarjanje navodil za Docker Image

Če želite ustvariti sliko Dockerja, morate Docker Engine dati nekaj navodil, kako jo zgraditi. Ta navodila naj bodo v datoteki z imenom Dockerfile. Upoštevajte, da datoteka nima končnice.

Z naslednjim ukazom ustvarite Dockerfile v korenski mapi vašega aplikacijskega projekta.

dotaknite se datoteke Docker

Po ustvarjanju Dockerfile, struktura map vaših projektov mora biti podobna spodnji:

Zdaj kopirajte in prilepite spodnjo kodo v svoj Dockerfile.

OD mcr.microsoft.com/dotnet/aspnet: 5,0-fokusna AS osnova
WORKDIR / app
IZPOSTAVITEV 80
OD mcr.microsoft.com/dotnet/sdk: 5.0-osrednja AS gradnja
WORKDIR / src
KOPIRAJ ["aspdockerapi.csproj", "./"]
ZAGONI obnovitev omrežja "./aspdockerapi.csproj"
KOPIRATI. .
WORKDIR "/ src /."
RUN dotnet build "aspdockerapi.csproj" -c Release -o / app / build
FROM build AS objavi
RUN dotnet objavi "aspdockerapi.csproj" -c Release -o / app / objavite
FROM base AS final
WORKDIR / app
KOPIRAJ - od = objavi / aplikacijo / objavi.
ENTRYPOINT ["dotnet", "aspdockerapi.dll"]

Opomba: V zgornji datoteki Docker sta ime projekta in dll aspdockerapi.csproj in aspdockerapi.dll če ima vaš projekt drugačno ime, posodobite svojo datoteko Docker s pravilnimi imeni.

Razumevanje navodil Dockerfile

The Dockerfile je v glavnem sestavljen iz ključnih besed Dockerfile, ki so po dogovoru velike besede. Ključne besede določajo navodila za izvedbo v vsaki plasti Dockerjeve slike. Spodaj so glavne ključne besede Docker, ki jih uporablja zgoraj Dockerfile.

1. OD

The OD Ključna beseda določa osnovno sliko, na kateri želimo, da je naša slika zgrajena. V zgornji datoteki Dockerfile je začetna osnovna slika Microsoftova slika .NET 5. Osnovna slika .NET 5 vsebuje potrebne komponente za zagon aplikacije.

2. WORKDIR

WORKDIR nastavi delovni imenik ali kontekst znotraj slike. V tem primeru je /app imenik je dodeljen kot privzeti korenski delovni imenik z uporabo naslednjega stavka WORKDIR / app.

3. KOPIRATI

The KOPIRATI ključna beseda preprosto kopira vsebino iz ene mape in jo postavi v drugo. V tem primeru se prvotno uporablja za kopiranje glavne datoteke projekta, to je aspdockerapi.csproj v delovni imenik slik.

4. TEK

The TEK Ključna beseda se uporablja za zagon določenega ukaza Linux znotraj Dockerjeve slike. V Dockerfile zgoraj, TEK ukaz se uporablja za obnovitev odvisnosti, izdelavo projekta ASP.NET in objavo projekta.

5. CMD

The CMD ključna beseda je nekoliko podobna TEK zgoraj obravnavana ključna beseda. Uporablja se tudi pri zagonu ukaza Linux, vendar za razliko od TEK ključna beseda, ki izvaja ukaze za gradnjo slike, CMD Ključna beseda se uporablja za zagon ukazov Linuxa ob zagonu slike v primerku vsebnika.

6. IZPOSTAVITE

The IZPOSTAVITEV Ključna beseda se uporablja za izpostavitev vrat znotraj slike Docker zunanjemu svetu. V tem primeru slika razkrije vrata 80, ki se uporabljajo za razkrivanje API-ja pri zagonu vsebnika Docker.

Ustvarjanje slike Dockerja

Za izdelavo slike Dockerja na osnovi Dockerfile, preprosto zaženite naslednji ukaz v korenski mapi projekta, to je, če je Dockerfile je postavljen.

docker build -t dockerwebapi -f Dockerfile.

Zgornji ukaz označi Dockerjevo sliko z imenom dockerwebapi in tudi določa, da so navodila za izdelavo te slike v Dockerfile.

Po končani gradnji slike lahko z naslednjim ukazom preverite, ali je navedena kot lokalna slika Dockerja:

slike dockerja

Izhod iz zgornjega ukaza mora biti podoben spodnjemu, slika (dockerwebapi) se v tem primeru prikaže v prvi vrstici.

Če v računalniku niste namestili Dockerja, tukaj je, kako namestiti docker v Ubuntu Linux, sicer uporabite spodnjo povezavo za prenos in namestitev Dockerja.

Prenesi: Navodila za prenos in namestitev Dockerja

Zagon slike Docker

Če želite zagnati novo ustvarjeno sliko Dockerja, uporabite naslednji ukaz. The -ti Možnost določa, da se slika izvaja v interaktivnem terminalskem načinu in - rm določa, da je treba posodo odstraniti takoj po izhodu.

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

Ukaz tudi določa, naj se vsebnik Dockerja izvaja na vratih HTTP 8080, ki se preslikajo na vrata 80 znotraj kontejnerja.

Pojdite na URL: http://localhost: 8080 / Vremenska napoved v brskalniku in našli boste, da se vaši podatki API-ja strežijo iz primerka Dockerja, ki ga izvajate.

Zakaj uporabljati Docker?

Ta vodnik vam je pokazal, kako ustvarite Dockerjevo sliko spletnega API-ja .NET 5.

Z Dockerjem lahko avtomatizirate uvajanje aplikacij, poenostavite nastavitev okolja za razvoj programske opreme in olajšate sodelovanje s kolegi programskimi inženirji.

Docker ponuja tudi več prednosti pred drugimi tehnologijami za virtualizacijo, zato bi ga verjetno morali razmisliti o uporabi pri projektih programskega inženiringa.

6 razlogov za uporabo programske opreme za virtualizacijo Docker

Docker ponuja številne prednosti pred navideznim računalnikom, zato ga danes lahko uporabljamo že danes.

Preberite Naprej

O avtorju

Razširi na Branje celotne zgodbe