בדף הזה מוסבר איך להתקין את השירותים הכלולים ולהשתמש בהם עם זמן הריצה של Go בסביבה הרגילה של App Engine. האפליקציה יכולה לגשת לשירותים בחבילה באמצעות ערכת ה-SDK של שירותי App Engine ל-Go.
לפני שמתחילים
- כדאי לעיין ברשימת ממשקי API של שירותים בחבילה מדור קודם שאפשר להפעיל בסביבת זמן הריצה של Go.
- לפני שמתחילים פרויקט העברה ל-Go, כדאי לעיין בסקירה הכללית של העברת זמן הריצה ובשיקולים להעברה כשמשתמשים בחבילת שירותים מדור קודם.
התקנה של App Engine services SDK
כדי לקרוא לממשקי ה-API של השירותים מהדור הקודם באמצעות Go, צריך להשתמש ב-SDK העדכני. איך לעשות את זה?
צריך לעדכן את הקובץ
app.yamlולהוסיף לו את השורה הבאה:app_engine_apis: trueכדי להוסיף הפניה לגרסה העדכנית של ה-SDK בקובץ
go.mod, מריצים את הפקודהgo getבמסוף באופן הבא:go get google.golang.org/appengine/v2ההבדל העיקרי בשדרוג ל-Go הוא השימוש בגרסה 2 של ה-SDK של שירותי App Engine.
באפליקציה, משנים את הצהרות הייבוא על ידי הוספת
/v2/לשמות החבילות הישנים. לדוגמה, אם משתמשים ב-Memcache, צריך לבצע את הפעולות הבאות:import ( "google.golang.org/appengine/v2" "google.golang.org/appengine/v2/memcache" )מריצים את הפקודה
go mod tidyכדי לנקות את ההפניות בקובץgo.mod.go mod tidy
שיקולים לגבי מיגרציה
אם אתם מעבירים את האפליקציה לזמן הריצה של Go והיא משתמשת בשירותים קודמים בחבילה, כדאי שתכירו את הנקודות הבאות:
- כדי לבדוק את הפונקציונליות של שירותים בחבילה מדור קודם באפליקציית Go,
מריצים את האפליקציה בסביבה המקומית
עם כלי הפיתוח שבהם אתם בדרך כלל משתמשים, כמו
go run. - כדי לפרוס את האפליקציה, משתמשים בפקודה
gcloud app deploy.