Πώς να δημιουργήσετε μια εικόνα Docker ενός .NET Web API

Ένα από τα κύρια πλεονεκτήματα του Docker είναι ότι σας επιτρέπει να εκτελείτε έργα λογισμικού χωρίς να χρειάζεται να δημιουργήσετε σύνθετα περιβάλλοντα ανάπτυξης.

Αυτός ο οδηγός θα σας δείξει πώς να δημιουργήσετε μια εικόνα Docker ενός .NET 5 Web API. Στη συνέχεια, μπορείτε να χρησιμοποιήσετε την εικόνα για να εκτελέσετε τον κώδικα backend από οποιονδήποτε υπολογιστή που έχει εγκαταστήσει το Docker και να αλληλεπιδράσει με το API από το έργο web διεπαφής ή μια εφαρμογή για κινητά.

Δημιουργία ενός .NET 5 Web API

Τόσο το Docker όσο και το .NET 5 είναι ανοιχτού κώδικα και cross-platform, επομένως μπορείτε να ακολουθήσετε αυτόν τον οδηγό είτε χρησιμοποιείτε macOS, Windows ή Linux.

Χρησιμοποιήστε το dotnet CLI για να δημιουργήσετε ένα έργο ASP.NET Web API με την ακόλουθη εντολή:

 dotnet νέο webapi -o aspdockerapi 

Η παραπάνω εντολή δημιουργεί ένα έργο με το όνομα ασπαδοκέρα και το τοποθετεί σε ένα φάκελο με το ίδιο όνομα. Επιπλέον, η εφαρμογή σκαλωσιάζει έναν ελεγκτή API με ορισμένα δείγματα δεδομένων πρόγνωσης καιρού.

Σημείωση: Εάν δεν έχετε εγκαταστήσει το .NET 5 στον υπολογιστή σας, μπορείτε να το κατεβάσετε από τον παρακάτω σύνδεσμο.

Κατεβάστε: .NET 5 Για Windows, macOS και Linux

Μόλις δημιουργηθεί το έργο, μπορείτε να μεταβείτε στον ριζικό φάκελο του έργου χρησιμοποιώντας την ακόλουθη εντολή.

cd aspdockerapi

Μπορείτε να εκτελέσετε και να εξυπηρετήσετε το API Ιστού χρησιμοποιώντας την παρακάτω εντολή.

 εκτέλεση dotnet 

Από προεπιλογή, η εφαρμογή θα προβάλλεται στη θύρα 5001. Μπορείτε να δείτε τα δείγματα δεδομένων της εφαρμογής στο πρόγραμμα περιήγησής σας στην ακόλουθη διεύθυνση URL: https://localhost: 5001 / πρόγνωση καιρού και τα δεδομένα API θα πρέπει να εμφανίζονται όπως παρακάτω.

Μάθε περισσότερα: Τι είναι το API;

Δημιουργία οδηγιών εικόνας Docker

Για να δημιουργήσετε μια εικόνα Docker, πρέπει να δώσετε στον Docker Engine μερικές οδηγίες σχετικά με τον τρόπο δημιουργίας της. Αυτές οι οδηγίες πρέπει να τοποθετηθούν σε ένα αρχείο με το όνομα Dockerfile. Σημειώστε ότι το αρχείο δεν έχει επέκταση.

Χρησιμοποιήστε την ακόλουθη εντολή για να δημιουργήσετε το Dockerfile στον ριζικό φάκελο του έργου της εφαρμογής σας.

αγγίξτε το Dockerfile

Μετά τη δημιουργία του Dockerfile, η δομή του φακέλου έργων σας πρέπει να είναι παρόμοια με αυτήν που ακολουθεί:

Τώρα, αντιγράψτε και επικολλήστε τον παρακάτω κώδικα στο δικό σας Dockerfile.

ΑΠΟ mcr.microsoft.com/dotnet/aspnet: 5.0-εστιακή βάση AS
WORKDIR / εφαρμογή
ΕΚΘΕΣΗ 80
ΑΠΟ mcr.microsoft.com/dotnet/sdk: 5.0-εστίαση AS build
WORKDIR / src
ΑΝΤΙΓΡΑΦΗ ["aspdockerapi.csproj", "./"]
Εκτελέστε επαναφορά dotnet "./aspdockerapi.csproj"
ΑΝΤΙΓΡΑΦΟ. .
WORKDIR "/ src /."
Εκτελέστε dotnet build "aspdockerapi.csproj" -c Release -o / app / build
ΑΠΟ την έκδοση AS δημοσίευση
Εκτελέστε dotnet δημοσίευση "aspdockerapi.csproj" -c Release -o / app / publish
ΑΠΟ τη βάση ως τελικό
WORKDIR / εφαρμογή
ΑΝΤΙΓΡΑΦΗ - από = δημοσίευση / εφαρμογή / δημοσίευση.
ENTRYPOINT ["dotnet", "aspdockerapi.dll"]

Σημείωση: Στο παραπάνω Dockerfile, τα ονόματα του έργου και του dll είναι aspdockerapi.csproj και aspdockerapi.dll αντίστοιχα, εάν το έργο σας έχει διαφορετικό όνομα, φροντίστε να ενημερώσετε το Dockerfile με τα σωστά ονόματα.

Κατανόηση των οδηγιών Dockerfile

ο Dockerfile αποτελείται κυρίως από λέξεις-κλειδιά Dockerfile, οι οποίες κατά συνθήκη είναι κεφαλαία γράμματα. Οι λέξεις-κλειδιά καθορίζουν τις οδηγίες που πρέπει να εκτελούνται σε κάθε επίπεδο της εικόνας Docker. Ακολουθούν οι κύριες λέξεις-κλειδιά του Docker που χρησιμοποιεί το παραπάνω Dockerfile.

1. ΑΠΟ

ο ΑΠΟ Η λέξη-κλειδί καθορίζει τη βασική εικόνα στην οποία θέλουμε να κατασκευαστεί η εικόνα μας. Στο Dockerfile παραπάνω, η αρχική βασική εικόνα είναι μια εικόνα .NET 5 από τη Microsoft. Η βασική εικόνα .NET 5 περιέχει τα απαραίτητα στοιχεία για την εκτέλεση της εφαρμογής.

2. WORKDIR

WORKDIR ορίζει τον κατάλογο εργασίας ή το περιβάλλον μέσα στην εικόνα. Σε αυτό το παράδειγμα, το /app Ο κατάλογος έχει οριστεί ως ο προεπιλεγμένος κατάλογος εργασίας root χρησιμοποιώντας την ακόλουθη δήλωση WORKDIR / εφαρμογή.

3. ΑΝΤΙΓΡΑΦΟ

ο ΑΝΤΙΓΡΑΦΟ η λέξη-κλειδί απλά αντιγράφει περιεχόμενο από έναν φάκελο και το τοποθετεί σε έναν άλλο. Σε αυτό το παράδειγμα, αρχικά χρησιμοποιείται για την αντιγραφή του κύριου αρχείου έργου, δηλαδή, ασπαδοκέρα.csproj στον κατάλογο εργασίας εικόνων.

4. ΤΡΕΞΙΜΟ

ο ΤΡΕΞΙΜΟ Η λέξη-κλειδί χρησιμοποιείται για την εκτέλεση μιας συγκεκριμένης εντολής Linux μέσα σε μια εικόνα Docker. Στο Dockerfile πάνω από το ΤΡΕΞΙΜΟ Η εντολή χρησιμοποιείται για την αποκατάσταση εξαρτήσεων, τη δημιουργία του έργου ASP.NET και τη δημοσίευση του έργου.

5. CMD

ο CMD λέξη-κλειδί είναι λίγο παρόμοια με το ΤΡΕΞΙΜΟ λέξη-κλειδί που συζητήθηκε παραπάνω. Χρησιμοποιείται επίσης για την εκτέλεση μιας εντολής Linux, αλλά σε αντίθεση με την ΤΡΕΞΙΜΟ λέξη-κλειδί που εκτελεί εντολές για την κατασκευή της εικόνας, το CMD Η λέξη-κλειδί χρησιμοποιείται για την εκτέλεση εντολών Linux όταν ξεκινά η εικόνα, σε μια παρουσία κοντέινερ.

6. ΕΚΘΕΣΗ

ο ΕΚΘΕΣΕΙ Η λέξη-κλειδί χρησιμοποιείται για την έκθεση μιας θύρας στο εσωτερικό της εικόνας Docker στον έξω κόσμο. Σε αυτήν την περίπτωση, η εικόνα εκθέτει τη θύρα 80, η οποία χρησιμοποιείται για την έκθεση του API κατά την εκτέλεση του κοντέινερ Docker.

Δημιουργία εικόνας Docker

Για να δημιουργήσετε την εικόνα Docker με βάση το Dockerfile, απλώς εκτελέστε την ακόλουθη εντολή μέσα στον ριζικό φάκελο του έργου, δηλαδή όπου Dockerfile είναι τοποθετημένο.

docker build -t dockerwebapi -f Dockerfile.

Η παραπάνω εντολή επισημαίνει την εικόνα Docker με το όνομα λιμενεργάτης και επίσης καθορίζει ότι οι οδηγίες για την κατασκευή αυτής της εικόνας βρίσκονται στο Dockerfile.

Αφού ολοκληρωθεί η κατασκευή της εικόνας, μπορείτε να ελέγξετε αν εμφανίζεται ως τοπική εικόνα Docker χρησιμοποιώντας την ακόλουθη εντολή:

εικόνες λιμενεργάτη

Η έξοδος από την παραπάνω εντολή πρέπει να είναι παρόμοια με αυτήν που ακολουθεί και η εικόνα (λιμενεργάτης) εμφανίζεται στην πρώτη γραμμή σε αυτήν την περίπτωση.

Εάν δεν έχετε εγκαταστήσει το Docker στον υπολογιστή σας, Δείτε πώς μπορείτε να εγκαταστήσετε το docker στο Ubuntu Linux, διαφορετικά χρησιμοποιήστε τον παρακάτω σύνδεσμο για λήψη και εγκατάσταση του Docker.

Κατεβάστε: Οδηγός λήψης και εγκατάστασης Docker

Εκτέλεση της εικόνας Docker

Για να εκτελέσετε τη νέα εικόνα Docker, χρησιμοποιήστε την ακόλουθη εντολή. ο -α Η επιλογή καθορίζει ότι η εικόνα πρέπει να εκτελείται σε διαδραστική λειτουργία τερματικού και - Ρρμ καθορίζει ότι το δοχείο πρέπει να αφαιρεθεί αμέσως μετά την έξοδο.

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

Επίσης, η εντολή καθορίζει ότι το κοντέινερ Docker πρέπει να εκτελείται στη θύρα HTTP 8080, η οποία αντιστοιχεί στη θύρα 80 μέσα στο κοντέινερ.

Μεταβείτε στη διεύθυνση URL: http://localhost: 8080 / WeatherForecast στο πρόγραμμα περιήγησής σας και θα βρείτε τα δεδομένα API που προβάλλονται από την παρουσία Docker που εκτελείτε.

Γιατί να χρησιμοποιήσετε το Docker;

Αυτός ο οδηγός σας έδειξε πώς να δημιουργήσετε μια εικόνα Docker ενός .NET 5 web API.

Με το Docker, μπορείτε να αυτοματοποιήσετε τον τρόπο ανάπτυξης των εφαρμογών σας, να απλοποιήσετε τη ρύθμιση περιβαλλόντων ανάπτυξης λογισμικού και να διευκολύνετε τη συνεργασία με συναδέλφους μηχανικούς λογισμικού.

Το Docker προσφέρει επίσης πολλά πλεονεκτήματα σε σχέση με άλλες τεχνολογίες εικονικοποίησης, γι 'αυτό θα πρέπει πιθανώς να το χρησιμοποιήσετε στα έργα σας.

6 λόγοι για να χρησιμοποιήσετε το λογισμικό εικονικοποίησης Docker

Το Docker παρέχει πολλά πλεονεκτήματα σε σχέση με μια εικονική μηχανή. Υπάρχουν οι λόγοι για να αρχίσετε να το χρησιμοποιείτε σήμερα.

Διαβάστε Επόμενο

Σχετικά με τον Συγγραφέα

Αναπτύξτε για να διαβάσετε την πλήρη ιστορία