Projektin palvelut: verkkopalvelut, taustaprosessit ja ajastetut tehtävät.
Lisää projektiin taustaprosesseja, ajastettuja tehtäviä, lisää verkkopalveluita, tietokantoja ja Valkey – sen omasta koodista, toisesta repositoriosta tai valmiista imagesta – tavoitettavissa nimellä ja yhdellä laskulla.
Projekti on enemmän kuin yksi prosessi. Pääsovelluksen rinnalla voit ajaa jonon käsittelijää, yöllistä tehtävää, erillistä API:a tai tietokantaa – kutakin palveluna omilla resursseillaan, kaikki yhdellä laskulla.
Palvelut löytyvät sovelluksen kohdasta Yleiskatsaus → Palvelut → Lisää palvelu. Projektilla voi olla enintään 10 palvelua. Pääpalvelu on käynnistettävä ensin, ja projektin tilauksen on oltava voimassa (kokeilujakso lasketaan).
Palvelutyypit
| Tyyppi | Mikä se on |
|---|---|
| Verkkopalvelu | toinen sivusto tai API – julkisella osoitteella tai vain sisäinen |
| Taustaprosessi | käynnissä koko ajan: jonot, Horizon, Celery, kuluttajat |
| Ajastettu tehtävä | käynnistyy aikataulun mukaan (cron-muoto, UTC), tekee työnsä ja pysähtyy |
| PostgreSQL, MySQL, Valkey | hallinnoidut tietokannat – katso Tietokannat |
| NATS, RabbitMQ | viestinvälittäjät tapahtumille ja jonoille, vain sisäisiä – katso Tapahtumat ja jonot |
Julkinen osoite vai vain sisäinen
Kun lisäät verkkopalvelun, valitse, miten siihen pääsee – mitään ei ole valittu valmiiksi:
- Julkinen osoite – avoin internetistä osoitteessa
https://<name>.rivervo.app; sillä voi olla omia verkkotunnuksia. - Vain sisäinen – ei osoitetta internetissä eikä verkkotunnuksia; vain sovelluksen muut palvelut tavoittavat sen. Sopii sivustosi takana olevalle API:lle, ylläpidon taustajärjestelmälle tai hakukoneelle.
Taustaprosessit, ajastetut tehtävät ja tietokannat eivät ole koskaan julkisia, joten niille ei ole valintaa. Voit muuttaa sitä myöhemmin palvelun kohdassa Asetukset → Julkinen osoite – katso Palveluiden välinen viestintä.
Mistä koodi tulee
Tämän projektin koodi
Sama koodi toisella tavalla käynnistettynä: jonon käsittelijä, ajastin, WebSocket-palvelin (esimerkiksi Laravel Reverb), monorepon kansio, erillinen API.
- Komento on pakollinen – mitä palvelu ajaa, esim.
php artisan queue:worktainode worker.js. - Verkkopalvelun on kuunneltava
$PORT-muuttujan porttia. - Ajastettu tehtävä tarvitsee lisäksi Aikataulun cron-muodossa (UTC), esim.
*/5 * * * *. - Jokainen pääpalvelun uusi versio julkaistaan myös näihin palveluihin, joten ne ajavat aina samaa koodia.
Toinen repositorio
Verkkopalvelu tai taustaprosessi yhdistetyn Git-tilisi toisesta repositoriosta, omalla haarallaan ja tarvittaessa omalla Projektikansiolla sekä Koonti- ja käynnistyskomennoilla (jätä kenttä tyhjäksi, niin käytetään tunnistamaamme). Sillä on omat julkaisunsa ja versionsa, ja se julkaisee jokaisen pushin haaraansa. Haaraesikatseluja ei vielä tehdä palveluille.
Valmis image
Verkkopalvelu tai taustaprosessi valmiista imagesta (Docker-image) Docker Hubista, GitHub Container Registrystä tai mistä tahansa muusta rekisteristä – esimerkiksi nginx:1.27 tai ghcr.io/org/app:tag.
- Portti – portti, jota image kuuntelee; välitämme sen myös muuttujassa
$PORT. - Komento – valinnainen; tyhjänä image käynnistyy niin kuin se on rakennettu.
- Yksityinen rekisteri – käyttäjänimi ja salasana tai käyttötunniste. Ne tallennetaan salattuina, niitä käytetään vain imagen lataamiseen eikä niitä näytetä enää uudelleen.
- Kun automaattiset julkaisut ovat päällä, tarkistamme kerran päivässä, osoittaako tagi uudempaan versioon, ja julkaisemme sen. Lataa image uudelleen Julkaisut-välilehdellä tekee sen heti.
Kafka (malli)
Kafka kohdassa Lisää palvelu on yhden napsautuksen valmisasetus: se luo palvelun virallisesta Apache Kafka -imagesta (3.9) – yksi välittäjä KRaft-tilassa ilman ZooKeeperia. Se sopii kehitykseen ja kohtuullisille kuormille.
- Vain sisäinen – ei julkista osoitetta eikä pääsyä ulkopuolelta; vain sovelluksen palvelut tavoittavat sen.
- Sovelluksen muut koodipalvelut saavat muuttujat
KAFKA_BROKERS=<service name>:9092jaRIVERVO_<NAME>_URL=<service name>:9092. - Aiheet (topicit) luodaan automaattisesti, kun niitä käytetään ensimmäisen kerran.
- Se käynnistyy resursseilla 1 Gt muistia · 1 suoritinydin · 10 Gt levyä. Kuten minkä tahansa valmiista imagesta luodun palvelun, voit muuttaa sen resursseja ja muuttujia.
- Sen data säilytetään palvelun datakansiossa sen levyllä.
Mitä siinä ei ole:
- Yksi välittäjä – ei replikointia; jokaisen aiheen replikointikerroin on 1.
- Ei hallinnoituja Kafka-varmuuskopioita. Päivittäinen varmuuskopio kopioi sen datakansion tiedostoina Kafkan ollessa käynnissä. Se ei ole johdonmukainen Kafka-varmuuskopio: palautuksen jälkeen tuoreita viestejä voi puuttua, tai Kafka voi joutua palauttamaan lokinsa käynnistyessään.
- Ei huoltoaikaa, ei pääsyä ulkopuolelta eikä Kafka-käyttöliittymää.
- Kafkan päivittäminen on sinun vastuullasi: vaihda image palvelun Asetuksissa.
Jonoihin ja tapahtumiin, joissa varmuuskopiot ja yhteysmuuttujat on valmiiksi määritetty, katso Tapahtumat ja jonot – NATS ja RabbitMQ.
Tavoitettavuus nimellä
Projektin palvelut viestivät yksityisessä verkossa nimellä: api-niminen palvelu on muiden tavoitettavissa nimellä api, db-niminen tietokanta nimellä db ja pääpalvelu nimellä web. Projektin palveluiden välistä liikennettä ei lasketa liikenteeksi.
Jokainen verkkopalvelu näyttää Sisäisen osoitteensa – esimerkiksi http://api:8080 – ja muut palvelut saavat sen muuttujassa RIVERVO_API_URL. Miten se toimii, vain sisäiset palvelut, useat instanssit ja aikakatkaisut: Palveluiden välinen viestintä.
Jokainen palvelu saa projektin muuttujat – myös tietokantayhteyden – sekä omat muuttujansa, jotka ohittavat projektin muuttujat. Katso Ympäristömuuttujat.
Resurssit ja hinta
Jokaisella palvelulla on oma Muisti, Suoritin ja Levy, ja ne hinnoitellaan kuten mikä tahansa sovellus: 6,84 € / Gt muistia ja 4,57 € / suoritinydin kuukaudessa, 10 Gt levyä sisältyy jokaista muistigigatavua kohden, minkä jälkeen 0,18 € / Gt. Palvelulla voi olla enintään 8 Gt muistia.
Kun lisäät palvelun, sen hinta lisätään projektin laskuun – kuluvalta kuukaudelta vain jäljellä olevalta osalta. Kun projekti on ilmaisella kokeilujaksolla, uudet palvelut ovat maksuttomia kokeilun loppuun asti.
Yleiskatsaus näyttää kohdan Projekti yhteensä – mitä projektin kaikki palvelut maksavat yhteensä kuukaudessa.
Taustaprosessit sovelluksen sisällä
Erillistä palvelua ei aina tarvita. Pääsovelluksen Prosessit-välilehdellä on:
- Taustaprosessit – enintään 5 pitkäkestoista prosessia sivuston rinnalla, esim. jonon käsittelijä. Ne jakavat sovelluksen resurssit ja käynnistyvät uudelleen jokaisessa julkaisussa.
- Ajastetut komennot – enintään 10 komentoa aikataulun mukaan (cron-muoto, UTC). Niiden tuloste on lokissa kohdassa Ajastus.
- Konsoli – aja kertaluonteinen komento käynnissä olevassa sovelluksessa sen muuttujilla ja tietokannalla. Komento voi kestää enintään 15 minuuttia; interaktiivisia komentoja (tinker, komentotulkki) ei tueta tässä.
Erillinen palvelu on parempi valinta, kun taustaprosessi tarvitsee omat resurssinsa, jotta raskas jono ei koskaan hidasta sivustoa.
Palvelun muuttaminen
Avaa palvelu Palvelut-luettelosta. Sen Asetuksissa ovat komento, aikataulu, image tai haara sekä resurssit; muutokset tallennetaan ja palvelu käynnistyy uudelleen niiden kanssa. Jokaisella palvelulla on myös omat Lokit ja Valvonta.