დაწყება

პროექტის სერვისები: ვებ-სერვისები, ვორკერები და დაგეგმილი ამოცანები.

დაამატეთ პროექტს ფონური ვორკერები, დაგეგმილი ამოცანები, დამატებითი ვებ-სერვისები, მონაცემთა ბაზები და Valkey — პროექტის საკუთარი კოდიდან, სხვა რეპოზიტორიდან ან მზა იმიჯიდან — სახელით ხელმისაწვდომი და ერთ ანგარიშზე.

5 წთ კითხვა

პროექტი მხოლოდ ერთი პროცესი არ არის. მთავარი აპლიკაციის გვერდით შეგიძლიათ გაუშვათ რიგის ვორკერი, ღამის ამოცანა, ცალკე API, მონაცემთა ბაზა — თითოეული სერვისის სახით, საკუთარი რესურსებით, ყველა კი ერთ ანგარიშზე.

სერვისების სია და მათი დამატება აპლიკაციის გვერდზეა: მიმოხილვა → სერვისები → სერვისის დამატება. პროექტს შეიძლება ჰქონდეს 10 სერვისამდე. ჯერ მთავარი სერვისი უნდა იყოს გაშვებული, და პროექტის გამოწერა უნდა იყოს აქტიური (საცდელი პერიოდიც ითვლება).

სერვისების სახეები

სახერა არის
ვებ-სერვისიკიდევ ერთი საიტი ან API — საჯარო მისამართით ან მხოლოდ შიდა
ფონური ვორკერიმუშაობს მუდმივად: რიგები, Horizon, Celery, consumer-ები
დაგეგმილი ამოცანაეშვება განრიგით (cron ფორმატი, UTC), ასრულებს სამუშაოს და ჩერდება
PostgreSQL, MySQL, Valkeyმართვადი მონაცემთა ბაზები — იხ. მონაცემთა ბაზები
NATS, RabbitMQშეტყობინებების ბროკერები მოვლენებისა და რიგებისთვის, მხოლოდ შიდა — იხ. მოვლენები და რიგები

საჯარო მისამართი თუ მხოლოდ შიდა

ვებ-სერვისის დამატებისას აირჩიეთ, როგორ იქნება ის ხელმისაწვდომი — წინასწარ არაფერია მონიშნული:

  • საჯარო მისამართი — იხსნება ინტერნეტიდან მისამართზე https://<name>.rivervo.app; შეიძლება ჰქონდეს თქვენი საკუთარი დომენები.
  • მხოლოდ შიდა — არც ინტერნეტ-მისამართი, არც დომენები; მას მხოლოდ აპლიკაციის სხვა სერვისები მიმართავენ. შესაფერისია საიტის უკან მდგომი API-სთვის, ადმინისტრირების ბექენდისთვის ან საძიებო სისტემისთვის.

ფონური ვორკერები, დაგეგმილი ამოცანები და მონაცემთა ბაზები არასოდეს არის საჯარო, ამიტომ მათთვის არჩევანი არ არსებობს. მოგვიანებით ამის შეცვლა სერვისის პარამეტრები → საჯარო მისამართი-ში შეგიძლიათ — იხ. სერვისებს შორის კავშირი.

საიდან მოდის კოდი

ამ პროექტის კოდი

იგივე კოდი, სხვაგვარად გაშვებული: რიგის ვორკერი, დამგეგმავი, WebSocket სერვერი (მაგალითად, Laravel Reverb), მონორეპოზიტორის საქაღალდე, ცალკე API.

  • ბრძანება სავალდებულოა — რას უშვებს სერვისი, მაგალითად php artisan queue:work ან node worker.js.
  • ვებ-სერვისმა უნდა მოუსმინოს $PORT-ში მითითებულ პორტს.
  • დაგეგმილ ამოცანას ასევე სჭირდება განრიგი cron ფორმატში (UTC), მაგალითად */5 * * * *.
  • მთავარი სერვისის ყოველი ახალი ვერსია ამ სერვისებზეც განთავსდება, ასე რომ ისინი ყოველთვის ერთსა და იმავე კოდს უშვებენ.

სხვა რეპოზიტორი

ვებ-სერვისი ან ფონური ვორკერი თქვენი დაკავშირებული Git ანგარიშის სხვა რეპოზიტორიდან, საკუთარი ბრენჩით და, საჭიროების შემთხვევაში, პროექტის საქაღალდით და აწყობისა და გაშვების ბრძანებებით (დატოვეთ ველი ცარიელი, თუ გსურთ, გამოვიყენოთ ის, რასაც ავტომატურად განვსაზღვრავთ). მას საკუთარი განთავსებები და ვერსიები აქვს და თავისი ბრენჩის ყოველ push-ს განათავსებს. სერვისებისთვის ბრენჩების პრევიუები ჯერ არ იქმნება.

მზა იმიჯი

ვებ-სერვისი ან ფონური ვორკერი მზა იმიჯიდან (Docker იმიჯი) Docker Hub-ზე, GitHub Container Registry-ში ან ნებისმიერ სხვა რეესტრში — მაგალითად nginx:1.27 ან ghcr.io/org/app:tag.

  • პორტი — პორტი, რომელსაც იმიჯი უსმენს; მას $PORT-შიც გადავცემთ.
  • ბრძანება — არასავალდებულო; ცარიელი ველის შემთხვევაში იმიჯი ისე ეშვება, როგორც აწყობილია.
  • პრივატული რეესტრი — მომხმარებლის სახელი და პაროლი ან წვდომის ტოკენი. ისინი დაშიფრულად ინახება, მხოლოდ იმიჯის ჩამოსატვირთად გამოიყენება და აღარასოდეს ჩანს.
  • ავტომატური განთავსების ჩართვისას დღეში ერთხელ ვამოწმებთ, მიუთითებს თუ არა ტეგი უფრო ახალ ვერსიაზე, და ვანთავსებთ მას. იმიჯის ხელახლა ჩამოტვირთვა განთავსებების ჩანართზე ამას მაშინვე აკეთებს.

Kafka (შაბლონი)

Kafka სერვისის დამატებაში ერთი დაწკაპებით მზა შაბლონია: ის ქმნის სერვისს Apache Kafka-ს ოფიციალური იმიჯიდან (3.9) — ერთი ბროკერი KRaft რეჟიმში, ZooKeeper-ის გარეშე. შესაფერისია დეველოპმენტისა და ზომიერი დატვირთვისთვის.

  • მხოლოდ შიდა — არც საჯარო მისამართი, არც გარედან წვდომა; მას მხოლოდ აპლიკაციის სერვისები მიმართავენ.
  • აპლიკაციის სხვა კოდის სერვისები იღებენ KAFKA_BROKERS=<service name>:9092 და RIVERVO_<NAME>_URL=<service name>:9092.
  • თემები (topics) ავტომატურად იქმნება პირველი გამოყენებისას.
  • საწყისი რესურსებია 1 GB მეხსიერება · 1 CPU ბირთვი · 10 GB დისკი. როგორც მზა იმიჯიდან შექმნილ ნებისმიერ სერვისს, მის რესურსებსა და ცვლადებს შეცვლა შეგიძლიათ.
  • მისი მონაცემები სერვისის დისკზე, მონაცემების საქაღალდეში ინახება.

რა არ აქვს:

  • ერთი ბროკერი — რეპლიკაციის გარეშე; ყოველი თემის რეპლიკაციის ფაქტორი 1-ია.
  • Kafka-ს მართვადი სარეზერვო ასლები არ არის. ყოველდღიური დარეზერვება მის მონაცემების საქაღალდეს ფაილებად აკოპირებს, სანამ Kafka მუშაობს. ეს Kafka-ს შეთანხმებული სარეზერვო ასლი არ არის: აღდგენის შემდეგ ბოლო შეტყობინებები შეიძლება აკლდეს, ან Kafka-ს გაშვებისას ლოგების აღდგენა დასჭირდეს.
  • არც ტექნიკური მომსახურების დრო, არც გარედან წვდომა, არც Kafka UI.
  • Kafka-ს განახლება თქვენზეა: შეცვალეთ იმიჯი სერვისის პარამეტრებში.

რიგებისა და მოვლენებისთვის სარეზერვო ასლებით და თქვენთვის გამართული კავშირის ცვლადებით იხ. მოვლენები და რიგები — NATS და RabbitMQ.

ერთმანეთთან სახელით მიმართვა

პროექტის სერვისები ერთმანეთს კერძო ქსელით, სახელით უკავშირდებიან: api სახელის სერვისი სხვებისთვის ხელმისაწვდომია როგორც api, db სახელის მონაცემთა ბაზა — როგორც db, ხოლო მთავარი სერვისი — როგორც web. პროექტის სერვისებს შორის ტრაფიკი ტრაფიკად არ ითვლება.

ყოველ ვებ-სერვისს აქვს შიდა მისამართი — მაგალითად http://api:8080 — და სხვა სერვისები მას ცვლადში იღებენ: RIVERVO_API_URL. როგორ მუშაობს ეს, მხოლოდ შიდა სერვისები, რამდენიმე ინსტანსი და ტაიმაუტები: სერვისებს შორის კავშირი.

ყოველი სერვისი იღებს პროექტის ცვლადებს — მონაცემთა ბაზასთან კავშირის ჩათვლით — და საკუთარ ცვლადებსაც, რომლებსაც პროექტისაზე მეტი პრიორიტეტი აქვთ. იხ. გარემოს ცვლადები.

რესურსები და ფასი

ყოველ სერვისს აქვს საკუთარი მეხსიერება, CPU და დისკი, რომლებიც ფასდება ისევე, როგორც ნებისმიერი აპლიკაცია: 7,08 $ მეხსიერების 1 GB-ზე და 4,72 $ CPU-ს 1 ბირთვზე თვეში, მეხსიერების ყოველ 1 GB-ზე 10 GB დისკი შედის ფასში, შემდეგ კი 0,18 $ 1 GB-ზე. სერვისს შეიძლება ჰქონდეს 8 GB-მდე მეხსიერება.

სერვისის დამატებისას მისი ფასი პროექტის ანგარიშს ემატება — მიმდინარე თვისთვის მხოლოდ მისი დარჩენილი ნაწილი. სანამ პროექტი უფასო საცდელ პერიოდშია, ახალი სერვისები საცდელი პერიოდის დასრულებამდე უფასოა.

მიმოხილვაზე ჩანს პროექტის ჯამი — რა ღირს პროექტის ყველა სერვისი ერთად თვეში.

ვორკერები თავად აპლიკაციის შიგნით

ცალკე სერვისი ყოველთვის საჭირო არ არის. მთავარი აპლიკაციის პროცესების ჩანართზეა:

  • ფონური ვორკერები — საიტის გვერდით 5-მდე ხანგრძლივი პროცესი, მაგალითად რიგის ვორკერი. ისინი აპლიკაციის რესურსებს იზიარებენ და ყოველი განთავსებისას გადაიტვირთება.
  • დაგეგმილი ბრძანებები — 10-მდე ბრძანება განრიგით (cron ფორმატი, UTC). მათი შედეგი ლოგშია, განრიგის ქვეშ.
  • კონსოლი — ერთჯერადი ბრძანების გაშვება მომუშავე აპლიკაციის შიგნით, მისი ცვლადებითა და მონაცემთა ბაზით. ბრძანება შეიძლება 15 წუთამდე მუშაობდეს; ინტერაქტიული ბრძანებები (tinker, shell) აქ არ არის მხარდაჭერილი.

ცალკე სერვისი უკეთესი არჩევანია, როცა ვორკერს საკუთარი რესურსები სჭირდება, რომ მძიმე რიგმა საიტი არასოდეს შეანელოს.

სერვისის შეცვლა

გახსენით სერვისი სერვისების სიიდან. მის პარამეტრებში არის ბრძანება, განრიგი, იმიჯი ან ბრენჩი და რესურსები; ცვლილებები ინახება და სერვისი მათით გადაიტვირთება. ყოველ სერვისს ასევე აქვს საკუთარი ლოგები და მონიტორინგი.

ჯერ კიდევ გაქვთ კითხვები?

მოგვწერეთ ჩატში — AI მაშინვე გპასუხობთ, საჭიროებისას კი ინჟინერი უერთდება, დღე-ღამის ნებისმიერ დროს.

მხარდაჭერასთან დაკავშირება