Ako vytvoriť Docker obrázok .NET Web API

Jednou z hlavných výhod Dockeru je, že vám umožňuje prevádzkovať softvérové ​​projekty bez potreby nastavenia zložitých vývojových prostredí.

Táto príručka vám ukáže, ako vytvoriť Dockerov obraz webového rozhrania .NET 5. Obrázok potom môžete použiť na spustenie backendového kódu z ľubovoľného počítača, na ktorom je nainštalovaný Docker, a na interakciu s rozhraním API z webového projektu front-end alebo z mobilnej aplikácie.

Vytvorenie webového rozhrania .NET 5

Docker aj .NET 5 sú open-source a cross-platform, preto sa môžete týmto sprievodcom riadiť, či už používate macOS, Windows alebo Linux.

Použite dotnet CLI na vytvorenie projektu webového rozhrania ASP.NET s nasledujúcim príkazom:

 dotnet new webapi -o aspdockerapi 

Vyššie uvedený príkaz vytvorí projekt s názvom aspdockerapi a umiestni ho do priečinka s rovnakým názvom. Aplikácia navyše vyskladá radič API pomocou niektorých vzorových údajov o predpovedi počasia.

Poznámka: Ak nemáte na počítači nainštalovaný program .NET 5, môžete si ho stiahnuť z odkazu uvedeného nižšie.

Stiahnuť ▼: .NET 5 Pre Windows, macOS a Linux

Po vytvorení projektu môžete prejsť do koreňového priečinka projektu pomocou nasledujúceho príkazu.

cd aspdockerapi

Webové API môžete spustiť a obsluhovať pomocou nižšie uvedeného príkazu.

 dotnet run 

Aplikácia sa predvolene bude zobrazovať na porte 5001. Vzorové údaje aplikácie si môžete pozrieť vo svojom prehliadači na nasledujúcej adrese URL: https://localhost: 5001 / predpoveď počasia a údaje rozhraní API by mali vyzerať nižšie.

Uč sa viac: Čo je to API?

Vytváranie pokynov pre obrázok Docker

Ak chcete vytvoriť Dockerov obraz, musíte dať Docker Engine niekoľko pokynov, ako ho vytvoriť. Tieto pokyny by mali byť vložené do súboru s názvom Dockerfile. Upozorňujeme, že súbor nemá príponu.

Pomocou nasledujúceho príkazu vytvorte Dockerfile v koreňovom priečinku aplikačného projektu.

klepnite na súbor Docker

Po vytvorení Dockerfile, štruktúra vašich priečinkov s projektmi by mala byť podobná štruktúre uvedenej nižšie:

Teraz skopírujte a vložte nasledujúci kód do svojho súboru Dockerfile.

FROM mcr.microsoft.com/dotnet/aspnet: 5,0-ohnisková základňa AS
WORKDIR / aplikácia
EXPOZÍCIA 80
FROM mcr.microsoft.com/dotnet/sdk: 5.0-ohniskové AS zostavenie
WORKDIR / src
KÓPIA ["aspdockerapi.csproj", "./"]
RUN dotnet restore "./aspdockerapi.csproj"
KOPÍROVAŤ. .
WORKDIR "/ src /."
RUN dotnet build "aspdockerapi.csproj" -c Release -o / app / build
ZO ZOSTAVENIA AS publikovať
RUN dotnet publish "aspdockerapi.csproj" -c Release -o / app / publish
ZO ZÁKLADU AS konečné
WORKDIR / aplikácia
KOPÍROVAŤ --z = publikovať / aplikovať / zverejniť.
ENTRYPOINT ["dotnet", "aspdockerapi.dll"]

Poznámka: Vo vyššie uvedenom súbore Docker sú názvy projektu a dll aspdockerapi.csproj a aspdockerapi.dll Ak má váš projekt iný názov, nezabudnite svoj súbor Docker aktualizovať správnymi názvami.

Porozumenie pokynom Dockerfile

The Dockerfile sa skladá hlavne z kľúčových slov súboru Dockerfile, ktoré sú podľa konvencie slová s veľkým písmenom. Kľúčové slová určujú inštrukciu, ktorá sa má vykonať v každej vrstve obrazu Dockera. Ďalej sú uvedené hlavné kľúčové slová Dockeru, ktoré používa súbor Docker uvedený vyššie.

1. ZO

The ZO kľúčové slovo určuje základný obrázok, na ktorom chceme vytvoriť náš obrázok. Vo vyššie uvedenom súbore Docker je počiatočným základným obrázkom obrázok .NET 5 od spoločnosti Microsoft. Základný obrázok .NET 5 obsahuje potrebné komponenty na spustenie aplikácie.

2. WORKDIR

WORKDIR nastaví pracovný adresár alebo kontext vo vnútri obrázka. V tomto príklade /app adresár je priradený ako predvolený koreňový pracovný adresár pomocou nasledujúceho príkazu WORKDIR / aplikácia.

3. KOPÍROVAŤ

The KOPÍROVAŤ kľúčové slovo jednoducho skopíruje obsah z jedného priečinka a umiestni ho do iného. V tomto príklade sa pôvodne používa na kopírovanie hlavného súboru projektu, tj. aspdockerapi.csproj do pracovného adresára obrázkov.

4. BEH

The BEH kľúčové slovo sa používa na spustenie konkrétneho príkazu systému Linux v rámci obrazu Dockeru. V Dockerfile nad BEH príkaz sa používa na obnovenie závislostí, zostavenie projektu ASP.NET a jeho zverejnenie.

5. CMD

The CMD kľúčové slovo je trochu podobné BEH kľúčové slovo diskutované vyššie. Používa sa tiež na spustenie príkazu Linux, ale na rozdiel od BEH kľúčové slovo, ktoré spúšťa príkazy na vytvorenie obrázka, CMD kľúčové slovo sa používa na spustenie príkazov Linuxu pri spustení obrázka v inštancii kontajnera.

6. EXPOZÍCIA

The EXPOZÍCIA kľúčové slovo sa používa na vystavenie portu vo vnútri obrazu Dockeru vonkajšiemu svetu. V tomto prípade obrázok vystavuje port 80, ktorý sa používa na odhalenie API pri spustení kontajnera Docker.

Budovanie Docker Image

Vytvoriť obraz Dockeru na základe Dockerfile, jednoducho spustite nasledujúci príkaz v koreňovom priečinku projektu, teda tam, kde Dockerfile je umiestnený.

docker build -t dockerwebapi -f Dockerfile.

Vyššie uvedený príkaz označí obrázok Dockeru menom dockerwebapi a tiež špecifikuje, že pokyny na vytvorenie tohto obrázka sú v Dockerfile.

Po dokončení vytvárania obrázka môžete pomocou nasledujúceho príkazu skontrolovať, či je uvedený ako miestny obraz Dockeru:

ukotviteľné obrázky

Výstup z vyššie uvedeného príkazu by mal byť podobný nasledujúcemu a obrázok (dockerwebapi) sa v tomto prípade zobrazí na prvom riadku.

Ak nemáte v počítači nainštalovaný Docker, Tu je postup, ako nainštalovať ukotviteľný panel na Ubuntu Linux, inak použite odkaz dole na stiahnutie a inštaláciu Dockeru.

Stiahnuť ▼: Sprievodca sťahovaním a inštaláciou Dockeru

Spustenie Docker Image

Ak chcete spustiť novo vytvorený obraz Dockeru, použite nasledujúci príkaz. The -ti voľba určuje, že obraz by sa mal spúšťať v režime interaktívneho terminálu a --rm určuje, že kontajner by sa mal odstrániť ihneď po jeho výstupe.

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

Príkaz tiež určuje, že kontajner Docker by mal bežať na porte HTTP 8080, ktorý sa mapuje na port 80 vo vnútri kontianeru.

Prejsť na adresu URL: http://localhost: 8080 / WeatherForecast vo svojom prehliadači a zistíte, že vaše údaje API sú poskytované z inštancie Docker, ktorú máte spustenú.

Prečo používať Docker?

Táto príručka vám ukázala, ako vytvoriť obraz Dockera webového rozhrania .NET 5.

Pomocou Dockeru môžete automatizovať spôsob nasadenia svojich aplikácií, zjednodušiť nastavenie vývojových prostredí softvéru a uľahčiť spoluprácu s ostatnými softvérovými inžiniermi.

Docker tiež ponúka niekoľko výhod oproti iným virtualizačným technológiám, a preto by ste pravdepodobne mali zvážiť jeho použitie vo vašich projektoch softvérového inžinierstva.

6 dôvodov prečo používať virtualizačný softvér Docker

Docker poskytuje oproti virtuálnemu stroju mnoho výhod. Existujú dôvody, prečo ho začať používať už dnes.

Prečítajte si Ďalej

O autorovi

Rozbaliť a prečítať si celý príbeh