Boshlash

Loyiha xizmatlari: veb-xizmatlar, fon workerlari va rejalashtirilgan vazifalar.

Loyihaga fon workerlari, rejalashtirilgan vazifalar, qoʻshimcha veb-xizmatlar, maʼlumotlar bazalari va Valkey qoʻshing — oʻz kodidan, boshqa repozitoriydan yoki tayyor obrazdan — ular bir-biriga nom orqali murojaat qiladi va bitta hisobga kiradi.

5 DAQIQA OʻQISH

Loyiha bitta jarayon bilan cheklanmaydi. Asosiy ilova yonida navbat workeri, tungi vazifa, alohida API, maʼlumotlar bazasini ishga tushirishingiz mumkin — har biri oʻz resurslariga ega xizmat sifatida, hammasi bitta hisobda.

Xizmatlar ilovaning Umumiy maʼlumot → Xizmatlar → Xizmat qoʻshish boʻlimida. Bitta loyihada 10 tagacha xizmat boʻlishi mumkin. Avval asosiy xizmat ishga tushirilgan boʻlishi va loyiha obunasi faol boʻlishi kerak (sinov muddati ham hisobga olinadi).

Xizmat turlari

TurNima
Veb-xizmatyana bitta sayt yoki API — ochiq manzil bilan yoki faqat ichki
Fon workeridoimiy ishlaydi: navbatlar, Horizon, Celery, consumerʼlar
Rejalashtirilgan vazifajadval boʻyicha ishga tushadi (cron formati, UTC), ishini bajaradi va toʻxtaydi
PostgreSQL, MySQL, Valkeyboshqariladigan maʼlumotlar bazalari — Maʼlumotlar bazalari maqolasiga qarang
NATS, RabbitMQhodisalar va navbatlar uchun xabar brokerlari, faqat ichki — Hodisalar va navbatlar maqolasiga qarang

Ochiq manzil yoki faqat ichki

Veb-xizmat qoʻshayotganda unga qanday murojaat qilinishini tanlang — oldindan hech narsa tanlanmagan:

  • Ochiq manzil — internetdan https://<name>.rivervo.app manzilida ochiladi; unga oʻz domenlaringizni ulash mumkin.
  • Faqat ichki — internetda manzili ham, domenlari ham yoʻq; unga faqat ilovaning boshqa xizmatlari murojaat qiladi. Saytingiz ortidagi API, admin backend yoki qidiruv tizimi uchun mos.

Fon workerlari, rejalashtirilgan vazifalar va maʼlumotlar bazalari hech qachon ochiq boʻlmaydi, shuning uchun ular uchun tanlov yoʻq. Keyinroq buni xizmatning Sozlamalar → Ochiq manzil boʻlimida oʻzgartirishingiz mumkin — Xizmatlararo aloqa maqolasiga qarang.

Kod qayerdan olinadi

Shu loyihaning kodi

Xuddi shu kod, faqat boshqacha ishga tushiriladi: navbat workeri, rejalashtiruvchi, WebSocket server (masalan, Laravel Reverb), monorepozitoriy papkasi, alohida API.

  • Buyruq majburiy — xizmat nimani ishga tushiradi, masalan, php artisan queue:work yoki node worker.js.
  • Veb-xizmat $PORT dagi portni tinglashi kerak.
  • Rejalashtirilgan vazifa uchun cron formatida (UTC) Jadval ham kerak, masalan, */5 * * * *.
  • Asosiy xizmatning har bir yangi versiyasi bu xizmatlarga ham deploy qilinadi, shuning uchun ular doim bir xil kodda ishlaydi.

Boshqa repozitoriy

Ulangan Git akkauntingizdagi boshqa repozitoriydan veb-xizmat yoki fon workeri — oʻz branchi bilan, kerak boʻlsa, Loyiha papkasi va Yigʻish va ishga tushirish buyruqlari bilan (biz aniqlagan qiymatni ishlatish uchun maydonni boʻsh qoldiring). Uning oʻz deploylari va versiyalari bor, u oʻz branchiga qilingan har bir pushʼni deploy qiladi. Xizmatlar uchun branchlarning preview nusxalari hozircha yaratilmaydi.

Tayyor obraz

Docker Hub, GitHub Container Registry yoki boshqa istalgan registrdagi tayyor obrazdan (Docker image) veb-xizmat yoki fon workeri — masalan, nginx:1.27 yoki ghcr.io/org/app:tag.

  • Port — obraz tinglaydigan port; biz uni $PORT da ham uzatamiz.
  • Buyruq — ixtiyoriy; boʻsh boʻlsa, obraz qanday yigʻilgan boʻlsa, shunday ishga tushadi.
  • Shaxsiy registr — foydalanuvchi nomi va parol yoki kirish tokeni. Ular shifrlangan holda saqlanadi, faqat obrazni yuklab olish uchun ishlatiladi va boshqa hech qachon koʻrsatilmaydi.
  • Avtomatik deploylar yoqilgan boʻlsa, biz kuniga bir marta teg yangiroq versiyaga ishora qilayotganini tekshiramiz va uni deploy qilamiz. Deploylar boʻlimidagi Obrazni qayta yuklab olish buni darhol bajaradi.

Kafka (shablon)

Xizmat qoʻshish dagi Kafka — bir bosishda tayyor boʻladigan shablon: u rasmiy Apache Kafka obrazidan (3.9) xizmat yaratadi — KRaft rejimidagi bitta broker, ZooKeeperʼsiz. U ishlab chiqish va oʻrtacha yuklamalar uchun mos.

  • Faqat ichki — ochiq manzil ham, tashqaridan kirish ham yoʻq; unga faqat ilova xizmatlari murojaat qiladi.
  • Ilovaning kodli boshqa xizmatlari KAFKA_BROKERS=<service name>:9092 va RIVERVO_<NAME>_URL=<service name>:9092 oʻzgaruvchilarini oladi.
  • Topiclar birinchi marta ishlatilganda avtomatik yaratiladi.
  • U 1 GB xotira · 1 CPU yadrosi · 10 GB disk bilan boshlanadi. Tayyor obrazdan yaratilgan har qanday xizmat kabi, uning resurslari va oʻzgaruvchilarini oʻzgartirishingiz mumkin.
  • Uning maʼlumotlari xizmat diskidagi maʼlumotlar papkasida saqlanadi.

Unda nimalar yoʻq:

  • Bitta broker — replikatsiya yoʻq; har bir topicning replikatsiya koeffitsiyenti 1.
  • Boshqariladigan Kafka zaxira nusxalari yoʻq. Kunlik zaxiralash Kafka ishlab turgan paytda uning maʼlumotlar papkasini fayllar sifatida nusxalaydi. Bu Kafkaʼning yaxlit zaxira nusxasi emas: tiklangandan keyin oxirgi xabarlar yetishmasligi yoki Kafka ishga tushganda oʻz loglarini tiklashi kerak boʻlishi mumkin.
  • Texnik ishlar vaqti, tashqaridan kirish va Kafka UI yoʻq.
  • Kafkaʼni yangilash sizning zimmangizda: xizmatning Sozlamalar boʻlimida obrazni almashtiring.

Zaxira nusxalari va siz uchun sozlab qoʻyilgan ulanish oʻzgaruvchilari bilan navbatlar va hodisalar kerak boʻlsa, Hodisalar va navbatlar maqolasiga qarang — NATS va RabbitMQ.

Bir-biriga nom orqali murojaat

Loyiha xizmatlari yopiq tarmoq orqali nom bilan muloqot qiladi: api deb nomlangan xizmatga boshqalar api orqali, db deb nomlangan maʼlumotlar bazasiga db orqali, asosiy xizmatga esa web orqali murojaat qiladi. Loyiha xizmatlari oʻrtasidagi trafik trafik sifatida hisoblanmaydi.

Har bir veb-xizmat oʻzining Ichki manzilini koʻrsatadi — masalan, http://api:8080 — boshqa xizmatlar esa uni RIVERVO_API_URL oʻzgaruvchisida oladi. Bu qanday ishlashi, faqat ichki xizmatlar, bir nechta instansiya va kutish vaqtlari haqida: Xizmatlararo aloqa.

Har bir xizmat loyiha oʻzgaruvchilarini — maʼlumotlar bazasiga ulanish maʼlumotlari bilan birga — hamda oʻz oʻzgaruvchilarini oladi; oʻz oʻzgaruvchilari loyiha oʻzgaruvchilaridan ustun turadi. Muhit oʻzgaruvchilari maqolasiga qarang.

Resurslar va narx

Har bir xizmatning oʻz Xotira, CPU va Disk resurslari bor, narxi esa boshqa har qanday ilovadagidek: oyiga xotiraning har GB uchun 6,72 $ va har bir CPU yadrosi uchun 4,48 $, xotiraning har GB uchun 10 GB disk kiritilgan, undan keyin har GB uchun 0,17 $. Xizmatda 8 GB gacha xotira boʻlishi mumkin.

Xizmat qoʻshganingizda uning narxi loyiha hisobiga qoʻshiladi — joriy oy uchun faqat oyning qolgan qismi hisoblanadi. Loyiha bepul sinov muddatida boʻlsa, yangi xizmatlar sinov muddati tugaguncha bepul.

Umumiy maʼlumot boʻlimida Loyiha jami koʻrsatiladi — loyihaning barcha xizmatlari birgalikda oyiga qancha turishi.

Ilovaning oʻzi ichidagi fon workerlari

Har doim ham alohida xizmat kerak emas. Asosiy ilovaning Jarayonlar boʻlimida quyidagilar bor:

  • Fon workerlari — sayt yonida uzoq ishlaydigan 5 tagacha jarayon, masalan, navbat workeri. Ular ilova resurslaridan birgalikda foydalanadi va har bir deployda qayta ishga tushadi.
  • Rejalashtirilgan buyruqlar — jadval boʻyicha (cron formati, UTC) 10 tagacha buyruq. Ularning natijasi logda Jadval ostida.
  • Konsol — ishlab turgan ilova ichida, uning oʻzgaruvchilari va maʼlumotlar bazasi bilan bir martalik buyruq ishga tushirish. Buyruq 15 daqiqagacha ishlashi mumkin; interaktiv buyruqlar (tinker, shell) bu yerda qoʻllab-quvvatlanmaydi.

Fon workeriga oʻz resurslari kerak boʻlsa, alohida xizmat yaxshiroq tanlov — shunda ogʻir navbat saytni hech qachon sekinlashtirmaydi.

Xizmatni oʻzgartirish

Xizmatni Xizmatlar roʻyxatidan oching. Uning Sozlamalar boʻlimida buyruq, jadval, obraz yoki branch va resurslar bor; oʻzgarishlar saqlanadi va xizmat ular bilan qayta ishga tushadi. Har bir xizmatning oʻz Loglar va Monitoring boʻlimlari ham bor.

Hali ham savollar bormi?

Bizga chatda yozing — AI darhol javob beradi, kerak boʻlsa muhandis qoʻshiladi, kunning istalgan vaqtida.

Yordamga yozish