כיצד ליצור תמונת Docker של .NET Web API

אחד היתרונות העיקריים של Docker הוא בכך שהוא מאפשר להריץ פרויקטים של תוכנה ללא צורך בהקמת סביבות פיתוח מורכבות.

מדריך זה יראה לך כיצד ליצור תמונת Docker של .NET 5 Web API. לאחר מכן תוכל להשתמש בתמונה כדי להריץ את קוד ה- backend מכל מחשב שהותקן בו Docker ולנהל אינטראקציה עם ה- API מפרויקט האינטרנט החזיתי שלך או מאפליקציה לנייד.

יצירת .NET 5 Web API

הן Docker והן .NET 5 הם קוד פתוח וחוצה פלטפורמות, לכן תוכלו לעקוב אחר המדריך הזה בין אם אתם משתמשים ב- macOS, Windows או Linux.

השתמש ב- dotnet CLI כדי ליצור פרוייקט ASP.NET Web API עם הפקודה הבאה:

 dotnet webapi חדש -o aspdockerapi 

הפקודה לעיל יוצרת פרויקט בשם aspdockerapi ומניח אותו בתיקייה הנושאת את אותו השם. בנוסף, היישום פיגום בקר API עם כמה נתוני תחזית מזג אוויר לדוגמה.

הערה: אם אין לך .NET 5 מותקן במחשב שלך, אתה יכול להוריד אותו מהקישור למטה.

הורד: .NET 5 עבור Windows, macOS ו- Linux

לאחר יצירת הפרויקט תוכלו להיכנס לתיקיית הבסיס של הפרויקט באמצעות הפקודה הבאה.

cd aspdockerapi

באפשרותך להפעיל ולשרת את ה- API של האינטרנט באמצעות הפקודה למטה.

 לרוץ dotnet 

כברירת מחדל, היישום יוגש ביציאה 5001. תוכל להציג את נתוני הדוגמה של היישום בדפדפן שלך בכתובת האתר הבאה: https://localhost: 5001 / תחזית מזג אוויר ונתוני ה- API צריכים להראות כמו להלן.

למד עוד: מהו API?

יצירת הוראות תמונה של Docker

כדי ליצור תמונה של Docker, עליך לתת למנוע ה- Docker כמה הוראות כיצד לבנות אותה. יש להציב הוראות אלה בקובץ בשם קובץ Docker. שים לב שלקובץ אין סיומת.

השתמש בפקודה הבאה כדי ליצור את קובץ Docker בתיקיית הבסיס של פרויקט היישום שלך.

גע ב- Dockerfile

לאחר יצירת ה- קובץ Docker, מבנה תיקיית הפרויקטים שלך צריך להיות דומה לזה שלמטה:

כעת, העתק והדבק את הקוד שלמטה לתוך שלך קובץ Docker.

מ- mcr.microsoft.com/dotnet/aspnet: בסיס AS 5.0 מוקדים
WORKDIR / אפליקציה
חשוף 80
מ- mcr.microsoft.com/dotnet/sdk: בניית AS 5.0-focal
WORKDIR / src
העתק ["aspdockerapi.csproj", "./"]
הפעל שחזור dotnet "./aspdockerapi.csproj"
עותק. .
WORKDIR "/ src /."
הפעל dotnet לבנות "aspdockerapi.csproj" -c שחרור -o / app / build
FROM build AS לפרסם
הפעל dotnet לפרסם "aspdockerapi.csproj" -c שחרור -o / app / publish
מהבסיס AS בסיסי
WORKDIR / אפליקציה
העתק - מ = פרסם / אפליקציה / פרסם.
ENTRYPOINT ["dotnet", "aspdockerapi.dll"]

הערה: ב- Dockerfile שלמעלה, שמות הפרויקט ו- dll הם aspdockerapi.csproj ו aspdockerapi.dll בהתאמה, אם לפרויקט שלך יש שם אחר, דאג לעדכן את Dockerfile שלך ​​בשמות הנכונים.

הבנת הוראות Dockerfile

ה קובץ Docker מורכב בעיקר ממילות מפתח של Dockerfile, שהן בדרך כלל מילות אות גדולות. מילות המפתח מציינות את ההוראות לביצוע בכל שכבה של תמונת ה- Docker. להלן מילות המפתח העיקריות של Docker בהן משתמש ה- Dockerfile לעיל.

1. מ

ה מ מילת המפתח מציינת את תמונת הבסיס עליה אנו רוצים להקים את התמונה שלנו. ב- Dockerfile שלמעלה, תמונת הבסיס הראשונית היא תמונת .NET 5 ממיקרוסופט. תמונת הבסיס של .NET 5 מכילה את הרכיבים הדרושים להפעלת היישום.

2. WORKDIR

WORKDIR מגדיר את ספריית העבודה או ההקשר בתוך התמונה. בדוגמה זו, /app הספרייה מוקצית כספריית ברירת המחדל לעבודה באמצעות ההצהרה הבאה WORKDIR / אפליקציה.

3. עותק

ה עותק מילת המפתח פשוט מעתיקה תוכן מתיקיה אחת ומציבה אותה בתיקייה אחרת. בדוגמה זו, הוא משמש בתחילה להעתקת קובץ הפרויקט הראשי, כלומר aspdockerapi.csproj לספריית העבודה של התמונות.

4. לָרוּץ

ה לָרוּץ מילת המפתח משמשת להפעלת פקודת לינוקס ספציפית בתוך תמונת Docker. בתוך ה קובץ Docker מעל ה לָרוּץ הפקודה משמשת לשחזור תלות, בניית פרויקט ASP.NET ופרסום הפרויקט.

5. CMD

ה CMD מילת המפתח דומה קצת ל- לָרוּץ מילת מפתח שנדונה לעיל. הוא משמש גם להפעלת פקודה של לינוקס, אך בניגוד ל- לָרוּץ מילת מפתח שמריצה פקודות לבניית התמונה, CMD מילת המפתח משמשת להפעלת פקודות לינוקס בעת הפעלת התמונה, למשל במכולה.

6. חשיפה

ה לַחשׂוֹף מילת המפתח משמשת לחשיפת יציאה בתוך תמונת Docker לעולם החיצון. במקרה זה, התמונה חושפת את יציאה 80, המשמשת לחשיפת ה- API בעת הפעלת מיכל ה- Docker.

בניית תמונת הדוקר

לבניית תמונת ה- Docker בהתבסס על ה- Dockerfile, פשוט הפעל את הפקודה הבאה בתוך תיקיית השורש של הפרויקט, כלומר היכן קובץ Docker ממוקם.

docker build -t dockerwebapi -f Dockerfile.

הפקודה שלמעלה מתייגת את תמונת ה- Docker עם השם dockerwebapi ומפרט גם כי ההוראות לבניית תמונה זו נמצאות ב קובץ Docker.

לאחר סיום בניית התמונה, תוכל לבדוק אם היא רשומה כתמונת Docker מקומית באמצעות הפקודה הבאה:

תמונות העגינה

הפלט מהפקודה לעיל צריך להיות דומה לזה שמתחת, והתמונה (dockerwebapi) מופיע בשורה הראשונה במקרה זה.

אם אין לך Docker מותקן במחשב האישי שלך, כך תתקין את הדוקר ב- Ubuntu Linux, אחרת השתמש בקישור למטה כדי להוריד ולהתקין את Docker.

הורד: מדריך להורדה והתקנה של Docker

הפעלת תמונת ה- Docker

כדי להפעיל את תמונת Docker שזה עתה נוצרה, השתמש בפקודה הבאה. ה -טי אפשרות מציינת כי התמונה צריכה להיות מופעלת במצב מסוף אינטראקטיבי, ו- - rm מציין כי יש להסיר את המיכל מיד לאחר יציאתו.

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

כמו כן, הפקודה מציינת כי על מיכל ה- Docker לפעול ביציאת HTTP 8080, הממופה ליציאה 80 בתוך המתקן.

עבור לכתובת האתר: http://localhost: 8080 / WeatherForecast בדפדפן שלך ותמצא את נתוני ה- API שלך המוגשים ממופע ה- Docker שאתה מפעיל.

מדוע להשתמש ב- Docker?

מדריך זה הראה לך כיצד ליצור תמונת Docker של ממשק API של .NET 5.

באמצעות Docker תוכלו להפוך את האופן שבו אתם פורסים את היישומים שלכם, לפשט את ההגדרה של סביבות פיתוח תוכנה ולהקל על שיתוף הפעולה עם מהנדסי תוכנה אחרים.

Docker מציע גם כמה יתרונות על פני טכנולוגיות וירטואליזציה אחרות, ולכן כדאי לשקול להשתמש בו בפרויקטים שלך להנדסת תוכנה.

6 סיבות להשתמש בתוכנת וירטואליזציה של דוקר

Docker מספק יתרונות רבים על פני מכונה וירטואלית הנה הסיבות להתחיל להשתמש בה עוד היום.

קרא הבא

על הסופר

הרחב לקריאת הסיפור המלא