Kaip sukurti .NET Web API „Docker“ vaizdą

Vienas pagrindinių „Docker“ pranašumų yra tai, kad jis leidžia vykdyti programinės įrangos projektus nereikalaujant sukurti sudėtingos kūrimo aplinkos.

Šis vadovas parodys, kaip sukurti .NET 5 žiniatinklio API „Docker“ vaizdą. Tada galite naudoti vaizdą, kad galėtumėte paleisti vidinės programos kodą iš bet kurio kompiuterio, kuriame įdiegta „Docker“, ir sąveikauti su API iš jūsų sąsajos žiniatinklio projekto ar programos mobiliesiems.

.NET 5 žiniatinklio API kūrimas

Tiek „Docker“, tiek .NET 5 yra atviro kodo ir daugiaplatformės platformos, todėl vadovaukitės šiuo vadovu, jei naudojate „MacOS“, „Windows“ ar „Linux“.

Norėdami sukurti ASP.NET žiniatinklio API projektą naudodami dotnet CLI naudokite šią komandą:

 dotnet naujas webapi -o aspdockerapi 

Aukščiau pateikta komanda sukuria projektą pavadinimu aspdockerapi ir įdeda jį į aplanką su tuo pačiu pavadinimu. Be to, programa pastoliuoja API valdiklį su kai kuriais orų prognozių duomenų pavyzdžiais.

Pastaba: Jei jūsų kompiuteryje nėra įdiegta .NET 5, galite ją atsisiųsti iš toliau pateiktos nuorodos.

parsisiųsti: .NET 5, skirta „Windows“, „MacOS“ ir „Linux“

Sukūrę projektą galite pereiti į projekto šakninį aplanką naudodami šią komandą.

CD aspdockerapi

Galite paleisti ir aptarnauti žiniatinklio API naudodami toliau pateiktą komandą.

 dotnet paleisti 

Pagal numatytuosius nustatymus programa bus teikiama 5001 uoste. Programos pavyzdinius duomenis galite peržiūrėti savo naršyklėje šiuo URL: https://localhost: 5001 / orų prognozė ir API duomenys turėtų atrodyti taip, kaip nurodyta toliau.

Sužinokite daugiau: Kas yra API?

„Docker Image“ instrukcijų kūrimas

Norėdami sukurti „Docker“ vaizdą, turite pateikti „Docker Engine“ instrukcijas, kaip jį sukurti. Šios instrukcijos turėtų būti dedamos į failą, pavadintą Dockerfile. Atminkite, kad failas neturi plėtinio.

Norėdami sukurti, naudokite šią komandą Dockerfile jūsų programos projekto šakniniame aplanke.

palieskite „Dockerfile“

Sukūrus Dockerfile, jūsų projektų aplankų struktūra turėtų būti panaši į žemiau pateiktą:

Dabar nukopijuokite ir įklijuokite žemiau esantį kodą į savo Dockerfile.

IŠ mcr.microsoft.com/dotnet/aspnet: 5.0 židinio AS bazė
WORKDIR / programa
80 POZICIJA
IŠ mcr.microsoft.com/dotnet/sdk: 5.0 židinio AS komponavimas
WORKDIR / src
KOPIJA ["aspdockerapi.csproj", "./"]
Vykdyti „dotnet“ atkūrimą "./aspdockerapi.csproj"
KOPIJA. .
WORKDIR "/ src /."
Paleiskite „dotnet“ komponavimo versiją „aspdockerapi.csproj“ -c Release -o / app / build
NUO „build AS“ paskelbimo
Paleiskite „dotnet“ paskelbti „aspdockerapi.csproj“ -c leidimą -o / app / publish
NUO bazės AS galutinis
WORKDIR / programa
KOPIJA - nuo = paskelbti / programą / paskelbti
ENTRYPOINT ["dotnet", "aspdockerapi.dll"]

Pastaba: Dockerfile aukščiau yra projekto ir dll pavadinimai aspdockerapi.csproj ir aspdockerapi.dll atitinkamai, jei jūsų projektas turi kitą pavadinimą, būtinai atnaujinkite „Dockerfile“ teisingais pavadinimais.

Suprasti „Dockerfile“ instrukcijas

The Dockerfile daugiausia sudaro „Dockerfile“ raktiniai žodžiai, kurie pagal susitarimą yra didžiosios raidės žodžiai. Raktiniai žodžiai nurodo instrukciją, kurią reikia atlikti kiekviename „Docker“ vaizdo sluoksnyje. Žemiau pateikiami pagrindiniai „Docker“ raktiniai žodžiai, kuriuos naudoja „Dockerfile“ aukščiau.

1. NUO

The NUO raktinis žodis nurodo pagrindinį vaizdą, ant kurio mes norime sukurti savo įvaizdį. Aukščiau pateiktoje „Dockerfile“ pradinis pagrindinis vaizdas yra „Microsoft“ .NET 5 vaizdas. .NET 5 pagrindiniame paveikslėlyje yra būtini komponentai programos paleidimui.

2. DARBAS

DARBAS nustato darbinį katalogą arba kontekstą vaizdo viduje. Šiame pavyzdyje /app katalogas yra paskirtas kaip numatytasis šakninis darbo katalogas, naudodamas šį sakinį WORKDIR / programa.

3. KOPIJA

The KOPIJA raktinis žodis tiesiog nukopijuoja turinį iš vieno aplanko ir perkelia jį į kitą. Šiame pavyzdyje jis iš pradžių naudojamas nukopijuojant pagrindinį projekto failą, tai yra, aspdockerapi.csproj į paveikslėlių darbo katalogą.

4. Paleisti

The Paleisti raktinis žodis naudojamas paleisti konkrečią „Linux“ komandą „Docker“ paveikslėlyje. Viduje konors Dockerfile virš Paleisti komanda naudojama norint atkurti priklausomybes, sukurti ASP.NET projektą ir paskelbti projektą.

5. CMD

The CMD raktinis žodis yra šiek tiek panašus į Paleisti raktinis žodis, aptartas aukščiau. Jis taip pat naudojamas vykdant „Linux“ komandą, tačiau, skirtingai nei Paleisti raktinis žodis, kuris paleidžia komandas kuriant vaizdą, CMD raktinis žodis naudojamas paleisti „Linux“ komandas, kai paleidžiamas vaizdas, konteinerio egzemplioriuje.

6. PASIŪLYMAS

The POVEIKIS raktinis žodis naudojamas „Docker“ atvaizdo viduje esančiam uostui atskleisti. Tokiu atveju paveikslėlyje rodomas 80 prievadas, kuris naudojamas API atskleidimui vykdant „Docker“ talpyklą.

„Docker Image“ kūrimas

Norėdami sukurti „Docker“ vaizdą pagal Dockerfile, paprasčiausiai vykdykite šią komandą projekto šakniniame aplanke, t. y Dockerfile yra padėtas.

statyti -t dockerwebapi -f Dockerfile.

Aukščiau pateikta komanda žymi „Docker“ vaizdą pavadinimu dockerwebapi ir taip pat nurodoma, kad šio vaizdo kūrimo instrukcijos yra Dockerfile.

Baigę kurti vaizdą, galite patikrinti, ar jis pateiktas kaip vietinis „Docker“ vaizdas, naudodami šią komandą:

dokininkų vaizdai

Aukščiau nurodytos komandos išvestis turėtų būti panaši į žemiau esančią, o vaizdas (dockerwebapi) šiuo atveju yra pirmoje eilutėje.

Jei jūsų kompiuteryje nėra įdiegta „Docker“, Štai kaip įdiegti doką „Ubuntu Linux“, kitaip naudokite toliau pateiktą nuorodą norėdami atsisiųsti ir įdiegti „Docker“.

parsisiųsti: „Docker“ atsisiuntimo ir diegimo vadovas

„Docker Image“ paleidimas

Norėdami paleisti naujai sukurtą „Docker“ vaizdą, naudokite šią komandą. The -ti parinktis nurodo, kad vaizdas turėtų būti rodomas interaktyviu terminalo režimu ir --rm nurodoma, kad konteinerį reikia išimti iškart po jo išėjimo.

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

Be to, komandoje nurodoma, kad „Docker“ konteineris turėtų veikti HTTP 8080 prievade, kuris susiejamas su 80 prievadu, esančiu „contianer“.

Eikite į URL: http://localhost: 8080 / WeatherForecast naršyklėje ir rasite, kad jūsų API duomenys bus teikiami iš jūsų vykdomos „Docker“ egzemplioriaus.

Kodėl naudoti Docker?

Šis vadovas parodė, kaip sukurti .NET 5 žiniatinklio API „Docker“ vaizdą.

Naudodami „Docker“ galite automatizuoti savo programų diegimą, supaprastinti programinės įrangos kūrimo aplinkos nustatymą ir palengvinti bendradarbiavimą su kitais programinės įrangos inžinieriais.

„Docker“ taip pat siūlo keletą pranašumų, palyginti su kitomis virtualizacijos technologijomis, todėl turbūt turėtumėte apsvarstyti galimybę jį naudoti programinės įrangos inžinerijos projektuose.

6 priežastys naudoti „Docker“ virtualizavimo programinę įrangą

„Docker“ teikia daug privalumų, palyginti su virtualia mašina, todėl šiandien reikia pradėti naudoti ją.

Skaitykite toliau

Apie autorių

Išskleisti skaityti visą istoriją