גישה לחבילות שירותים מדור קודם ל-Go

בדף הזה מוסבר איך להתקין ולהשתמש בשירותים בחבילה עם זמן הריצה של Go בסביבה הרגילה של App Engine. האפליקציה יכולה לגשת לשירותים בחבילה באמצעות App Engine services SDK for Go.

לפני שמתחילים

התקנה של App Engine services SDK

כדי לקרוא לממשקי ה-API של השירותים מהדור הקודם באמצעות Go, צריך להשתמש ב-SDK העדכני ביותר. איך לעשות את זה?

  1. מעדכנים את קובץ app.yaml כדי לציין שירות אחד או יותר מהדור הקודם. לדוגמה:

    app_engine_bundled_services:
    - datastore_v3
    - memcache
    - user
    

    אם אתם משתמשים בתכונות כמו login: admin בקטע handlers של קובץ app.yaml, אתם צריכים להפעיל את Users API על ידי הגדרת ההגדרה user ברשימה app_engine_bundled_services.

  2. כדי להוסיף הפניה לגרסה העדכנית של ה-SDK בקובץ go.mod, מריצים את הפקודה go get במסוף באופן הבא:

    go get google.golang.org/appengine/v2
    

    ההבדל העיקרי בשדרוג ל-Go הוא השימוש בגרסה 2 של ה-SDK של שירותי App Engine.

  3. באפליקציה, משנים את הצהרות הייבוא על ידי הוספת /v2/ לשמות החבילות הישנים. לדוגמה, אם משתמשים ב-Memcache, צריך לבצע את הפעולות הבאות:

    import (
      "google.golang.org/appengine/v2"
      "google.golang.org/appengine/v2/memcache"
    )
    

    לרשימה המלאה של שמות החבילות הזמינות

  4. מריצים את הפקודה go mod tidy כדי לנקות את ההפניות בקובץ go.mod.

    go mod tidy
    

שיקולים לגבי מיגרציה

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