Problemy

Rozwiązywanie problemów

Strona zawiera listę najczęściej występujących problemów związanych z używaniem mygit oraz sposoby ich rozwiązania.
Problemy zostały podzielone na kategorie: panel webowy, snapshoty, repozytoria oraz problemy środowiskowe.

---

1. Problemy z panelem webowym

Panel nie otwiera się w przeglądarce

Możliwe przyczyny:

• panel nie został uruchomiony,
• port jest zajęty,
• blokada ze strony dodatków przeglądarki.

Rozwiązania:

1. Sprawdź, czy panel został uruchomiony przez mygit (informacja wyświetla się w terminalu).
2. Upewnij się, że adres jest poprawny, zwykle:

   http://localhost:9614
   

3. Jeśli port 9614 jest zajęty, zmień port w konfiguracji lub zamknij aplikację blokującą ten port.
4. Wyłącz dodatki takie jak React DevTools — mogą blokować połączenie WebSocket.

---

Panel działa, ale nie widzi repozytoriów

Możliwe przyczyny:

• brak uprawnień do odczytu katalogów,
• uszkodzony plik metadanych repozytorium,
• błędna lokalizacja bazy danych.

Rozwiązania:

• uruchom mygit z uprawnieniami administratora,
• sprawdź strukturę repo i obecność folderu .mygit,
• odbuduj metadane repozytorium (przez ponowną inicjalizację lub odtworzenie plików JSON).

---

2. Problemy z tworzeniem snapshotów

Snapshot nie może zostać utworzony

Możliwe przyczyny:

• brak miejsca na dysku,
• zbyt duży projekt,
• pliki o ograniczonych uprawnieniach,
• uszkodzone ścieżki.

Rozwiązania:

1. Zwolnij miejsce na dysku.
2. Użyj .mygitignore, aby wykluczyć ciężkie katalogi.
3. Uruchom snapshot z wyższymi uprawnieniami.
4. Sprawdź, czy ścieżki plików nie są zbyt długie.

---

Snapshot tworzy się bardzo wolno

Możliwe przyczyny:

• brak .mygitignore,
• duże katalogi (np. node_modules, dist, .venv),
• praca na wolnym dysku (np. HDD lub dysk sieciowy).

Rozwiązania:

• dodaj .mygitignore i wyklucz niepotrzebne katalogi,
• przenieś repo na szybszy dysk,
• ogranicz liczbę plików tymczasowych w projekcie.

---

W snapshotach pojawiają się pliki, które nie powinny

Możliwe przyczyny:

• błędnie skonfigurowany .mygitignore,
• wpisy w ignore nie są poprawne lub zawierają błędy składni.

Rozwiązania:

• sprawdź wzorce i ich zgodność z .gitignore,
• pamiętaj, że ignorowanie działa od katalogu głównego repo.

---

3. Problemy z komendą GET

GET nadpisuje pliki mimo ustawionych zabezpieczeń

Możliwe przyczyny:

• użycie opcji --force,
• nieprawidłowe rozpoznanie konfliktu,
• lokalne pliki mają starszą datę niż w snapshotcie.

Rozwiązania:

• upewnij się, że używasz właściwych flag (--backup, --skip-conflicts),
• użyj --dry-run, aby sprawdzić potencjalne nadpisania.

---

Snapshot nie może zostać pobrany

Możliwe przyczyny:

• uszkodzony plik ZIP,
• brak uprawnień do zapisu w katalogu docelowym,
• timeout przy pobieraniu z panelu.

Rozwiązania:

• sprawdź integralność pliku ZIP,
• użyj opcji:

  mygit get --output ./folder
  

• zwiększ timeout:

  mygit get --timeout 120
  

---

4. Problemy z repozytoriami

Repozytorium nie zostało rozpoznane

Możliwe przyczyny:

• brak katalogu .mygit,
• uszkodzone pliki metadanych,
• repozytorium przeniesione bez metadanych.

Rozwiązania:

• utwórz repo ponownie:

  mygit init
  

• przywróć pliki .mygit ze snapshotu lub kopii zapasowej,
• nie przenoś repo bez katalogu .mygit.

---

5. Problemy środowiskowe

Brak Pythona lub nieodpowiednia wersja

Rozwiązanie: Zainstaluj Python 3.7+ i sprawdź:

python3 --version

---

Błędy uprawnień

Rozwiązania:

• uruchom komendę z wyższymi uprawnieniami,
• nadaj prawa zapisu katalogowi projektu.

---

mygit nie uruchamia się przez alias

Możliwe przyczyny:

• błędna ścieżka do mygit.py,
• alias nie został dodany do pliku konfiguracyjnego.

Rozwiązania:

• popraw alias:

  alias mygit='python3 /pełna/ścieżka/do/mygit.py'

• dodaj go do .bashrc lub .zshrc.

---

6. Ogólne wskazówki

• zawsze używaj najnowszej wersji mygit,
• sprawdzaj logi wyświetlane w terminalu,
• regularnie porządkuj snapshoty,
• upewnij się, że .mygitignore jest prawidłowo skonfigurowany.

---