להתחיל

שירותים של פרויקט: שירותי web, ‏workers ומשימות מתוזמנות.

הוסיפו לפרויקט workers ברקע, משימות מתוזמנות, עוד שירותי web, מסדי נתונים ו-Valkey — מהקוד שלו, ממאגר אחר או מאימג׳ מוכן — עם גישה לפי שם ובחשבון אחד.

5 דקות קריאה

פרויקט הוא יותר מתהליך אחד. לצד האפליקציה הראשית אפשר להריץ worker לתורים, משימה לילית, API נפרד, מסד נתונים — כל אחד כשירות עם משאבים משלו, והכול בחשבון אחד.

השירותים מופיעים בסקירה כללית של האפליקציה → שירותים → הוספת שירות. לפרויקט יכולים להיות עד 10 שירותים. קודם צריך להשיק את השירות הראשי, והמנוי של הפרויקט חייב להיות פעיל (תקופת הניסיון נחשבת).

סוגי שירותים

סוגמה זה
שירות webעוד אתר או API — עם כתובת ציבורית או פנימי בלבד
Worker ברקערץ כל הזמן: תורים, Horizon, ‏Celery, ‏consumers
משימה מתוזמנתמתחילה לפי תזמון (פורמט cron, ‏UTC), עושה את העבודה שלה ונעצרת
PostgreSQL, MySQL, Valkeyמסדי נתונים מנוהלים — ראו מסדי נתונים
NATS, RabbitMQברוקרים של הודעות לאירועים ולתורים, פנימיים בלבד — ראו אירועים ותורים

כתובת ציבורית או פנימי בלבד

כשמוסיפים שירות web, בוחרים איך אפשר להגיע אליו — שום דבר לא נבחר מראש:

  • כתובת ציבורית — פתוח מהאינטרנט בכתובת https://<name>.rivervo.app; אפשר לחבר אליו דומיינים משלכם.
  • פנימי בלבד — בלי כתובת באינטרנט ובלי דומיינים; רק השירותים האחרים של האפליקציה מגיעים אליו. מתאים ל-API שמאחורי האתר, ל-backend של ניהול או למנוע חיפוש.

Workers ברקע, משימות מתוזמנות ומסדי נתונים אף פעם לא ציבוריים, ולכן אין בהם בחירה. אפשר לשנות את זה אחר כך בהגדרות של השירות → כתובת ציבורית — ראו תקשורת בין שירותים.

מאיפה מגיע הקוד

הקוד של הפרויקט הזה

אותו קוד שמופעל בדרך אחרת: worker לתורים, scheduler, שרת WebSocket (למשל Laravel Reverb), תיקייה ב-monorepo, API נפרד.

  • פקודה היא שדה חובה — מה השירות מריץ, למשל php artisan queue:work או node worker.js.
  • שירות web חייב להאזין לפורט שב-$PORT.
  • משימה מתוזמנת צריכה גם תזמון בפורמט cron ‏(UTC), למשל */5 * * * *.
  • כל גרסה חדשה של השירות הראשי נפרסת גם לשירותים האלה, כך שהם תמיד מריצים את אותו קוד.

מאגר אחר

שירות web או worker ברקע ממאגר אחר בחשבון ה-Git המחובר שלכם, עם branch משלו ובמידת הצורך תיקיית פרויקט ופקודות בנייה והפעלה (השאירו שדה ריק כדי להשתמש במה שאנחנו מזהים). יש לו פריסות וגרסאות משלו, וכל push ל-branch שלו נפרס. תצוגות מקדימות של branches עדיין לא נוצרות לשירותים.

אימג׳ מוכן

שירות web או worker ברקע מאימג׳ מוכן (Docker image) מ-Docker Hub, מ-GitHub Container Registry או מכל registry אחר — למשל nginx:1.27 או ghcr.io/org/app:tag.

  • פורט — הפורט שהאימג׳ מאזין לו; אנחנו מעבירים אותו גם ב-$PORT.
  • פקודה — לא חובה; כשהשדה ריק, האימג׳ מופעל כפי שהוא נבנה.
  • Registry פרטי — שם משתמש וסיסמה או טוקן גישה. הם נשמרים מוצפנים, משמשים רק להורדת האימג׳ ולא מוצגים שוב.
  • כשפריסות אוטומטיות מופעלות, אנחנו בודקים פעם ביום אם התג מצביע על גרסה חדשה יותר ופורסים אותה. הורדת האימג׳ מחדש בלשונית פריסות עושה את זה מיד.

Kafka (תבנית)

Kafka בהוספת שירות היא תבנית בלחיצה אחת: היא יוצרת שירות מהאימג׳ הרשמי של Apache Kafka ‏(3.9) — broker יחיד במצב KRaft, בלי ZooKeeper. היא מתאימה לפיתוח ולעומסים בינוניים.

  • פנימי בלבד — בלי כתובת ציבורית ובלי גישה מבחוץ; רק השירותים של האפליקציה מגיעים אליו.
  • שאר שירותי הקוד של האפליקציה מקבלים KAFKA_BROKERS=<service name>:9092 ו-RIVERVO_<NAME>_URL=<service name>:9092.
  • Topics נוצרים אוטומטית בפעם הראשונה שמשתמשים בהם.
  • הוא מתחיל עם 1 GB זיכרון · ליבת CPU אחת · 10 GB דיסק. כמו בכל שירות מאימג׳ מוכן, אפשר לשנות את המשאבים והמשתנים שלו.
  • הנתונים שלו נשמרים בתיקיית הנתונים של השירות על הדיסק שלו.

מה אין בו:

  • Broker אחד — בלי רפליקציה; לכל topic יש replication factor של 1.
  • אין גיבויים מנוהלים של Kafka. הגיבוי היומי מעתיק את תיקיית הנתונים שלו כקבצים בזמן ש-Kafka רץ. זה לא גיבוי עקבי של Kafka: אחרי שחזור ייתכן שיחסרו הודעות אחרונות, או ש-Kafka יצטרך לשחזר את הלוגים שלו בהפעלה.
  • אין חלון תחזוקה, אין גישה מבחוץ ואין ממשק Kafka UI.
  • עדכון Kafka באחריותכם: החליפו את האימג׳ בהגדרות של השירות.

לתורים ולאירועים עם גיבויים ומשתני חיבור שמוגדרים בשבילכם, ראו אירועים ותורים — NATS ו-RabbitMQ.

גישה זה לזה לפי שם

השירותים של פרויקט מתקשרים ברשת פרטית לפי שם: שירות בשם api נגיש מהאחרים כ-api, מסד נתונים בשם db כ-db, והשירות הראשי כ-web. תעבורה בין השירותים של פרויקט לא נספרת כתעבורה.

כל שירות web מציג את הכתובת הפנימית שלו — למשל http://api:8080 — והשירותים האחרים מקבלים אותה במשתנה, RIVERVO_API_URL. איך זה עובד, שירותים פנימיים בלבד, כמה מופעים ו-timeouts: תקשורת בין שירותים.

כל שירות מקבל את משתני הפרויקט — כולל החיבור למסד הנתונים — וגם משתנים משלו, שגוברים על אלה של הפרויקט. ראו משתני סביבה.

משאבים ומחיר

לכל שירות יש זיכרון, CPU ודיסק משלו, במחיר כמו כל אפליקציה: ‏19.53 ‏₪ ל-GB זיכרון ו-‏13.02 ‏₪ לליבת CPU בחודש, עם 10 GB דיסק כלולים לכל GB זיכרון, ומעבר לזה ‏0.49 ‏₪ ל-GB. לשירות יכולים להיות עד 8 GB זיכרון.

כשמוסיפים שירות, המחיר שלו נוסף לחשבון של הפרויקט — לחודש הנוכחי רק החלק שנותר ממנו. כל עוד הפרויקט בתקופת הניסיון החינמית, שירותים חדשים הם בחינם עד סוף תקופת הניסיון.

סקירה כללית מציגה את סך הכול לפרויקט — כמה כל השירותים של הפרויקט עולים יחד בחודש.

Workers בתוך האפליקציה עצמה

לא תמיד צריך שירות נפרד. בלשונית תהליכים של האפליקציה הראשית יש:

  • Workers ברקע — עד 5 תהליכים ארוכים לצד האתר, למשל worker לתורים. הם חולקים את המשאבים של האפליקציה ומופעלים מחדש בכל פריסה.
  • פקודות מתוזמנות — עד 10 פקודות לפי תזמון (פורמט cron, ‏UTC). הפלט שלהן מופיע בלוג תחת תזמון.
  • קונסולה — הרצת פקודה חד-פעמית בתוך האפליקציה הרצה, עם המשתנים ומסד הנתונים שלה. פקודה יכולה לרוץ עד 15 דקות; פקודות אינטראקטיביות (tinker, ‏shell) לא נתמכות כאן.

שירות נפרד הוא הבחירה הטובה יותר כש-worker צריך משאבים משלו, כדי שתור כבד אף פעם לא יאט את האתר.

שינוי שירות

פתחו את השירות מרשימת שירותים. בהגדרות שלו נמצאים הפקודה, התזמון, האימג׳ או ה-branch, והמשאבים; השינויים נשמרים והשירות מופעל מחדש איתם. לכל שירות יש גם לוגים וניטור משלו.

עדיין תקועים?

דברו איתנו בצ׳אט — AI עונה מיד, ומהנדס מצטרף כשצריך, בכל שעה ביממה.

פנייה לתמיכה