מעבר מתורי דחיפה ל-Cloud Tasks באמצעות שדרוג לגרסת ה-SDK העדכנית ביותר (Java)

לפני שמשדרגים לגרסה האחרונה של ה-SDK של שירותי App Engine, כדאי לקרוא את הסקירה הכללית על ההעברה.

כדי לעבור ל-Cloud Tasks באופן אוטומטי, אתם יכולים לעדכן את ה-SDK של שירותי App Engine לגרסה העדכנית. אחרי השדרוג, ערכת ה-SDK מפנה באופן אוטומטי את הקריאות ל-PushQueue אל ממשקי ה-API של Cloud Tasks בממשק הקצה. ב-Cloud Tasks נשמרים תורי המשימות והמשימות הקיימים, כך שאין צורך בהעברה נוספת.

מאחורי הקלעים, ערכת ה-SDK המעודכנת משתמשת בממשקי ה-API של Cloud Tasks כדי לשמור על שוויון בין התכונות של תורי המשימות. ערכת ה-SDK תומכת בתכונות הבאות:

  • יצירת משימות באצווה: ערכת ה-SDK משתמשת בממשקי API של אצווה כדי לתמוך בהוספה של עד 100 משימות בקריאה אחת.
  • מחיקת משימות באצווה: ה-SDK משתמש בממשקי API של אצווה כדי לתמוך במחיקה של עד 1,000 משימות בקריאה אחת.
  • ניסיונות חוזרים ברמת המשימה: ה-SDK תומך בהגדרות של ניסיונות חוזרים ספציפיים למשימה.
  • משימות טרנזקציות: ה-SDK מוסיף משימות לתור בתוך טרנזקציות של Datastore. כדי לשמור על האמינות, צריך ליצור או לשנות את הקובץ cron.yaml.

תמחור ומכסות

העברת תורי הדחיפה ל-Cloud Tasks עשויה להשפיע על התמחור ועל המכסות של האפליקציה.

תמחור

כדאי לעיין בתמחור של Cloud Tasks כדי להעריך את העלות החודשית לפני המעבר.

בדומה לתורי משימות, שליחת בקשות לאפליקציית App Engine עם יעד דחיפה של Cloud Tasks היא בחינם. עם זאת, בניגוד לתורי משימות, ב-Cloud Tasks החיוב הוא על פעולות שבוצעו, כמו יצירה, מחיקה או ניהול של משימות. יכול להיות שהעלות החודשית הכוללת תהיה גבוהה יותר בהשוואה לשימוש בתור המשימות של App Engine, שניתן בחינם.

אם אתם משדרגים את ה-SDK של שירותי App Engine כדי להעביר את האפליקציה, והאפליקציה מוסיפה לתור משימות טרנזקציות בתוך טרנזקציות של Datastore, כל משימה שנוספת לתור כרוכה ב-3 פעולות כתיבה, 2 פעולות קריאה ופעולת מחיקה אחת ב-Datastore, בנוסף לחיוב הרגיל של Cloud Tasks API.

מכסות

בקשות של Cloud Tasks נכללות גם במכסות הבקשות של App Engine.

בדומה לתורי משימות, ל-Cloud Tasks יש מכסות ספציפיות לשירות. המעבר ל-Cloud Tasks כנראה ישנה את המכסות שלכם.

אופטימיזציה של זמן האחזור של הבקשות

מכיוון שערכת ה-SDK המעודכנת שולחת בקשות ישירות ל-Cloud Tasks API, הוספה לתור או מחיקה של משימות בודדות ברצף יכולה להגדיל את זמן האחזור של הבקשות בהשוואה לשירות תורי המשימות הקודם. כדי לצמצם את זמן האחזור:

  • הוספה של כמה משימות בקריאה אחת: במקום להוסיף משימות לתור או למחוק אותן אחת אחרי השנייה בלולאה, אפשר לקבץ אותן לקריאות הוספה (עד 100 משימות לקריאה) או לקריאות מחיקה (עד 1,000 משימות לקריאה).
  • שימוש בקריאות אסינכרוניות ל-API: משתמשים בשיטות שלא חוסמות, כמו addAsync() ו-deleteTaskAsync(), כדי שפעולות המשימה לא יחסמו את הטיפול בבקשות.

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

לפני שמעבירים את תורי הדחיפה (push queue) ל-Cloud Tasks, צריך לבצע את הפעולות הבאות:

  1. מוודאים שיש לכם גישה לקוד המקור של App Engine.

  2. מפעילים את Cloud Tasks API ואת Cloud Scheduler API:

    הפעלת ממשקי API

  3. כדי לוודא שלחשבון השירות של App Engine יש את ההרשאות הנדרשות כדי לאפשר ל-SDK לשלוח משימות ל-Cloud Tasks API, צריך לבקש מהאדמין להקצות את תפקיד ה-IAM הוספה לתור של Cloud Tasks (roles/cloudtasks.enqueuer) בפרויקט.

עדכון ה-SDK של שירותי App Engine

  1. מוודאים שהאפליקציה משתמשת בגרסה העדכנית של ה-SDK של שירותי App Engine.

    ב-pom.xml, מעדכנים את ה-SDK של שירותי App Engine לגרסה 5.2.0 ואילך.

    <dependency>
        <groupId>com.google.appengine</groupId>
        <artifactId>appengine-api-1.0-sdk</artifactId>
        <version>5.2.0</version>
    </dependency>
  2. הפעלת הניתוב של Cloud Tasks

    runtime: java25
    service: my-service-b
    
    env_variables:
      APPENGINE_USE_CLOUDTASK_PUSH_QUEUE: "true"
    

    מעדכנים את התלות ב-App Engine SDK בקובץ pom.xml לגרסה 5.2.0 ואילך.

    אם האפליקציה משתמשת בהגדרות אישיות ב-XML‏ (appengine-web.xml):

    <appengine-web-app xmlns="http://appengine.google.com/ns/1.0">
      <service>my-java-service-b</service>
      <runtime>java25</runtime>
      <env-variables>
        <env-var name="APPENGINE_USE_CLOUDTASK_PUSH_QUEUE" value="true" />
      </env-variables>
    </appengine-web-app>
    
  3. פורסים את האפליקציה:

    gcloud app deploy
    
  4. כדי לוודא שהאפליקציה משתמשת ב-Cloud Tasks, נכנסים לדף Cloud Tasks במסוףGoogle Cloud .

הגדרת משימות טרנזקציונליות (אופציונלי)

אם האפליקציה שלכם מוסיפה משימות לתור בתוך טרנזקציות של Datastore, ה-SDK מסתמך על משימת Cron פנימית כדי לוודא שכל המשימות שלא נוספו לתור במהלך ה-commit של Datastore יעובדו בסופו של דבר.

כדי לטפל במשימות טרנזקציות של תור דחיפה (push queue), צריך ליצור או לעדכן את הקובץ cron.yaml כדי לקרוא למעבד הפנימי באופן תקופתי. לדוגמה:

cron:
- description: "Process push queue transactional tasks"
  url: /_ah/cloudtask/sweep
  schedule: every 30 minutes # Change this based on the usage pattern

מוסיפים מפת URL בקובץ web.xml של com.google.apphosting.utils.servlet.SweeperServlet, או com.google.apphosting.utils.servlet.jakarta.SweeperServlet של Java 17 וסביבות זמן ריצה מאוחרות יותר של Jakarta EE.

<servlet>
 <servlet-name>cloudtask_sweep</servlet-name>
 <servlet-class>com.google.apphosting.utils.servlet.SweeperServlet</servlet-class>
</servlet>
<servlet-mapping>
 <servlet-name>cloudtask_sweep</servlet-name>
 <url-pattern>/_ah/cloudtask/sweep</url-pattern>
</servlet-mapping>

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