guide.pl-pl.md

title	excerpt	updated
Konfiguracja i korzystanie z Git na hostingu OVHcloud	Dowiedz się, jak skonfigurować i korzystać z Git na Twoim hostingu w Panelu klienta OVHcloud	2025-01-31

Wprowadzenie

W dzisiejszym świecie cyfrowym społeczeństwa stają się coraz bardziej dynamiczne i innowacyjne. Zdolność skutecznego zarządzania i wdrażania kodu strony WWW jest kluczowa dla utrzymania konkurencyjności i rentowności Twojej marki. Git, najpopularniejszy na świecie system zarządzania wersjami, pozwala na przechowywanie kodu strony internetowej na platformach takich jak GitHub, umożliwiając lepsze śledzenie zmian, a także szybszą automatyzację i wdrożenia. Jeśli jesteś klientem OVHcloud, dysponujesz solidną infrastrukturą do hostowania strony WWW, przy jednoczesnym wykorzystaniu zalet Git i GitHub do rozwoju i skalowania strony WWW.

Dowiedz się, jak skonfigurować Git i korzystać z niego w ramach Twojego hostingu w Panelu klienta OVHcloud.

Wymagania początkowe

• Posiadanie hostingu OVHcloud.
• Dostęp do Panelu klienta OVHcloud, sekcja Web Cloud.
• Posiadanie konta GitHub{.external} i logowanie.

[!primary]

W dniu dotychczasowym w ramach współpracy z usługami hostingowymi OVHcloud obsługiwana jest tylko platforma GitHub.

W praktyce

[!primary]

Aby powiązać i skonfigurować Git, wprowadź zmiany na koncie GitHub. Przed rozpoczęciem korzystania z przewodnika zaloguj się do konta GitHub.

Przypisz katalog do Git

Warning

Po dołączeniu katalogu do Git wszystkie nazwy domen w tym katalogu będą również powiązane z Git. Na przykład, jeśli katalog odpowiadający przypisanej do Ciebie stronie WWW to www, wówczas wszystkie domeny przypisane do katalogu www będą również powiązane z Git.

Zaloguj się do Panelu klienta OVHcloud i wykonaj następujące czynności:

• Przejdź do zakładki Web Cloud{.action}.
• Wybierz hosting w rubryce Hosting{.action} po lewej stronie.
• Kliknij zakładkę MultiSite{.action}.
• W tabeli, która się wyświetli wskaż linię odpowiadającą katalogowi, który chcesz powiązać z Git.
• Kliknij przycisk ...{.action} i wybierz Powiąż Git{.action}.

{.thumbnail}

Zostanie wyświetlony formularz powiązania Git. Należy skonfigurować kilka elementów:

• Klucz SSH
• Repozytorium GitHub
• Gałąź repozytorium GitHub
• Klucz SSH (do prywatnego repozytorium GitHub)
• Webhook (opcjonalnie)

Ustaw repozytorium GitHub

Wprowadź adres Twojego repozytorium GitHub. Jeśli nie masz jeszcze repozytorium GitHub dla swojego projektu, utwórz je.

Aby utworzyć nowe repozytorium:

• Zaloguj się do swojego konta GitHub.
• Kliknij na Twój obraz profilu w prawym górnym rogu, a następnie Your repositories{.action}.
• Kliknij New{.action} po prawej stronie ekranu, który się wyświetli.

Nadaj nazwę repozytorium i podaj wymagane informacje.

Warning

Zaznacz opcję Add a README file, aby GitHub poprawnie zainicjował repozytorium.

Na koniec kliknij przycisk Create Repository{.action}.

Skopiuj adres repozytorium GitHub. Musi mieć formę:

• https://github.com/<username>/<repository_name.git> w repozytorium publicznym.
• [email protected]:<username>/<repository_name.git> w prywatnym repozytorium.

Wróć do formularza kojarzenia Git i wklej adres Twojego repozytorium GitHub w polu Repozytorium{.action}. Jeśli adres ma niepoprawny format, wyświetlany jest następujący komunikat o błędzie:

{.thumbnail}

Teraz zdefiniuj gałąź repozytorium GitHub. Domyślną gałęzią jest main, ale jeśli chcesz użyć innej gałęzi, utwórz ją w GitHubie wykonując poniższe kroki:

• Zaloguj się do swojego konta GitHub.
• Kliknij na Twój obraz profilu w prawym górnym rogu, a następnie Your repositories{.action}.
• Przejdź do odpowiedniego repozytorium GitHub.
• Kliknij na Main{.action}, następnie View all branches{.action}, lub kliknij bezpośrednio na zakładkę x Branch{.action}.
• Po prawej stronie ekranu, który się wyświetli kliknij New branch{.action}.
• Nadaj nazwę nowej gałęzi i potwierdź, klikając na Create new branch{.action}.

Powróć do formularza stowarzyszenia Git w Panelu klienta OVHcloud i podaj nazwę nowo utworzonej gałęzi.

Przypisz klucz SSH do GitHuba (tylko w przypadku prywatnych repozytoriów GitHub)

[!primary]

Wygenerowanie klucza SSH jest kluczowym etapem, ponieważ ustanawia bezpieczne, zaszyfrowane połączenie między katalogiem Twojej strony WWW i repozytorium GitHub. Klucz ten gwarantuje, że transfer danych oraz modyfikacje kodu są realizowane w bezpieczny i uwierzytelniony sposób, zapobiegając nieautoryzowanemu dostępowi oraz zapewniając integralność kodu.

[!primary]

Dlaczego klucz SSH jest wymagany tylko w przypadku rejestracji prywatnej?

Gdy repozytorium GitHub jest publiczne, pliki mogą być odzyskiwane bez uwierzytelniania, co oznacza, że Git może klonować i aktualizować kod bez potrzeby posiadania klucza SSH. Jeśli repozytorium jest prywatne, GitHub wymaga uwierzytelnienia, aby uzyskać do niego dostęp. Klucz SSH pozwala następnie na nawiązanie bezpiecznego połączenia i gwarantuje, że tylko autoryzowani użytkownicy mogą wchodzić w interakcje z repozytorium.

Skopiuj i zapisz klucz SSH na koncie GitHub. Pozwala to na nawiązanie bezpiecznego połączenia bez konieczności wprowadzania hasła do każdej operacji Git, którą będziesz musiał wykonać.

• Zaloguj się do swojego konta GitHub.
• Kliknij na Twój obraz profilu w prawym górnym rogu, a następnie Settings{.action}.
• Na nowej stronie kliknij SSH and GPG keys{.action} w kolumnie po lewej stronie.
• Wybierz New SSH key{.action} lub Add SSH key{.action}.

Zostanie wyświetlony formularz dodawania nowego klucza SSH:

• Title : dodaj opis dla Twojego klucza SSH. Na przykład możesz nazwać ten klucz "OVHcloud".
• Type of key: pozostaw wartość domyślną authentication key{.action}
• Key : wklej klucz SSH.

Aby zatwierdzić informacje, kliknij Add SSH key{.action}. Jeśli zostanie wyświetlony monit, potwierdź dostęp do konta w GitHub.

Skonfiguruj automatyczne wdrażanie

W dolnej części formularza kojarzenia Git, wyświetla się sekcja Skonfiguruj automatyczne wdrożenie{.action} wraz z adresem URL elementu webhook. Konfiguracja interfejsu webhook pozwala repozytorium GitHub na automatyczne powiadamianie hostingu OVHcloud o zdarzeniach, które mają miejsce w repozytorium GitHub (nowe wdrożenie, zmiana kodu, itp.). Funkcja ta jest szczególnie przydatna, jeśli pracujesz w grupie nad tym samym projektem i chcesz być na bieżąco ze wszystkimi zmianami w repozytorium GitHub. Aby dowiedzieć się więcej, sprawdź, jak skonfigurować webhook na GitHubie.

Zatwierdź powiązanie Git

Przed zatwierdzeniem formularza skojarzenia Git, upewnij się, że:

• Twój klucz SSH został zarejestrowany na koncie GitHub.
• Adres repozytorium GitHub jest poprawny. Musi mieć formę https://github.com/<username>/<repository_name.git>.
• Nazwa gałęzi repozytorium GitHub jest poprawna.
• Twój katalog instalacyjny jest pusty.

Aby zatwierdzić informacje zawarte w formularzu powiązania Git, kliknij przycisk Zastosuj konfigurację{.action}.

Aktywacja powiązania Git

Sukces w powiązaniu z Git

Po zatwierdzeniu formularza Asocjacja Git zostaniesz przekierowany do zakładki MultiSite.

{.thumbnail}

Zielony baner informuje, że Git jest aktywowany. Śledź aktywację Git, klikając link Zadania w trakcie{.action}.

{.thumbnail}

Status W realizacji{.action} wskazuje, że trwa przypisywanie do Git. Proces może potrwać kilka minut. Po wykonaniu zadania pojawia się status Włączony{.action}.

Możesz również śledzić postęp aktywacji Git w zakładce MultiSite{.action}. W tabeli określ wiersze odpowiadające katalogowi, który chcesz skojarzyć z Git. W kolumnie Git{.action}, w kolumnie W realizacji{.action}, pojawia się informacja, że Git jest aktywowany.

Po przypisaniu Git status Aktywny{.action} pojawia się w kolumnie Git{.action} dla wybranych wierszy.

{.thumbnail}

Błędy skojarzenia Git

W tabeli w zakładce MultiSite{.action} znajdź wiersze odnoszące się do katalogu, który chcesz powiązać z Git. Jeśli pojawi się informacja Błąd, w kolumnie Git oznacza to, że wystąpił co najmniej jeden z następujących błędów:

• Klucz SSH nie został zapisany na Twoim koncie GitHub.
• Katalog instalacyjny nie jest pusty.
• Adres repozytorium GitHub nie istnieje lub jest nieprawidłowy.
• Gałąź repozytorium GitHub nie istnieje lub jej nazwa jest nieprawidłowa.

Aby poznać dokładną przyczynę błędu, zobacz informacje o ostatnim wdrożeniu. W tabeli wskaż wiersz odpowiadający nazwie domeny, której logi chcesz sprawdzić podczas ostatniego wdrożenia. Po prawej stronie linii kliknij przycisk ...{.action}, a następnie Informacje o ostatnim wdrożeniu{.action}.

{.thumbnail}

Po zidentyfikowaniu(ych) błędu(ów) przypisz ponownie Git. Spróbuj ponownie wykonać operację, klikając przycisk ...{.action} w odpowiedniej linii, a następnie Powiąż Git{.action}.

Uruchomienie repozytorium GitHub na hostingu OVHcloud

Zaloguj się do Panelu klienta OVHcloud, przejdź do sekcji Web Cloud{.action}, kliknij Hosting{.action}, a następnie wybierz odpowiedni hosting. Wybierz zakładkę MultiSite{.action}. W tabeli, która się wyświetli, wskaż linię odpowiadającą nazwie domeny, którą chcesz wdrożyć za pomocą Git. Upewnij się, że stan kolumny Git jest Aktywny{.action}. Kliknij przycisk ...{.action}, a następnie Uruchom Git{.action}.

{.thumbnail}

Zostanie wyświetlony komunikat potwierdzenia wraz z polem wyboru informującym, że w przypadku konfliktu podczas wdrażania możesz wymusić zdalne zmiany (repozytorium GitHub) w repozytorium lokalnym. Zaznacz lub nie tę kratkę, w zależności od dokonanego wyboru, następnie kliknij Zatwierdź{.action}, aby zatwierdzić wdrożenie.

Warning

Aby uniknąć utraty lokalnych zmian, pamiętaj o zapisaniu ich przed nadpisaniem przez zmiany w odgałęzieniu zdalnym.

Nowa wersja Twojej strony została pomyślnie wdrożona na Twoim hostingu OVHcloud. Jeśli inne osoby pracują nad tym samym projektem i wprowadzają zmiany w repozytorium GitHub, możesz skonfigurować webhook na GitHub, aby zmiany zostały automatycznie wdrożone na Twoim hostingu. Dzięki temu nie musisz ręcznie wdrażać Git, a Twój hosting zawsze będzie aktualny.

Zmiana nazwy domeny

Zaloguj się do Panelu klienta OVHcloud, przejdź do sekcji Web Cloud{.action}, kliknij Hosting{.action}, a następnie wybierz odpowiedni hosting. Wybierz zakładkę MultiSite{.action}. W tabeli, która się wyświetli wskaż wiersz odpowiadający domenie, którą chcesz zmodyfikować. Kliknij przycisk ...{.action}, a następnie Zmień domenę{.action}. Możliwe są dwa scenariusze:

Nazwa domeny nie jest jedyną nazwą przypisaną do tego samego katalogu

Pojawi się następujące okno:

{.thumbnail}

Zmień wybrane informacje i kliknij na Dalej{.action}.

Wyświetli się drugie okno potwierdzenia z podsumowaniem zmian.

{.thumbnail}

Kliknij przycisk Zatwierdź{.action}, aby zatwierdzić zmiany w nazwie domeny.

Domena jest jedyną nazwą przypisaną do katalogu

Pojawi się następujące okno:

{.thumbnail}

Jak wskazuje komunikat, usuń swoje powiązanie Git przed zmianą nazwy domeny.

Odłącz domenę

Zaloguj się do Panelu klienta OVHcloud, przejdź do sekcji Web Cloud{.action}, kliknij Hosting{.action}, a następnie wybierz odpowiedni hosting. Wybierz zakładkę MultiSite{.action}. W tabeli, która się wyświetli, zidentyfikuj linię odpowiadającą domenie, którą chcesz oddzielić od Twojego hostingu. Kliknij przycisk ...{.action}, a następnie Odłącz domenę{.action}. Możliwe są dwa scenariusze:

Nazwa domeny nie jest jedyną nazwą przypisaną do tego samego katalogu

Pojawi się następujące okno.

{.thumbnail}

Kliknij na Zatwierdź{.action}, aby potwierdzić odłączenie domeny.

Domena jest jedyną nazwą przypisaną do katalogu

Pojawi się następujące okno:

{.thumbnail}

Jak wskazuje komunikat, usuń swoje powiązanie Git przed odłączeniem domeny.

Konfiguracja Git

Zaloguj się do Panelu klienta OVHcloud, przejdź do sekcji Web Cloud{.action}, kliknij Hosting{.action}, a następnie wybierz odpowiedni hosting. Wybierz zakładkę MultiSite{.action}. W tabeli, która się wyświetla określ wiersz odpowiadający katalogowi, który chcesz skonfigurować za pomocą Git. Kliknij przycisk ...{.action}, a następnie Skonfiguruj Git{.action}.

{.thumbnail}

Wyświetlą się następujące informacje:

• Klucz SSH: jeśli jeszcze tego nie zrobiłeś, zarejestruj klucz SSH na swoim koncie GitHub.
• Rejestracja: adres repozytorium Git. To pole jest nieaktywne, ponieważ nie można zmienić adresu repozytorium Git. Aby zmienić adres repozytorium Git, musisz usunąć skojarzenie Git z Twojego katalogu, a następnie ponownie powiązać katalog z Git.
• Gałąź: nazwa gałęzi repozytorium GitHub. To pole można edytować.
• URL webhook : jeśli chcesz zoptymalizować swoje wdrożenia w Git, skonfiguruj webhook na GitHubie.

Informacje o ostatnim wdrożeniu

Po wdrożeniu repozytorium GitHub na Twoim hostingu możesz sprawdzić informacje dotyczące ostatniego wdrożenia, takie jak błędy, testy lub inne przydatne informacje.

Zaloguj się do Panelu klienta OVHcloud, przejdź do sekcji Web Cloud{.action}, kliknij Hosting{.action}, a następnie wybierz odpowiedni hosting. Wybierz zakładkę MultiSite{.action}. W tabeli, która się wyświetla wskaż wiersz odpowiadający domenie, której logi chcesz sprawdzić podczas ostatniego wdrożenia. Po prawej stronie linii kliknij przycisk ...{.action}, a następnie Informacje o ostatnim wdrożeniu{.action}.

{.thumbnail}

Na tym ekranie znajdziesz wszystkie informacje dotyczące najnowszego wdrożenia.

Usuń powiązanie Git

Zaloguj się do Panelu klienta OVHcloud, przejdź do sekcji Web Cloud{.action}, kliknij Hosting{.action}, a następnie wybierz odpowiedni hosting. Wybierz zakładkę MultiSite{.action}. W tabeli, która się wyświetla określ wiersz odpowiadający katalogowi, którego powiązanie chcesz usunąć za pomocą Git. Kliknij przycisk ...{.action}, a następnie Usuń Git{.action}.

{.thumbnail}

Pojawi się następujące okno:

{.thumbnail}

Poinformujemy, że usunięcie zostanie zastosowane do wszystkich domen przypisanych do katalogu. Zaznacz pole wyboru Czy chcesz wyczyścić zawartość katalogu <your_directory>?{.action} jeśli chcesz również usunąć zawartość (foldery i pliki) z katalogu.

1. Po zaznaczeniu tego pola wyboru pojawi się następujące okno:

{.thumbnail}

Kliknij przycisk Zatwierdź{.action}, aby potwierdzić usunięcie powiązania Git z katalogu i jego zawartości.

2. Jeśli nie zaznaczysz tego pola, wyświetli się następujące okno:

{.thumbnail}

Kliknij przycisk Zatwierdź{.action}, aby potwierdzić usunięcie powiązania Git z Twojego katalogu.

Konfiguracja interfejsu webhook na GitHubie

Pobierz adres URL elementu webhook

[!primary]

Jeśli korzystasz już ze skojarzenia Git, skopiuj adres URL elementu webhook i przejdź do etapu "Konfiguruj element webhook".

Zaloguj się do Panelu klienta OVHcloud, przejdź do sekcji Web Cloud{.action}, kliknij Hosting{.action}, a następnie wybierz odpowiedni hosting. Wybierz zakładkę MultiSite{.action}. W tabeli, która się wyświetla określ wiersz odpowiadający katalogowi, w którym chcesz skonfigurować element webhook. Kliknij przycisk ...{.action}, a następnie Skonfiguruj Git{.action}.

{.thumbnail}

Na dole formularza, który się wyświetla znajdź adres pola URL webhooka{.action} i skopiuj go. Teraz zapisz adres URL i skonfiguruj webhook na koncie GitHub.

Skonfiguruj webhook

Zaloguj się na swoje konto GitHub i przejdź do repozytorium, w którym chcesz skonfigurować webhook. Przejdź do zakładki Settings{.action}, a następnie w bocznym menu ustawień kliknij Webhooks{.action}. Kliknij przycisk Add webhook{.action}, aby przejść do formularza:

• Payload URL: wprowadź adres URL podany w formularzu powiązania Git (URL webhooka{.action}).
• Content type : wybierz application/json{.action} jako typ treści dla przesłanych danych.
• Secret: klucz jest opcjonalny. GitHub będzie go używać do podpisywania wiadomości wysyłanych przez webhook, zwiększając tym samym bezpieczeństwo.
• SSL verification : jeśli Twoja strona WWW używa protokołu HTTPS, pozostaw tę opcję włączoną, aby zwiększyć bezpieczeństwo.
• Which events would you like to trigger this webhook ? : wybierz zdarzenia, które spowodują wysłanie funkcji webhook. W przypadku wdrożenia automatycznego, Just the push event{.action} (Just the push event) jest często wystarczające, ale możesz wybrać Send me everything{.action}, aby otrzymywać powiadomienia o wszystkich zdarzeniach.
• Active : upewnij się, że zaznaczone jest pole wyboru pozwalające na aktywację elementu webhook.

Kliknij przycisk Add webhook{.action}, aby zarejestrować i aktywować nowy webhook.

Przetestuj Twój webhook

Po utworzeniu elementu webhook w GitHubie przejdź do listy elementów webhook i wybierz ten, który właśnie utworzyłeś, lub kliknij na Edit{.action}.

Na wyświetlonym ekranie kliknij zakładkę Recent Deliveries{.action}. Aby wysłać zdarzenie testowe specjalnie, GitHub zazwyczaj wysyła zdarzenie ping podczas tworzenia elementu webhook, a do przetestowania tego zdarzenia możesz użyć przycisku Redeliver{.action} obok tego zdarzenia.

Jeśli test się powiódł, zakładka Response{.action} zwraca kod 200. Jeśli kod błędu zostanie zwrócony (zazwyczaj 500 lub 400), oznacza to, że webhook został nieprawidłowo skonfigurowany. Wróć do formularza dodawania elementu webhook i sprawdź informacje, a w szczególności adres URL elementu webhook dostarczony przez OVHcloud.

Korzystanie z funkcji webhook

Po skonfigurowaniu elementu webhook kod Twojej strony WWW będzie aktualizowany automatycznie za każdym razem, gdy pojawią się zmiany w repozytorium GitHub. Na przykład jeśli w repozytorium GitHub jedna ze współpracowników wprowadzi zmiany, kod Twojej strony WWW zostanie zaktualizowany lokalnie (na Twoim hostingu OVHcloud).

Zakończenie

Powiązałeś kod Twojej strony WWW z Git za pomocą repozytorium GitHub. Możesz teraz wdrożyć zmiany w repozytorium GitHub na Twoim hostingu lub wdrożyć je automatycznie za pomocą interfejsu webhook, sprawdzić logi wdrożeń i wykonywać wiele operacji - wszystko to za pomocą kilku kliknięć w Panelu klienta.

Sprawdź również

Uruchomienie strony WWW na hostingu

W przypadku wyspecjalizowanych usług (pozycjonowanie, rozwój, etc.) skontaktuj się z partnerami OVHcloud.

Jeśli chcesz otrzymywać wsparcie w zakresie konfiguracji i użytkowania Twoich rozwiązań OVHcloud, zapoznaj się z naszymi ofertami pomocy.

Dołącz do grona naszych użytkowników.