Jak utworzyć obraz platformy Docker internetowego interfejsu API platformy .NET

Jedną z głównych zalet Dockera jest to, że umożliwia uruchamianie projektów oprogramowania bez konieczności konfigurowania złożonych środowisk programistycznych.

W tym przewodniku pokazano, jak utworzyć obraz platformy Docker interfejsu API sieci Web platformy .NET 5. Następnie możesz użyć obrazu, aby uruchomić kod zaplecza z dowolnego komputera, na którym zainstalowano platformę Docker, i wchodzić w interakcję z interfejsem API z projektu internetowego frontonu lub aplikacji mobilnej.

Tworzenie internetowego interfejsu API platformy .NET 5

Zarówno Docker, jak i .NET 5 są oprogramowaniem typu open source i wieloplatformowym, dlatego możesz postępować zgodnie z tym przewodnikiem, niezależnie od tego, czy korzystasz z systemu macOS, Windows czy Linux.

Użyj dotnet CLI, aby utworzyć projekt ASP.NET Web API za pomocą następującego polecenia:

 dotnet new webapi -o aspdocerapi 

Powyższe polecenie tworzy projekt o nazwie aspdockerapi i umieszcza go w folderze o tej samej nazwie. Ponadto aplikacja tworzy szkielet kontrolera API z przykładowymi danymi prognozy pogody.

Uwaga: Jeśli nie masz zainstalowanego .NET 5 na swoim komputerze, możesz go pobrać z poniższego linku.

Ściągnij: .NET 5 dla systemów Windows, macOS i Linux

Po utworzeniu projektu możesz przejść do folderu głównego projektu za pomocą następującego polecenia.

cd aspdocerapi

Możesz uruchomić i obsługiwać internetowy interfejs API za pomocą poniższego polecenia.

 Uruchom dotnet 

Domyślnie aplikacja będzie obsługiwana na porcie 5001. Przykładowe dane aplikacji można wyświetlić w przeglądarce pod następującym adresem URL: https://localhost: 5001/prognoza pogody a dane API powinny wyglądać jak poniżej.

Ucz się więcej: Co to jest interfejs API?

Instrukcje dotyczące tworzenia obrazu Docker

Aby utworzyć obraz Docker, musisz przekazać silnikowi Docker kilka instrukcji, jak go zbudować. Instrukcje te należy umieścić w pliku o nazwie Plik dockera. Zauważ, że plik nie ma rozszerzenia.

Użyj następującego polecenia, aby utworzyć Plik dockera w folderze głównym projektu aplikacji.

dotknij Dockerfile

Po utworzeniu Plik dockera, struktura folderów projektów powinna być podobna do poniższej:

Teraz skopiuj i wklej poniższy kod do swojego Plik dockera.

Z mcr.microsoft.com/dotnet/aspnet: 5.0-focal AS base
KATALOG ROBOCZY / aplikacja
EKSPOZYCJA 80
Z mcr.microsoft.com/dotnet/sdk: 5.0-focal AS build
KATALOG ROBOCZY /src
KOPIUJ ["aspdocerapi.csproj", "./"]
URUCHOM przywracanie dotnet "./aspdocerapi.csproj"
KOPIUJ. .
KATALOG ROBOCZY "/źródło/."
URUCHOM kompilację dotnet "aspdocerapi.csproj" -c Release -o /app/build
OD kompilacji JAKO opublikuj
URUCHOM dotnet publish "aspdocerapi.csproj" -c Release -o /app/publish
Z bazy jako ostatecznej
KATALOG ROBOCZY / aplikacja
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "aspdockerapi.dll"]

Uwaga: W powyższym pliku Dockerfile nazwy projektu i biblioteki dll są aspdocerapi.csproj i aspdocerapi.dll odpowiednio, jeśli twój projekt ma inną nazwę, upewnij się, że zaktualizowałeś plik Dockerfile z poprawnymi nazwami.

Zrozumienie instrukcji dockerfile

Plik dockera składa się głównie ze słów kluczowych Dockerfile, które zgodnie z konwencją są słowami wielkimi literami. Słowa kluczowe określają instrukcję do wykonania w każdej warstwie obrazu Docker. Poniżej znajdują się główne słowa kluczowe platformy Docker, których używa powyższy plik Dockerfile.

1. Z

Z słowo kluczowe określa obraz bazowy, na którym chcemy zbudować nasz obraz. W powyższym pliku Dockerfile początkowy obraz podstawowy to obraz platformy .NET 5 firmy Microsoft. Obraz podstawowy platformy .NET 5 zawiera składniki niezbędne do uruchomienia aplikacji.

2. KIERUNEK ROBOCZY

KIERUNEK ROBOCZY ustawia katalog roboczy lub kontekst wewnątrz obrazu. W tym przykładzie /app katalog jest przypisywany jako domyślny główny katalog roboczy za pomocą następującej instrukcji KATALOG ROBOCZY / aplikacja.

3. KOPIUJ

KOPIUJ słowo kluczowe po prostu kopiuje zawartość z jednego folderu i umieszcza ją w innym. W tym przykładzie jest początkowo używany do kopiowania głównego pliku projektu, czyli aspdockerapi.csproj do katalogu roboczego obrazów.

4. BIEGAĆ

BIEGAĆ słowo kluczowe służy do uruchamiania określonego polecenia systemu Linux w obrazie platformy Docker. w Plik dockera wyżej BIEGAĆ Polecenie służy do przywracania zależności, budowania projektu ASP.NET i publikowania projektu.

5. CMD

CMD słowo kluczowe jest trochę podobne do BIEGAĆ słowo kluczowe omówione powyżej. Jest również używany do uruchamiania poleceń systemu Linux, ale w przeciwieństwie do BIEGAĆ słowo kluczowe, które uruchamia polecenia do budowania obrazu, CMD słowo kluczowe służy do uruchamiania poleceń systemu Linux podczas uruchamiania obrazu w instancji kontenera.

6. EKSPOZYCJA

EXPOSE słowo kluczowe służy do udostępnienia portu wewnątrz obrazu platformy Docker światu zewnętrznemu. W takim przypadku obraz uwidacznia port 80, który jest używany do ujawniania interfejsu API podczas uruchamiania kontenera Docker.

Tworzenie obrazu Docker

Aby zbudować obraz Dockera w oparciu o plik Dockera, po prostu uruchom następujące polecenie w folderze głównym projektu, czyli tam, gdzie Plik dockera Jest położone.

docker build -t dockerwebapi -f plik Dockerfile .

Powyższe polecenie oznacza obraz Dockera nazwą dockerwebapi a także określa, że ​​instrukcje budowania tego obrazu znajdują się w Plik dockera.

Po zakończeniu budowania obrazu możesz sprawdzić, czy jest on wymieniony jako lokalny obraz Dockera, używając następującego polecenia:

obrazy dokowane

Wynik powyższego polecenia powinien być podobny do tego poniżej, a obraz (dockerwebapi) pojawia się w tym przypadku w pierwszym wierszu.

Jeśli nie masz zainstalowanego Dockera na swoim komputerze, Oto jak zainstalować docker w systemie Ubuntu Linux, w przeciwnym razie użyj poniższego łącza, aby pobrać i zainstalować Docker.

Ściągnij: Instrukcja pobierania i instalacji platformy Docker

Uruchamianie obrazu Docker

Aby uruchomić nowo utworzony obraz platformy Docker, użyj następującego polecenia. -ti opcja określa, że ​​obraz powinien być uruchamiany w interaktywnym trybie terminala, oraz --rm określa, że ​​kontener powinien zostać usunięty natychmiast po wyjściu.

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

Ponadto polecenie określa, że ​​kontener Docker powinien działać na porcie HTTP 8080, który jest mapowany na port 80 wewnątrz kontenera.

Przejdź do adresu URL: http://localhost: 8080/Prognoza pogody w przeglądarce, a dane interfejsu API są obsługiwane z uruchomionej instancji platformy Docker.

Dlaczego warto korzystać z Dockera?

W tym przewodniku pokazano, jak utworzyć obraz platformy Docker internetowego interfejsu API platformy .NET 5.

Dzięki Dockerowi możesz zautomatyzować wdrażanie aplikacji, uprościć konfigurację środowisk programistycznych i ułatwić współpracę z innymi inżynierami oprogramowania.

Docker oferuje również kilka zalet w porównaniu z innymi technologiami wirtualizacji, dlatego prawdopodobnie powinieneś rozważyć użycie go w swoich projektach inżynierii oprogramowania.

6 powodów, dla których warto korzystać z oprogramowania do wirtualizacji Docker

Docker ma wiele zalet w porównaniu z maszyną wirtualną, oto powody, dla których warto zacząć z niego korzystać już dziś.

Czytaj dalej

O autorze

Rozwiń, aby przeczytać całą historię