Użyj GitHub Desktop, aby uprościć aktualizacje FiveM i dostrzec każdą zmianę

Wprowadzenie

Każdy właściciel serwera zna to uczucie. Pojawia się nowa wersja zasobu, changelog mówi: "podmień folder /config/framework", a Ty zamierasz — ponieważ spędziłeś godziny na dostrajaniu tych plików i nie masz pojęcia, czego tak naprawdę dotyczy aktualizacja. Czy nadpiszesz je i stracisz swoją pracę? Pominiesz folder i zaryzykujesz uszkodzenie skryptu? Będziesz kopiować linie w jedną i drugą stronę ręcznie, mając nadzieję, że o niczym nie zapomniałeś?

Istnieje znacznie lepszy sposób — i nie musisz wpisywać ani jednej komendy. Dzięki darmowej aplikacji GitHub Desktop, możesz dokładnie zobaczyć, co zmieniło się w dowolnej aktualizacji, zachować swoje własne modyfikacje w bezpieczeństwie oraz wrócić do poprzedniej wersji w kilka sekund, a wszystko to za pomocą prostego interfejsu typu kliknij i użyj.

Co to jest Git i czym jest GitHub Desktop?

Git to system kontroli wersji — pomyśl o tym jak o nieograniczonej, idealnej historii wycofywania zmian dla folderu. Za każdym razem, gdy zapiszesz migawkę (nazywaną commit), rejestrowany jest dokładny stan każdego pliku. Później możesz porównać dowolne dwie migawki linia po linii, przywrócić wcześniejszy stan lub połączyć zmiany ze sobą.

GitHub Desktop to darmowa, wizualna aplikacja, która ukrywa Git pod przyjaznymi przyciskami. Żadnego czarnego terminala, żadnych komend do zapamiętania — tylko przejrzyste okno, które pokazuje, co uległo zmianie, i pozwala na commit, wycofanie zmian oraz scalanie za pomocą jednego kliknięcia.

Dla serwera FiveM, folder, który śledzisz, to Twój katalog resources (lub pojedynczy skrypt wewnątrz niego). Git zamienia "Myślę, że coś tu zmieniłem kilka tygodni temu" w "pokaż mi dokładnie, co zmieniło się między zeszłym miesiącem a dzisiaj."

Dlaczego jest to idealne do aktualizacji zasobów

Aktualizacja skryptu w tradycyjny sposób oznacza pracę po omacku. Git daje Ci trzy supermoce:

1. Wykrywanie zmian — po wrzuceniu nowej wersji GitHub Desktop wyróżnia każdy zmieniony plik i każdą zmienioną linię. Changelog mówi Ci, które foldery należy zastąpić; Git pokazuje Ci, co faktycznie się zmieniło, dzięki czemu możesz mu zaufać.
2. Bezpieczna personalizacja — Twoje edycje są zapisane w commitach. Gdy aktualizacja od dostawcy dotyczy tego samego pliku, Git może scalić oba zestawy zmian, zachowując Twoje oraz ich.
3. Błyskawiczne wycofanie zmian — jeśli aktualizacja zepsuje Twój serwer, dzieli Cię tylko jedno kliknięcie od dokładnego stanu, który miałeś pięć minut temu. Bez paniki typu "gdzie ja położyłem ten backup".

Jednorazowa konfiguracja z GitHub Desktop

Robisz to tylko raz na serwer.

# Never track secrets
**/*.env
**/secrets.lua
server.cfg

# Caches, logs, build output
**/cache/
**/logs/
**/.DS_Store

Przepływ pracy przy aktualizacji

To rutyna, którą powtarzasz przy każdej aktualizacji. Zajmuje to około minuty.

Cofanie zmian, gdy coś nie działa

Aktualizacja sprawia problemy? Zachowaj spokój — GitHub Desktop daje Ci kilka opcji, od łagodnych po radykalne.

Cofnij niezatwierdzone zmiany. W karcie Changes zaznacz pliki (lub wszystkie), kliknij prawym przyciskiem myszy i wybierz Discard Changes / Discard All Changes. To przywróci je do stanu z Twojego ostatniego zatwierdzenia.

Wróć do wcześniejszej migawki. Otwórz kartę History (historia) w lewym pasku bocznym, aby zobaczyć każdą wykonaną przez Ciebie migawkę:

• Aby bezpiecznie cofnąć aktualizację, zachowując czystą historię, kliknij prawym przyciskiem myszy na błędny commit i wybierz Revert Changes in Commit. Tworzy to nowy commit typu „cofnij” — nic nie zostaje utracone.
• Aby w pełni cofnąć się do wcześniejszego stanu, kliknij prawym przyciskiem myszy na wybraną migawkę i wybierz Reset to commit.

Tymczasowo odłóż swoje zmiany — przydatne do testowania aktualizacji na czystym polu, a następnie przywrócenia swojej pracy. Kliknij prawym przyciskiem myszy na nagłówek Changed files i wybierz Stash All Changes. Aby je odzyskać, wybierz Stashed Changes w pasku bocznym i kliknij Restore.

Pro Tip: Automatyczne łączenie aktualizacji dostawców

Masz dość ręcznego ponownego nakładania edycji konfiguracji po każdej aktualizacji? GitHub Desktop może zrobić to za Ciebie, korzystając z trójstronnego scalania (three-way merge).

Idea: zachowaj jedną gałąź z czystymi wydaniami dostawców, a drugą z Twoimi edycjami na górze.

Jest to ta sama technika, której profesjonalne zespoły używają do śledzenia bibliotek upstream bez utraty lokalnych zmian — i działa równie dobrze w przypadku Twojego serwera.

Wolisz linię poleceń?

Jeśli czujesz się swobodnie w terminalu, cały powyższy proces można przełożyć na kilka poleceń:

# One-time setup (run inside your resources folder)
git init
git add .
git commit -m "Baseline: working server before updates"

# Each update
git add . && git commit -m "Pre-update snapshot"   # snapshot first
# ...drop in the new release, overwriting files...
git status            # which files changed
git diff --stat       # a compact per-file summary
git diff              # full line-by-line changes
git add . && git commit -m "Update sky_base to 1.21.0"

# Rolling back
git restore <file>    # undo changes to one file
git restore .         # undo all uncommitted changes
git log --oneline     # find a snapshot
git reset --hard <id> # rewind to it (destructive)
git stash / git stash pop   # shelve and restore temporarily

Dobre praktyki

• Zatwierdzaj zmiany przed każdą aktualizacją. Migawka zajmuje dwie sekundy, a oszczędza godziny pracy.
• Pisz jasne podsumowania. Update sky_base to 1.21.0 wygrywa z stuff, gdy przeglądasz historię pół roku później.
• Ignoruj poufne dane. Dane uwierzytelniające nigdy nie powinny znajdować się w historii wersji.
• Zatwierdzaj zmiany po czystym uruchomieniem, a nie przed nim. Oznaczaj migawkę jako „dobrą” dopiero wtedy, gdy serwer faktycznie działa.
• Śledź cały swój folder resources w jednym repozytorium. W ten sposób pojedynczy rollback może przywrócić stan po błędnej aktualizacji dowolnego skryptu.
• Trzymaj pliki lokalnie. Nigdy nie publikuj zasobów objętych licencją lub ochroną escrow w publicznym repozytorium.

Podsumowanie

Aktualizacja serwera FiveM nie musi już oznaczać zgadywania, utraconych personalizacji i gorączkowego szukania kopii zapasowych. Dzięki jednorazowej konfiguracji w GitHub Desktop i minutowej rutynie możesz widzieć każdą zmianę wprowadzaną przez aktualizację, zachować własne edycje w nienaruszonym stanie oraz natychmiast cofnąć każdy błąd — wszystko to bez wpisywania ani jednej komendy.

Następnym razem, gdy w changelogu zobaczysz instrukcję zastąpienia folderu, zrobisz to z pewnością — ponieważ GitHub Desktop za każdym razem pokaże Ci dokładnie, co uległo zmianie.