7

Rozdział 7 z 11

Git i prywatne repozytorium na GitHubie

Opublikowany

Zamieniamy vault w repozytorium Git z historią każdej zmiany i wysyłamy go do prywatnego repozytorium na GitHubie. Pokazujemy też, na co patrzeć na ekranie autoryzacji GitHub CLI.

Czego się nauczysz

  • Dlaczego Git, a nie iCloud
  • .gitignore i sprawdzenie sekretów
  • Repozytorium lokalne
  • gh auth login i ekran autoryzacji
  • Prywatne repo: gh repo create --private

Rozdział 7: Git i prywatne repozytorium na GitHubie

Twój „drugi mózg” istnieje na razie tylko na jednym dysku. W tym rozdziale robimy z niego repozytorium Git (historia każdej zmiany) i wysyłamy do prywatnego repozytorium na GitHubie (kopia w chmurze, a w Rozdziale 9 źródło dla serwera).

Po tym rozdziale vault ma pełną historię zmian i prywatną kopię na GitHubie, widoczną tylko dla Ciebie.


Dlaczego Git, a nie iCloud czy Dropbox?

Git + GitHub iCloud / Dropbox
historia każdej zmiany; każdą da się cofnąć zwykle tylko ostatnia wersja pliku
widać, co zmienił agent AI (commit wiki: …) nie wiadomo, kto co zmienił
serwer może pobrać vault jedną komendą (Rozdział 9) trudny dostęp z serwera Linux
darmowe prywatne repozytoria ograniczona przestrzeń

Krok 1 — Plik .gitignore 💻

Niektóre pliki Obsidiana zmieniają się przy każdym kliknięciu (np. które notatki masz otwarte). Nie ma sensu ich wersjonować. Utwórz w głównym folderze vaulta plik .gitignore:

.DS_Store
.trash/
.obsidian/workspace*.json
.obsidian/cache

Reszta folderu .obsidian/ (ustawienia, wtyczki) trafia do repo. To dobrze: na innym komputerze vault otworzy się z tą samą konfiguracją.


Krok 2 — Sprawdź, czy nie ma sekretów 💻

Zanim cokolwiek wyślesz w świat, nawet do prywatnego repo, przeszukaj vault pod kątem haseł i kluczy:

cd ~/Projekty/moja-baza
grep -rniE "(api[_-]?key|secret|token|password|hasło)\s*[:=]" --include="*.md" . | head -20

Przejrzyj wyniki. Wartości przykładowe (np. change_to_a_strong_password w dokumentacji) są w porządku. Prawdziwe hasła usuń z notatek, zanim przejdziesz dalej.

Uwaga na kopie dokumentacji: README projektów często zawierają testowe dane logowania do środowiska developerskiego. Leżą już w repozytorium projektu, więc w prywatnym repo vaulta nic nowego nie wyciekają. Prawdziwych danych produkcyjnych w README być nie powinno.


Krok 3 — Repozytorium lokalne 💻

cd ~/Projekty/moja-baza
git init -b main
git add -A
git commit -m "Initial vault structure"
git log --oneline

Oczekiwany rezultat: git log pokazuje jeden commit.

Puste foldery: Git nie zapisuje pustych katalogów. Żeby 03-Private czy 04-Wiki/analyses przetrwały klonowanie na inny komputer, wrzuć do nich pusty plik: touch 04-Wiki/analyses/.gitkeep. Obsidian go nie pokazuje.

Od teraz agent z Rozdziału 6 będzie robił commit po każdej operacji na wiki, z opisem wiki: <operacja> | <tytuł>.


Krok 4 — Logowanie do GitHuba w terminalu 💻

Repozytorium na GitHubie założymy narzędziem GitHub CLI (gh). Jeśli go nie masz:

brew install gh

Zaloguj się:

gh auth login

Kreator zadaje kilka pytań. Odpowiadasz strzałkami i Enterem:

Pytanie Odpowiedź
Where do you use GitHub? GitHub.com
What is your preferred protocol for Git operations? HTTPS
Authenticate Git with your GitHub credentials? Yes
How would you like to authenticate GitHub CLI? Login with a web browser

Terminal pokaże jednorazowy kod (np. ABCD-1234). Skopiuj go, naciśnij Enter, a w przeglądarce wklej kod.

Ekran „Authorize GitHub CLI” 📱

GitHub pokaże, o jakie uprawnienia prosi aplikacja. Sprawdź dwie rzeczy:

  • aplikacja to GitHub CLI by GitHub (oficjalne narzędzie) i prosi o dostęp do Twojego konta;
  • w żółtej ramce jest lokalizacja i godzina prośby. Lokalizacja jest przybliżona (wg Twojego dostawcy internetu), a godzina powinna się zgadzać z chwilą, gdy wpisałeś gh auth login.

Uprawnienia do repozytoriów, także prywatnych, są potrzebne, żeby założyć prywatne repo i do niego wysyłać. Jeśli wszystko się zgadza, kliknij Authorize github.

🔒 Bezpieczeństwo: jeśli lokalizacja lub godzina zupełnie się nie zgadzają, kliknij Cancel. Ktoś mógł podesłać Ci kod logowania do swojego urządzenia.

Po chwili zobaczysz „Congratulations, you're all set!”, a w terminalu:

✓ Logged in as TWOJ_LOGIN

Sprawdzenie w dowolnym momencie:

gh auth status

Krok 5 — Prywatne repozytorium i wysyłka 💻

Jedna komenda zakłada prywatne repo, podłącza je jako origin i wysyła cały vault:

gh repo create TWOJ_LOGIN/moja-baza --private --description "Drugi mózg – vault Obsidian (LLM Wiki)" --source=. --remote=origin --push
Flaga Działanie
--private repo widzisz tylko Ty
--source=. używa bieżącego folderu (vaulta)
--remote=origin podłącza GitHuba jako zdalne repo
--push od razu wysyła wszystkie commity

Sprawdzenie:

gh repo view TWOJ_LOGIN/moja-baza --json visibility,url
git status -sb

Oczekiwany rezultat: "visibility":"PRIVATE", a git status pokazuje ## main...origin/main (bez „ahead”, czyli wszystko wysłane).

Możesz też wejść na stronę repozytorium na GitHubie i zobaczyć swoje notatki. Pliki .md GitHub wyświetla ładnie sformatowane.


Weryfikacja rozdziału

  • .gitignore wyklucza pliki workspace Obsidiana.
  • Przeszukałeś vault pod kątem sekretów.
  • git log pokazuje commity.
  • gh auth status pokazuje zalogowane konto.
  • Repo na GitHubie jest PRIVATE i zawiera vault.

Częste problemy

Objaw Co zrobić
You are not logged into any GitHub hosts uruchom gh auth login (krok 4)
gh repo create zgłasza, że repo już istnieje wybierz inną nazwę albo podłącz istniejące: git remote add origin https://github.com/TWOJ_LOGIN/moja-baza.git i git push -u origin main
Git pyta o hasło przy git push uruchom gh auth setup-git, żeby Git korzystał z logowania gh
Kod logowania wygasł uruchom gh auth login ponownie; dostaniesz nowy kod

Podsumowanie

  • ✅ Vault jest repozytorium Git z historią każdej zmiany.
  • ✅ Przed wysyłką sprawdziłeś, czy nie ma sekretów.
  • ✅ Zalogowałeś się do GitHuba przez gh i wiesz, na co patrzeć na ekranie autoryzacji.
  • ✅ Vault ma prywatną kopię na GitHubie.

Po tym rozdziale masz kopię w chmurze, ale wysyłasz ją ręcznie. W następnym rozdziale wtyczka Obsidian Git zrobi to za Ciebie automatycznie.

Dalej: Rozdział 8 — Wtyczka Obsidian Git: automatyczna synchronizacja.

Narzędzia / paczki

git GitHub CLI (gh) GitHub

Spis treści