Centrum Pomocy
› Panel Plesk
› Jak skonfigurować deployment przez Git w Plesku
Automatyczny deployment Git Plesk przez webhook to eleganckie rozwiązanie CI/CD, które eliminuje konieczność ręcznego wdrażania kodu po każdej zmianie. Po konfiguracji webhooka każdy push do repozytorium GitHub, GitLab lub Bitbucket automatycznie uruchamia deployment na serwerze Plesk — bez dodatkowych narzędzi, serwerów CI ani ręcznych kroków. W tej instrukcji przeprowadzę Cię przez cały proces: od skopiowania URL webhooka z Plesk Obsidian, przez konfigurację w GitHub lub GitLab, aż po pierwsze testowe wdrożenie automatyczne.
Wymagania: Aktywne konto hostingowe w smartxhosting.pl; Dane do logowania z e-maila powitalnego; Skonfigurowane repozytorium Git w Plesk (patrz: artykuł „Jak skonfigurować Git w Plesku"); Konto GitHub, GitLab lub Bitbucket z uprawnieniami do zarządzania webhookami w repozytorium.
Webhook URL dla automatycznego deploymentu jest generowany indywidualnie dla każdego repozytorium skonfigurowanego w Plesk. Znajdziesz go w ustawieniach konkretnego repozytorium.
- Otwórz przeglądarkę i zaloguj się do panelu Plesk danymi z e-maila powitalnego od smartxhosting.pl.
- Kliknij Witryny i domeny w lewym menu.
- Wybierz domenę, dla której skonfigurowane jest repozytorium Git.
- Kliknij kafelek Git, aby otworzyć listę repozytoriów.
Każde repozytorium Git skonfigurowane w Plesk ma unikalny URL webhooka — jest to specjalny adres HTTP, którego wywołanie przez zewnętrzny serwis (GitHub, GitLab) uruchamia deployment. URL zawiera token bezpieczeństwa.
- Na liście repozytoriów Git kliknij nazwę repozytorium, dla którego chcesz skonfigurować automatyczny deployment.
- W ustawieniach repozytorium znajdź sekcję lub pole o nazwie Webhook URL lub Deployment hook.
- Skopiuj wyświetlony URL do schowka — będzie wyglądał podobnie do: https://twojadomena.pl:8443/modules/git/deploy.php?hash=xxxxxxxxxxxxx
- Zachowaj ten URL — będzie potrzebny w kolejnym kroku.
Jeśli używasz GitHub jako platformy do hostowania kodu, konfiguracja webhooka przebiega przez panel ustawień repozytorium.
- Otwórz swoje repozytorium na stronie github.com.
- Kliknij zakładkę Settings (Ustawienia) w menu repozytorium.
- W lewym menu kliknij Webhooks.
- Kliknij przycisk Add webhook (Dodaj webhook).
- W pole Payload URL wklej skopiowany adres webhooka z Plesk.
- W polu Content type wybierz application/json.
- W sekcji „Which events would you like to trigger this webhook?" wybierz Just the push event.
- Upewnij się, że opcja Active jest zaznaczona.
- Kliknij Add webhook, aby zapisać konfigurację.
Jeśli korzystasz z GitLab zamiast GitHub, konfiguracja webhooka przebiega nieco inaczej, ale idea jest ta sama.
- Otwórz swoje repozytorium na stronie gitlab.com lub swojej instalacji GitLab.
- W lewym menu wybierz Settings > Webhooks.
- W pole URL wklej skopiowany adres webhooka z Plesk.
- W sekcji „Trigger" zaznacz Push events.
- Możesz opcjonalnie ograniczyć webhook do konkretnej gałęzi (Branch filter).
- Kliknij Add webhook, aby zapisać.
Po skonfigurowaniu webhooka pora na test. Wykonaj dowolną zmianę w kodzie i wypchnij ją do repozytorium, aby sprawdzić, czy deployment uruchamia się automatycznie.
- W swoim lokalnym repozytorium Git dokonaj dowolnej zmiany w pliku (np. edytuj README.md).
- Zatwierdź zmianę: git add . && git commit -m "Test automatycznego deploymentu"
- Wypchnij zmianę do gałęzi skonfigurowanej w Plesk: git push origin main
- GitHub lub GitLab automatycznie wyśle żądanie do URL webhooka Plesk.
- Plesk pobierze zmiany z repozytorium i wdroży je na serwer.
Po wykonaniu push warto zweryfikować, czy deployment przebiegł pomyślnie, sprawdzając logi w Plesk i aktualną zawartość strony.
- Wróć do panelu Plesk i przejdź do sekcji Git dla swojej domeny.
- Sprawdź datę ostatniego deploymentu przy repozytorium — powinna być aktualna.
- Otwórz swoją stronę w przeglądarce i sprawdź, czy zmiany z ostatniego push są widoczne.
- W przypadku problemów sprawdź logi błędów domeny (Witryny i domeny > Logi).
- Na GitHub możesz też sprawdzić historię wywołań webhooka w zakładce Settings > Webhooks > Recent Deliveries, gdzie zobaczysz status każdego wywołania (200 OK = sukces).
Ważne: Przed wprowadzaniem zmian w konfiguracji hostingu zalecamy wykonanie kopii zapasowej danych.
Hosting z panelem Plesk na SmartXHosting.pl — serwery NVMe SSD, WordPress Toolkit, darmowy SSL i automatyczne backupy.
Sprawdz plany hostingowe.