Railway krok po kroku: aplikacja z GitHuba, baza danych i publiczny adres
Samouczek Railway: projekt z repozytorium, budowanie, baza danych jednym kliknięciem, zmienne i odwołania, publiczny adres i wdrożenia po każdej zmianie.
👁 121 przeczytań
- Railway wdraża aplikację z repozytorium GitHub automatycznie: wystarczy wskazać projekt, a platforma sama rozpoznaje język i buduje aplikację bez dodatkowej konfiguracji.
- Bazę danych PostgreSQL dodaje się jednym kliknięciem przycisku '+ New' na planszy projektu, a zmienne połączenia można podpiąć przez odwołanie, nie kopiując ich ręcznie.
- Publiczny adres nie pojawia się domyślnie po wdrożeniu - trzeba wejść w ustawienia usługi, sekcję sieci, i kliknąć 'Generate Domain', by aplikacja była dostępna z internetu.
Railway stawia aplikację z repozytorium na GitHubie w kilka minut: wskazujesz projekt, Railway sam go buduje i uruchamia, a bazę danych dokładasz jednym kliknięciem. Ten samouczek prowadzi od pustego konta do działającej aplikacji z bazą i publicznym adresem, według oficjalnego przewodnika Railway.
Zanim zaczniesz: sprawdź projekt lokalnie
Railway zbuduje aplikację tak, jak jest w repozytorium, więc większość problemów przy pierwszym wdrożeniu da się wyłapać wcześniej. Upewnij się, że aplikacja uruchamia się lokalnie z czystego klonu repozytorium, bez plików, które masz tylko u siebie. Spisz wszystkie zmienne środowiskowe, których potrzebuje, bo każdą trzeba będzie dodać w Railway. Sprawdź, na jakim porcie aplikacja nasłuchuje i czy odczytuje go ze zmiennej, a nie ma wpisanego na sztywno.
Pliki z sekretami, na przykład lokalny plik ze zmiennymi, nie powinny trafić do repozytorium.
Krok 1. Nowy projekt z repozytorium
W panelu klikasz New Project i wybierasz wdrożenie z repozytorium GitHuba. Railway wymaga połączonego konta GitHub, a jeśli go jeszcze nie połączyłeś, poprosi o to. Potem wyszukujesz swój projekt i wybierasz go z listy.
Masz dwie opcje: Deploy Now uruchamia budowanie od razu, a Add variables pozwala najpierw ustawić zmienne środowiskowe. Jeśli aplikacja potrzebuje bazy danych albo kluczy, wybierz drugą opcję.
Krok 2. Jak Railway buduje aplikację
Railway sam rozpoznaje, jak zbudować projekt. Jeśli w repozytorium jest Dockerfile, użyje go, a w przeciwnym razie dobierze sposób budowania na podstawie języka i plików projektu. Na tym etapie najważniejsze są logi budowania i wdrożenia.
Dokumentacja daje tu cenną radę: czytaj cały log, bo prawdziwy błąd rzadko jest w ostatniej linijce. Najczęściej chodzi o brakującą zmienną środowiskową albo inną wersję języka niż ta, której używasz lokalnie.
Krok 3. Baza danych
Bazę PostgreSQL dodajesz przyciskiem + New na planszy projektu, wybierając bazę danych i PostgreSQL. Railway tworzy ją jako osobną usługę i udostępnia zmienne z danymi połączenia, w tym adres bazy.
Krok 4. Zmienne i odwołania
W ustawieniach usługi aplikacji dodajesz zmienne. Zamiast kopiować adres bazy, ustawiasz odwołanie do zmiennej bazy danych, na przykład do jej adresu połączenia. Dzięki temu, gdy dane bazy się zmienią, aplikacja dostanie nowe automatycznie. Tam dodajesz też klucze do usług zewnętrznych i ustawienia środowiska produkcyjnego.
Krok 5. Publiczny adres
To krok, który zaskakuje wiele osób: po wdrożeniu aplikacja domyślnie nie jest dostępna z internetu. Wchodzisz w ustawienia usługi, sekcję sieci, i klikasz Generate Domain. Dostajesz publiczny adres, pod którym aplikacja działa. Własną domenę możesz podpiąć w tym samym miejscu.
Krok 6. Wdrożenia po każdej zmianie
Od tej chwili każda zmiana wypchnięta do repozytorium uruchamia nowe wdrożenie. Nie logujesz się na żaden serwer, a historia wdrożeń pozwala wrócić do poprzedniej wersji, gdy coś pójdzie nie tak.
Wiersz poleceń
Railway ma też narzędzie wiersza poleceń. Polecenie railway up wysyła pliki aplikacji prosto z komputera, bez repozytorium, a osobne polecenia dodają bazę danych czy generują domenę. Przydaje się przy szybkich testach i skryptach.
Przykład: bot na Discordzie z bazą
Masz bota na Discordzie, który zapisuje punkty użytkowników. Repozytorium leży na GitHubie. W Railway tworzysz projekt z repozytorium, wybierasz dodanie zmiennych, wpisujesz token bota, dodajesz bazę PostgreSQL i ustawiasz odwołanie do jej adresu. Bot działa całą dobę, a każda poprawka wypchnięta na GitHuba trafia na serwer sama.
Po takim wdrożeniu warto od razu zrobić jedną rzecz: wypchnąć drobną zmianę i sprawdzić, czy bot zaktualizował się sam. To potwierdza, że automatyczne wdrożenia działają, zanim będą naprawdę potrzebne. Warto też zajrzeć do bazy po kilku dniach działania i upewnić się, że punkty użytkowników się zapisują, a po ponownym wdrożeniu nie znikają.
Najczęstsze błędy
- Brak publicznego adresu i przekonanie, że aplikacja nie działa.
- Klucze w kodzie zamiast w zmiennych środowiskowych.
- Czytanie tylko końca logu.
- Adres bazy wklejony na sztywno zamiast odwołania do zmiennej.
Jak ocenić pierwsze wdrożenie
Po wdrożeniu otwórz wygenerowany adres i przetestuj najważniejsze funkcje, a nie tylko stronę główną. Sprawdź, czy aplikacja zapisuje dane w bazie i czy po ponownym wdrożeniu one zostają. Przejrzyj logi z pierwszej godziny działania: ostrzeżenia, które lokalnie ignorowałeś, na serwerze bywają pierwszym sygnałem problemu. Na koniec wypchnij drobną zmianę i sprawdź, czy nowe wdrożenie uruchomiło się samo.
Gdy pierwsza aplikacja działa, kolejne wdrażasz tak samo: projekt z repozytorium, zmienne, ewentualnie baza i domena. Po drugim projekcie cała procedura zajmuje kilka minut, a na planszy projektu widzisz wszystkie usługi i połączenia między nimi w jednym miejscu.
Kod do planu Railway Hobby na 12 miesięcy sprzedaję w sklepie kinetyka.pl.
Cały tydzień w AI, w jednym mailu
Wybrane premiery, narzędzia i analizy. Raz w tygodniu, prosto do skrzynki.
Zapisz się za darmo →Najczęstsze pytania
Jak wdrożyć aplikację z GitHuba na Railway krok po kroku?
W panelu klikasz 'New Project', wybierasz wdrożenie z repozytorium GitHub i wskazujesz projekt z listy. Masz dwie opcje: 'Deploy Now' uruchamia budowanie od razu, a 'Add variables' pozwala najpierw ustawić zmienne środowiskowe, co jest zalecane, gdy aplikacja potrzebuje bazy danych lub kluczy API.
Jak dodać bazę danych PostgreSQL w Railway?
Bazę PostgreSQL dodajesz przyciskiem '+ New' na planszy projektu, wybierając opcję 'Database', a następnie 'PostgreSQL'. Railway tworzy ją jako osobną usługę i automatycznie udostępnia zmienne z danymi połączenia, w tym adres bazy.
Dlaczego moja aplikacja na Railway nie jest dostępna z internetu po wdrożeniu?
Po wdrożeniu aplikacja domyślnie nie ma publicznego adresu - to częsty błąd, przez który użytkownicy myślą, że coś nie działa. Trzeba wejść w ustawienia usługi, sekcję sieci, i kliknąć 'Generate Domain', by wygenerować publiczny adres.
Jak Railway buduje aplikację i gdzie szukać błędów wdrożenia?
Railway sam rozpoznaje sposób budowania: jeśli w repozytorium jest Dockerfile, używa go, w przeciwnym razie dobiera metodę na podstawie języka i plików projektu. Błędów należy szukać w logach budowania i wdrożenia, czytając cały log, bo prawdziwy błąd rzadko pojawia się w ostatniej linijce.
Podobne tematy na Promptowym
