Kuinka luoda .NET Web API -sovelluksen Docker-kuva

Yksi Dockerin tärkeimmistä eduista on, että sen avulla voit suorittaa ohjelmistoprojekteja tarvitsematta luoda monimutkaisia ​​kehitysympäristöjä.

Tässä oppaassa kerrotaan, miten luodaan .NET 5 Web-sovellusliittymän Docker-kuva. Tämän jälkeen voit käyttää kuvaa taustakoodin suorittamiseen mistä tahansa tietokoneesta, johon Docker on asennettu, ja olla vuorovaikutuksessa käyttöliittymän kanssa käyttöliittymän web-projektista tai mobiilisovelluksesta.

NET 5 Web -sovellusliittymän luominen

Sekä Docker että .NET 5 ovat avoimen lähdekoodin ja alustojen välisiä, joten voit seurata tätä opasta riippumatta siitä, käytätkö macOS: ää, Windowsia tai Linuxia.

Luo ASET.NET Web API -projekti dotnet CLI: n avulla seuraavalla komennolla:

 dotnet uusi webapi -o aspdockerapi 

Yllä oleva komento luo projektin nimeltä aspdockerapi ja sijoittaa sen samannimiseen kansioon. Lisäksi sovellus rakentaa API-ohjaimen, jossa on joitain esimerkkejä sääennusteista.

Merkintä: Jos tietokoneellasi ei ole .NET 5 -asennusta, voit ladata sen alla olevasta linkistä.

ladata: .NET 5 Windowsille, macOS: lle ja Linuxille

Kun projekti on luotu, voit siirtyä projektin juurikansioon seuraavalla komennolla.

cd aspdockerapi

Voit suorittaa ja käyttää web-sovellusliittymää alla olevan komennon avulla.

 dotnet-ajo 

Oletusarvoisesti sovellus palvellaan portissa 5001. Voit tarkastella sovelluksen esimerkkitietoja selaimessasi seuraavasta URL-osoitteesta: https://localhost: 5001 / sääennuste ja sovellusliittymien tietojen tulisi näyttää alla olevilta.

Lisätietoja: Mikä on API?

Docker Image -ohjeiden luominen

Docker-kuvan luomiseksi sinun on annettava Docker Enginen ohjeet sen rakentamiseen. Nämä ohjeet tulisi sijoittaa tiedostoon nimeltä Docker-tiedosto. Huomaa, että tiedostolla ei ole laajennusta.

Käytä seuraavaa komentoa luodaksesi Docker-tiedosto sovellusprojektin juurikansiossa.

kosketa Dockerfile

Kun olet luonut Docker-tiedosto, projektisi kansion rakenteen tulee olla samanlainen kuin alla:

Kopioi ja liitä nyt alla oleva koodi omaan Docker-tiedosto.

Lähettäjä mcr.microsoft.com/dotnet/aspnet: 5.0-polttovälin AS-pohja
WORKDIR / sovellus
ALTISTUMINEN 80
FROM mcr.microsoft.com/dotnet/sdk: 5.0-polttovälinen AS-koontiversio
WORKDIR / src
KOPIOI ["aspdockerapi.csproj", "./"]
SUORITA dotnet-palautus "./aspdockerapi.csproj"
KOPIO. .
WORKDIR "/ src /."
SUORITA dotnet-koontiversio "aspdockerapi.csproj" -c Release -o / app / build
FROM build AS julkaise
SUORITA dotnet-julkaisu "aspdockerapi.csproj" -c Release -o / app / publish
ASEMASTA lopullinen
WORKDIR / sovellus
KOPIOI - from = julkaise / sovellus / julkaise.
ENTRYPOINT ["dotnet", "aspdockerapi.dll"]

Merkintä: Yllä olevassa Docker-tiedostossa projekti- ja dll-nimet ovat aspdockerapi.csproj ja aspdockerapi.dll vastaavasti, jos projektillasi on eri nimi, muista päivittää Docker-tiedostosi oikeilla nimillä.

Dockerfile-ohjeiden ymmärtäminen

Docker-tiedosto koostuu pääasiassa Dockerfile-avainsanoista, jotka sopimuksen mukaan ovat isoja kirjaimia. Avainsanat määrittävät suoritettavan käskyn jokaisessa Docker-kuvan kerroksessa. Alla ovat tärkeimmät Docker-avainsanat, joita yllä oleva Docker-tiedosto käyttää.

1. Alkaen

Alkaen avainsana määrittää peruskuvan, jolle haluamme kuvamme rakennettavan. Yllä olevassa Docker-tiedostossa alkuperäinen peruskuva on Microsoftin .NET 5 -kuva. .NET 5 -peruskuva sisältää tarvittavat komponentit sovelluksen suorittamiseen.

2. TYÖRYHMÄ

TYÖRYHMÄ asettaa työhakemiston tai kontekstin kuvan sisään. Tässä esimerkissä /app hakemisto on määritetty oletusjuurihakemistoksi seuraavan käskyn avulla WORKDIR / sovellus.

3. KOPIO

KOPIO avainsana yksinkertaisesti kopioi sisällön yhdestä kansiosta ja sijoittaa sen toiseen. Tässä esimerkissä sitä käytetään alun perin kopioimaan pääprojektitiedosto, aspdockerapi.csproj kuvien työhakemistoon.

4. JUOSTA

JUOSTA avainsanaa käytetään tietyn Linux-komennon suorittamiseen Docker-kuvassa. vuonna Docker-tiedosto yllä JUOSTA komentoa käytetään palauttamaan riippuvuudet, rakentamaan ASP.NET-projekti ja julkaisemaan projekti.

5. CMD

CMD avainsana on vähän samanlainen kuin JUOSTA edellä käsitelty avainsana. Sitä käytetään myös Linux-komennon suorittamiseen, mutta toisin kuin JUOSTA avainsana, joka suorittaa komentoja kuvan rakentamiseksi, CMD avainsanaa käytetään Linux-komentojen suorittamiseen, kun kuva käynnistetään, säilöesimerkissä.

6.EHDOTUS

ALTISTUMINEN avainsanaa käytetään Docker-kuvan sisäisen portin paljastamiseen ulkomaailmaan. Tässä tapauksessa kuva paljastaa portin 80, jota käytetään API: n paljastamiseen Docker-säilöä suoritettaessa.

Docker-kuvan rakentaminen

Docker-kuvan rakentaminen Dockerfile, Suorita seuraava komento projektin juurikansiossa, ts. missä Docker-tiedosto on sijoitettu.

docker build -t dockerwebapi -f Docker-tiedosto.

Yllä oleva komento merkitsee Docker-kuvan nimellä dockerwebapi ja täsmentää myös, että tämän kuvan rakentamisohjeet ovat Docker-tiedosto.

Kun kuva on valmis, voit tarkistaa, onko se listattu paikallisena Docker-kuvana, seuraavalla komennolla:

telakointikuvia

Yllä olevan komennon ulostulon tulisi olla samanlainen kuin alla, ja kuvan (dockerwebapi) näkyy tässä tapauksessa ensimmäisellä rivillä.

Jos tietokoneellasi ei ole Dockeria asennettuna, täältä saat ohjeet telakointiaseman asentamiseen Ubuntu Linuxiin, muuten käytä alla olevaa linkkiä ladataksesi ja asentamalla Docker.

ladata: Dockerin lataus- ja asennusopas

Docker-kuvan suorittaminen

Suorita uusi Docker-kuva käyttämällä seuraavaa komentoa. -ti - vaihtoehto määrittää, että kuva on suoritettava interaktiivisessa päätelaitteessa, ja --rm täsmentää, että astia on poistettava heti sen poistumisen jälkeen.

telakointiajo -ti --rm -p 8080: 80 dockerwebapi

Komento määrittelee myös, että Docker-säilön tulisi toimia HTTP-portissa 8080, joka kartoittaa portin 80 kilpailijan sisällä.

Siirry URL-osoitteeseen: http://localhost: 8080 / Sääennuste selaimessasi ja huomaat, että API-tietojasi näytetään käyttämästäsi Docker-ilmentymästä.

Miksi käyttää Dockeria?

Tässä oppaassa kerrottiin, kuinka luodaan .NET 5 -verkkosovellusliittymän Docker-kuva.

Dockerin avulla voit automatisoida sovellusten käyttöönoton, yksinkertaistaa ohjelmistokehitysympäristöjen määritystä ja helpottaa yhteistyötä muiden ohjelmistoinsinöörien kanssa.

Docker tarjoaa myös useita etuja muihin virtualisointitekniikoihin verrattuna, minkä vuoksi sinun kannattaa harkita sen käyttöä ohjelmistosuunnitteluprojekteissasi.

6 syytä käyttää Docker-virtualisointiohjelmistoa

Docker tarjoaa monia etuja virtuaalikoneeseen verrattuna, joten on syytä aloittaa sen käyttö tänään.

Lue seuraava

Kirjailijasta

Laajenna lukemaan koko tarina