זמן הריצה של ‎ .NET

סקירה כללית

הפונקציה של Cloud Run פועלת בסביבה שכוללת גרסת מערכת הפעלה, חבילות של תוספים, תמיכה בשפה וספריית Functions Framework שתומכת בפונקציה ומפעילה אותה. הסביבה הזו מזוהה לפי גרסת השפה, והיא נקראת זמן ריצה.

מידע על סביבות ריצה באופן כללי, ועל גרסת אובונטו שבה כל סביבת ריצה של ‎ .NET משתמשת, זמין במאמר סביבת ההפעלה של פונקציות Cloud Run.

חבילת תבניות

חבילת התבניות עוזרת לכם ליצור פונקציות חדשות. כדי להשתמש בו:

  1. מתקינים את .NET SDK.

  2. מתקינים את חבילת התבניות:

    dotnet new install Google.Cloud.Functions.Templates

יש תבניות לשלושת סוגי הפונקציות ב-C#‎ (ברירת המחדל), ב-F#‎ וב-Visual Basic. כשיוצרים פרויקט חדש מתבנית, מציינים -lang f# כדי ליצור פרויקט F# ‎, או -lang vb כדי ליצור פרויקט Visual Basic. למידע נוסף:

בחירת גרסה של .NET Functions Framework

גרסאות שונות של .NET Functions Framework תומכות בסביבות ריצה שונות. גרסה 1 תומכת ב-‎ .NET Core 3.1 ומעלה, והתבניות מוגדרות כברירת מחדל ל-‎.NET Core 3.1. גרסה 2 תומכת ב-‎ .NET 6 ואילך, והתבניות מוגדרות כברירת מחדל ל-‎ .NET 6.

כדי לשדרג פרויקט קיים באמצעות גרסה 1 של .NET Functions Framework, צריך לערוך את קובץ הפרויקט (או להשתמש ב-Visual Studio) כדי לעדכן את כל התלויות שמתחילות ב-Google.Cloud.Functions לגרסה העדכנית ביותר, ולהגדיר את מסגרת היעד ל-‎ .NET 6.

בחירת זמן הריצה

פונקציות Cloud Run תומכות בכמה גרסאות של ‎ .NET, שמפורטות בדף Runtime support. כשפורסים את הפונקציה, צריך לציין סביבת זמן ריצה של ‎ .NET שתואמת למסגרת היעד בקובץ הפרויקט (MyFunction.csproj או דומה). כדי לציין את סביבת זמן הריצה של ‎ .NET:

אם משתמשים ב-Google Cloud CLI, מציינים את סביבת זמן הריצה באמצעות הפרמטר --runtime. הדגל --entry-point מציין את שם הכיתה המוגדר במלואו (FQN). לדוגמה:

gcloud functions deploy NAME --no-gen2 --entry-point FQN --no-gen2 --runtime dotnet6 --trigger-http

פרמטרים נוספים לפריסה מפורטים במאמר פריסת פונקציה ב-Cloud Run.

הכנת הפונקציה

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

הספרייה שמפעילה את הפונקציה היא .NET Functions Framework.

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

כדי שפונקציות Cloud Run יוכלו למצוא את ההגדרה של הפונקציה, לכל סביבת ריצה יש דרישות מסוימות לגבי המבנה של קוד המקור. מידע נוסף זמין במאמר בנושא כתיבת פונקציות של Cloud Run.

ציון יחסי תלות

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

המאמרים הבאים