בדף הזה מוסבר איך להעביר קוד של תור משימות מסוג שליפת הודעות מ-Task Queues ל-Pub/Sub. Pub/Sub היא עכשיו הדרך המומלצת לבצע עבודה בתור למשיכת הודעות ב-App Engine.
אם האפליקציה שלכם משתמשת גם בתורי משיכה וגם בתורי דחיפה, כדאי להיעזר במדריך הזה כדי להעביר את תורי המשיכה ל-Pub/Sub לפני שתעבירו את תורי הדחיפה לשירות החדש של תורי דחיפה Cloud Tasks. לא מומלץ להעביר את תורי המשימות מסוג pull אחרי שמבצעים העברה של תורי משימות מסוג push ל-Cloud Tasks, כי סביר להניח שהשימוש הנדרש בקובץ queue.yaml יגרום להתנהגות בלתי צפויה ב-Cloud Tasks.
תכונות שלא זמינות כרגע ב-Pub/Sub
התכונות הבאות של תורי משימות לא זמינות כרגע ב-Pub/Sub:
- הוספה לחבילה לפי תג
- ביטול כפילויות אוטומטי
תמחור ומכסות
העברת תורי שליפה ל-Pub/Sub עשויה להשפיע על התמחור והמכסות של האפליקציה.
תמחור
ל-Pub/Sub יש תמחור משלו. בדומה לתורי משימות, שליחת בקשות לאפליקציית App Engine באמצעות Pub/Sub עלולה לגרום לאפליקציה שלכם לחייב אתכם בעלויות.
מכסות
המיכסות של Pub/Sub שונות מהמיכסות של Task Queues. בדומה לתורי משימות, שליחת בקשות לאפליקציית App Engine מ-Pub/Sub עשויה להשפיע על מכסות הבקשות של App Engine.
לפני ההעברה
בקטעים הבאים מפורטים שלבי ההגדרה לפני העברת תורי ההודעות מסוג pull ל-Pub/Sub.
הפעלת Pub/Sub API
כדי להפעיל את Pub/Sub API, לוחצים על Enable ב- Pub/Sub API ב-API Library. אם מופיע לחצן ניהול במקום לחצן הפעלה, סימן שהפעלתם בעבר את Pub/Sub API בפרויקט, ואין צורך לעשות זאת שוב.
אימות האפליקציה ב-Pub/Sub API
צריך לאמת את האפליקציה ב-Pub/Sub API. בקטע הזה נדון באימות בשני תרחישי שימוש שונים.
כדי לפתח או לבדוק את האפליקציה באופן מקומי, מומלץ להשתמש בחשבון שירות. הוראות להגדרת חשבון שירות וקישור שלו לאפליקציה מופיעות במאמר קבלת פרטי כניסה לחשבון שירות וצירופם באופן ידני.
כדי לפרוס את האפליקציה ב-App Engine, לא צריך לספק אימות חדש. פרטי האימות של אפליקציות App Engine מוסקים מ-Application Default Credentials (ADC).
הורדת Google Cloud CLI
אם לא התקנתם בעבר את Google Cloud CLI, הורידו והתקינו אותו כדי להשתמש ב-ה-CLI של gcloud עם Pub/Sub API. אם כבר התקנתם את Google Cloud CLI, מריצים את הפקודה הבאה מהטרמינל.
gcloud components update
ייבוא ספריות לקוח של Cloud
כדי להשתמש בספריית הלקוח עם האפליקציה, פועלים לפי ההוראות של Pub/Sub בנושא התקנת ספריית הלקוח.תורים של Pub/Sub ושל שליפה
השוואה בין תכונות
Pub/Sub שולח עבודה לעובדים דרך קשר של מפרסם/מנוי. מינוי לשליפת הודעות ב-Pub/Sub דומה לתור של שליפת הודעות בתורי משימות, כי המנוי שולף את ההודעה מהנושא. בטבלה שבהמשך מפורטת התכונה העיקרית של תורי שליפת הודעות בתור המשימות, והתכונה המקבילה של מינויים לשליפת הודעות ב-Pub/Sub.
| התכונה 'תורי משימות' | תכונת Pub/Sub |
|---|---|
| הבאים בתור | נושא |
| משימה | הודעה |
| קובץ שירות | מנויים |
מידע נוסף על ארכיטקטורת Pub/Sub זמין במאמר Cloud Pub/Sub: שירות העברת הודעות עם מלוא היכולות של Google.
השוואה בין תהליכי עבודה
בהמשך מוצגת השוואה בין תהליך עבודה אופייני לתור משימות מסוג pull ב-Task Queues לבין מינוי מסוג pull ב-Pub/Sub.
| תהליך העבודה עם תורי משימות | זרימת עבודה של Pub/Sub |
|---|---|
| אתם יוצרים את תור ההמתנה למשיכת נתונים | אתם יוצרים את הנושא ומצרפים את המנוי (כלומר, העובד) לנושא. |
| יוצרים את המשימה ומכניסים אותה לתור | יוצרים את ההודעה ומפרסמים אותה בנושא |
| העובד שוכר את המשימה | המשתמש שנרשם לנושא מושך את ההודעה מהנושא |
| העובד מעבד את המשימה | המנוי מעבד את ההודעה |
| העובד מוחק את המשימה מהתור | המנוי מאשר את ההודעה |
| החוזה יפוג | הנושא מוחק את ההודעה כשכל המנויים שלו אישרו את קבלת ההודעה |
יצירת מינויים לשליפה ב-Pub/Sub
אתם יכולים להשתמש במינוי מסוג pull ב-Pub/Sub כמו בתור מסוג pull של תורי משימות. מינויים לנושא לא פוקעים, ויכולים להתקיים בו-זמנית לכמה עובדים. כלומר, יותר מעובד אחד יכול לעבד הודעה, וזה אחד מתרחישי השימוש העיקריים ב-Pub/Sub. כדי ליצור מחדש את תורי המשימות שלכם כמנויים לשליפה ב-Pub/Sub, יוצרים נושא לכל עובד ומנויים רק את העובד המשויך לנושא. כך מוודאים שכל הודעה תעובד על ידי עובד אחד בדיוק, כמו בתורי משימות. מידע על יצירה וניהול של מינויים מסוג pull זמין במאמר בנושא ניהול נושאים ומינויים.
מחיקת תורים להעברת הודעות
אחרי שמעבירים את תורי המשימות מסוג pull למינויים מסוג pull ב-Pub/Sub, צריך למחוק אותם מ-Task Queues באמצעות קובץ ה-queue.yaml. מומלץ למחוק כל תור משיכה לפני העברת התור הבא. כך האפליקציה לא תשכפל את העבודה שהיא מקבלת מהמינוי החדש של Pub/Sub pull בזמן שאתם מעבירים את תורי ההמתנה האחרים של pull. שימו לב: מחיקה של תורי משימות מסוג pull בנפרד ולא בפריסה אחת עשויה להשפיע יותר על מכסת הפריסה של App Engine.
אחרי שמוחקים את כל תורי שליפת המשימות מ-Task Queues, אפשר להשמיט את קובץ queue.yaml מהפריסות העתידיות של האפליקציה.
אם האפליקציה שלכם משתמשת רק בתורי שליפה, צריך להסיר מהקוד את כל ההפניות ל-Task Queues API. אם האפליקציה שלכם משתמשת גם בתורי שליפה וגם בתורי דחיפה, אתם יכולים להסיר את ההפניות אל Task Queues API שמופיעות בקבצים שמשתמשים רק בתורי שליפה, או לחכות עד שתבצעו גם את ההעברה של תורי הדחיפה ואז להסיר את ההפניות אל Task Queues API מכל הקבצים.