Gogs to najłatwiejszy sposób na uruchomienie lokalnego serwera Git (oto jak go skonfigurować)

Opublikowany: 2023-01-03
Logo Gogs na niebieskim tle.
Gogi

Nie chcesz przesyłać swojego kodu do hostowanego repozytorium Git? Następnie uruchom własny serwer Git we własnym zakresie. Gogs to najłatwiejszy sposób na zrobienie tego. Oto jak to skonfigurować.

Spis treści

Problem z repozytoriami hostowanymi w chmurze
Co to jest Gogs?
Jak zainstalować Gogsa
Szybka wycieczka po Gogach
Najłatwiejszy serwer Git — brak

Problem z repozytoriami hostowanymi w chmurze

Bez wątpienia Git jest wybitnym systemem kontroli wersji. Nawet w przypadku projektów realizowanych przez jednego programistę Git zapewnia wartość i korzyści dzięki swojej funkcjonalności wersjonowania. W przypadku projektów obejmujących wielu programistów Git zapewnia zupełnie inny wymiar. Dzięki centralnemu, zdalnemu repozytorium Git umożliwia współpracę, która zmieni sposób, w jaki zespoły programistów postrzegają kontrolę wersji.

Co to jest GitHub i do czego służy?
POWIĄZANE Co to jest GitHub i do czego służy?

Właśnie dlatego istnieją usługi takie jak GitHub, GitLab i BitBucket i dlatego obserwuje się takie zainteresowanie i wzrost. Sam GitHub obsługuje ponad 200 milionów repozytoriów. Ale repozytoria hostowane w chmurze nie są odpowiednie dla wszystkich. Większość z nich pobiera opłaty za hostowanie prywatnych repozytoriów. Niektóre z nich narzucają limity przechowywania, limity użytkowników lub limity transferu danych na darmowych kontach.

Nawet jeśli Twoje użycie i rozmiar zespołu mieszczą się w ograniczeniach bezpłatnych kont lub nawet jeśli jesteś gotów zapłacić za licencję komercyjną, możesz po prostu nie czuć się komfortowo przechowując swoją bazę kodu w chmurze.

Alternatywą jest hostowanie własnego serwera Git lokalnie we własnej sieci lub prywatnie dostępnego we własnej prywatnej chmurze. Skonfigurowanie serwera Git, który zapewnia interfejs sieciowy o wyglądzie, działaniu i opcjach, które GitHub i jego przyjaciele uczynili tak popularnymi, wymagało pewnego poziomu umiejętności technicznych. I tu wkracza Gogs.

Co to jest Gogs?

Gogs to stosunkowo nowy projekt, napisany w Go, który zapewnia łatwą do zainstalowania, ale w pełni funkcjonalną instancję Git. Nie ma ograniczeń co do wielkości zespołu, miejsca na dane ani niczego innego.

Nawet jeśli jesteś programistą-hobbistą, używanie Gogs jako usługi Git w sieci lokalnej pozwala przechowywać kopię kodu z dala od komputera programistycznego. Kiedy ty — lub ktoś inny — chcesz pracować na innym lub nowym komputerze, po prostu sklonujesz repozytorium ze swojego serwera Gogs, tak jak zrobiłbyś to z GitHub.

Jeśli zamierzasz często korzystać z Gogsa, prawdopodobnie wygodniej będzie dodać go do aplikacji startowych komputera, na którym jest uruchomiony.

POWIĄZANE: Jak uruchomić program Linux podczas uruchamiania za pomocą systemd

Jak zainstalować Gogsa

Aby zainstalować Gogs, pobierz odpowiedni plik archiwum, rozpakuj go i uruchom główny plik binarny. Wypełniasz kilka formularzy, a Gogs inicjuje twoje repozytorium i dodaje cię jako administratora. Następnie możesz przeglądać swoją instancję Gogs i dodawać użytkowników oraz tworzyć repozytoria.

Gogs używa bazy danych do przechowywania zaplecza. Obsługuje MySQL, MariaDB, PostgreSQL i TiDB. Jeśli chcesz korzystać z jednego z tych potężnych silników baz danych, musisz go zlokalizować i zainstalować samodzielnie, zanim zainstalujesz Gogs. W przypadku mniejszych zespołów możesz użyć SQLite3. Jeśli zdecydujesz się na SQLite3, jest on zainstalowany dla Ciebie. Oczywiście będziesz także musiał mieć zainstalowanego git .

Pobierz odpowiedni plik binarny.

  • W przypadku większości nowoczesnych dystrybucji Linuksa pobierz plik „Linux amd64”.
  • Jeśli używasz 32-bitowej wersji systemu Linux, pobierz plik „Linux 386”.
  • Jeśli instalujesz na Raspberry Pi 2 lub starszym , pobierz plik „Linux armv7”.
  • Jeśli instalujesz na Raspberry Pi 3, 3+ lub nowszym , pobierz plik „Linux armv8”.
  • Jeśli używasz komputera Mac z procesorem Intel, pobierz plik „macOS amd64”.
  • W przypadku komputera Apple Silicon Mac pobierz plik „macOS arm64”.

Pobraliśmy plik ZIP „Linux amd64” do instalacji na 64-bitowym komputerze z systemem Ubuntu 22.10. Plik jest mały — tylko około 25 MB — więc nie zdziw się, jeśli pobiera się go bardzo szybko. To normalne.

Znajdź plik w swoim systemie plików. Jeśli zachowałeś domyślną lokalizację pobierania przeglądarki, plik prawdopodobnie znajdzie się w katalogu „~/Downloads”. Kliknij go prawym przyciskiem myszy i wybierz „Wyodrębnij” z menu kontekstowego. Niektóre przeglądarki plików mogą zamiast tego używać opcji „Wyodrębnij tutaj”.

Katalog jest wyodrębniany z pliku ZIP. Jego nazwa pochodzi od pobranego pliku. W naszym przypadku nazywał się „gogs_0.11.91_linux_amd64”.

Wyodrębniony katalog, nazwany na cześć pobranego pliku

Kliknij dwukrotnie wyodrębniony katalog, a zobaczysz inny katalog o nazwie „gogs”.

Katalog gogs

Kliknij dwukrotnie katalog „gogs”. Zobaczysz pliki i katalogi Gogs. Kliknij prawym przyciskiem myszy w oknie przeglądarki plików i wybierz „Otwórz w terminalu” z menu kontekstowego.

Aby uruchomić instancję Gogs, wpisz to polecenie:

./gogs web

Uruchamianie serwera gogs Git

Gogs uruchamia się i mówi ci, że nasłuchuje na porcie 3000.

Połącz się z serwerem Gogs, otwierając przeglądarkę internetową i przechodząc do adresu IP lub nazwy sieciowej komputera, na którym działa Gogs. Dodaj „:3000” po adresie IP lub nazwie sieci. Nie dołączaj żadnych białych znaków.

Jeśli przeglądasz na komputerze, na którym działa Gogs, możesz użyć „localhost” jako nazwy komputera, na przykład „localhost:3000”. Nasz komputer Gogs nazywa się „ubuntu-22-10.local”, więc z innego komputera w tej samej sieci adres, do którego musimy przejść, to „ubuntu-22-10.local:3000”, w tym numer portu.

Gdy zrobisz to po raz pierwszy, zobaczysz formularz, który przechwytuje informacje o wstępnej konfiguracji.

Część menu wyboru bazy danych na ekranie konfiguracji Gogs

Pierwszą rzeczą, którą musimy zrobić, to wybrać „SQLite3” z menu rozwijanego „Typ bazy danych” i wprowadzić swoją nazwę użytkownika w polu „Uruchom użytkownika”.

Pole „Uruchom użytkownika” na ekranie konfiguracji Gogs

Jeśli chcesz skonfigurować powiadomienia e-mail, musisz skonfigurować kilka dodatkowych kroków. Będziesz musiał przekazywać e-maile przez serwer poczty Simple Mail Transfer Protocol (SMTP), do którego masz uprawnienia. Jeśli jesteś użytkownikiem Gmaila Google, możesz użyć serwera SMTP Gmaila firmy Google.

Będzie to wymagało ustawień na serwerze pocztowym, aby Twoje konto mogło akceptować i przekazywać wiadomości e-mail. Te ustawienia różnią się w zależności od serwera pocztowego.

Gogs wymaga podania następujących informacji o serwerze poczty e-mail.

  • Host SMTP : Adres i port serwera e-mail. W naszym przykładzie jest to serwer SMTP firmy Google pod adresem smtp.gmail.com:587.
  • Od : Adres e-mail, z którego zostanie wysłana wiadomość e-mail. W przypadku Gmaila powinien to być adres e-mail Gmail konta, którego używasz.
  • E-mail nadawcy : Musi być taki sam jak powyżej. To jest identyfikator konta e-mail, którego Gogs będzie używać do komunikacji z serwerem SMTP.
  • Hasło nadawcy : To nie jest hasło do konta Gmail. Jest to hasło do aplikacji, które otrzymujesz od Google podczas konfigurowania konta w taki sposób, aby aplikacja mogła wysyłać wiadomości e-mail w Twoim imieniu.
  • Włącz potwierdzenie rejestracji : aby Gogs weryfikował e-maile użytkowników, zaznacz to pole wyboru. Nowi użytkownicy otrzymają wiadomość e-mail z zawartym w niej linkiem. Muszą kliknąć, aby udowodnić, że adres e-mail jest autentyczny i znajduje się pod ich kontrolą.
  • Włącz powiadomienie pocztą : Zaznacz to pole wyboru, aby zezwolić na powiadomienia e-mail od Gogs.

Część „Ustawienia usługi e-mail” na ekranie konfiguracji Gogs

Oczywiście, jeśli nie chcesz być nękany przez e-maile, możesz pominąć wszystkie ustawienia poczty e-mail.

Kliknij niebieski przycisk „Zainstaluj Gogs”, gdy będziesz gotowy, aby kontynuować. Gogs zapisuje plik konfiguracyjny, inicjuje przechowywanie bazy danych i uruchamia instancję Git.

Zobaczysz główną stronę główną Gogs.

Strona główna Gogsa

Pierwsze utworzone konto użytkownika automatycznie otrzyma uprawnienia administratora. Kliknij łącze „Zarejestruj się”.

Tworzenie konta na serwerze Gogs

Wypełnij formularz „Zarejestruj się” podając nazwę swojego konta, hasło do tego konta (wpisz je dwukrotnie) oraz cyfry z Captcha. Kliknij zielony przycisk „Utwórz nowe konto”. Zobaczysz stronę „Zaloguj się”.

Logowanie do Gogsa

Wprowadź nazwę konta i hasło, a następnie kliknij zielony przycisk „Zaloguj się”.

Szybka wycieczka po Gogach

Jeśli w ogóle znasz jakąkolwiek inną instancję Git dostępną przez Internet, bardzo łatwo odnajdziesz się w Gogs.

Pulpit nawigacyjny Gogs przed utworzeniem jakichkolwiek repozytoriów

Widok Gogs „Dashboard” jest trochę rzadki, dopóki nie masz repozytorium do pracy. Kliknij niebieski przycisk „+” i wypełnij formularz „Nowe repozytorium”.

Prosi o nazwę repozytorium, czy jest to prywatne czy publiczne, oraz opis.

Tworzenie nowego repozytorium poprzez podanie nazwy i innych szczegółów

Kolejne trzy pola tworzą pliki z szablonów.

Trzy pola kontrolujące tworzenie domyślnych plików z szablonów

  • Menu „.gitignore” pozwala wybrać szablon dla pliku „.gitignore” skonfigurowany z ustawieniami zgodnie z wybranymi językami. Możesz dokonać więcej niż jednego wyboru z tego menu, aby obsłużyć repozytoria korzystające z różnych technologii programistycznych.
  • Menu „Licencja” pozwala wybrać licencję z obszernej listy.
  • Menu „Readme” ma jedną opcję, domyślny plik „README.md”.

Zaznacz pole wyboru „Zainicjuj to repozytorium z wybranymi plikami i szablonem” i kliknij zielony przycisk „Utwórz repozytorium”.

Nowo utworzone repozytorium zawierające trzy automatycznie wygenerowane pliki

Wyświetli się Twoje nowe repozytorium. Gogs stworzył dla nas nasze trzy standardowe pliki i dodał je do repozytorium z komunikatem zatwierdzenia „Początkowe zatwierdzenie”.

Sklonowaliśmy repozytorium na nasz komputer, dodaliśmy plik o nazwie „ack.c”, zatwierdziliśmy go i wypchnęliśmy do naszego zdalnego repozytorium Gogs. Wszystko to zostało wykonane przy użyciu standardowych poleceń Git.

Dodanie pliku do lokalnego repozytorium i przekazanie go do Gogsa

Zgodnie z oczekiwaniami nasz nowy plik pojawia się w naszym repozytorium Gogs.

Repozytorium z nowym plikiem zostało pomyślnie przekazane do niego

Kliknięcie pliku pokazuje nam zawartość pojedynczego pliku. Pliki Markdown są dla Ciebie interpretowane wraz z nagłówkami, linkami, listami i wszystkimi innymi funkcjami Markdown. Pliki „README.md” są zwykle zapisywane w języku Markdown.

Zawartość automatycznie wygenerowanego pliku README.md

Klikając ikonę ołówka „Edytuj”, możemy bezpośrednio edytować nasz plik „README.md”. Dodaliśmy trochę więcej tekstu, użyliśmy znaczników Markdown do wstawienia hiperłączy i kursywy oraz zatwierdziliśmy nasze zmiany. Wszystko z poziomu Gogsa.

Zaktualizowany plik README.md

Po powrocie do naszego widoku repozytorium wyświetlany jest nasz zaktualizowany plik „README.md”, a wpis „README.md” na liście plików pokazuje nowy komunikat o zatwierdzeniu i czas aktualizacji.

Zaktualizowany plik README.md z nowym komunikatem zatwierdzenia i sygnaturą czasową

Najłatwiejszy serwer Git – bez ograniczeń

Gogs to absolutny triumf. Doskonale łączy funkcjonalność z prostotą.

Po wyjęciu z pudełka zaspokoi potrzeby większości hobbystów lub małych zespołów programistycznych. Niektóre z jego zaawansowanych opcji są aktywowane poprzez edycję pliku konfiguracyjnego, który domyślnie znajduje się w „~/Downloads/gogs_0.12.10_linux_amd64/gogs/custom/conf/app.ini”. Pamiętaj, że ścieżka będzie odzwierciedlać wersję Gogs, której używasz.

Ogólną administrację systemem można przeprowadzić z poziomu panelu administracyjnego, który można znaleźć w sekcji Your Profile > Admin panel .

Chociaż dokumentacja Gogs jest krótka do tego stopnia, że ​​jest zwięzła, oznacza to, że łatwo jest znaleźć to, czego szukasz, a opisy są wystarczająco szczegółowe, abyś mógł je śledzić.

Jeśli obawiasz się repozytoriów hostowanych w chmurze, które ostatecznie znajdują się pod kontrolą innych, rozważ użycie Gogs lokalnie. Nie stracisz funkcjonalności, ale zyskasz kontrolę i gwarantowaną prywatność.

POWIĄZANE: Jak sprawdzić i zaktualizować swoją wersję Git