7

Rozdział 7 z 11

Dostęp serwera do kodu — SSH Deploy Key

Opublikowany

Dla prywatnego repo: generujemy klucz na serwerze, dodajemy go jako Deploy Key w GitHubie i uruchamiamy provisioning. Repo publiczne? Rozdział pomijasz.

Czego się nauczysz

  • Czym jest Deploy Key
  • Klucz na serwerze (VPS → GitHub)
  • Konfiguracja ~/.ssh/config + known_hosts
  • Klon przez SSH i uruchomienie skryptu

Rozdział 7: Dostęp serwera do kodu — SSH Deploy Key

Jeśli Twoje repozytorium jest prywatne (jak FactoryCode), serwer nie pobierze z niego kodu bez uprawnień. Damy mu tylko do odczytu dostęp przez tzw. Deploy Key. Na końcu rozdziału uruchomimy provisioning z Rozdziału 6. Czynności 🔁 jednorazowe, 🖥️ na serwerze i 🐙 w GitHubie.

Repo publiczne? Ten rozdział pomiń — uruchom setup-vps.sh ścieżką A z Rozdziału 6 i przejdź do Rozdziału 8.

Po tym rozdziale serwer potrafi klonować i pobierać Twoje prywatne repo, a aplikacja jest już sklonowana i wyposażona (Docker/Nginx/SSL).


Czym jest Deploy Key (prostym językiem)

Deploy Key to klucz SSH dodany do jednego repozytorium na GitHubie, dający (domyślnie) dostęp tylko do odczytu. Idealny dla serwera, który ma tylko pobierać kod — nie może nic wypchnąć ani sięgnąć do innych repo.

⚠️ To druga, osobna para kluczy (<KLUCZ_VPS_GH>), różna od <KLUCZ_LOKALNY> z Rozdziału 2:

  • <KLUCZ_LOKALNY> — logowanie komputer/GitHub Actions → serwer,
  • <KLUCZ_VPS_GH> — logowanie serwer → GitHub (pobieranie repo). Ten robimy teraz.

Faza A — wygeneruj klucz na serwerze 🖥️

Co robisz: instalujesz git i tworzysz na serwerze parę kluczy dla GitHuba. Dlaczego: klucz musi powstać tam, gdzie będzie używany (na serwerze), a jego prywatna część nigdy stamtąd nie wyjdzie.

# 🖥️ na serwerze (zalogowany: ssh -i ~/.ssh/<KLUCZ_LOKALNY> root@<VPS_IP>)
apt-get update && apt-get install -y git
ssh-keygen -t ed25519 -f /root/.ssh/github_deploy -N "" -C "vps-deploy"
cat /root/.ssh/github_deploy.pub

Ostatnia komenda wypisze publiczny klucz (jedna linia ssh-ed25519 AAAA...). Zaznacz i skopiuj tę linię.

🎯 Dla FactoryCode <KLUCZ_VPS_GH> = /root/.ssh/github_deploy.

Oczekiwany rezultat: w terminalu widzisz publiczny klucz zaczynający się od ssh-ed25519.


Faza B — dodaj klucz w GitHubie 🐙

Co robisz: wklejasz publiczny klucz jako Deploy Key repozytorium. Dlaczego: dopiero wtedy GitHub wpuści serwer do tego repo (tylko odczyt).

  1. Wejdź na: https://github.com/<REPO>/settings/keys
  2. Kliknij „Add deploy key".
  3. Title: np. vps-deploy.
  4. Key: wklej skopiowaną linię (ssh-ed25519 ...).
  5. ⚠️ NIE zaznaczaj „Allow write access" (serwer ma tylko czytać).
  6. Kliknij „Add key".

GitHub może poprosić o potwierdzenie tożsamości („Confirm access" / sudo mode) — to normalny krok bezpieczeństwa. Potwierdź (np. „Verify via email"), potem dokończ dodawanie klucza.

Oczekiwany rezultat: na liście „Deploy keys" repo widać Twój klucz.


Faza C — połącz serwer z GitHubem i pobierz kod 🖥️

Co robisz: mówisz gitowi na serwerze, by do github.com używał tego klucza, ufasz hostowi GitHuba, testujesz i klonujesz.

# 🖥️ na serwerze
printf 'Host github.com\n  IdentityFile ~/.ssh/github_deploy\n  IdentitiesOnly yes\n' >> /root/.ssh/config
chmod 600 /root/.ssh/config
ssh-keyscan github.com >> /root/.ssh/known_hosts 2>/dev/null
ssh -T git@github.com

Co robią te linie:

  • ~/.ssh/config — kieruje połączenia do github.com na klucz github_deploy,
  • ssh-keyscan — zapisuje „odcisk" GitHuba jako zaufany (żeby git nie pytał interaktywnie podczas automatycznych deployów),
  • ssh -T git@github.com — test połączenia.

Oczekiwany rezultat testu:

Hi <REPO>! You've successfully authenticated, but GitHub does not provide shell access.

To sukces (fragment „does not provide shell access" jest OK — Deploy Key nie daje powłoki, tylko dostęp do repo).

Teraz sklonuj kod i uruchom provisioning z Rozdziału 6:

# 🖥️ na serwerze
git clone <REPO_SSH> <APP_DIR>
bash <APP_DIR>/docker/setup-vps.sh <DOMENA> <EMAIL>

🎯 Dla FactoryCode:

git clone git@github.com:sidczak/factorycode-sf.git /var/www/factorycode
bash /var/www/factorycode/docker/setup-vps.sh factorycode.pl you@example.com

To uruchomi instalację Dockera/Nginx/SSL (3–6 min). Czekaj na === GOTOWE ===.

Wskazówka: uruchom to w tmux (patrz Rozdział 6), by długa instalacja przeżyła ewentualne rozłączenie SSH.


Jak to współgra z automatycznym deployem

Ponieważ sklonowaliśmy repo adresem SSH (git@github.com:...), późniejsze git pull na serwerze (wykonywane przez automat w Rozdziale 8) też użyje tego Deploy Key. Czyli: raz skonfigurowany klucz obsługuje i pierwsze klonowanie, i wszystkie kolejne aktualizacje kodu. 🧩


Weryfikacja rozdziału

  • ssh -T git@github.com 🖥️ zwraca „successfully authenticated".
  • <APP_DIR> 🖥️ zawiera sklonowany kod (ls <APP_DIR>).
  • Skrypt provisioningu zakończył się === GOTOWE ===.
  • https://<DOMENA> 💻 ma ważny SSL (błąd 502 wciąż OK — aplikacja wstanie w Rozdziale 9).

Częste problemy

Objaw Przyczyna Rozwiązanie
git@github.com: Permission denied (publickey) klucz nie dodany jako Deploy Key / zła konfiguracja sprawdź, czy publiczny <KLUCZ_VPS_GH>.pub jest w Deploy keys repo; sprawdź ~/.ssh/config
Host key verification failed brak GitHuba w known_hosts wykonaj ssh-keyscan github.com >> /root/.ssh/known_hosts
could not read Username przy git clone klonujesz adresem HTTPS zamiast SSH użyj git clone <REPO_SSH> (git@github.com:...)
połączenie SSH do serwera pada w trakcie długa instalacja + niestabilne łącze użyj tmux; po powrocie tmux attach -t deploy

Podsumowanie

  • ✅ Rozumiesz, czym jest Deploy Key (dostęp read-only do jednego repo).
  • ✅ Serwer ma własny klucz (<KLUCZ_VPS_GH>) dodany w GitHubie i potrafi pobierać kod.
  • ✅ Kod jest sklonowany w <APP_DIR>, a provisioning wykonany (Docker/Nginx/SSL).
  • ✅ Wiesz, że ten sam klucz obsłuży przyszłe git pull w automatycznym deployu.

Infrastruktura gotowa. Teraz napiszemy drugi automat — Deploy — i połączymy GitHub z serwerem sekretami.

Dalej: Rozdział 8: Workflow Deploy, sekrety i zmienne środowiskowe.

Narzędzia / paczki

SSH Deploy Key ssh-keygen ssh-keyscan

Spis treści