Git: aktualizacja strony internetowej z repozytorium

Pracują Państwo z Git, na przykład z GitHub lub GitLab? W DirectAdmin, w sekcji Git, można utworzyć repozytorium na serwerze lub połączyć je z zewnętrznym repozytorium. Dzięki temu nową wersję strony internetowej umieszczają Państwo na serwerze jednym kliknięciem (lub automatycznie).

Tworzenie repozytorium

1. W DirectAdmin, w sekcji Funkcje zaawansowane, klikną Państwo Git.
2. Klikną Państwo UTWÓRZ REPOZYTORIUM.
3. Przy polu Domena widoczna jest domena, do której należy repozytorium.
4. W polu Imię i nazwisko (1) prosimy wpisać nazwę, na przykład website.
5. Chcą Państwo pobrać istniejące repozytorium z GitHub, GitLab lub innej usługi? Wtedy w polu Zdalny (2) prosimy wpisać adres.
6. Jeśli to repozytorium jest prywatne, w polu Plik klucza (3) prosimy wpisać klucz, dzięki któremu serwer będzie mógł je odczytać (patrz poniżej).
7. Klikną Państwo UTWÓRZ REPOZYTORIUM.

Jeśli pole Zdalny pozostanie puste, DirectAdmin utworzy puste repozytorium na serwerze, do którego będą Państwo sami wysyłać dane (push) przez SSH (patrz Klucze SSH i logowanie przez SSH).

Prywatne repozytorium: klucz wdrożeniowy (deploy key)

Aby odczytać prywatne repozytorium, serwer potrzebuje własnego klucza. Najlepiej utworzyć klucz tylko do odczytu, jako deploy key w GitHub lub GitLab. Część publiczną należy umieścić przy repozytorium (w GitHub: Settings, Deploy keys), a DirectAdmin wskazać ścieżkę do części prywatnej w swoim pakiecie. Dla adresu należy wtedy użyć formy SSH, na przykład git@github.com:twojanazwa/website.git.

Aktualizacja i wdrażanie (deploy)

Klikną Państwo na swoje repozytorium na liście. W ten sposób pobierają Państwo najnowszą wersję z zewnętrznego repozytorium i umieszczają pliki w folderze swojej strony (wdrażanie, deploy). DirectAdmin pokazuje tam również adres webhooka. Jeśli ten adres zostanie dodany przy repozytorium jako webhook (w GitHub: Settings, Webhooks), serwer będzie automatycznie wdrażał każdy push.

Uwaga: Adres webhooka należy zachować w tajemnicy. Każdy, kto zna ten adres, może uruchomić nowe wdrożenie.

Warto wiedzieć

• Podczas wdrażania pliki o tej samej nazwie są nadpisywane, ale pliki usunięte z repozytorium pozostają na serwerze. Prosimy samodzielnie je uporządkować.
• Nie należy umieszczać samego repozytorium w public_html. W przeciwnym razie każdy może odczytać folder .git z całą historią zmian. Niech DirectAdmin sam wdraża pliki do public_html.
• Nie należy umieszczać haseł ani kluczy API w repozytorium. Prosimy przechowywać je w osobnym pliku, który nie znajduje się w Git, na przykład .env.
• Uruchamianie Composer lub npm po wdrożeniu odbywa się w Terminal lub przez SSH (patrz Terminal w przeglądarce).