Zacznij

Jak uruchomić pierwszą aplikację z GitHuba.

Połącz GitHuba, wybierz repozytorium, zasoby i adres, a po kilku minutach aplikacja działa — pierwsza aplikacja ma 3-dniowy darmowy okres próbny.

4 MIN CZYTANIA

Aplikacje uruchamiają twój własny kod — stronę, API, zadanie w tle — prosto z repozytorium Git. Nie wybierasz serwera ani pakietu hostingowego: wskazujesz repozytorium, my ustalamy, jak je zbudować i uruchomić, a każdy push sam trafia na produkcję.

Wszystko dzieje się w nowym panelu (rivervo.com/panel) → Aplikacje → Nowa aplikacja.

1. Połącz konto Git

GitHub jest dostępny zawsze. Kliknij Połącz z GitHubem: GitHub zapyta, gdzie zainstalować Rivervo (na koncie osobistym czy w organizacji) i które repozytoria może odczytywać. Do twoich repozytoriów nic nie zapisujemy.

Rivervo jest już zainstalowane na GitHubie? Użyj opcji Masz już instalację na GitHubie? Połącz ją.

GitLab i Bitbucket pojawiają się jako dodatkowe przyciski nad listą repozytoriów tam, gdzie są dostępne. Łączenie działa tak samo: zezwalasz Rivervo na odczyt repozytoriów i dodanie webhooka do automatycznych wdrożeń. Twój kod nigdy nie jest zmieniany.

2. Wybierz repozytorium

Wyszukaj repozytorium, kliknij to, które chcesz wdrożyć, a potem wybierz:

  • Gałąź — gałąź, która trafia na produkcję. Każdy push do niej jest wdrażany automatycznie.
  • Folder projektu — tylko dla repozytorium z kilkoma projektami (monorepo), np. apps/web. Zostaw puste, jeśli projekt jest w katalogu głównym.

Kliknij Dalej.

Nie masz jeszcze repozytorium? Albo zacznij od szablonu tworzy na twoim koncie GitHub nowe repozytorium z jednego z naszych szablonów — Next.js, Laravel, Express, Flask albo strona statyczna. Kod należy do ciebie, a zmiany wdrażasz pushem.

3. Co wykrywamy

Odczytujemy repozytorium i ustalamy, jak je zbudować i uruchomić. Nie piszesz żadnej konfiguracji. Rozpoznajemy:

StosCzego szukamy
Node.jsNext.js, Nuxt, SvelteKit, Astro, Express, Fastify, Koa, Hono, NestJS; npm, yarn lub pnpm po pliku lock
PHPLaravel, Symfony, Slim, CodeIgniter lub czyste PHP (8.2–8.4)
PythonDjango, Flask, FastAPI
Gogo.mod w katalogu głównym
Strony statyczneczysty HTML albo build front-endu: Vite (React, Vue, Svelte), Create React App, Angular, Gatsby, Docusaurus, VitePress, statyczny eksport Next.js lub Nuxt

Jeśli repozytorium ma własny Dockerfile, budujemy z niego bez zmian — to także sposób na uruchomienie stosu, którego nie ma na liście.

Wykryte polecenia instalacji, budowania i uruchomienia możesz później zmienić w Ustawienia → Ustawienia budowania. Wskazówki dla poszczególnych stosów: Laravel, Node.js, Next.js i Nuxt, Python, strony statyczne.

4. Zasoby i cena

Trzema suwakami wybierz tyle, ile potrzebuje aplikacja:

ZasóbCenaZakres
Pamięć RAM29,53 zł za GB miesięcznie256 MB, 512 MB, potem pełne GB do 16 GB
CPU19,69 zł za rdzeń miesięcznieod 1 do 8 rdzeni
Dysk10 GB w cenie na każdy GB pamięci, potem 0,74 zł za GB miesięcznieod 5 do 500 GB, co 5 GB

Kilka przykładów:

PamięćCPUDyskMiesięcznie
512 MB1 rdzeń5 GB34,45 zł
1 GB1 rdzeń10 GB49,22 zł
2 GB2 rdzenie20 GB98,45 zł
4 GB2 rdzenie60 GB172,29 zł

Podczas przesuwania suwaków panel pokazuje sumę miesięczną. Zasoby możesz zmienić w każdej chwili; aplikacja zachowuje swoje dane. Każda aplikacja ma też w cenie 500 GB transferu miesięcznie na projekt — zobacz Rozliczenia aplikacji.

5. Adres

Wybierz, jak aplikacja ma być dostępna — nic nie jest zaznaczone z góry:

  • Adres publiczny — dostęp z internetu pod darmowym adresem z HTTPS, https://<name>.rivervo.app. Po uruchomieniu możesz podłączyć własną domenę — zobacz Własne domeny.
  • Tylko wewnętrzna — bez adresu w internecie; z aplikacją łączą się tylko inne usługi aplikacji. Dobre dla API albo backendu, który wywołuje inna usługa aplikacji — zobacz Komunikacja między usługami.

Wybierz nazwę (małe litery łacińskie, cyfry i myślniki, od 3 do 42 znaków); panel od razu powie, czy jest wolna. Później możesz przełączać się między tymi opcjami w Ustawienia → Adres publiczny.

6. Uruchomienie i darmowy okres próbny

Kliknij Uruchom i dodaj kartę. Twoja pierwsza aplikacja ma 3-dniowy darmowy okres próbny: przez te 3 dni nie pobieramy opłat z karty, a pierwszą płatność pobieramy po zakończeniu okresu próbnego. Potem aplikacja jest rozliczana co miesiąc według pokazanej ceny.

Okres próbny przysługuje raz na konto — dla pierwszej uruchomionej aplikacji.

7. Pierwsze wdrożenie

Po uruchomieniu panel na bieżąco pokazuje każdy krok: pobieranie kodu, kontrolę bezpieczeństwa, budowanie, uruchamianie i włączanie adresu. Zwykle trwa to kilka minut. Przed każdym wydaniem sprawdzamy kod pod kątem ukrytego złośliwego kodu; projekt, który go zawiera, nie zostanie zbudowany ani uruchomiony.

Po zakończeniu wdrożenia przycisk Otwórz przeniesie cię do działającej aplikacji (jeśli ma adres publiczny).

Jeśli uruchomienie się nie zakończy, panel pokaże krok i log. Usuń przyczynę w kodzie lub w Zmiennych i kliknij Spróbuj ponownie — nic więcej nie pobieramy. Wyjaśnij ten błąd krótko objaśni log i podpowie, jak to naprawić (zobacz Narzędzia dla programistów).

Co dalej

Nadal masz pytania?

Napisz do nas na czacie — AI odpowiada od razu, a inżynier dołącza, gdy trzeba, o każdej porze.

Kontakt z pomocą techniczną