Жоба қызметтері: веб-қызметтер, воркерлер және жоспарлы тапсырмалар.
Жобаға фондық воркерлер, жоспарлы тапсырмалар, қосымша веб-қызметтер, дерекқорлар мен Valkey қосыңыз — жобаның өз кодынан, басқа репозиторийден немесе дайын образдан. Олар бір-біріне атау бойынша жүгінеді, төлемі бір шотта.
Жоба — бір ғана процесс емес. Негізгі қолданбаның жанында кезек воркерін, түнгі тапсырманы, бөлек API-ді, дерекқорды іске қоса аласыз — әрқайсысы өз ресурстары бар қызмет ретінде, барлығы бір шотта.
Қызметтер қолданбаның Шолу → Қызметтер бөлімінде тізіледі, жаңасы Қызмет қосу арқылы қосылады. Бір жобада ең көбі 10 қызмет болуы мүмкін. Алдымен негізгі қызмет іске қосылуы керек, ал жобаның жазылымы белсенді болуы тиіс (сынақ кезеңі де есептеледі).
Қызмет түрлері
| Түрі | Не үшін |
|---|---|
| Веб-қызмет | тағы бір сайт немесе API — жария мекенжаймен немесе тек ішкі |
| Фондық воркер | үздіксіз жұмыс істейді: кезектер, Horizon, Celery, тұтынушылар (consumers) |
| Жоспарлы тапсырма | кесте бойынша іске қосылады (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 Hub, GitHub Container Registry немесе кез келген басқа тізілімдегі дайын образдан (Docker image) алынған веб-қызмет немесе фондық воркер — мысалы nginx:1.27 немесе ghcr.io/org/app:tag.
- Порт — образ тыңдайтын порт; біз оны
$PORTішінде де береміз. - Команда — міндетті емес; бос болса, образ өзі құрастырылған күйінде іске қосылады.
- Жеке тізілім — пайдаланушы аты және құпиясөз немесе қол жеткізу токені. Олар шифрланып сақталады, тек образды жүктеу үшін пайдаланылады және қайта ешқашан көрсетілмейді.
- Автоматты жариялау қосулы болса, тегтің жаңа нұсқаға сілтейтінін күніне бір рет тексеріп, оны жариялаймыз. Жариялаулар қойындысындағы Образды қайта жүктеу мұны дереу жасайды.
Kafka (үлгі)
Қызмет қосу ішіндегі Kafka — бір рет басу арқылы қосылатын дайын үлгі: ол ресми Apache Kafka образынан (3.9) қызмет жасайды — ZooKeeper-сіз, KRaft режиміндегі бір брокер. Әзірлеуге және орташа жүктемеге жарайды.
- Тек ішкі — жария мекенжайы да, сырттан қол жеткізу де жоқ; оған тек қолданбаның қызметтері жетеді.
- Қолданбаның басқа код қызметтері
KAFKA_BROKERS=<service name>:9092жәнеRIVERVO_<NAME>_URL=<service name>:9092айнымалыларын алады. - Топиктер алғаш пайдаланылғанда автоматты түрде жасалады.
- Бастапқы ресурстары: 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 және Дискі бар, бағасы кез келген қолданбадағыдай: айына жадтың 1 GB үшін 6,96 $ және 1 CPU ядросы үшін 4,64 $, жадтың әр GB-на 10 GB диск кіреді, одан артығы 1 GB үшін 0,17 $. Қызметтің жадысы 8 GB-қа дейін болуы мүмкін.
Қызмет қосқанда оның бағасы жобаның шотына қосылады — ағымдағы айда тек қалған бөлігі үшін. Жоба тегін сынақ кезеңінде болса, жаңа қызметтер сынақ біткенше тегін.
Шолу бетінде Жоба бойынша барлығы көрсетіледі — жобаның барлық қызметі бірге айына қанша тұратыны.
Қолданбаның өз ішіндегі воркерлер
Бөлек қызмет әрдайым қажет емес. Негізгі қолданбаның Процестер қойындысында мыналар бар:
- Фондық воркерлер — сайттың жанында ұзақ жұмыс істейтін 5 процеске дейін, мысалы кезек воркері. Олар қолданбаның ресурстарын бөліседі және әр жариялауда қайта іске қосылады.
- Жоспарлы командалар — кесте бойынша (cron форматы, UTC) 10 командаға дейін. Олардың нәтижесі логта Кесте бөлімінде болады.
- Консоль — жұмыс істеп тұрған қолданбаның ішінде оның айнымалылары мен дерекқорымен бір реттік команда орындау. Команда 15 минутқа дейін орындала алады; интерактивті командалар (tinker, shell) мұнда қолдау көрсетілмейді.
Воркерге өз ресурстары керек болса, бөлек қызмет тиімдірек — сонда ауыр кезек сайтты ешқашан баяулатпайды.
Қызметті өзгерту
Қызметті Қызметтер тізімінен ашыңыз. Оның Баптаулар бөлімінде команда, кесте, образ немесе тармақ және ресурстар бар; өзгерістер сақталып, қызмет солармен қайта іске қосылады. Әр қызметтің өз Логтары мен Мониторингі де бар.