Jak skonfigurować Git w Plesku — deployment przez Git bez FTP
Skonfiguruj repozytorium Git w Plesk i deployuj kod bezpośrednio na hosting. Instrukcja krok po kroku dla klientów smartxhosting.pl. Programowanie bez FTP.
Spis treści
- Co będziesz potrzebować
- Zaloguj się do panelu Plesk
- Wybierz domenę w sekcji Witryny i domeny
- Otwórz sekcję Git
- Dodaj nowe repozytorium Git
- Skonfiguruj gałąź i katalog deploymentu
- Zapisz konfigurację i wykonaj deployment
- Weryfikacja deploymentu
- Często zadawane pytania
Konfiguracja Git Plesk pozwala na nowoczesny deployment aplikacji webowych bez konieczności ręcznego przesyłania plików przez FTP. Integracja Plesk z Git umożliwia automatyczne wdrażanie kodu bezpośrednio z repozytoriów GitHub, GitLab, Bitbucket lub własnego serwera Git. W tej instrukcji dowiesz się krok po kroku, jak połączyć swoją domenę w Plesk Obsidian z repozytorium Git, skonfigurować gałąź i katalog deploymentu, a następnie wdrożyć kod za pomocą jednego kliknięcia lub automatycznie przy każdym push do repozytorium.
Co będziesz potrzebować
- Aktywne konto hostingowe w smartxhosting.pl
- Dane do logowania z e-maila powitalnego
- Adres URL repozytorium Git (GitHub, GitLab, Bitbucket lub inne)
- Dane uwierzytelniające do repozytorium (jeśli jest prywatne)
Konfiguracja integracji z Git wymaga zalogowania do panelu Plesk. Upewnij się, że Twój plan hostingowy w smartxhosting.pl obejmuje obsługę Git — funkcja ta jest dostępna po zainstalowaniu rozszerzenia Git w Plesk.
- Otwórz przeglądarkę i przejdź pod adres panelu Plesk.
- Wpisz swoją nazwę użytkownika i hasło.
- Kliknij Zaloguj się.
Integracja Git w Plesk jest konfigurowana na poziomie domeny — każda witryna może mieć swoje własne repozytoria Git z niezależnymi ustawieniami deploymentu.
- W lewym menu panelu Plesk kliknij Witryny i domeny.
- Na liście domen odszukaj witrynę, dla której chcesz skonfigurować Git.
- Kliknij nazwę domeny lub przycisk zarządzania, aby wejść w panel tej witryny.
Sekcja Git w panelu domeny Plesk umożliwia zarządzanie wszystkimi repozytoriami powiązanymi z tą witryną. Możesz tu dodawać wiele repozytoriów, monitorować ich status i uruchamiać deployment.
- W panelu zarządzania domeną odszukaj ikonę lub kafelek Git.
- Kliknij go, aby otworzyć panel zarządzania repozytoriami Git dla tej domeny.
- Na liście repozytoriów widoczna jest nazwa, aktualna gałąź i ścieżka deploymentu każdego repozytorium.
Dodanie repozytorium polega na podaniu adresu URL zdalnego repozytorium (np. z GitHub, GitLab lub Bitbucket) i skonfigurowaniu parametrów połączenia.
- Kliknij przycisk Dodaj repozytorium (ang. Add Repository).
- W polu „Adres URL repozytorium" wpisz adres swojego repozytorium Git:
- GitHub HTTPS:
https://github.com/twojuzytkownik/twojerepo.git - GitLab SSH:
[email protected]:twojuzytkownik/twojerepo.git
- GitHub HTTPS:
- Jeśli repozytorium jest prywatne, wpisz dane uwierzytelniające:
- Login i hasło (lub Personal Access Token zamiast hasła)
- Lub klucz SSH (bardziej bezpieczna opcja)
Wybór odpowiedniej gałęzi (branch) i katalogu deploymentu jest kluczowy dla poprawnego działania procesu wdrożenia. Zazwyczaj deployujesz gałąź produkcyjną (main lub master) do katalogu publicznego witryny.
- W polu „Gałąź" wybierz lub wpisz nazwę gałęzi, z której ma być deployowany kod (np.
main,master,production). - W polu „Katalog docelowy" ustaw ścieżkę, do której mają trafiać pliki z repozytorium:
httpdocs— katalog publiczny witryny (dla stron statycznych, PHP)- Możesz też podać podkatalog, np.
httpdocs/app
- Opcjonalnie: zaznacz opcję automatycznego deploymentu przy każdym pull (konfiguracja webhooka — szczegóły w artykule o automatycznym deploymencie).
Po skonfigurowaniu wszystkich parametrów repozytorium możesz zapisać ustawienia i wykonać pierwsze wdrożenie kodu na serwer.
- Sprawdź wszystkie wprowadzone dane i kliknij OK, aby zapisać konfigurację repozytorium.
- Repozytorium pojawi się na liście w sekcji Git domeny.
- Kliknij przycisk Deploy (ang. Wdróż) przy repozytorium, aby Plesk pobrał kod z repozytorium i skopiował go do skonfigurowanego katalogu deploymentu.
- Poczekaj na zakończenie operacji — czas zależy od rozmiaru repozytorium.
- Sprawdź swoją witrynę w przeglądarce, aby upewnić się, że deployment przebiegł pomyślnie.
Po wykonaniu deploymentu warto zweryfikować, że pliki trafiły do właściwego katalogu i strona działa prawidłowo.
- Przejdź do Menedżera plików dla swojej domeny i sprawdź, czy katalog
httpdocszawiera pliki z repozytorium Git. - Otwórz swoją stronę w przeglądarce i sprawdź, czy wyświetla się poprawnie.
- Sprawdź logi błędów, jeśli strona nie działa prawidłowo.
Często zadawane pytania
Czy Plesk obsługuje prywatne repozytoria Git?
Tak, Plesk obsługuje zarówno publiczne jak i prywatne repozytoria Git. Podczas dodawania repozytorium możesz podać dane uwierzytelniające: login i hasło lub klucz SSH. Dla prywatnych repozytoriów GitHub i GitLab zdecydowanie zalecamy używanie tokenów dostępu Personal Access Token zamiast hasła do konta — tokeny można łatwo odwołać bez zmiany głównego hasła, a ich zakres uprawnień można ograniczyć wyłącznie do odczytu repozytorium. Token generujesz w ustawieniach bezpieczeństwa swojego konta GitHub lub GitLab.
Jak skonfigurować automatyczny deployment?
Automatyczny deployment w Plesk konfiguruje się przez mechanizm webhook. Po skonfigurowaniu repozytorium Git w Plesk skopiuj adres URL webhooka widoczny w ustawieniach repozytorium w panelu Plesk. Następnie w GitHub lub GitLab przejdź do ustawień repozytorium (Settings > Webhooks) i dodaj skopiowany URL jako nowy webhook. Wybierz zdarzenie „push" i zapisz. Od tej chwili każdy push do wybranej gałęzi automatycznie uruchomi deployment kodu w Plesk — bez konieczności ręcznego klikania Deploy.
Jakie repozytoria Git obsługuje Plesk?
Plesk obsługuje wszystkie repozytoria Git dostępne przez protokół HTTP/HTTPS lub SSH. W praktyce możesz korzystać z GitHub (github.com), GitLab (gitlab.com lub własna instalacja self-hosted), Bitbucket (bitbucket.org), Azure DevOps Repos, Gitea oraz dowolnych innych serwisów hostujących repozytoria Git w standardowym protokole. Możesz też używać lokalnego repozytorium Git na swojej stacji roboczej i pushować zmiany bezpośrednio do Plesk, który działa wtedy jak własny serwer Git.
Czy Plesk ma własny serwer Git?
Tak, Plesk może pełnić rolę własnego, prywatnego serwera Git. Możesz dodać lokalne repozytorium w Plesk i używać go jak własnego serwisu hostingu kodu. W tym scenariuszu pushowanie zmian ze swojej lokalnej stacji roboczej bezpośrednio do repozytorium na serwerze Plesk jest traktowane jako transport deploymentu — Plesk automatycznie wdraża kod po każdym push. Ważne: repozytoria Plesk-hosted są chronione hasłem użytkownika FTP Twojej subskrypcji, a dostęp anonimowy nie jest obsługiwany.
Potrzebujesz pomocy z Plesk?
Zespół smartxhosting.pl chętnie pomoże Ci skonfigurować hosting i rozwiązać problemy z panelem Plesk.
Skontaktuj się z nami